Educao Corporativa

TotvsDevStudio

Matriz - Av. Braz Leme, 1.717 - 02511-000 - So Paulo - SP - Brasil. Tel.: 55 (11) 3981 - 7001 www.microsiga.com.br
Todos os direitos reservados. Planejamento e controle oramentrio

Sumrio

VISO GERAL DO CURSO Objetivos do Curso TotvsDevStudio CONFIGURAO Preferncias Configuraes Criao e Edio de Programas Novo Arquivo Caracter ASCll Documentao de Explicao Documentao de Cdigos Documentao de Cabealhos Localizar Repetir Procura Abaixo Indentar Substituir Minsculo Maisculo Duplicar Linha Ir para a Linha Ir para a Linha em Execuo Projetos, Compilao, Gerao, Aplicao de Patch e Anlise do RPO Projetos Compilar Tudo Compilao de Projetos Compilao de Pastas Compilao de Arquivos Compilao em Batch Gerao de Patchs Aplicaes de Patchs Inspetores de Objetos Logs dos Repositrios Gerente de Projetos Execuo dos Programas Executar Pausa da Execuo Parar a Execuo Ponto de Parada (Break Point) Book Marks Percorrer Linha Pular Linha Executar at o Cursor Animao Para Animao Acelera Animao Desacelera Animao Ferramentas Assistentes de Cdigos Assistentes de Converses Gerenciador de Dados

4 4 4 5 5 9 11 12 14 15 16 17 19 19 20 20 21 21 22 23 23 24 24 27 29 29 29 30 30 32 34 35 37 37 38 41 41 42 44 46 47 48 49 50 51 52 53 53 57 59

TotvsDevStudio

Todos os direitos reservados.

Verificao de Integridades Desfragmentar Repositrio Configurao de Ferramentas Anlises de Variveis, Tabelas e Campos Comandos Watchs Break Points Pilha de Chamadas (Call Stacks) Variveis Tabelas e Campos Desenho de Interface

64 65 66 68 68 70 72 74 75 77 78

Todos os direitos reservados.

TotvsDevStudio

VISO GERAL DO CURSO

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

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

TotvsDevStudio
O que a Ferramenta de Desenvolvimento TotvsDevStudio?
O TotvsDevStudio (Totvs Development Studio) 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 TotvsDevStudio, onde 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.

Anotaes

TotvsDevStudio

Todos os direitos reservados.

CONFIGURAO
Neste captulo, aprenderemos como devero ser feitas as configuraes bsicas do TotvsDevStudio para um melhor aproveitamento de seus recursos. Ferramenta de Desenvolvimento TotvsDevStudio: Preferncias; Configuraes.

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

Anotaes

Todos os direitos reservados.

TotvsDevStudio

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

Marque a opo Ignorar todos os fontes no encontrados que est localizada na parte inferior; ,

TotvsDevStudio

Todos os direitos reservados.

Na pasta Cdigo verifique as cores que sero utilizadas durante a Digitao do Fonte; ,

Na pasta Controle de Verso informe o Caminho do Software utilizado para realizar o Controle de , , Verses dos Fontes caso seja utilizado algum; ,

Anotaes

Todos os direitos reservados.

TotvsDevStudio

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; ,

Aps verificar todas as Preferncias confirme. ,

Exerccios
Como configurar Preferncias do TotvsDevStudio: 1. Acesse a "Ferramenta de Desenvolvimento TotvsDevStudio", atravs do atalho no desktop; 2. Selecione as seguintes opes: Arquivo > Preferncias; 3. Na pasta Geral na opo Padro de teclas utilizado selecione a opo Delphi; , , 4. Marque a opo Ignorar todos os fontes no encontrados que est localizada na parte , inferior; 5. Na pasta Cdigo verifique as cores que sero utilizadas durante a Digitao do Fonte; , 6. Na pasta Controle de Verso informe o Caminho do Software utilizado para realizar o Controle , , de Verses dos Fontes caso seja utilizado algum; , 7. Na pasta Compilaodever ser informado o Nmero de Processadores existentes no Servidor , de Aplicao para que haja Ganhos de Performance durante a Compilao dos Programas; , 8. Aps verificar todas as Preferncias confirme. ,

TotvsDevStudio

Todos os direitos reservados.

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 TotvsDevStudio, para atualizar um determinado RPO durante a Compilao dos Fontes. Para Configurar o TotvsDevStudio, selecione ArquivoConfiguraes; ,

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 TotvsApplicationServer(TotvsAppServe , r.INI); No Campo Conexo: informe o Protocolo Vlido para a Conexo com o TotvsApplicationServer 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.

TotvsDevStudio

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, 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 inser-las no repositrio,normalmente no final do mesmo, caso no encontre espao suficiente para aloc-las entre uma funo e outra, ou seja, o arquivo ficar fragmentado. Na pasta Hand Held poder ser definido para qual Tipo de Interface o compilador estar sendo utilizado, , isso para programas desenvolvidos para Pocket PC e PalmOS

10

TotvsDevStudio

Todos os direitos reservados.

Exerccios
Como Configurar o TotvsAppServer: 1. Selecione as seguintes opes: Arquivo > Configuraes; 2. Clique na opo Adicionar; 3. No Campo Descrio: informe o Nome do Ambiente; , 4. Na pasta Compilao informe no Campo Ambienteo Nome do Ambienteque ser utilizado , , , pelo Compilador; 5.NoCampo Conexo:informe oProtocoloVlidopara aConexo com oTotvsApplicationServer , , , que dever ser TCP; 6. No Campo Diretrio de Includes informe o Caminho das Pastas onde se encontram os , , Arquivos de Cabealhos de Programas (*.CH); 7. 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;

Anotaes

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 TotvsDevStudio: Novo Arquivo; Caracter ASCll; Documentao de Explicao; Documentao de Cdigo; Documentao de Cabealho; Localizar;

Todos os direitos reservados.

TotvsDevStudio

11

 Repetir Procura Abaixo; Repetir Procura Acima; Substituir; Indentao; Minsculo; Maisculo; Duplicar Linha; Ir para a Linha; Ir para a Linha em Execuo.

Novo Arquivo
A opo Novo Arquivo, ir possibilitar a edio de novos programas, dentro do TotvsDevStudio. Para criar Novos Arquivos no TotvsDevStudio, Selecione Arquivo, Novo Arquivo ou clique no boto Novo Arquivo , disponvel na Barra de Ferramentas; Nesta Pgina de Edio possvel digitar o programa fonte;

Anotaes

