Sie sind auf Seite 1von 78

DevStudio

Sumrio
Sumrio ............................................................................................................................ 2 Viso Geral do Curso ..................................................................................................... 4 Objetivos do Curso ......................................................................................................... 5 O que o DevStudio? .................................................................................................... 6 Configurao ................................................................................................................... 7 Preferncias..................................................................................................................... 8 Configuraes ............................................................................................................... 11 Criao e Edio de Programas ................................................................................. 14 Novo Arquivo................................................................................................................. 15 Caracter ASCII .............................................................................................................. 17 Documentao de Explicao ..................................................................................... 18 Documentao de Cdigos ......................................................................................... 20 Documentao de Cabealhos ................................................................................... 21 Localizar ......................................................................................................................... 22 Repetir Procura Abaixo ............................................................................................ 23 Repetir Procura Acima ............................................................................................. 23 Substituir........................................................................................................................ 23 Indentar ......................................................................................................................... 24 Minsculo ....................................................................................................................... 25 Maisculo ....................................................................................................................... 25 Duplicar Linha ............................................................................................................... 26 Ir para a Linha .............................................................................................................. 26 Ir para a Linha em Execuo...................................................................................... 27 Projetos, Compilao, Gerao e Aplicao de Patch e Anlise do RPO ............. 28 Projetos .......................................................................................................................... 29 Compilar Tudo .............................................................................................................. 33 Compilao de Projetos ............................................................................................... 35 Compilao de Pastas .................................................................................................. 35 Compilao de Arquivos .............................................................................................. 35 Compilao em Batch .................................................................................................. 35 Gerao de Patches ..................................................................................................... 36 Aplicaes de Patches ................................................................................................. 38 Inspetor de Objetos ..................................................................................................... 40 Log do Repositrio ....................................................................................................... 41 Gerente de Projetos ..................................................................................................... 43 Execuo dos Programas ............................................................................................ 44 Executar ......................................................................................................................... 45 Pausa da Execuo ...................................................................................................... 48 Parar a Execuo .......................................................................................................... 48 Ponto de Parada (BreakPoint) .................................................................................... 49 BookMarks ..................................................................................................................... 51 Percorrer Linha ............................................................................................................. 52

2 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Pular linha...................................................................................................................... 53 Executar at o cursor .................................................................................................. 54 Animao ....................................................................................................................... 55 Para animao .............................................................................................................. 55 Acelera animao ......................................................................................................... 55 Desacelera animao ................................................................................................... 55 Ferramentas .................................................................................................................. 57 Assistentes de cdigos ................................................................................................ 58 Assistentes de converses .......................................................................................... 61 Gerenciador de dados .................................................................................................. 64 Verificao de integridades ......................................................................................... 67 Desfragmentar repositrio .......................................................................................... 68 Configurao de ferramentas ..................................................................................... 68 Anlises de variveis, tabelas e campos ................................................................... 70 Comandos ...................................................................................................................... 71 Watches ......................................................................................................................... 72 Break points ................................................................................................................ 72 Pilha de chamadas (call stacks) ................................................................................. 74 Variveis ........................................................................................................................ 75 Tabelas e campos......................................................................................................... 76 Desenho de interface ................................................................................................... 77

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

-3

Viso Geral do Curso


Este curso foi elaborado para capacitar os analistas e programadores do Protheus a utilizarem os recursos da Ferramenta de Desenvolvimento DevStudio da MICROSIGA, para que seja possvel o desenvolvimento de rotinas personalizadas referentes customizaes futuras dentro do Protheus.

4 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Objetivos do Curso
O objetivo deste curso ensinar os futuros desenvolvedores a utilizarem por completo a Ferramenta de Desenvolvimento DevStudio, com todos os recursos oferecidos.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

-5

O que o DevStudio?
O DevStudio um ambiente de desenvolvimento integrado que acompanha o Protheus, permitindo ao usurio editar, compilar e depurar programas escritos na Linguagem de Programao ADVPL. Como Ferramenta de Edio, possui todos os recursos das ferramentas mais populares, como Cortar e Colar, Levar o Cursor at determinada linha do cdigo, Localizao e Substituio de Texto, etc., e recursos adicionais, como Indentao de Cdigo, Insero de Comentrios de Documentao, etc. Como Ferramenta de Debug, dispe de aes de Debug como Percorrer Linha, Pular Linha, Executar, Seguir at o Retorno, Pausar Execuo, Derrubar Client, etc., permitindo ao usurio executar e depurar suas rotinas de dentro de seu ambiente integrado, inspecionando o ambiente de execuo de suas rotinas atravs de diversas janelas de informaes, como variveis (divididas entre variveis locais, variveis pblicas, variveis privadas e variveis estticas), expresses em Watch, Tabelas, ndices e Campos, Break Points, Programas Registrados (Inspetor de Objetos) e Pilha de Chamadas. Alm disso, os programas criados so compilados diretamente do DevStudio, em que so mantidos em Projetos e Grupos de Projetos. Os Grupos de Projetos facilitam a compilao de um ou mais projetos de arquivos, utilizando conceitos de Repositrios e Diretivas de Compilao, possibilitando inclusive a manuteno de bibliotecas de rotinas do usurio.

