You are on page 1of 78

DevStudio

2 DevStudio


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






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




4 DevStudio


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.






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


6 DevStudio


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.






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


8 DevStudio


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;






DevStudio - 9


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;





10 DevStudio


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



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



Exerccio

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






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


12 DevStudio



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,






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



Exerccio

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



14 DevStudio


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.






DevStudio - 15
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;


16 DevStudio


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



Exerccio

1. Crie um novo arquivo para o fonte abaixo:
#Include totvs.ch
User Function Exemplo1
Local nI
For nI:=1 to 10
Conout(Exemplo de Programa.)
Next
Return
2. Salve o programa fonte como Exemplo1.prw.


Para uma melhor visualizao do texto informado
durante a elaborao de um programa, utilize a
fonte Ms Line Draw, atravs das seguintes
opes Arquivo + Escolha de Fonte,
selecionando a fonte citada.







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



Para inserir d um duplo clique no caracter desejado.

Exerccio

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


18 DevStudio


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.








DevStudio - 19
Confira os dados e confirme;



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

Exerccio

1. Insira 3 documentaes de explicao num novo fonte.



20 DevStudio


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


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

Exerccio

1. Visualize as documentaes includas anteriormente.






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




Exerccio

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


22 DevStudio


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.










DevStudio - 23
Repetir Procura Abaixo
Dever ser utilizada quando houver a necessidade de se encontrar
uma determinada palavra dentro do texto digitado, lembrando que
essa pesquisa ser feita partir da linha onde localiza-se o Cursor
para Baixo.
Repetir Procura Acima
Dever ser utilizada quando houver a necessidade de se encontrar
uma determinada palavra dentro do texto digitado, lembrando que
essa pesquisa ser feita a partir da linha em que localiza-se o Cursor
para Cima.
Para utilizar este recurso, selecione Editar, Repetir Procura
Abaixo ou pressione F3.

Substituir
Quando houver a necessidade por uma substituio de palavras no
programa, poderemos optar por utilizar a opo substituir.
Aqui encontraremos, ao mesmo tempo, a opo Localizar e
Substituir simultaneamente, sendo que os critrios para isto tambm
sero bem detalhados, assim como na opo Localizar.
Para utilizar este recurso, selecione Editar, Substituir.




24 DevStudio


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

Exerccio

1.Digite o fonte abaixo:
#include "totvs.ch"
User Function Exemplo2
Local i
For i:=1 to 10
If i==3
MsgAlert("Estou no 3")
Elseif i==5
MsgAlert("Estou no 5")
EndIf
Next
Return
2. Execute a indentao automtica.


Se a opo Indentar for utilizada em um fonte
com estrutura de comandos incompleta, ser
exibido erro de estrutura








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

Exerccio

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


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


Exerccio

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


26 DevStudio


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

Exerccio

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

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



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







DevStudio - 27
Exerccio

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

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


28 DevStudio


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.






DevStudio - 29
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;


30 DevStudio


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;








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



32 DevStudio



Exerccio

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








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



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




34 DevStudio


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



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

Exerccio

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






DevStudio - 35
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


36 DevStudio


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;







DevStudio - 37


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


Exerccio

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


38 DevStudio


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)








DevStudio - 39
Verifique na guia Mensagens que o processo foi inicializado.


Exerccio

1. Aplique o patch gerado anteriormente.


40 DevStudio


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

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

Exerccio

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






DevStudio - 41
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;


42 DevStudio




Exerccio

1. Verifique quantos patches foram aplicados no RPO atual.






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




44 DevStudio


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






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


46 DevStudio


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



Confirme as mensagens do programa at a sua finalizao.






DevStudio - 47

Exerccio

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





48 DevStudio


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

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



Exerccio

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






DevStudio - 49
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;


50 DevStudio


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

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

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






DevStudio - 51
BookMarks
Esta opo tem por finalidade marcar determinados pontos do
programa, para facilitar a localizao de pontos estratgicos do
fonte, durante a sua manuteno.

Para adicionar bookmarks basta pressionar as teclas <ctrl> +
<shift> + <nmero de 0 9>, em algum ponto do programa, isso
far a linha onde on cursos est posicionada seja marcada com um
bookmark.



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


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