12

TotvsDevStudio

Todos os direitos reservados.

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; Procure sempre salvar seus programas na pasta Rdmake localizada no Diretrio Raiz do Protheus essa , , pasta exclusivo para este propsito.

Exerccios
Como criar Novos Arquivos no TotvsDevStudio: 1. Selecione as seguintes opes: Arquivo > Novo Arquivo 2. Na Pgina de Edio informe o programa a seguir: , #Include Rwmake.ch User Function Exemplo1 For nI:=1 to 10 MsgAlert(Exemplo de Programa.) Next Return 3. Salve o programa fonte como Exemplo1 e confirme.

Dica

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 selecionado a fonte citada. ,

Anotaes

Todos os direitos reservados.

TotvsDevStudio

13

Caracter ASCll
Tem como finalidade inserir um Caracter no Padro ASCll no fonte dos programas, caso isso seja necessrio. Para utilizar a Tabela ASCll, selecione ArquivoNovo Arquivo , Clique em Inserir + Caracter ASCll e selecione algum Caracter da Tabela; Note que o Caracter foi inserido no fonte; ,

Para inserir d um duplo clique no caracter desejado

Exerccios
Como utilizar a Tabela ASCll: 1. Selecione as seguintes opes Arquivo > Novo Arquivo 2. Clique nas seguintes opes Inserir + Caracter ASCll e selecione algum Caracter da Tabela; 3. Insira o caracter desejado dando um duplo clique

Anotaes

14

TotvsDevStudio

Todos os direitos reservados.

Documentao de Explicao
Esta opo tem por finalidade criar um Documento de Explicao, 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 ArquivoNovo 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 .

Confira os dados e confirme;

Todos os direitos reservados.

TotvsDevStudio

15

Verifique que o Comentrio foi gravado no Editor iniciando com BEGINDOC e encerrando com , , ENDDOC .

Exerccios
Como utilizar Documentaes de Explicao: 1. Selecione as seguintes opes: Arquivo > Novo Arquivo 2. Clique nas seguintes opes Inserir + Documentao de Explicao 3. No Box que foi exibido, informe a mensagem a seguir: Teste de programa, utilizando a Documentao de Explicao . 4. Confira os dados e confirme;

Anotaes

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 FerramentasDocumentao de Cdigo; ,

Verifique que o Comentrio digitado na Documentao de Explicao foi gravado nesta opo, alm , , disso, as Linhas onde esse comentrio foi inserido tambm est sendo informada.

16

TotvsDevStudio

Todos os direitos reservados.

Exerccios

Como utilizar Documentaes de Cdigos: 1. Selecione as seguintes opes: Ferramentas > Documentao de Cdigo; 2. Confira os dados, confirme e Cancele o Editor sem Salvar .

Anotaes

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 principais sobre a elaborao daquele fonte. Como por exemplo: Nome do Programa, Autor, Data, Finalidade e etc... Para utilizar Documentaes de Cabealhos, selecione ArquivoNovo Arquivo; , Clique em Inserir Documentao de Cabealho; ,

Anotaes

Todos os direitos reservados.

TotvsDevStudio

17

Verifique que ser inserido no Editor uma Caixa Formatada para a Informao dos Comentrios , , .

Exerccios
Como utilizar Documentaes de Cabealhos: 1. Selecione as seguintes opes: Arquivo > Novo Arquivo; 2. Clique nas seguintes opes: Inserir > Documentao de Cabealho; 3. Confira os dados e Cancele a Operao .

18

TotvsDevStudio

Todos os direitos reservados.

Localizar
Para Localizarmos uma determinada palavra dentro de um Cdigo-Fonte 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 EditarLcalizar; ,

Anotaes

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 partir da linha onde localiza-se o Cursor para Cima. Para utilizar este recurso, selecione EditarRepetir Procura Abaixo ou pressione F3; ,

Todos os direitos reservados.

TotvsDevStudio

19

Substituir
Quando houver a necessidade 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 o mesmo, tambm sero bem detalhados, assim como na opo Localizar. Para utilizar este recurso, selecione EditarSubstituir; ,

Indentar
Quando quisermos que o fonte digitado seja Indentado (Organizado) deveremos utilizadar esta opo. Para Indentar, selecione EditarTextoIndentar; , , Note que o Fonte digitado anteriormente foi Indentado , .

Exerccios
Como utilizar Indentaes: 1. Selecione as seguintes opes: Arquivo > Abrir; 2. No Diretrio Rdmake na pasta MP8 abra o arquivo Exemplo1.prw; , , 3. Selecione as seguintes opes: Editar > Texto > Indentar;

Quando a opo Indentar for utilizada em um fonte no qual estiver faltando o encerramento de alguma , condio, ser exibida uma mensagem indicando a linha onde est faltando o trmino da mesma.

20

TotvsDevStudio

Todos os direitos reservados.

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

Exerccios
Como utilizar a opo Minsculo: 1. Ainda com o programa Exemplo1 em aberto, marque com o cursor qualquer Linha do Texto; 2. Selecione as seguintes opes: Editar > Texto > Minsculo; Texto foi formatado todo com Letras Minsculas , .

Anotaes

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

Todos os direitos reservados.

TotvsDevStudio

21

Exerccios
Como utilizar a opo Maisculo: 1. Ainda com o programa Exemplo1 em aberto, marque com o cursor qualquer Linha do Texto; 2. Selecione as seguintes opes: Editar > Texto > Maisculo; Texto foi formatado todo com Letras Maisculas , .

Anotaes

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 EditarTextoDuplicar Linha; , , Note que a Linha foi Duplicada logo abaixo.

Exerccios
Como utilizar a opo Duplicar Linha: 1. Ainda com o programa Exemplo1 em aberto, posicione com o cursor sobre qualquer Linha que possua Texto; 2. Selecione as seguintes opes: Editar > Texto > Duplicar Linha; Note que a Linha foi Duplicada logo abaixo.

22

TotvsDevStudio

Todos os direitos reservados.

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 EditarIr 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.

Exerccios
Como utilizar a opo Ir para a linha: 1. Ainda com o programa Exemplo1 em aberto, selecione as seguintes opes: Editar > Ir para a Linha; 2. No Campo que surgiu, informe o Nmero da Linha desejada;

Anotaes

Ir para a Linha em Execuo

Dever ser utilizada quando quisermos que o cursor se posicione na linha que estiver sendo executada pelo TotvsDevStudio. Para utilizar este recurso, selecione EditarIr para Linha em Execuo; ,

Todos os direitos reservados.