6 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Configurao
Neste captulo, aprenderemos como devero ser feitas as configuraes bsicas do DevStudio para um melhor aproveitamento de seus recursos. Preferncias; Configuraes.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

-7

Preferncias
Na opo de Preferncias onde so definidas as informaes que influenciam no comportamento do DevStudio, ou seja, o perfil de teclas utilizado, cores dos fontes, tabulao, etc. Para configurar Preferncias do DevStudio, acesse a ferramenta de desenvolvimento DevStudio;

Selecione Arquivo, Preferncias; Na pasta Geral, na opo Padro de teclas utilizado, selecione o pradro de telas desejado;

8 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Marque a opo Ignorar todos os fontes no encontrados, que est localizada na parte inferior; Na pasta Cdigo, verifique as cores que sero utilizadas durante a Digitao do Fonte;

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

-9

Na pasta Controle de Verso, informe o caminho do Software, utilizado para realizar o controle de verses dos fontes, caso seja utilizado algum;

Na pasta Compilao, dever ser informado o nmero de processadores existentes no servidor de aplicao, para que haja ganhos de performance durante a compilao dos programas;

Exerccio
1. Teste a padro de teclas Delphi; 2. Marque a opo Ignorar os fontes no encontrados; 3. Volte a opo Fivewin para o padro de teclas.

10 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Configuraes Aps a definio de todas as Preferncias que sero utilizadas, deveremos ento configurar o Ambiente de Trabalho que ser utilizado pelo compilador, ou seja, qual o caminho que dever ser usado pela Ferramenta de Desenvolvimento DevStudio, para atualizar um determinado RPO durante a Compilao dos Fontes. Para Configurar Configuraes; o DevStudio, selecione Arquivo,

Clique na opo Adicionar; No Campo Descrio:, informe o Nome do Ambiente, que ser utilizado; Na pasta Compilao, informe no Campo Ambiente, o Nome do Ambiente, que ser utilizado pelo Compilador; Dever ser um ambiente vlido, no arquivo de inicializao do AppServer (AppServer.INI); No campo Conexo:, informe o Protocolo Vlido, para a Conexo com o AppServer, que dever ser TCP; No campo Diretrio de Includes, informe o Caminho das Pastas, onde se encontram os Arquivos de Cabealhos de Programas (*.CH);

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 11

Na pasta Geral, posicione com o cursor sobre o campo Otimizao do Repositrio e selecione qual ser a maneira que o compilador ir atualizar o repositrio de objetos, as opes so: Por Tamanho do Repositrio ou Por Velocidade da Compilao;

Se selecionada a opo Por Tamanho do Repositrio, o mesmo ficar com um tamanho reduzido, pois o compilador ir alocar as Funes de acordo com os espaos existentes entre uma funo e outra dentro do repositrio, porm, a compilao ir demorar mais,

12 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

pois ser necessrio maior tempo para a indexao das mesmas dentro repositrio; Caso seja selecionada a opo Por Velocidade de Compilao, a compilao dos programas ser bem mais rpida, porm o RPO ficar com um tamanho maior em relao opo anterior, pois conforme as funes forem geradas, o compilador apenas ir inserlas no repositrio, normalmente no final deste, caso no encontre espao suficiente para aloc-las entre uma funo e outra, ou seja, o arquivo ficar fragmentado. A pasta Hand Held no mais utilizada.

Exerccio
1. Configure um ambiente de compilao baseado nas definies do AppServer.ini.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 13

Criao e Edio de Programas Neste captulo, aprenderemos quais os procedimentos corretos, para a elaborao de novos programas e suas respectivas manutenes. Ferramenta de Desenvolvimento DevStudio: Novo Arquivo; Caracter ASCll; Documentao de Explicao; Documentao de Cdigo; Documentao de Cabealho; Localizar; Repetir Procura Abaixo; Repetir Procura Acima; Substituir; Indentao; Minsculo; Maisculo; Duplicar Linha; Ir para a Linha; Ir para a Linha em Execuo.

14 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Novo Arquivo A opo Novo Arquivo ir possibilitar a edio de novos programas, dentro do DevStudio. Para criar Novos Arquivos no DevStudio, selecione Arquivo, Novo Arquivo ou clique no boto Novo Arquivo , disponvel na barra de ferramentas; Nesta pgina de edio possvel digitar o programa fonte;

Selecione Arquivo , Salvar ou clique no boto Salvar, disponvel na barra de ferramentas e salve no diretrio previamente criado para guardar os programas fonte e projetos. Note que aps salvar o programa, automaticamente o mesmo ser salvo com a extenso PRW, que significa que o fonte pertence ao ADVPL;

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 15

Procure sempre salvar seus programas na pasta My Projects, localizada no diretrio raiz, essa pasta exclusiva para este propsito.

Exerccio
1. Crie um novo arquivo para o fonte abaixo: #Include totvs.ch User Function Exemplo1 Local nI For nI:=1 to 10 Conout(Exemplo de Programa.) Next Return 2. Salve o programa fonte como Exemplo1.prw. Para uma melhor visualizao do texto informado durante a elaborao de um programa, utilize a fonte Ms Line Draw, atravs das seguintes opes Arquivo + Escolha de Fonte, selecionando a fonte citada.