52 DevStudio


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

Exerccio

1. Faa a depurao do fonte Exemplo2.prw.






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

Exerccio

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


54 DevStudio


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


Exerccio

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






DevStudio - 55
Animao
Dever ser utilizado quando quisermos que o cursor acompanhe a
execuo do programa, dando assim, um efeito de animao,
durante o debug do mesmo.

Para animao
Dever ser utilizado quando quisermos que o programa em
animao seja pausado.

Acelera animao
Utilizado para aumentar a velocidade da animao do programa
durante o debug.

Desacelera animao
Utilizado para diminuir a velocidade da animao do programa
durante o debug.

Exerccio

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


56 DevStudio


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






DevStudio - 57
Ferramentas
Neste captulo, aprenderemos como utilizar os recursos do
assistente de cdigo, converso de fontes, gerenciador de dados,
verificar a integridade do rpo, patches e configurar atalhos para
outros aplicativos.

Ferramenta de desenvolvimento devstudio:
Assistentes de cdigos;
Assistentes de converses;
Gerenciadores de dados;
Checar integridades;
Configurar ferramentas.


58 DevStudio


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



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








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



No campo ttulo, e clique na opo finalizar;





60 DevStudio


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




Exerccio

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







DevStudio - 61
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;




62 DevStudio



O processo de converso ser iniciado;

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









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



64 DevStudio


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



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








DevStudio - 65
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;



66 DevStudio



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



Exerccio

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







DevStudio - 67
Verificao de integridades
Utilizado para verificar a integridade do rpo e patch que esto sendo
utilizados pelo sistema.
Para tanto, basta selecionar as seguintes opes Ferramentas ,
Checar integridade e localize o arquivo de patch.


Utilize esta opo sempre que for atualizar um
RPO ou antes de aplicar uma atualizao ao
mesmo.



68 DevStudio


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



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


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








DevStudio - 69

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




Exerccio

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



70 DevStudio


Anlises de variveis, tabelas e campos
Neste captulo, aprenderemos como utilizar o watches, analisar
variveis dos programas, pilha de chamadas, verificar os pontos
onde esto localizados os break points, verificar as tabelas e campos
utilizados pelo programa e o gerenciador de dados.

Ferramenta de desenvolvimento ide:
Comandos;
Watches;
Break points;
Pilhas de chamadas;
Variveis locais;
Variveis privadas;
Variveis pblicas;
Variveis estticas;
Tabelas e campos.






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




Exerccio

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



72 DevStudio


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



Exerccio

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

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








DevStudio - 73

Exerccio

Como utilizar a opo break point:
1. Utilizando o programa exemplo2, posicione o cursor na linha
4 do programa;
2. Selecione as seguintes opes:
executar > liga/desliga ponto de parada
3. Selecione as seguintes opes:
visualizar > janelas de debug > break points
5. No campo condio, digite ni==3 e confirme;

6. Insira um novo ponto de parada na linha 3 do programa,
posicionando o cursor na mesma linha e selecionando as opes:
executar > liga/desliga ponto de parada
7. Execute o programa por meio das opes:
executar > executar
8. Assim que a execuo do programa for congelada no ponto de
parada, localizado na linha 3, remova-o de l, clicando sobre o
break point daquela linha;
9. Selecione as seguintes opes:
executar > animao
10. Observe que quando a varivel ni estiver com o valor 3,
a execuo ser congelada, atendendo a condio do ponto de
parada condicional;
11. Encerre a execuo do programa, selecionando as opes:
executar > para execuo


74 DevStudio


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


Exerccio

1. Copie e compile o fonte abaixo:
#include "totvs.ch"
User Function programa1
programa2()
return

static function programa2
programa3()
return

static function programa3
msgalert("oi")
return






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



Exerccio

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


76 DevStudio


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



Exerccio

1. Copie o fonte abaixo:
#include "totvs.ch"
User Function Mt010Inc
Return
2. Coloque um breakpoint na linha do return, escolha SIGAFAT na
combobox de execuo na barra de ferramentas, inclua um produto
e confirme;
3. Utilize a opo para verificar as tabelas abertas at o momento da
execuo.






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



78 DevStudio



Exerccio

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

You might also like