TotvsDevStudio

23

Projetos, Compilao, Gerao, 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 TotvsDevStudio: Projetos; Compilar Tudo; Compilar Projetos; Compilar Pastas; Compilar Arquivos; Compilao em Batch; Gerao de Patchs; Aplicao de Patchs; Inspetor de Objetos; Logs dos Repositrios; Templates.

Projetos
Tem por finalidade, ajudar o desenvolvedor 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, onde cada Tpico abordado, pode ser classificado em uma Pasta diferente dentro do mesmo. 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 (Projeto) onde deveremos definir o Nome do Mesmo no quadro Novo , Grupo de Projetos o qual dever ser um nome sugestivo customizao que ser iniciada, neste caso, , Curso IDE;

24

TotvsDevStudio

Todos os direitos reservados.

Para salvar, clique v em ProjetosSalvar; , Salve o Novo Projeto confirme; Logo a seguir, existe outro Quadro onde poderemos detalhar ainda mais o nosso Projeto daremos o , , nome de IDE clicando com o boto direito do mouse e selecionando a opo Renomear; , 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; ,

Selecione Visualiza, Mensagens; Clique com o boto esquerdo do mouse sobre o Titulo do Projeto e arraste-o para o rodap, at ele fixarse com as demais Pastas que l se encontram.

Anotaes

Todos os direitos reservados.

TotvsDevStudio

25

Exerccios
Como criar Novos Projetos e Adicionar Arquivos: 1. Ainda com o programa Exemplo1 em aberto, selecione as seguintes opes: Projetos > Novo 2. Ser apresentado uma Tela (Projeto) onde deveremos definir o Nome do Mesmo no quadro , Novo Grupo de Projetos o qual dever ser um nome sugestivo customizao que ser iniciada, , neste caso, Curso IDE; 3. Selecione as seguintes opes: Projetos > Salvar 4. Salve o Novo Projeto com o nome de IDE e confirme; , 5. Logo a seguir, existe outro Quadro onde poderemos detalhar ainda mais o nosso Projeto , , daremos o nome de IDE clicando com o boto direito do mouse e selecionando a opo , Renomear; 6. Agora, deveremos associar o nosso programa ao projeto, clicando com o boto direito do mouse sobre a pasta Fontes selecionando a opo Adicionar Arquivos; ,

26

TotvsDevStudio

Todos os direitos reservados.

7. Marque o programa Exemplo1.prw e confirme; 8. Clique na opo + da pasta Fontes e observe que ele acabou de ser inserido dentro da , mesma; 9. Selecione as seguintes opes Visualizar > Mensagens; 10. Clique com o boto esquerdo do mouse sobre o Titulo do Projeto e arraste-o para o rodap, at ele fixar-se com as demais Pastas que l se encontram.

Anotaes

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 TotvsAppServer;

Todos os direitos reservados.

TotvsDevStudio

27

Retorne para a Ferramenta de Desenvolvimento TotvsDevStudio clique com o boto direito do mouse , sobre qualquer umas das Pastas existentes no Projeto em Aberto; Selecione a opo Compilar Tudo disponvel na Barra de Ferramentas; , Ser solicitada a Senha do Administrador para que a Compilao tenha incio, no Campo ID do , Usurio informe Administrador e confirme; ,

Observe que ser informada na pasta Mensagens a Conexo entre o TotvsDevStudio e o TotvsAppServer .

Caso a Compilao no seja finalizada por motivos de erro no programa, o mesmo ser informado na Tela de Mensagens juntamente com o Nmero exato da linha onde encontra-se o erro. ,

28

TotvsDevStudio

Todos os direitos reservados.

Exerccios
Como utilizar a opo Compilar Tudo: 1. Carregue o Aplicativo do TotvsAppServer no Desktop; , 2. Retorne para a Ferramenta de Desenvolvimento TotvsDevStudio clique com o boto direito do , mouse sobre qualquer umas das Pastas existentes no Projeto em Aberto; 3. Selecione a opo Compilar Tudo disponvel na Barra de Ferramentas; , 4. Ser solicitada a Senha do Administrador para que a Compilao tenha incio, no Campo ID , do Usurio informe Administrador e confirme; ,

Anotaes

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 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.

Todos os direitos reservados.

TotvsDevStudio

29

Compilao em Batch
Utilizado para Compilar em vrios Ambientes simultaneamente existentes na Configurao do MP8IDE, todos os programas contidos em um determinado Gerenciador de Projetos, Projeto, Pasta ou simplesmente um Arquivo selecionado.

Gerao de Patchs
Esta opo utilizada para a gerao de Patchs atravs de programas que j tenham sido compilados atravs do TotvsDevStudio e que se encontrem dentro do RPO utilizado. Para utilizar a Gerao de Pacths, selecione Ferramentas Gerao de Patchs; , Ser apresentada uma Telacontendo do lado direito todos os Programas que se encontram Compilados , no RPO em uso; Na pasta Selecionar Arquivos no campo Configuraes Disponveis selecione o ambiente; , ,

Logo abaixo, procure o programa Exemplo1.prw e adicione-o com a Seta Azul ao box do lado direito. , No Campo Diretrio do(s) Patch(s) clique na opo ao lado direito e defina o diretrio APO\ como , , padro para a Criao dos Arquivos de Patchs;

30

TotvsDevStudio

Todos os direitos reservados.

Na sequncia confirme a Gerao da Patch clicando no boto OK; Verifique na Pasta de Mensagens que o Processo foi inicializado e finalizado com sucesso. ,

Todos os direitos reservados.

TotvsDevStudio

31

Exerccios
Como utilizar a Gerao de Pacths: 1. Selecione as seguintes opes: Ferramentas > Gerao de Patchs; 2. Na pasta Selecionar Arquivos no campo Configuraes Disponveis selecione o ambiente , , Environment; 3. Logo abaixo, procure o programa Exemplo1.prw e adicione-o com a Seta Vermelha ao box , do lado direito. 4. No Campo Diretrio do(s) Patch(s) clique na opo ao lado direito e defina o diretrio APO\ , , como padro para a Criao dos Arquivos de Patchs e confirme; 5. Na sequncia, confirme a Gerao da Patch;

Anotaes

Aplicaes de Patchs
A opo Gerao de Patchs 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 simplesmente Programas Customizados. Para utilizar Aplicaes de Patchs: Selecione as seguintes opes: Ferramentas > Aplicao de Patch; Ser apresentada uma Tela onde devemos informar no campo Configuraes o Ambiente , Logo abaixo do lado esquerdo, deveremos informar onde se encontra a Pacth ser aplicada; Selecione as seguintes opes: Raiz do Servidor > apo;