16 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Caracter ASCII Tem como finalidade inserir um caracter no padro ASCII, no fonte dos programas, caso isso seja necessrio. Para utilizar a Tabela ASCII, selecione Arquivo, Novo Arquivo. Clique em Inserir , Caracter ASCII e selecione algum caracter da tabela; Note que o caracter ser inserido no fonte;

Para inserir d um duplo clique no caracter desejado.

Exerccio
1. Inicie um novo fonte, inclua os caracteres ASCII 65, 167 e 166; 2. Feche o fonte, sem salv-lo.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 17

Documentao de Explicao Esta opo tem por finalidade criar um comentrio explicativo que poder ser utilizado como meio para detalhar as etapas do programa, tambm cria um Log referenciando os pontos do programa que foram documentados. Para utilizar documentaes de explicao, selecione Arquivo, Novo Arquivo Ou clique no boto Novo Arquivo, disponvel na barra de ferramentas; Clique em Inserir + Documentao de Explicao; No Box que foi exibido, informe a mensagem a seguir: Teste de programa, utilizando a Documentao de Explicao.

18 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Confira os dados e confirme;

Verifique que o comentrio foi gravado no editor, iniciando com BEGINDOC e encerrando com ENDDOC.

Exerccio
1. Insira 3 documentaes de explicao num novo fonte.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 19

Documentao de Cdigos A Documentao de Cdigos utilizada na sequncia da Documentao de Explicao, pois nessa opo encontram-se gravados todos os pontos onde foram inseridos os comentrios. Para utilizar Documentaes de Cdigo, selecione Ferramentas, Documentao de Cdigo;

Verifique que o comentrio, digitado na documentao de explicao, foi gravado nesta opo, alm disso, as linhas em que esse comentrio foi inserido tambm est sendo informada.

Exerccio
1. Visualize as documentaes includas anteriormente.

20 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Documentao de Cabealhos A opo Documentao de Cabealhos dever ser utilizada quando for iniciado um programa, pois dessa maneira poderemos deixar documentado todos os detalhes daquele fonte, como Nome do Programa, Autor, Data e Finalidade. Para utilizar clique em Inserir, Documentao de Cabealho;

Exerccio
1. Num novo fonte, inclua uma documentao de cabealho; 2. Observe a alterao de fontes entre MsLineDraw e Courier New.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 21

Localizar Para localizarmos uma determinada palavra dentro de um cdigofonte aberto, poderemos utilizar esta opo. Ela possui diversos tipos de pesquisas bastante criteriosas. Como por exemplo coincidir as palavras maisculas e minsculas, realizar a pesquisa abaixo ou acima do posicionamento do cursor, localizao em pastas e subpastas. Para utilizar este recurso, selecione Editar, Localizar.

22 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Repetir Procura Abaixo

Dever ser utilizada quando houver a necessidade de se encontrar uma determinada palavra dentro do texto digitado, lembrando que essa pesquisa ser feita partir da linha onde localiza-se o Cursor para Baixo.
Repetir Procura Acima

Dever ser utilizada quando houver a necessidade de se encontrar uma determinada palavra dentro do texto digitado, lembrando que essa pesquisa ser feita a partir da linha em que localiza-se o Cursor para Cima. Para utilizar este recurso, selecione Editar, Repetir Procura Abaixo ou pressione F3. Substituir Quando houver a necessidade por uma substituio de palavras no programa, poderemos optar por utilizar a opo substituir. Aqui encontraremos, ao mesmo tempo, a opo Localizar e Substituir simultaneamente, sendo que os critrios para isto tambm sero bem detalhados, assim como na opo Localizar. Para utilizar este recurso, selecione Editar, Substituir.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 23

Indentar Quando quisermos que o fonte digitado seja Indentado (tabulado na estrutura de comandos) deveremos utilizadar esta opo. Para Indentar, selecione Editar, Texto, Indentar;

Exerccio
1.Digite o fonte abaixo: #include "totvs.ch" User Function Exemplo2 Local i For i:=1 to 10 If i==3 MsgAlert("Estou no 3") Elseif i==5 MsgAlert("Estou no 5") EndIf Next Return 2. Execute a indentao automtica. Se a opo Indentar for utilizada em um fonte com estrutura de comandos incompleta, ser exibido erro de estrutura

24 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Minsculo Esta opo tem por finalidade transformar um determinado texto marcado em Minsculo, caso seja necessrio. Para utilizar este recurso, selecione o texto que se deseja que fique em letra Minsculo, clique Editar, Texto, Minsculo; Note que o Texto, foi formatado todo com Letras Minsculas.

Exerccio
1. Selecione parte do texto do fonte aberto e transforme em minsculo.

Maisculo Esta opo tem por finalidade transformar um determinado texto marcado em Maisculo, caso seja necessrio. Para utilizar este recurso, selecione o texto que se deseja que fique em letra Maiscula, clique Editar, Texto, Maiscula; Note que o texto ser formatado com letras maisculas.

Exerccio
1. Selecione parte do texto do fonte aberto e transforme em maisculo.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 25

