Você está na página 1de 80

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
2

TotvsDevStudio

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

Todos os direitos reservados.

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

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

Todos os direitos reservados.

64
65
66
68
68
70
72
74
75
77
78

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

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 Compilao,dever 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 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 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 Ambiente,o Nome do Ambiente,que ser utilizado
pelo Compilador;
5.NoCampo Conexo:,informe oProtocoloVlido,para 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 Arquivo,Novo 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 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;

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 Ferramentas,Documentao 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 Arquivo,Novo 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 Editar,Lcalizar;

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 Editar,Repetir 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 Editar,Substituir;

Indentar
Quando quisermos que o fonte digitado seja Indentado (Organizado) deveremos utilizadar esta opo.
Para Indentar, selecione Editar,Texto,Indentar;
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 Editar,Texto,
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 Editar,Texto,
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 Editar,Texto,Duplicar 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 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.

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 Editar,Ir 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 Projetos,Salvar;


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 Tela,contendo 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.prw,Adicione 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.prw,Adicione 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;

Todos os direitos reservados.

TotvsDevStudio

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 Parada,que 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.

Você também pode gostar