32

TotvsDevStudio

Todos os direitos reservados.

Do lado direito da tela, ser apresentado o Arquivo da Pacth que ser aplicado Posicione com o cursor sobre o Arquivo e confirme;

Verifique na Pasta de Mensagens que o Processo foi inicializado. ,

Todos os direitos reservados.

TotvsDevStudio

33

Exerccios
Como utilizar Aplicaes de Patchs: 1. Selecione as seguintes opes: Ferramentas > Aplicao de Patch; 2. Logo abaixo do lado esquerdo, deveremos informar onde se encontra a Pacth ser aplicada; 3. Selecione as seguintes opes: Raiz do Servidor > apo; 4. Posicione com o cursor sobre o Arquivo e confirme;

Anotaes

Inspetores 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;

34

TotvsDevStudio

Todos os direitos reservados.

Em seguida, ser apresentada uma Tela com todas as Funes que se encontram Compiladas 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 .

Exerccios
Como utilizar Inspetores de Objetos: 1. Selecione as seguintes opes: Visualizar > Inspetor de Objetos 2. Em seguida, ser apresentada uma Tela com todas as Funes que se encontram Compiladas , no RPO em uso.

Anotaes

Logs dos Repositrios

Utilizado para visualizar todo o Histrico sobre o RPO em uso, poderemos atravs desta opo visualizar as Datas das ltimas Patchs aplicadas, o Contedo das Patchs e a Data da Build utilizada. Para utilizar Logs dos Repositrios, selecione Visualizar Log do Repositrio ou clique no boto Log , dos Repositrios, , disponvel na "Barra de Ferramentas"; Note que ser iniciado o Carregamento do RPO;

Todos os direitos reservados.

TotvsDevStudio

35

Clique na opo + da Data que aparece do lado esquerdo da tela, em seguida posicione o cursor sobre o 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; , Depois, clique na opo Fechar .

Exerccios
Como utilizar Logs dos Repositrios: 1. Selecione as seguintes opes: Visualizar > Log do Repositrio 2. Clique na opo + da Data que aparece do lado esquerdo da tela, em seguida posicione o cursor sobre o Disquete que ser apresentado; , 3. 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; 4. Caso seja necessrio, poderemos Imprimir este Log clicando na Opo Imprimir Log que se , , encontra abaixo da tela; 5. Depois, clique na opo Fechar .

36

TotvsDevStudio

Todos os direitos reservados.

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

Anotaes

Execuo dos Programas

Neste captulo, aprenderemos a Debugar os Programas, Execut-los, Anim-los, Adicionar Break Points, Book Marks, entre outros. Ferramenta de Desenvolvimento TotvsDevStudio: Executar; Pausa da Execuo; Para Execuo (Derrubar Client); Percorrer Linha; Pular Linha; Executar at o Cursor; Ponto de Parada (Break Point); Book Marks
Todos os direitos reservados. TotvsDevStudio

37

 Animao; Para Animao; Desacelera Animao; Acelera Animao.

Executar
Esta opo dever ser utilizada, para que aps a Compilao dos Programas, seja possvel a sua execuo imediata com a finalidade de test-lo. Para utilizar a opo Executar, selecione Arquivo Novo; , Digite o Programa; Salve como Exemplo2.prwAdicione ao Projeto e Compile , .

38

TotvsDevStudio

Todos os direitos reservados.

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 TotvsDevStudio dever ser executado utilizando-se a letra U seguida do Underline antes do Nome da Funo isso se deve ao fato de estarmos , , executando uma User Function . Para esxecutar, selecione Executar Executar ou Executa , disponvel na "Barra de Ferramentas"; , Note que o Programa ser executado na tela; ,

Confirme as Mensagens do Programa at a sua finalizao. ,

Anotaes

Todos os direitos reservados.

TotvsDevStudio

39

Exerccios
Como utilizar a opo Executar: 1. Selecione as seguintes opes: Arquivo > Novo; 2. Informe o Programa a seguir: #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 3. Salve como Exemplo2.prwAdicione ao Projeto e Compile , . 4. Na Barra de Ferramentas ao lado direito da tela, informe o Nome da Funo Compilada neste , , caso u_Exemplo2; 5. Execute o Programa 6. Confirme as Mensagens do Programa at a sua finalizao. ,

Anotaes

40

TotvsDevStudio

Todos os direitos reservados.

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 uma tela de mensagem referente ao Cancelamento da Execuo

Exerccios
Como utilizar a opo Parar a Execuo: 1. Com o programa Exemplo2 aberto, adicione um Ponto de Parada na Linha 4 do Programa; 2. Na Barra de Ferramentas ao lado direito da tela, informe o Nome da Funo Compilada neste , , caso u_Exemplo2; 3. Assim que o programa for Executado e Parado selecione as opes , Executar > Para Execuo

Anotaes

Todos os direitos reservados.

TotvsDevStudio

41

Ponto de Parada (Break Point)

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 e selecione, Executar Liga/Desliga ponto de parada, ou clique no boto Ponto de Parada ; ,

Na Seqncia, execute o programa;

Anotaes

42

TotvsDevStudio

Todos os direitos reservados.

Verifique que quando a Execuo passar pela linha onde se encontra o Ponto de Parada o mesmo ser , congelado;

Clique sobre o Ponto de Parada removendo-o do programa; ,

4. Execute o programa novamente at a sua finalizao.

Todos os direitos reservados. TotvsDevStudio

43

Exerccios
Como utilizar a opo Ponto de Parada (Break Point): 1.Com o programa Exemplo2 aberto, posicione o cursor na Linha 4 do Programa e selecione as seguintes opes: Executar > Liga/Desliga ponto de parada 2. Na Seqncia, execute o programa; 3. Clique sobre o Ponto de Parada removendo-o do programa; , 4. Execute o programa novamente at a sua finalizao.

Anotaes

Book Marks
Esta opo tem por finalidade Marcar determinados Pontos do Programa, para facilitar a Localizao de Pontos Estratgicos do fonte, durante a sua manuteno. Para inserir os Book Marks: Para adicionar Book Marks basta pressionar as teclas <Ctrl> + <Shift> + <Nmero de 0 9>, em algum Ponto do Programa isso far com que sejam marcados alguns Pontos de posicionamento do cursor , dentro dos Fontes . Verifique que ser adicionado um Book Mark ao lado da linha;

44