Duplicar Linha Esta opo dever ser utilizada quando quisermos que uma determinada linha do cdigo seja duplicada logo abaixo, ou seja, ter o mesmo efeito que a opo copiar e colar. Para utilizar este recurso, selecione Editar, Texto, Duplicar Linha; A linha ser duplicada logo abaixo.

Exerccio
1. Clique numa linha qualquer do fonte e duplique-a; 2. Desfaa a alterao com CTRL+Z.

Ir para a Linha Dever ser utilizada quando quisermos que o cursor se posicione em uma determinada Linha do Programa, sem que haja a necessidade do programador ficar navegando pelo texto. Para utilizar este recurso, selecione Editar, Ir para Linha;

Informe o nmero da linha que deseja ir e clique em OK; Verifique que na seqncia, o cursor se posiciona na linha indicada.

26 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Exerccio
1. Abra o fonte rddemo.prw e posicione na linha 100.

Ir para a Linha em Execuo Dever ser utilizada quando quisermos que o cursor se posicione na linha que estiver sendo executada pelo DevStudio. Para utilizar este recurso, selecione Editar, Ir para Linha em Execuo.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 27

Projetos, Compilao, Gerao e Aplicao de Patch e Anlise do RPO Neste captulo, aprenderemos como devero ser compilados os programas, criao de projetos de trabalho, as possibilidades de compilao, gerao e aplicao de patchs, verificao e anlises de logs do repositrio. Ferramenta de Desenvolvimento DevStudio: Projetos; Compilar Tudo; Compilar Projetos; Compilar Pastas; Compilar Arquivos; Compilao em Batch; Gerao de Patches; Aplicao de Patches; Inspetor de Objetos; Logs dos Repositrios; Templates.

28 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Projetos Tem por finalidade ajudar o desenvolvedor a administrar, de maneira prtica e organizada, os programas envolvidos em uma determinada Customizao. Como por exemplo, um mdulo que ser customizado poder ser representado por um Projeto, em que cada Tpico abordado pode ser classificado em uma Pasta diferente dentro do mesmo Projeto. Para criar Novos Projetos e Adicionar Arquivos, selecione Projetos, Novo ou clique no boto Novo Grupo de Projetos, disponvel na barra de ferramentas; Ser apresentado uma tela Gerenciados de Projetos, onde deveremos definir o nome do projeto no quadro Novo Grupo de Projetos;

Para salvar, clique v em Projetos, Salvar; Logo a seguir, existe outro Quadro, em que poderemos detalhar ainda mais o nosso Projeto, daremos o nome de IDE, clicando com o boto direito do mouse e selecionando a opo Renomear;

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 29

Agora, deveremos associar o nosso programa ao projeto, clicando com o boto direito do mouse sobre a pasta Fontes, selecionando a opo Adicionar Arquivos; Marque o programa Exemplo1.prw e confirme; Clique na opo +, da pasta Fontes e observe que ele acabou de ser inserido dentro da mesma;

30 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Selecione Visualizar, Mensagens; Clique com o boto esquerdo do mouse sobre a barra de ttulos do gerenciador de projetos e arraste-o para o rodap, at ele fixar-se com a guia Mensagens e Comandos.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 31

Exerccio
1. Com o programa Exemplo1 aberto, selecione as seguintes opes: Projetos, Novo 2. Ser apresentado o gerenciador de projetos, defina o nome Curso DevStudio; 3. Selecione as seguintes opes: Projetos, Salvar 4. Salve o projeto, com o nome de DevStudio e confirme; 5. Defina o nome do grupo como ADVPL e confirme; 6. Selecione a palavra Fontes, clique novamente com o boto direito e mande Adicionar arquivos; 7. Selecione o programa Exemplo1.prw e confirme; 8. Clique na barra de ttulos e arraste o gerenciador para a esquerda, at estacionar na lateral do DevStudio, depois pelo centro da tela e at a guia Mensagens at se agrupar a ela.

32 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Compilar Tudo Utilizado para Compilar todos os programas que se encontram no Gerenciador de Projetos em aberto. Para utilizar a opo Compilar Tudo, carregue o Aplicativo do AppServer;

Retorne para o DevStudio, clique com o boto direito do mouse sobre qualquer umas das pastas existentes no projeto aberto; Selecione a opo Compilar Tudo, disponvel na barra de ferramentas; Somente administradores podem compilar projetos, no campo ID do Usurio, informe Administrador e confirme;

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 33

Observe que ser informada na pasta Mensagens a conexo entre o DevStudio e o AppServer.

Caso a compilao no seja finalizada por motivos de erro no programa, este ser informado na guia Mensagens, juntamente com o nmero da linha onde encontra-se o erro.

Exerccio
1. Carregue o AppServer, no Desktop; 2. Retorne para o DevStudio, clique com o boto direito do mouse sobre qualquer umas das pastas existentes no projeto aberto; 3. Selecione a opo Compilar Tudo, disponvel na barra de ferramentas; 4. Informe ID e senha do Administrador e confirme.

34 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Compilao de Projetos Utilizado para compilar todos os programas contidos no projeto selecionado. Os procedimentos para a compilao so os mesmos utilizados na opo Compilar Tudo, alterando apenas a opo Compilar Tudo por Compilar Projeto.

