P8 R4 Estoque/Custos

Sumrio

2Sumrio

4Viso Geral do Curso

5Objetivos do Curso

6O que o DevStudio?

7Configurao

7Preferncias

10Configuraes

13Criao e Edio de Programas

14Novo Arquivo

15Caracter ASCII

16Documentao de Explicao

18Documentao de Cdigos

19Documentao de Cabealhos

20Localizar

20Repetir Procura Abaixo

20Repetir Procura Acima

21Substituir

21Indentar

22Minsculo

22Maisculo

23Duplicar Linha

23Ir para a Linha

24Ir para a Linha em Execuo

24Projetos, Compilao, Gerao e Aplicao de Patch e Anlise do RPO

24Projetos

27Compilar Tudo

28Compilao de Projetos

29Compilao de Pastas

29Compilao de Arquivos

29Compilao em Batch

29Gerao de Patches

31Aplicaes de Patches

32Inspetor de Objetos

33Log do Repositrio

34Gerente de Projetos

35Execuo dos Programas

36Executar

38Pausa da Execuo

38Parar a Execuo

38Ponto de Parada (BreakPoint)

40BookMarks

40Percorrer Linha

41Pular linha

41Executar at o cursor

42Animao

42Para animao

42Acelera animao

42Desacelera animao

43Ferramentas

43Assistentes de cdigos

45Assistentes de converses

47Gerenciador de dados

50Verificao de integridades

50Desfragmentar repositrio

50Configurao de ferramentas

51Anlises de variveis, tabelas e campos

52Comandos

52Watches

53Break points

54Pilha de chamadas (call stacks)

55Variveis

56Tabelas e campos

57Desenho de interface

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.

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.

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.

Configurao

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

Preferncias;

Configuraes.

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;

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;

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;

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

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 o DevStudio, selecione Arquivo, Configuraes;

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

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

Exerccio1. Configure um ambiente de compilao baseado nas definies do AppServer.ini.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.

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;

Procure sempre salvar seus programas na pasta My Projects, localizada no diretrio raiz, essa pasta exclusiva para este propsito.Exerccio1. Crie um novo arquivo para o fonte abaixo:#Include Totvs.ChUser 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.

Caracter ASCIITem 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.Exerccio1. Inicie um novo fonte, inclua os caracteres ASCII 65, 167 e 166;2. Feche o fonte, sem salv-lo.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.

Confira os dados e confirme;

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

Exerccio1. Insira 3 documentaes de explicao num novo fonte.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.

Exerccio1. Visualize as documentaes includas anteriormente.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;

Exerccio1. Num novo fonte, inclua uma documentao de cabealho;2. Observe a alterao de fontes entre MsLineDraw e Courier New.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 Editar, Localizar.

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

Indentar

Quando quisermos que o fonte digitado seja Indentado (tabulado na estrutura de comandos) deveremos utilizadar esta opo.

Para Indentar, selecione Editar, Texto, Indentar;

Exerccio1.Digite o fonte abaixo:#Include Totvs.ChUser Function Exemplo2

Local nIFor nI:=1 to 10

If nI==3

MsgAlert("Estou no 3")

Elseif nI==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.

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.

Exerccio1. 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.Exerccio1. Selecione parte do texto do fonte aberto e transforme em maisculo.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.Exerccio1. 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.

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

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

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

Compilar TudoUtilizado 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;

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

Exerccio1. Gere um patch a partir do fonte Exemplo1.prw na pasta \Updates.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)

Verifique na guia Mensagens que o processo foi inicializado.

Exerccio1. Aplique o patch gerado anteriormente.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.

Exerccio1. Utilize o inspetor de objetos para verificar a ltima compilao do fonte Exemplo1.prw.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;

Exerccio1. Verifique quantos patches foram aplicados no RPO atual.Gerente de ProjetosEsta 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.

Execuo dos ProgramasNeste 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.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.

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

Confirme as mensagens do programa at a sua finalizao.Exerccio1. 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

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.

Exerccio1. No programa anterior, pare a execuo ao exibir a primeira mensagem. 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;

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.Exerccio1. No fonte exemplo2.prw, adicione um ponto de parada na linha 5, execute-o observando a parada, remova o ponto e conclua a execuo.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 + + , 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 + + .

Exerccio1.Inclua um bookmark na linha 7 do fonte Exemplo2.prw.

2.Remova o bookmark includoPercorrer 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.Exerccio1. Faa a depurao do fonte Exemplo2.prw.Pular linhaDever 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, executarClique 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.Exerccio1. No fonte Exemplo2.prw, pule a linha que executaria a segunda mensagem.Executar at o cursorDever 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 Exerccio1. Simule no fonte Exemplo2.prw o recurso de executar at o cursor.

AnimaoDever ser utilizado quando quisermos que o cursor acompanhe a execuo do programa, dando assim, um efeito de animao, durante o debug do mesmo. Para animaoDever ser utilizado quando quisermos que o programa em animao seja pausado.Acelera animaoUtilizado para aumentar a velocidade da animao do programa durante o debug.Desacelera animaoUtilizado para diminuir a velocidade da animao do programa durante o debug.Exerccio1. Salve o fonte abaixo como Exemplo3.prw:#Include Totvs.ChUser Function Exemplo3

Local nIFor nI:=1 to 100

Conout(i)

Next

Return

2. Compile-o, coloque breakpont na linha 3, na declarao Local i;

3. Execute a animao, parando, acelerando e desacelerando.

FerramentasNeste 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.Assistentes de cdigosUtilizado 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;

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

No campo ttulo, e clique na opo finalizar;

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

Exerccio1. 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).Assistentes de conversestc "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;

O processo de converso ser iniciado;

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

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.

Gerenciador de dadosEsta 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 dadosSelecione a empresa desejada e confirme;

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

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;

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

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

Verificao de integridadesUtilizado 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.

Desfragmentar repositrioEsta 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 ferramentasQuando 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, Configurar ferramentas

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

Exerccio1. Faa um atalho para a calculadora (calc.exe) e mapa de caracteres (charmap.exe)Anlises de variveis, tabelas e camposNeste 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.ComandosUtilizado 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 ;Observe que o valor da varivel ser retornado.

Exerccio1. No fonte Exemplo1.prw, coloque um breakpoint na linha 5. Verifique o valor da varivel nI e altere-a vontade.WatchesAtravs dessa opo poderemos verificar o valor de variveis, no permitindo alter-las, e tambm incluir expresses ADVPL sem ter que necessriamente declarar uma varivel.

Exerccio1. 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 pointsEsta 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.ExerccioComo 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 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..

Exerccio1. Copie e compile o fonte abaixo:#Include Totvs.ChUser Function programa1MsgInfo(Vou executar o Programa 2, Exemplo de Programa.)

programa2()

return

static function programa2MsgInfo(Vou executar o Programa 3, Exemplo de Programa.)

programa3()

return

static function programa3

msgalert("oi", Teste de Programa)

return

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

Exerccio1. Crie um fonte com o cdigo abaixo:

#Include "Totvs.ChUser 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.Tabelas e camposNesta 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.

Exerccio1. Copie o fonte abaixo:

#Include Totvs.ChUser 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.Desenho de interfaceNeste 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.

Exerccio1. Crie uma caixa de dilogo, inclua uma textbox, um label e um button, gere o cdigo, salve o fonte como exemploX.prw, adicione-o ao projeto e compile e execute-o.Totvs DevStudio

2 DevStudio

DevStudio - 3