TotvsDevStudio

Todos os direitos reservados.

Para remover os Book Marks do programa, basta pressionar a seguinte combinao de teclas <Ctrl> + <Shift> + <Nmero Digitado>.

Exerccios
Como inserir os Book Marks: 1. Com o programa Exemplo2 aberto, posicione com o cursor sobre a Linha 3 do Programa e utilize a seguinte combinao de teclas <Ctrl> + <Shift> + 1; 2. Posicione com o cursor sobre a Linha 6 do Programa e utilize a seguinte combinao de teclas <Ctrl> + <Shift> + 2; 3. Posicione com o cursor sobre a Linha 9 do Programa e utilize a seguinte combinao de teclas <Ctrl> + <Shift> + 3. Exerccio 2 Como Remover Book Marks: 1. Utilize a seguinte combinao de teclas <Ctrl> + <Shift> + 1; 2. Agora, utilize a seguinte combinao de teclas <Ctrl> + <Shift> + 2; 3. Por fim, utilize a seguinte combinao de teclas <Ctrl> + <Shift> + 3;
TotvsDevStudio

Todos os direitos reservados.

45

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 .

Exerccios
Como utilizar a opo Percorrer Linha: 1. Posicione com o cursor sobre a Linha 4 do Programa e clique nas seguintes opes: Executar > Liga/Desliga Ponto de Parada 2. Assim que a execuo congelar no Ponto de Parada selecione as seguintes opes: , Executar > Executar 3. Clique nas seguintes opes: Executar > Percorrer Linha

Anotaes

46

TotvsDevStudio

Todos os direitos reservados.

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 .

Exerccios

Como utilizar a opo Pular Linha: 1. Posicione com o cursor sobre a Linha 3 do Programa e clique nas seguintes opes: Executar > Liga/Desliga Ponto de Parada 2. Selecione as seguintes opes: Executar > Executar 3. Selecione as seguintes opes: Executar > Pular Linha 4. Aps o Teste pare a Execuo derrubando o Client; , ,

Anotaes

Todos os direitos reservados.

TotvsDevStudio

47

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; , , Clique nas seguintes opes: Executar Executar Clique nas seguintes opes: Executar Executar At o Cursor Ou clique no boto Executar At o Cursor disponvel na Barra de Ferramentas simultaneamente at o , , Fim do Debug .

Exerccios
Como utilizar a opo Executar at o Cursor: 1. Posicione com o cursor sobre a Linha 3 do Programa e clique nas seguintes opes: Executar > Liga/Desliga Ponto de Parada 2. Selecione as seguintes opes: Executar > Executar 3. Posicione com o cursor sobre a Linha 6 do Programa; 4. Selecione as seguintes opes: Executar > Executar at o Cursor 4. Aps o Teste pare a Execuo derrubando o Client; , ,

48

TotvsDevStudio

Todos os direitos reservados.

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.

Exerccios
Como utilizar a opo Animao: 1. Posicione com o cursor sobre a Linha 3 do Programa e clique nas seguintes opes: Executar > Liga/Desliga Ponto de Parada 2. Selecione as seguintes opes: Executar > Executar 3. Assim que a Execuo for congelada no Ponto de Parada remova-o; , 4. Com o programa parado no Ponto de Parada selecione as seguintes opes: , Executar > Animao 5. Execute-o at o final.

Anotaes

Todos os direitos reservados.

TotvsDevStudio

49

Para Animao
Dever ser utilizado quando quisermos que o Programa em Animao seja Pausado.

Exerccios
Como utilizar a opo Para Animao: 1. Posicione com o cursor sobre a Terceira Linha do Programa e clique nas seguintes opes: Executar > Liga/Desliga Ponto de Parada 2. Selecione as seguintes opes: Executar > Executar 3. Assim que a Execuo for congelada no Ponto de Parada remova-o; , 4. Com o programa parado no Ponto de Parada selecione as seguintes opes: , Executar > Animao 5. Na seqncia, selecione as seguintes opes: Executar > Para Animao 6. Selecionando novamente a opo Animao o programa retornar ao Modo de , Animao; 7. Execute-o at o final.

Anotaes

50

TotvsDevStudio

Todos os direitos reservados.

Acelera Animao
Utilizado para Aumentar a Velocidade da Animao do programa durante o Debug.

Exerccios
Como utilizar a opo Acelera Animao: 1. Posicione com o cursor sobre a Terceira Linha do Programa e clique nas seguintes opes: Executar > Liga/Desliga Ponto de Parada 2. Selecione as seguintes opes: Executar > Executar 3. Com o programa parado no Ponto de Parada selecione as seguintes opes: , Executar > Animao 4. Na seqncia, selecione as seguintes opes: Executar > Acelera Animao 5. Aps o Teste pare o programa em Execuo disponvel na Barra de Ferramentas , , .

Anotaes

Todos os direitos reservados.

TotvsDevStudio

51

Desacelera Animao
Utilizado para Diminuir a Velocidade da Animao do programa durante o Debug.

Exerccios
Como utilizar a opo Desacelera Animao: 1. Posicione com o cursor sobre a Terceira Linha do Programa e clique nas seguintes opes: Executar > Liga/Desliga Ponto de Parada 2. Selecione as seguintes opes: Executar > Executar 3. Com o programa parado no Ponto de Parada selecione as seguintes opes: , Executar > Animao 4. Na seqncia, selecione as seguintes opes: Executar > Desacelera Animao 5. Aps o Teste pare o programa em Execuo disponvel na Barra de Ferramentas , , .

52

TotvsDevStudio

Todos os direitos reservados.

Ferramentas
Neste captulo, aprenderemos como utilizar os recursos do Assistente de Cdigo, Converso de Fontes, Gerenciador de Dados, Verificar a Integridade do RPO, Patchs e Configurar atalhos para outros aplicativos. Ferramenta de Desenvolvimento TotvsDevStudio: Assistentes de Cdigos; Assistentes de Converses; Gerenciadores de Dados; Checar Integridades; Configurar Ferramentas.

Assistentes de Cdigos
Utilizado para ajudar o programador 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

Anotaes

Todos os direitos reservados.

TotvsDevStudio

53

Clique na opo Avanar em seguida informe o Alias do Arquivo (nome da tabela)e clique na opo Avanar;

Na prxima tela, informe a chave para Parmetros de Relatrio e clique na opo Avanar;

No campo Ttulo e clique na opo Finalizar; ,

54

TotvsDevStudio

Todos os direitos reservados.