Compilao de Pastas Utilizado para compilar todos os programas contidos na Pasta selecionada. Os Procedimentos para a compilao so os mesmos utilizados na opo Compilar Projeto, alterando apenas a opo Compilar Projeto por Compilar Pasta;

Compilao de Arquivos Utilizado para compilar um programa especfico contido na Pasta selecionada. Os Procedimentos para a compilao so os mesmos utilizados na opo Compilar Projeto, alterando apenas a opo Compilar Projeto por Compilar Arquivo, lembrando que necessrio que o cursor esteja posicionado exatamente sobre o programa que dever ser compilado dentro da Pasta. Compilao em Batch Utilizado para Compilar em vrios ambientes simultaneamente existentes na configurao do DevStudio, todos os programas

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 35

contidos em um determinado Projetos, Pasta ou simplesmente um Arquivo selecionado. Gerao de Patches Esta opo utilizada para a gerao de Patches, por meio de programas que j tenham sido compilados atravs do DevStudio e que se encontrem dentro do RPO utilizado. Para utilizar a Gerao de Patches, selecione Ferramentas, Gerao de Atualizaes; Ser apresentada uma tela, contendo do lado direito todos os programas que se encontram compilados no RPO em uso; Na pasta Selecionar Arquivos, na combobox Configuraes Disponveis, selecione o ambiente;

Logo abaixo, procure o programa Exemplo1.prw e adicione-o clicando na seta azul, listbox do lado direito. No campo Diretrio do(s) Patch(s), clique na opo ao lado direito e defina o diretrio UPDATES\, como padro para a criao dos arquivos de Patches;

36 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Na sequncia confirme a gerao da atualizao clicando no boto OK; Verifique na pasta de Mensagens que o processo foi inicializado e finalizado com sucesso.

Exerccio
1. Gere um patch a partir do fonte Exemplo1.prw na pasta \Updates.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 37

Aplicaes de Patches A opo gerao de patches utilizada quando houver a necessidade da atualizao dos programas existentes no RPO em uso pelo sistema. Esse processo poder ser utilizado, para atualizarmos os programas gerados pela MICROSIGA ou programas customizados. Para utilizar aplicaes de patches: Selecione as seguintes opes: Ferramentas , Atualizao de repositrio; Ser apresentada uma tela, onde devemos informar no campo configuraes o ambiente desejado. Logo abaixo do lado esquerdo, deveremos informar em que se encontra o patch a ser aplicada; Selecione as seguintes opes: Raiz do servidor, Updates; (os patches devem ser gravados dentro de uma pasta do rootpath, nunca no prprio rootpath)

38 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Verifique na guia Mensagens que o processo foi inicializado.

Exerccio
1. Aplique o patch gerado anteriormente.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 39

Inspetor de Objetos Utilizado para visualizar todos os Programas (Funes), que se encontram Compilados no RPO em uso. Para utilizar Inspetores de Objetos, selecione Visualizar, Inspetor de Objetos, ou clique no boto Inspetor de Objetos, disponvel na barra de ferramentas. Verifique que ser iniciado o carregamento do RPO;

Em seguida, ser apresentada uma lista com todas os arquivos fontes contendo funes, arquivos HTML, ADVPL-ASP e imagens, que se encontram compilados no RPO em uso. Clique com o boto direito do mouse sobre a tela do Inspetor de Objetos e verifique que ser apresentada algumas opes de consultas, legendas das funes e tipos de pesquisas.

Exerccio
1. Utilize o inspetor de objetos para verificar a ltima compilao do fonte Exemplo1.prw.

40 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Log do Repositrio Utilizado para visualizar todo o histrico sobre o RPO em uso, poderemos atravs desta opo visualizar as datas dos ltimos patches aplicados, o contedo dos patches e a data da build utilizada. Para utilizar Log do repositrio, selecione Visualizar, Log do Repositrio ou clique no boto Log dos Repositrios, , disponvel na barra de ferramentas;

No lado esquerdo da tela, visualizamos em seguida posicione o cursor sobre o cone Disquete, que ser apresentado; Verifique que ao lado direito da tela ser informada a data de gerao e aplicao da patch, juntamente com o contedo dela e a data da build; caso seja necessrio, poderemos imprimir este log, clicando na opo Imprimir Log, que se encontra abaixo da tela;

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 41

Exerccio
1. Verifique quantos patches foram aplicados no RPO atual.

42 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Gerente de Projetos Esta opo simplesmente habilita a pasta Gerenciador de Projetos e abre o ltimo Projeto, que estava sendo utilizado pelo DevStudio, caso no haja nenhum Projeto em uso. Para tanto basta clicar nas seguintes opes: Visualizar, Gerente de Projetos.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 43

Execuo dos Programas Neste captulo, aprenderemos a depurar os programas, execut-los, anim-los, adicionar BreakPoints, BookMarks, entre outros. Ferramenta de Desenvolvimento DevStudio: Executar; Pausa da Execuo; Para Execuo (Derrubar Client); Percorrer Linha; Pular Linha; Executar at o Cursor; Ponto de Parada (BreakPoint); BookMarks Animao; Para Animao; Desacelera Animao; Acelera Animao.