Verifique que o Fonte do Programa foi criado automaticamente com seus devidos Comentrios , .

Exerccios
Como utilizar Assistentes de Cdigos para Relatrios: 1. Selecione as seguintes opes: Ferramentas > Assistente de Cdigo > Relatrio 2. Clique na opo Avanar em seguida informe o Alias do Arquivo a ser utilizado como SB1 e clique na opo Avanar; 3. Na prxima tela, informe a chave como RSZ1 e clique na opo Avanar; 4. No campo Ttulo informe Relatrio de Produtos e clique na opo Finalizar; , , 5. Confira os dados e cancele a Operao .

Todos os direitos reservados.

TotvsDevStudio

55

Exerccio 2 Como utilizar Assistentes de Cdigos para Cadastros: 1. Selecione as seguintes opes: Ferramentas > Assistente de Cdigo > Cadastro; 2. Clique na opo Avanar em seguida informe o Alias do Arquivo a ser utilizado como SB1 e clique nas seguintes opes Avanar e Avanar; 3. Na prxima tela, deixe marcada a opo AxCadastro e clique na opo Finalizar; 4. Confira os dados e cancele a Operao . Exerccio 3 Como utilizar Assistentes de Cdigos para Gerao de Arquivos Textos: 1. Selecione as seguintes opes: Ferramentas >Assistente de Cdigo > Gerao de Arquivo Texto; 2. Clique na opo Avanar em seguida informe o Alias do Arquivo a ser utilizado como SB1 e clique na opo Avanar at o fim da Gerao do Fonte; 3. Confira os dados e cancele a Operao . Exerccio 4 Como utilizar Assistentes de Cdigos para Importao de Arquivos Textos: 1. Selecione as seguintes opes: Ferramentas > Assistente de Cdigo > Importao de Arquivo Texto; 2. Clique na opo Avanar em seguida informe o Alias do Arquivo a ser utilizado como SB1 e clique na opo Avanar at o fim da Gerao do Fonte; Observao: Verifique que o Fonte do Programa foi criado automaticamente com seus devidos Comentrios , . 3. Confira os dados e cancele a Operao .

56

TotvsDevStudio

Todos os direitos reservados.

Exerccio 5 Como utilizar Assistentes de Cdigos para Processamentos Genricos: 1. Selecione as seguintes opes: Ferramentas > Assistente de Cdigo > Processamento Genrico; 2. Clique na opo Avanar em seguida informe o Alias do Arquivo a ser utilizado como SB1 e clique na opo Avanar at o fim da Gerao do Fonte; Observao: Verifique que o Fonte do Programa foi criado automaticamente com seus devidos , Comentrios . 3. Confira os dados e cancele a Operao .

Anotaes

Assistentes de Converses
Utilizado para converter os Fontes dos Programas criados nas verses anteriores do sistema, como por exemplo a verso Siga Advanced que possui a diferenas em alguns pontos do programa. Para utilizar Assistentes de Converses, selecione: Ferramentas >Assistente de Converso; Ser apresentada uma tela onde deveremos informar onde se encontra o programa a ser convertido;

Todos os direitos reservados.

TotvsDevStudio

57

Clique na Seta ao Lado Direito da Tela informe o Driver onde se encontra instalado o Protheus 10 com , o Path e Arquivo de arquivo que deve ser convertido: Clique em Abrir e Avanar;

Assim que a Converso do Fonte for finalizada, clique na opo Avanar;

Informe o Diretrio onde o Programa Convertido ser salvo, utilize o Driver onde se encontra instalado o Protheus10 e use o seguinte Path Protheus10\Rdmake , Clique na opo Avanar;

58

TotvsDevStudio

Todos os direitos reservados.

Desmarque a opo Criar um Novo Projeto e clique na opo Finalizar;

Pronto, o Fonte do Programa foi convertido.

Todos os Fontes convertidos pelo Assistente de Converso recebero um Complemento em seu nome como _MP8 , , antes da Extenso do Arquivo .
Dica

Anotaes

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; Ser apresentada uma Tela onde deveremos informar qual a Empresa a ser analisada. , Selecione a Empresa que aparece em destaque e clique na opo Ok; ,

Todos os direitos reservados.

TotvsDevStudio

59

Verifique que todos os Arquivos necessrios, sero carregados neste momento; Ser apresentada uma tela contendo todos os Arquivos existentes na Base de Dados da empresa selecionada;

Clique nas seguintes opes + + Arquivos localizada ao lado esquerdo da tela; , Posicione com o cursor sobre o Arquivo desejado e clique na opo +; Ser informado ao Lado Direito da Tela os dados completos referentes ao arquivo selecionado; ,

Anotaes

60

TotvsDevStudio

Todos os direitos reservados.

Os Campos tambm podero ter a sua Estrutura analisada, basta posicionar com o cursor sobre os mesmos, para obtermos informaes sobre suas estruturas, que iro aparecer ao Lado Direito da Tela .

Exerccios
Como utilizar Gerenciadores de Dados: 1. Selecione as seguintes opes: Ferramentas > Gerenciador de Dados; 2. Selecione a Empresa que aparece em destaque e clique na opo Ok; , 3. Ser apresentada uma tela contendo todos os Arquivos existentes na Base de Dados da empresa selecionada; 4. Clique nas seguintes opes + + Arquivos localizada ao lado esquerdo da tela; , 5. Posicione com o cursor sobre o Arquivo AA1 e clique na opo +; 6. Ser informado ao Lado Direito da Tela os dados completos referentes ao arquivo selecionado; , 7. Os Campos tambm podero ter a sua Estrutura analisada, basta posicionar com o cursor sobre os mesmos, para obtermos informaes sobre suas estruturas, que iro aparecer ao Lado Direito da Tela .

Todos os direitos reservados.

TotvsDevStudio

61

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;

62

TotvsDevStudio

Todos os direitos reservados.

Sero apresentados os Arquivos e seus Relacionamentos atravs de Linhas Relacionais; , Com um duplo clique sobre as Pastas dos Arquivos poderemos verificar tambm quais os Campos que , se relacionam e seus Nomes;

Aps a verificao, encerre o Gerenciador de Dados .

Exerccios

Como utilizar Modelos Entidade-Relacionamentos: 1. Selecione a opo Modelo Entidade-Relacionamento que se encontra ao Lado Esquerdo , da Tela; 2. Clique na opo Selecionar Arquivos localizado na Barra de Ferramentas logo acima; , , 3. Marque os seguintes Arquivos SB1, SC4 e SI1 e confirme; 4. Sero apresentados os Arquivos e seus Relacionamentos atravs de Linhas Relacionais; , 5. Com um duplo clique sobre as Pastas dos Arquivos poderemos verificar tambm quais os , Campos que se relacionam e seus Nomes; 6. Aps a verificao, encerre o Gerenciador de Dados .

Todos os direitos reservados.

TotvsDevStudio

63

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 + Repositrio ou Arquivo de Patch . Caso seja selecionada a opo (Repositrio), o TotvsDevStudio ir informar o Status do mesmo na pasta (Mensagens), localizada no rodap e se for selecionada a opo (Arquivo de Patch), deveremos informar antes o Diretrio onde localiza-se o Arquivo de Patch, para que na sequncia tambm seja demonstrado o Status do Arquivo na pasta (Mensagens).

Utilize esta opo sempre que for Atualizado um RPO ou antes de aplicar um Arquivo de Patch ao mesmo.
Dica

Anotaes

64

TotvsDevStudio

Todos os direitos reservados.

Desfragmentar Repositrio
Essa opo somente ser vlida se o TotvsDevStudio estiver configurado como (Por Velocidade da Compilao), pois dessa maneira o RPO ficar fragmentado, devido ao fato das funes serem alocadas no repositrio por Ordem de Compilao. Para tanto basta selecionar as seguintes opes Ferramentas + Desfragmentar Repositrio .

Anotaes

Todos os direitos reservados.

TotvsDevStudio

65

Configurao de Ferramentas
Quando quisermos Criar um Atalho, para algum Executvel dentro do MP8IDE deveremos utilizar esta opo. Ela simplesmente cria uma Nova Opo no menu de Ferramentas, logo abaixo da opo (Configurar Ferramentas). Para Configurao de Ferramentas: Selecione as seguintes opes: Ferramentas > Configurar Ferramentas

Clique na opo Adicionar; Ser apresentada uma Tela para a Configurao do Atalho para o Novo Executvel , . No campo Ttulo: informe o nome: , No campo Programa: clique na opo ao lado direito e informe o caminho a seguir no Driver onde se , , encontra o programa que ser executado

66

TotvsDevStudio

Todos os direitos reservados.

Confira os dados e confirme a Operao; Observe que ser adicionado logo abaixo da opo Configurar Ferramentas no menu Ferramentas um , Novo Atalho para o programa; , Basta acessar a Nova Opo para que a mesma seja executada. , Esta opo poder ser utilizada tanto para Programas do Protheus quanto para programas externos, , como por exemplo: Word, Excel, etc... .

Exerccios

Como utilizar Configurao de Ferramentas: 1. Selecione as seguintes opes: Ferramentas > Configurar Ferramentas E clique na opo Adicionar; 2. No campo Ttulo: informe APDiff; , 3. No campo Programa: clique na opo ao lado direito e informe o caminho a seguir no Driver , , onde se encontra o Protheus10 instalado: Protheus10\SmartClient\APDiff.exe . 4. No campo Iniciar em: informe: , <Driver> Protheus10\SmartClient\ . 5. Confira os dados e confirme a Operao; 6. Basta acessar a Nova Opo para que a mesma seja executada. ,

Anotaes

Todos os direitos reservados.

TotvsDevStudio

67

Anlises de Variveis, Tabelas e Campos

Neste captulo, aprenderemos como utilizar o Watchs, 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; Watchs; Break Points; Pilhas de Chamadas; Variveis Locais; Variveis Privadas; Variveis Pblicas; Variveis Estticas; Tabelas e Campos.

Comandos
Utilizado para que seja possvel analisarmos e alterarmos os Valores das Variveis durante o Debug dos Programas e poderemos tambm alterar o valor das mesmas durante a anlise. 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.

68

TotvsDevStudio

Todos os direitos reservados.

Exerccios
Como utilizar a pasta Comandos: 1. Utilizando o programa Exemplo2 posicione com o cursor sobre a Linha 4 e selecione as , seguintes opes: Executar > Liga/Desliga Ponto de Parada 2. Selecione as seguintes opes: Executar > Executar 3. Clique na pasta Comandos que se encontra no rodap ao lado esquerdo; , 4. Na rea de Comandos informe nI e observe que ser retornado o Valor da Varivel; , 5. Clique com o Boto Esquerdo do Mouse sobre a mesma Varivel marque-a, arraste-a clicando , com o Boto Direito do Mouse para a rea de Comandos e verifique que o Resultado o , mesmo; 6. Clique com o Boto Esquerdo do Mouse sobre a Varivel nI==3 marque-a, arraste-a clicando , com o Boto Direito do Mouse para a rea de Comandos e verifique que o resultado .F. ou seja, , , Falso pois o seu Valor ainda no este; , 7. Na rea de Comandos troque o Valor da Varivel para nI==1 e verifique que o retorno ser , , .T. ou seja, Verdadeiro pois esse o Valor da mesma neste momento; , ,

Anotaes

Todos os direitos reservados.

TotvsDevStudio

69

Watchs
Segue a mesma idia de Comandos, porm esta opo, apenas informa os Valores das Variveis durante o Debug. A grande diferena que atravs desta opo poderemos analisar os Valores das Variveis em Tempo de Execuo, ou seja, sempre que o valor de uma determinada varivel for alterado durante a Execuo do Debug, o mesmo ser demonstrado na janela de Watchs.

Exerccios
Como utilizar a opo Watchs: 1. Posicione o cursor sobre a Linha 4 do Programa e selecione as seguintes opes: Executar > Liga/Desliga Ponto de Parada 2. Selecione as seguintes opes: Executar > Executar 3. Selecione as seguintes opes: Visualizar > Janelas de Debug > Watchs

70

TotvsDevStudio

Todos os direitos reservados.

4. Clique com o "Boto Esquerdo do Mouse" sobre a Varivel nI marque-a e arraste-a clicando , com o Boto Direito do Mouse para a Janela de Watchs; , 5. Clique com o Boto Esquerdo do Mouse sobre a Varivel nI==3 marque-a, arraste-a clicando , com o Boto Direito do Mouse para a Janela de Watchs e verifique que o resultado .F. ou seja, , , Falso pois o seu Valor ainda no este; , 6. Na Janela de Watchs, clique com o "Boto Direito do Mouse" sobre a mesma, selecione a opo Editar troque o Valor da Varivel para nI==1 e verifique que o Retorno ser .T. ou seja, , , , Verdadeiro pois esse o Valor da mesma neste momento; , 7. Para entendermos o significado de cada um dos Desenhos demonstrados durante a exibio das Variveis na janela, basta clicar com o "Boto Direito do Mouse" sobre as mesmas e selecionar a opo Legenda; 8. Na seqncia, desmarque o Ponto de Paradaque se encontra no programa, selecione as seguintes , opes: Executar > Animao 9. Aps o Teste pare o programa em Execuo , .