44 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Executar Esta opo utilizada para testar o programa aps compil-lo. Primeiramente crie um fonte, salve-o, adicione-o ao projeto, salve o projeto e compile-o.

Na barra de ferramentas, ao lado direito da tela, informe o nome da funo compilada, neste caso u_Exemplo2; Nunca devemos esquecer que todo programa compilado pelo DevStudio dever ser executado utilizando-se a letra U_ antes do nome da funo, isso se deve ao fato de estarmos executando uma User Function.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 45

Para executar, selecione Executar no menu Executar, Programa ser executado na tela.

Confirme as mensagens do programa at a sua finalizao.

46 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Exerccio
1. Compile o programa abaixo: #Include Rwmake.ch User Function Exemplo2 For nI:=1 to 10 If nI==3 MsgAlert(Estou no 3) Elseif nI==5 MsgAlert(Estou no 5) Endif Next Return

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 47

Pausa da Execuo Dever ser utilizado sempre que for necessrio Pausar a Execuo de um Programa. Para tanto, basta iniciarmos a execuo de uma determinada Funo e selecionarmos: Executar, Pausa Ou clicarmos no boto Pausa de Execuo, disponvel na Barra de Ferramentas.

Parar a Execuo Dever ser utilizado sempre que for necessrio Derrubar a Execuo de um Programa. Para utilizar a opo Parar a Execuo: Executar, Para Execuo Ser exibida a mensagem de cancelamento da execuo.

Exerccio
1. No programa anterior, pare a execuo ao exibir a primeira mensagem.

48 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Ponto de Parada (BreakPoint) Esta opo tem por finalidade definir um ponto de parada durante a execuo de um determinado programa, ou seja, aonde quisermos que a execuo do programa seja interrompida deveremos inserir um ponto de parada. Para utilizar a opo ponto de parada (break point), com o cursor posicionado em alguma linha do programa, selecione Executar, liga/desliga ponto de parada, ou clique no boto Ponto de parada ;

Na Seqncia, execute o programa;

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 49

Verifique que quando a Execuo passar pela linha onde se encontra o ponto de parada, este ser congelado;

Clique sobre o ponto de parada, removendo-o do programa e execute o programa novamente at a sua finalizao.

Exerccio
1. No fonte exemplo2.prw, adicione um ponto de parada na linha 5, execute-o observando a parada, remova o ponto e conclua a execuo.

50 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

BookMarks Esta opo tem por finalidade marcar determinados pontos do programa, para facilitar a localizao de pontos estratgicos do fonte, durante a sua manuteno. Para adicionar bookmarks basta pressionar as teclas <ctrl> + <shift> + <nmero de 0 9>, em algum ponto do programa, isso far a linha onde on cursos est posicionada seja marcada com um bookmark.

Para remover os bookmarks do programa, basta pressionar a combinao de teclas <Ctrl> + <Shift> + <Nmero do bookmark>.

Exerccio
1. 2. Inclua um bookmark na linha 7 do fonte Exemplo2.prw. Remova o bookmark includo

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 51

Percorrer Linha Dever ser utilizado para que o programa seja executado linha a linha pelo debugador, para isso deveremos adicionar um ponto de parada, no incio do programa. Para utilizar a opo percorrer linha, posicione com o cursor sobre qualquer linha do programa e clique em executar, liga/desliga ponto de parada; Assim que a execuo congelar no ponto de parada, selecione executar, executar; Clique nas seguintes opes: executar > percorrer linha Ou clique no boto percorrer linha, disponvel na barra de ferramentas, simultaneamente at o fim do debug.

Exerccio
1. Faa a depurao do fonte Exemplo2.prw.

52 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Pular linha Dever ser utilizado quando for necessrio saltarmos linhas do programa, que estiver sendo executado. Para utilizar a opo pular linha, posicione com o cursor sobre qualquer linha do programa e clique em executar, liga/desliga ponto de parada; Assim que a execuo congelar no ponto de parada, selecione: executar, executar Clique nas seguintes opes: executar > executar Selecione as seguintes opes: executar > pular linha Ou clique no boto pula linha, disponvel na barra de ferramentas, simultaneamente at o fim do debug.

Exerccio
1. No fonte Exemplo2.prw, pule a linha que executaria a segunda mensagem.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 53

Executar at o cursor Dever ser utilizado quando quisermos que um determinado programa seja executado apenas at onde o cursor estiver posicionado. Para utilizar a opo executar at o cursor, posicione com o cursor sobre qualquer linha do programa e clique em Executar, liga/desliga ponto de parada; Assim que a execuo congelar no ponto de parada, selecione Executar, Executar; Posicione o cursor numa linha posterior ao ponto de parada, no sendo a prxima; Clique executar at o cursor

Exerccio
1. Simule no fonte Exemplo2.prw o recurso de executar at o cursor.

54 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Animao Dever ser utilizado quando quisermos que o cursor acompanhe a execuo do programa, dando assim, um efeito de animao, durante o debug do mesmo. Para animao Dever ser utilizado quando quisermos que o programa em animao seja pausado. Acelera animao Utilizado para aumentar a velocidade da animao do programa durante o debug. Desacelera animao Utilizado para diminuir a velocidade da animao do programa durante o debug.