Anotaes

Todos os direitos reservados.

TotvsDevStudio

71

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.

Exerccios
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; ,

72

TotvsDevStudio

Todos os direitos reservados.

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, atravs 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

Anotaes

Todos os direitos reservados.

TotvsDevStudio

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. Ser apresentada uma tela informando a Linha do Programa em que o Debug est sendo executado naquele momento, o Nome da Funo utilizada, Parmetros da Funo (caso exista algum) e o Nome do Programa .

Exerccios
Como utilizar a opo Pilha de Chamadas: 1. Utlizando 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: Executar > Executar 4. Assim que a Execuo do Programa for congelada no Ponto de Parada localizado na Linha 4 selecione as seguintes opes: , Visualizar > Janelas de Debug > Pilha de Chamadas 5. Aps a Visualizao encerre o a Execuo do Programa atravs das seguintes opes: , Executar > Para Execuo

74

TotvsDevStudio

Todos os direitos reservados.

Variveis
Esta opo dever ser utilizada para demonstrar todas as Variveis do Tipo Local, Privada, Pblica e Esttica que se encontram no programa que estiver sendo debugado.

Anotaes

Todos os direitos reservados.

TotvsDevStudio

75

Exerccios
Como utilizar Variveis Locais: 1. Adicione o programa Rddemo.prw ao Projeto em uso e compile-o; 2. Digite u_Rddemo no campo destinado Execuo dos Programas; 3. Posicione o cursor na Linha 13 do Programa e selecione as seguintes opes: Executar > Liga/Desliga Ponto de Parada 4. Selecione as seguintes opes: Executar > Executar 5. Na seqncia, selecione as seguintes opes: Visualizar > Janelas de Debug > Variveis Locais > Variveis Privadas > Variveis , , Pblicas e Variveis Estticas 6. Selecione as seguintes opes: Executar > Animao 7. Execute o programa at o final do Debug .

Anotaes

76

TotvsDevStudio

Todos os direitos reservados.

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.

Exerccios
Como utilizar Tabelas e Campos: 1. Atravs de qualquer Editor de Texto insira o programa Rddemo no menu do Mdulo de , Faturamento atravs do arquivo Sigafat.mnu; , 2. Na Ferramenta de Desenvolvimento IDE posicione com o cursor sobre a Linha 13 do Programa , e selecione as seguintes opes: Executar > Liga/Desliga Ponto de Parada 3. Digite Sigafat no campo destinado Execuo de Programas; 4. Selecione as seguintes opes: Executar > Executar 5. Selecione as seguintes opes: Visualizar > Janelas de Debug > Tabelas e Campos 6. No Mdulo de Faturamento selecione a opo Rddemo que foi inserida no menu; , 7. Automaticamente o sistema ir voltar para a Ferramenta de Desenvolvimento IDE onde ser , exibida uma Tela com todos os Arquivos e Campos que o Programa em Debug est abrindo; 8. Clicando na opo + de cada um dos Arquivos sero exibidos os seus Campos ao Lado , Esquerdo e as Chaves de ndices ao Lado Direito juntamente com o Contedo de cada , campo;

Todos os direitos reservados.

TotvsDevStudio

77

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 (Botes) e Dilogos. Ferramenta de Desenvolvimento TotvsDevStudio: Desenho de Interface; Sempre que criarmos um programa pelo Desenhador de Telas nunca deveremos esquecer de salvar os , dois Fontes gerados, ou seja, o Prw e o Prv . O segundo Fonte trata o Desenho da Tela sendo assim, sempre que se fizer necessrio a Manuteno , , dos Objetos basta abrir o Arquivo de Tela e nele alterar ou inserir Novos Objetos e em seguida, gerar , outro Programa que dever substituir o anterior que foi compilado. ,

78

TotvsDevStudio

Todos os direitos reservados.

Exerccios
Como utilizar Desenhadores de Telas: 1. Selecione as seguintes opes: Arquivo > Novo Dilogo 2. Na barra de Botes Bsicos clique duas vezes sobre o boto Ok disponvel na "Barra de , , Ferramentas"; 3. Alinhe os Dois Botes lateralmente na Tela de Dilogo e posicione com o cursor sobre o Boto denominado oSBtn2; 4. No Editor de Propriedades na pasta Propriedades clique no Campo nType informe 2 , , , , pressione a tecla <Enter> e observe que o Desenho do Boto ser alterado para ;

5. Ainda posicionado com o cursor sobre o boto oSBtn2 clique na pasta Eventos do Editor de , Propriedades no Campo bAction informe oDlg:End() e pressione a tecla <Enter>; , 6. Posicione com o cursor sobre o Boto denominado oSBtn1 no Editor de Propriedades; , 7. Na pasta Propriedades clique no Campo nType informe 1 pressione a tecla <Enter> e , , , observe que o Desenho do Boto ser alterado para ; , 8. Clique na pasta Eventos do Editor de Propriedades no Campo bAction informe Mata010() , , e pressione a tecla <Enter>; 9. Ainda no Editor de Propriedades na pasta Propriedades selecione o campo ICentered mude , , , para .T. e pressione a tecla <Enter>, para Centralizar a Tela de Dilogo no momento de sua , Execuo; 10. Posicione com o cursor sobre a Janela de Dilogo clique com o "Boto Direito do Mouse" e , selecione a opo Gerar Cdigo; 11. Ser gerado automaticamente o Cdigo-Fonte da nossa Janela de Dilogo; 12. Selecione as seguintes opes: Arquivo > Salvar

Todos os direitos reservados.

TotvsDevStudio

79

E salve o programa na pasta Rdmake localizada do Diretrio Raiz do MP8 com o nome sugerido , , de IoDlg.prw; 13. Salve tambm o Fonte do Desenho do Dilogo com o nome de IoDlg.prv; , 14. Adicione o Programa IoDlg.prw ao Projeto em Uso e compile-o; 15. Insira este programa no arquivo Sigafat.mnu localizado na pasta \Sigaadv\ localizada no , , Diretrio Raiz do MP8 e realize um teste, acessando o Mdulo de Faturamento .

Nmero de Registro: P10210807

80

TotvsDevStudio

Todos os direitos reservados.