Exerccio
1. Salve o fonte abaixo como Exemplo3.prw: #include totvs.ch User Function Exemplo3 Local i For i:=1 to 100 Conout(i)

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 55

Next Return 2. Compile-o, coloque breakpont na linha 3, na declarao Local i; 3. Execute a animao, parando, acelerando e desacelerando.

56 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Ferramentas Neste captulo, aprenderemos como utilizar os recursos do assistente de cdigo, converso de fontes, gerenciador de dados, verificar a integridade do rpo, patches e configurar atalhos para outros aplicativos. Ferramenta de desenvolvimento devstudio: Assistentes de cdigos; Assistentes de converses; Gerenciadores de dados; Checar integridades; Configurar ferramentas.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 57

Assistentes de cdigos Utilizado para ajudar o programador a desenvolver fontes de programas, como por exemplo: cadastros, relatrios, gerao e importao de arquivos texto e processamentos genricos. Para utilizar assistentes de cdigos para relatrios, selecione: ferramentas > assistente de cdigo > relatrio

Clique na opo avanar em seguida informe o alias do arquivo (nome da tabela) e clique na opo avanar;

58 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Na prxima tela, informe a chave para parmetros de relatrio e clique na opo avanar;

No campo ttulo, e clique na opo finalizar;

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 59

Verifique que o fonte do programa foi criado automaticamente com seus devidos comentrios.

Exerccio
1. Utilize o Assistente de cdigo para criar um relatrio de Clientes, exibindo codigo, loja e nome dos clientes. 2. Utilize o assistente de cdigo para criar um cadastro para a tabela SB1 (produtos).

60 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Assistentes de converses Utilizado para converter os fontes dos programas criados nas verses anteriores do sistema, como a verso siga advanced que possui diferenas em alguns pontos do programa. Para utilizar assistentes de converses, selecione: Ferramentas, Assistente de converso. Ser apresentada a tela abaixo: Clique no boto Adicionar Arquivo no lado direito da tela:

Escolha o fonte a ser convertido;

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 61

O processo de converso ser iniciado;

Informe o diretrio onde o fonte convertido ser salvo e clique no boto Avanar;

62 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Informe se deseja criar um novo projeto, clique em Finalizar;

O fonte convertido poder ser compilado pelo DevStudio. Todos os fontes convertidos pelo assistente de converso, recebero o suplemento _ap aps a nome do arquivo.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 63

Gerenciador de dados Esta opo utilizada como uma maneira de se obter informaes sobre os arquivos e campos existentes no sistema, tambm ser possvel analisarmos as estruturas dos mesmos, suas validaes e relacionamentos. Para utilizar gerenciadores de dados, selecione as seguintes opes: Ferramentas, Gerenciador de dados Selecione a empresa desejada e confirme;

Sero lidos os arquivos SX (dicionrio de dados) da empresa escolhida;

64 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Clique no sinal de + Arquivos esquerda, a lista de tabelas ser expandida abaixo. Selecione um Alias de tabela e ser exibido direita as informaes sobre essa tabela.

Para utilizar modelos entidade-relacionamentos, selecione a opo Modelo Entidade-Relacionamento, que se encontra ao lado esquerdo da tela;

Clique na opo Selecionar Arquivos, localizado na barra de ferramentas, logo acima; Ser apresentada uma tela onde deveremos marcar os arquivos a relacionar; Marque os seguintes arquivos que deseja e confirme;

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 65

Sero apresentados os arquivos e seus relacionamentos, com um duplo clique sobre as pastas dos arquivos poderemos verificar tambm quais os campos que se relacionam entre as tabelas e o tipo de relacionamento (1xN, 1x1, etc);

Exerccio
1. Faa um MER entre as tabelas SA1, SC5 e SE1.

66 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Verificao de integridades Utilizado para verificar a integridade do rpo e patch que esto sendo utilizados pelo sistema. Para tanto, basta selecionar as seguintes opes Ferramentas , Checar integridade e localize o arquivo de patch. Utilize esta opo sempre que for atualizar um RPO ou antes de aplicar uma atualizao ao mesmo.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 67

Desfragmentar repositrio Esta opo somente ser vlida se o DevStudio estiver configurado como Por velocidade da compilao, pois dessa maneira o RPO ficar fragmentado. Para tanto basta selecionar as seguintes opes Ferramentas, Desfragmentar repositrio.

Deve-se ter acesso exclusivo ao repositrio para desfragment-lo. Esse processo ir reduzir o tamanho do repositrio reescrevendo-o e eliminando espao ocupado por rotinas antigas..

Configurao de ferramentas Quando quisermos criar um atalho para algum executvel dentro do DevStudio poderemos utilizar esta opo. Ela simplesmente cria uma nova opo no menu de ferramentas, logo abaixo da opo configurar ferramentas. Selecione as seguintes opes: Ferramentas, ferramentas Configurar

68 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Clique em Adicionar; Informe o ttulo a ser exibido no menu, o caminho completo para o executvel do aplicativo e demais parmetros necessrios;

Exerccio
1. Faa um atalho para a calculadora (calc.exe) e mapa de caracteres (charmap.exe)

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 69

Anlises de variveis, tabelas e campos

Neste captulo, aprenderemos como utilizar o watches, analisar variveis dos programas, pilha de chamadas, verificar os pontos onde esto localizados os break points, verificar as tabelas e campos utilizados pelo programa e o gerenciador de dados. Ferramenta de desenvolvimento ide: Comandos; Watches; Break points; Pilhas de chamadas; Variveis locais; Variveis privadas; Variveis pblicas; Variveis estticas; Tabelas e campos.

70 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Comandos Utilizado para que seja possvel analisarmos e alterarmos os valores das variveis durante o debug dos programas. Para utilizar a pasta comandos, crie um ponto de parada; Na pasta comandos digite o valor da varivel e pressione <enter>; Observe que o valor da varivel ser retornado.

Exerccio
1. No fonte Exemplo1.prw, coloque um breakpoint na linha 5. Verifique o valor da varivel nI e altere-a vontade.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 71

Watches Atravs dessa opo poderemos verificar o valor de variveis, no permitindo alter-las, e tambm incluir expresses ADVPL sem ter que necessriamente declarar uma varivel.

Exerccio
1. No fonte Exemplo1.prw coloque um ponto de parada, execute o programa, exiba a janela de Watches e verifique o valor da varivel nI e das expresses nI==10 e Time().

Break points Esta opo dever ser utilizada quando quisermos saber onde se encontram todos os pontos de parada que esto marcados no programa em uso. Poderemos tambm inserir condies nos pontos de parada, dessa maneira, sempre que o programa estiver em modo de debug, o mesmo somente ter sua execuo parada se atender a condio do ponto de parada.

72 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Exerccio
Como utilizar a opo break point: 1. Utilizando o programa exemplo2, posicione o cursor na linha 4 do programa; 2. Selecione as seguintes opes: executar > liga/desliga ponto de parada 3. Selecione as seguintes opes: visualizar > janelas de debug > break points 5. No campo condio, digite ni==3 e confirme; 6. Insira um novo ponto de parada na linha 3 do programa, posicionando o cursor na mesma linha e selecionando as opes: executar > liga/desliga ponto de parada 7. Execute o programa por meio das opes: executar > executar 8. Assim que a execuo do programa for congelada no ponto de parada, localizado na linha 3, remova-o de l, clicando sobre o break point daquela linha; 9. Selecione as seguintes opes: executar > animao 10. Observe que quando a varivel ni estiver com o valor 3, a execuo ser congelada, atendendo a condio do ponto de parada condicional; 11. Encerre a execuo do programa, selecionando as opes: executar > para execuo

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 73

Pilha de chamadas (call stacks) Dever ser utilizado sempre que quisermos analisar a seqncia das execues dos programas, com a finalidade de identificar algum erro de lgica dos mesmos. Sero exibidas as chamadas de rotina, por ordem descentente, ou seja, qual programa foi chamado por qual programa, comeando do ltimo..

Exerccio
1. Copie e compile o fonte abaixo: #include "totvs.ch" User Function programa1 programa2() return static function programa2 programa3() return static function programa3 msgalert("oi")

74 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

return 2. Coloque um breakpoint na linha do msgalert() e verifique a pilha de chamadas. Variveis Esta opo dever ser utilizada para demonstrar todas as variveis do tipo local, privada, pblica e esttica, que se encontram no programa debugado, no momento.

Exerccio
1. Crie um fonte com o cdigo abaixo: #include "totvs.ch" User Function Variaveis Local cNome:="Sergio" Private dDia:=Date() Public nSalario:=10000 Static lCasado:=.T. Return 2. Compile, coloque um breakpoint no Return e visualize as variveis.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 75

Tabelas e campos Nesta opo teremos a possibilidade de visualizar todos os arquivos (tabelas) e campos utilizados em um determinado programa, ser possvel tambm analisarmos as chaves de ndices, utilizadas pelos arquivos, nmero do registro corrente e path do arquivo.

Exerccio
1. Copie o fonte abaixo:
#include

"totvs.ch"

User Function Mt010Inc Return 2. Coloque um breakpoint na linha do return, escolha SIGAFAT na combobox de execuo na barra de ferramentas, inclua um produto e confirme; 3. Utilize a opo para verificar as tabelas abertas at o momento da execuo.

76 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista

Desenho de interface
Neste captulo, aprenderemos como utilizar os recursos do desenhador de telas, utilizado para facilitar as telas de entrada de dados, que trabalham com objetos e dilogos. Para utilizar o assistente de interface, clique em Arquivo, Novo Dialogo. Observe os objetos disponveis para incluso na caixa de dilogo na barra Bsicos. Os nomes dos objetos podem ser trocados, e os mtodos executados em cada evento podem ser alterados pelo Editor de propriedades. Ao concluir o layout da DialogBox, clique sobre ela com o boto direito e mande Gerar cdigo.

Todos os direitos reservados.

19 3027-6660 totvs.com/interiorpaulista
DevStudio

- 77

Exerccio
1. Crie uma caixa de dilogo, inclua uma textbox, um label e um button, gere o cdigo, salve o fonte como exemploX.prw, adicioneo ao projeto e compile e execute-o.

78 DevStudio
Todos os direitos reservados. 19 3027-6660 totvs.com/interiorpaulista