Apostila MP TOTVS Developer Studio 11 5

Todos os direitos autorais reservados pela TOTVS S.A.
Proibida a reproduo total ou parcial, bem como a armazenagem em sistema de recuperao e a

transmisso, de qualquer modo ou por qualquer outro meio, seja este eletrnico, mecnico, de fotocpia, de
gravao, ou outros, sem prvia autorizao por escrito da proprietria.
O desrespeito a essa proibio configura em apropriao indevida dos direitos autorais e patrimoniais da
TOTVS.
Conforme artigos 122 e 130 da LEI no. 5.988 de 14 de Dezembro de 1973.
TOTVS |
Developer Studio
Habilitar o participante nas funcionalidades do ambiente de

desenvolvimento TOTVS | Developer Studio, abordando suas diversas
funcionalidades.
Linha de
Produto
Microsiga
Protheus
11.5
TOTVS | Developer Studio
ndice
1.
Objetivos ........................................................................................................................................... 4
2.
Introduo ......................................................................................................................................... 5
3.
Instalando o TOTVS | Developer Studio ............................................................................................. 6
4.
Iniciando TOTVS | Developer Studio .................................................................................................. 7
4.1.
Termo de aceite ................................................................................................................................. 7
4.2.
Trabalhando com reas de Trabalho ou Workspaces .......................................................................... 7
4.3.
Instalao de adicionais ...................................................................................................................... 8
4.4.
Perspectivas e Vises ......................................................................................................................... 9
5.
Ajustando as preferncias do TOTVS | Developer Studio .................................................................. 12
5.1.
Autorizao ........................................................................................................................................ 12
5.2.
Developer Studio Editor ..................................................................................................................... 12
5.2.1. Auto-complete ................................................................................................................................... 13

5.2.2. Decorator AdvPL ................................................................................................................................ 13
5.2.3. Performance ...................................................................................................................................... 14
5.2.4. Modelos ............................................................................................................................................. 14
5.2.5. Server ................................................................................................................................................ 14
5.2.6. Compilador/Pr-Compilador............................................................................................................... 14
5.2.7. Configuraes do servidor .................................................................................................................. 14
5.3.
Developer Studio Help ........................................................................................................................ 15
5.4.
Developer Studio Robo de Testes ....................................................................................................... 15
5.5.
Includes.............................................................................................................................................. 15
5.6.
Configurao de Servidores TOTVS ..................................................................................................... 15
5.6.1. Acessando a perspectiva TOTVS Server ............................................................................................... 15

5.6.2. Adicionando um servidor.................................................................................................................... 17
5.6.3. Conectando-se ao servidor ................................................................................................................. 18
5.6.4. Configurao do servidor ................................................................................................................... 18
5.6.4.1.Inspetor de Objetos ............................................................................................................................ 18
5.6.4.2.Log do Repositrio .............................................................................................................................. 19
5.6.4.3. Desfragmentar repositrio ................................................................................................................. 19
5.6.5. Selecionando o servidor para a sua utilizao ..................................................................................... 19
6.
Trabalhando com projetos................................................................................................................. 20
6.1.
Iniciando um projeto .......................................................................................................................... 20
6.2.
Criando arquivos-fonte ....................................................................................................................... 23
6.3.
Edio de arquivos-fonte .................................................................................................................... 24
6.4.
Adio de arquivos de recursos .......................................................................................................... 24
6.5.
Compilao de arquivos e projetos ..................................................................................................... 24
6.6.
Compilando Pastas e Projetos ............................................................................................................ 25
TOTVS | Developer Studio Linha de Produto Microsiga Protheus

Verso 11.5
6.7.
Gerenciamento de projetos ................................................................................................................ 26
6.8.
Execuo de projetos ......................................................................................................................... 27
6.8.1. Bsico ................................................................................................................................................ 27

6.8.2. Avanado ........................................................................................................................................... 29
6.9.
Depurao de projetos ....................................................................................................................... 31
6.9.1. Viso Debug ....................................................................................................................................... 33

6.9.2. Viso Breakpoint ................................................................................................................................ 34
6.9.3. Viso Tabela de Dados........................................................................................................................ 34
6.9.4. Viso Adv/PL Commands .................................................................................................................... 34
6.9.5. Viso Variables ................................................................................................................................... 34
6.9.6. Viso Expression ................................................................................................................................. 34
7.
Assistente de Cdigo ......................................................................................................................... 36
7.1.
Assistente de cdigo: Cadastro ........................................................................................................... 37
7.2.
Assistente de cdigo: Gerao de Arquivo Texto ................................................................................. 39
7.3.
Assistente de cdigo: Importao de Arquivo Texto ............................................................................ 42
7.4.
Assistente de cdigo: Processamento Genrico .................................................................................. 45
7.5.
Nova Classe Adv/PL ............................................................................................................................ 46
7.6.
Nova Funo Adv/PL .......................................................................................................................... 47
7.7.
Novo Fonte WSDL Adv/PL ................................................................................................................... 48
8.
Trabalhando com pacotes de atualizao (patch) .............................................................................. 49
8.1.
Gerao de pacotes de atualizao (patch) ......................................................................................... 49
8.1.1. Gerao de pacotes de atualizao por Comparao .......................................................................... 50

8.1.2. Gerao de pacotes de atualizao por Programa, selecionados a partir do RPO ................................. 50
8.1.3. Gerao de pacotes de atualizao por Programa selecionados a partir des Projetos .......................... 51
8.1.4. Gerao de pacotes de atualizao por Grupo de Projeto ................................................................... 51
8.2.
Aplicao de pacote de atualizao .................................................................................................... 51
9.
Compilao de verso ........................................................................................................................ 53
10.
Desempenho de programas (profile) ................................................................................................. 55
10.1.
Obtendo perfil (profile) ...................................................................................................................... 55
10.2.
Analisando perfil ................................................................................................................................ 56
10.2.1. Informaes resumidas ...................................................................................................................... 56

10.2.2. Informao detalhada ........................................................................................................................ 57
11.
Cobertura de cdigo (coverage code) ................................................................................................ 58
11.1.
Ativao da cobertura de cdigo ........................................................................................................ 60
11.2.
Plano de teste .................................................................................................................................... 60
11.3.
Analisando a cobertura de cdigo....................................................................................................... 61
12.
Monitoramento de servidores ........................................................................................................... 66
13.
Principais comandos do TOTVS | Developer Studio ........................................................................... 68
TOTVS | Developer Studio - Linha de Produto Microsiga Protheus

Verso 11.5
1. Objetivos
O objetivo deste curso ensinar aos futuros desenvolvedores como utilizar a Ferramenta de Desenvolvimento TOTVS |
Developer Studio, com todos os recursos oferecidos.
No decorrer deste treinamento esperado que o treinando desenvolva-se nos seguintes aspectos:
Conceitos:
- Princpios bsicos de desenvolvimento de programas usando a plataforma TOTVS.
Habilidades:
- Domnio conceitual e prtico em desenvolvimento e lgica de programao.
- Conhecimentos nos ambientes ERP TOTVS, Microsiga Protheus ou outros.
Tcnicas:
- Operacionalizao do ambiente.
- Desenvolviemento de funcionalidades e/ou customizaes em ERPs TOTVS.
- Aplicao e utilizao das funcionalidades da ferramenta.
Ao trmino do treinamento, o treinando dever ser capaz de:
Conhecer e empregar adequadamente os conceitos e funcionalidades do TOTVS | Developer Studio.
Desenvolvimento de rotinas personalizadas referentes s customizaes em ERPs TOTVS.

Verso 11.5
2. Introduo
O TOTVS | Developer Studio um ambiente de desenvolvimento integrado, que permite 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, assim como recursos adicionais, como Identificao de
Cdigo, Insero de Comentrios de Documentao etc.
Como Ferramenta de Debug dispe de aes como Percorrer Linha, Pular Linha, Executar, Seguir at o Retorno, Pausar
Execuo, Derrubar Client, permitindo ao usurio executar e depurar suas rotinas de dentro de seu ambiente integrado,
inspecionando o ambiente de execuo de suas rotinas por meio de diversas vises contendo informaes de depurao, como
variveis (divididas entre variveis locais, variveis pblicas, variveis privadas e variveis estticas), expresses, Tabelas de
dados, ndices e Campos, Break Points, Programas Registrados (Inspetor de Objetos), Pilha de Chamadas entre outras
informaes.
Alm disso, os programas criados so compilados diretamente do TOTVS | Developer Studio, os quais so mantidos em
Projetos.
Os 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.
O TOTVS | Developer Studio foi construdo sob a plataforma Eclipse, que um ambiente de desenvolvimento de uso geral
configurvel e extensvel a vrias tarefas. Caso tenha familiaridade com o Eclipse ver que o funcionamento do TOTVS |
Developer Studio praticamente o mesmo de quando o utilizamos para desenvolvimento em Java ou outras linguagens
suportadas por ele.
Caso no conhea o Eclipse passaremos aqui as informaes primordiais para utilizar o TOTVS | Developer Studio, e caso queira
se aprofundar, recomendamos acessar o site do Eclipse: http://www.eclipse.org/.
O TOTVS | Developer Studio uma ferramenta de desenvolvimento integrada (IDE), por isso, possui uma vasta gama de
funcionalidades, tais como edio de programas, execuo, depurao (debug), anlise de desempenho, configurao de
servidores entre outras. Para ativ-las necessrio instalar adicionais ao seu TDS, para as diversas linguagens que a TOTVS
possui.

Verso 11.5
3. Instalando o TOTVS | Developer Studio

Diferentemente dos ambientes de desenvolvimento anteriores, o TOTVS | Developer Studio no disponibilizado em conjunto
com os binrios TOTVS. Para ser utilizado, deve ser baixado do site http://suporte.totvs.com.br e previamente instalado.
Para isso, atente-se a dois pr-requisitos: o sistema operacional em que o TOVS | Developer Studio ser instalado e a prvia
instalao de uma Mquina Virtual Java (JVM).
Sistema Operacional
Certifique-se que o sistema operacional que ser utilizado, seja homologado para uso do TOTVS | Developer Studio e
devidamente atualizado.
Mquina Virtual Java (JVM)
Em ambientes Windows, o instalador do TOTVS | Developer Studio efetuar uma verificao, e se necessrio far atualizao
ou instalao da JVM de forma automtica, aps confirmao.
Ao acionar o instalador do TOTVS | Developer Studio, este o guiar pelos procedimentos necessrios para a instalao. Seguem
os passos:
Inicie o instalador do TOTVS | Developer Studio, conforme o seu sistema operacional.
Selecione o idioma que deseja utilizar durante o processo de instalao.
Leia os termos e condies do licenciamento e selecione a opo que corresponde ao aceite.
Selecione o local de instalao.
Aguarde o fim da instalao.
Ao trmino da instalao, o ambiente de desenvolvimento estar pronto para ser usado. Para isso, acione o atalho
no desktop do computador ou no menu de programas.
Saiba Mais:
Para mais informaes acesse:
http://tdn.totvs.com/pages/viewpage.action?pageId=6066171
Exerccio:
Baixe e Instale o TOTVS | Developer Studio em sua mquina.

Verso 11.5
4. Iniciando TOTVS | Developer Studio

4.1. Termo de aceite
Para iniciar o TOTVS | Developer Studio clique no cone no seu desktop ou acesse via menu de programas, o atalho
especfico do TOTVS | Developer Studio.
Ao utilizar o TOTVS | Developer Studio pela primeira vez necessrio que voc esteja cadastrado pela TOTVS para a
utilizao deste software e aceite o termo de utilizao. Com isso, no primeiro acesso ser apresentada uma tela
contendo este termo de utilizao. Leia-o com ateno e somente se estiver de acordo, preencha os campos
solicitados, acione a opo Aceito os termos e envie-o. Ser validado por um de nossos servidores e se estiver correto,
ser apresentada a tela de Boas Vindas, caso contrrio ser apresentado o motivo da recusa.
4.2. Trabalhando com reas de Trabalho ou Workspaces

Aps o aceite do termo de utilizao, ser apresentada uma tela para seleo de uma rea de Trabalho (ou em ingls
Workspace). O conceito de rea de trabalho consiste em um local no qual seus trabalhos podem ser armazenados e/ou
acessados via ligao simblica (symbolic link) ou fisicamente. Contm tambm informaes de gerenciamento e
organizao dos fontes e outras informaes necessrias ao funcionamento do TOTVS | Developer Studio.

Verso 11.5
possvel manter quantas reas de trabalho desejar, organizando seus trabalhos da forma que achar mais confortvel
e natural. Por exemplo, mantendo uma rea para cada produto/verso, cliente, projetos pessoais etc.
Usando as ligaes simblicas (symbolic links) possvel compartilhar diretrios e arquivos, que so comuns a vrios
projetos.
Ao iniciar o TOTVS | Developer Studio ser necessrio informar uma workspace. Indique um diretrio de workspace ou
aceite o local padro. Caso o diretrio selecionado no exista, este ser criado.
Logo abaixo do campo workspace existe uma caixa de marcao, a qual optativa para que seja a sua rea de trabalho
padro. Se for marcada, na prxima vez em que entrar no TOTVS | Developer Studio, no ser solicitado rea.
possvel alterar de diretrio workspace, posteriormente, acessando o menu Arquivo e depois Alterar Workspace.
Recomenda-se que a rea de trabalho seja colocada em diretrio diferente do local de instalao do TOTVS | Developer
Studio. Este procedimento facilitar manter cpias de segurana e futuras atualizaes do produto.
Aps a seleo da rea de trabalho aguarde alguns instantes enquanto o TOTVS | Developer Studio inicializado e
apresente a tela de boas-vindas.
4.3. Instalao de adicionais

Aps os procedimentos acima, o TOTVS | Developer Studio estar inicializado, porm falta a instalao de um
adicional especfico para a linguagem de programao que iremos utilizar. O conceito de Adicional (plugins eclipse)
consiste em um ou mais pacotes de softwares que adicionam capacidades ou que estendem funcionalidades j
existentes plataforma Eclipse, no caso em questo, conter informaes sobre cada uma das linguagens de
programao TOTVS, suas janelas, especificaes entre outras informaes.
Para esta instalao acesse o Gerenciador de Atualizaes do TOTVS | Developer Studio, acionando o menu Ajuda |
Instalar novo software. Ser apresentada uma janela para informar o adicional a ser instalado, mais precisamente a url
de instalao do adicional.

Verso 11.5
Tomaremos como exemplo, que desejamos desenvolver aplicativos utilizando a linguagem de programao Adv/PL da
TOTVS.
Para isso, no campo Work With (item A na imagem a seguir), informe (digitando ou colando) o endereo do pacote a
ser adicionado, no caso do Adv/PL ser http://ds.totvs.com/updates/advpl que foi obtido no site http://ds.totvs.com
Acione ENTER e depois de alguns instantes (pode demorar algum tempo), ser apresentada uma rvore (item B na
imagem a seguir), para a seleo dos adicionais desejados. No caso selecione a raiz da rvore, ou seja, Adv/PL.
Acione Avanar (item C na imagem a seguir), aceite o termo de utilizao e siga as instrues do Gerenciador de
Atualizaes.
Ao finalizar a instalao e reiniciar o TOTVS | Developer Studio teremos um ambiente pronto para a programao em
Adv/PL da TOTVS.
Importante:
O processo de instalao de adicionais semelhante a todas as linguagens suportadas (Adv/PL, 4GL e
4GLP), mudando apenas os endereos em que os adicionais esto disponveis. Acesse
http://ds.totvs.com para obter a lista dos endereos e mais informaes.
4.4. Perspectivas e Vises

As funcionalidades adicionadas ou estendidas por meio dos adicionais (plugins) no caso acima de Adv/PL so agrupadas
em perspectivas. As perspectivas so configuraes pr-definidas, que podem ser customizadas posteriormente pelo
usurio desenvolvedor, e que permite de uma forma rpida, modificar o seu ponto de vista (perspectiva) em relao ao
trabalho que esta sendo executado ou que ser necessrio fazer.
Cada perspectiva ter uma ou mais vises, que se relacionam de alguma forma entre si e com o trabalho a ser
executado. As vises so janelas acoplveis (do ingls dockable) que adicionam funcionalidades ou informaes
perspectiva que a contm.
possvel selecionar ou mudar de uma perspectiva utilizando as opes disponveis por meio dos botes e cones de
seleo, presentes na barra de ferramentas ou acessando o menu: Janela | Abrir perspectiva | Outros
Verso 11.5
Tambm possvel selecionar diretamente na barra de perspectivas, como na imagem a seguir no item A.
Como exemplo, ao instalar o adicional da linguagem de programao Adv/PL no TOTVS | Developer Studio, ele vir com
as perspectivas bsicas para o desenvolvedor de produtos TOTVS em Adv/PL, cuja perspectiva conter diversas vises
especficas para o ambiente de desenvolvimento da Linha de Produto Microsiga Protheus.
Para entendermos melhor esses conceitos abra o TOTVS | Developer Studio. A perspectiva inicial a de Informaes
(ou em ingls Resources). Para melhor visualizao acesse a seleo de perspectivas (conforme citado acima) e
selecione a perspectiva Totvs Developer. Esta a perspectiva que reordenar as vises de acordo com o adicional para
a linguagem de programao Adv/PL, previamente instalado.
Ao abrir a perspectiva TOTVS Developer teremos o TOTVS | Developer Studio dividido em diversas partes: Menu
principal, barra de ferramentas, Navegador de projetos, Estrutura de programas/classes, rea de editores, Abas
informativas e retorno e rea de trabalho das abas informativas, barra de status e menu de acesso rpido etc.
No TOTVS | Developer Studio utilizaremos 4 perspectivas principais na maior parte do tempo, sendo elas:
10
TOTVS Developer: responsvel pela organizao e disposio das principais funcionalidades relacionadas ao
desenvolvimento de projetos e programas.
TOTVS Servers: responsvel pela organizao e disposio do cadastro e suas funcionalidades, assim como o
monitoramento de servidores de aplicao TOTVS.
Debug: responsvel por servir funcionalidades e informaes acerca do debug/deburao de programas.
TOTVS Store: responsvel pela organizao e integrao do TOTVS | Developer Studio com a TOTVS | Store.

Verso 11.5
Importante:
Viso ou Janela acoplvel (dockable) permite a configurao visual da forma que for mais
conveniente. Arraste uma das vises que esto em abas informativas e ver que, conforme for se
movimentando pela tela aparecer um quadro pontilhado indicando onde ser acoplada se soltar
o boto do mouse.
Exerccio:
Instale o adicional para programao em Adv/PL TOTVS em seu TOTVS | Developer Studio.
Verifique a perspectiva TOTVS Developer e as suas vises.

Verso 11.5
11
5. Ajustando as preferncias do TOTVS | Developer Studio

O TOTVS | Developer Studio possui alguns comportamentos que podem ser configurados pelo usurio, de acordo com suas
preferncias ou ainda, ajud-lo no seu dia a dia.
Acione o menu Janela, opo Preferncias, obtendo uma tela semelhante a:
Na rvore de navegao ( esquerda) temos vrios grupos de opes a serem explorados. Aqui, abordamos apenas as opes
especficas do TOTVS | Developer Studio.
Importante:
Os grupos podem variar bastante de instalao para instalao, em funo de pacotes adicionais (plug-ins)
instalados. Cada adicional ter alguns grupos a mais, consulte a documentao de cada adicional para mais
detalhes.
5.1. Autorizao
Tela de preferncia para informar a chave especial de compilao para fontes AdvPL.
5.2. Developer Studio Editor

Ao acionar o n Developer Studio Editor sero exibidas as preferncias gerais, permitindo assim as configuraes sobre
o comportamento do editor.
12
Salva fonte automaticamente antes de compilar - se ativada, ao compilar os fontes sofrer edio desde a
ltima compilao. Sero salvos sem solicitar confirmao.
Habilitar auto-aspas - se ativada, ao ser digitado (aspas duplas), ' (aspas simples), [ (colchetes), (
(parnteses), { (chaves) ou | (barra vertical), o editor ir inserir o seu equivalente para fech-lo.

Verso 11.5
Tamanho da listas de arquivos recentemente abertos - informe a quantidade de arquivos que ser mantida
no histrico de arquivos recentes.
Mostrar vrias guias do editor - se ativada apresentar diversas guias de apoio ao usurio, tais como linhas
modificadas, limites de blocos de cdigos entre outras.
Permitir editores de sistema no local - se ativada, o editor registrado no sistema ser acionado para arquivos
com extenses no tratadas pelo editor, como por exemplo, arquivos PNG (imagens).
Restaurar estado do editor no arranque - se ativada, ao sair do TOTVS | Developer Studio ser armazenada
uma srie de informaes, tais como, arquivos abertos, diretrios expandidos na rvore de projeto, arquivo
corrente entre outras. Ao iniciar o TOTVS | Developer Studio novamente, estes dados sero recuperados e a
tela ser reconstituda da mesma forma que voc a deixou.
Fechar editores automaticamente - se ativo, quando a quantidade de editores abertos (arquivos em edio)
atingir o valor especificado em Numero de editores abertos antes de fechar, o editor ir pedir para salvar um
arquivo qualquer e reutilizar este editor ou abrir um novo editor (opes configuradas em Quando todos os
editores estiverem sujos (editados) ou travados).
Dentro deste grupo possvel efetuar configuraes especficas para alguns processos.
5.2.1. Auto-complete
Configure a abrangncia que ser utilizada na obteno de opes para seleo no autocompletar (control + barra de
espao).
Importante:
O autocompletar utiliza somente a fonte corrente e opes de templates, como fonte de opes da
lista. Esta configurao agrega maior abrangncia.
Desabilitar pesquisa de funes/classes no RPO - ao ativar, o RPO ser desprezado como fonte de propostas.
Pesquisa funes/classes do RPO (Sintaxe Highligh e Auto complete) - se ativada ir pesquisar todo o RPO
para destacar sintaxe como fonte de propostas.
Pesquisa funes/classes do RPO (Auto complete) - se ativada ir pesquisar todo o RPO como fonte de
propostas. Em mquinas no potentes, este processo pode ser bastante lento. Para minimizar esta situao
indique o nmero mnimo de caracteres digitados necessrios para que o autocompletar seja ativado.
5.2.2. Decorator AdvPL

Alm da decorao tradicional (marcas de erro, avisos entre outras) possvel habilitar um indicador de arquivos no
compilados no RPO em uso pelo ambiente selecionado, basta ativar a opo Marca arquivos que no esto
compilados no RPO.
Importante:
Este processo pode ser demorado.

Verso 11.5
13
5.2.3. Performance
Em mquinas menos potentes, a edio de arquivos-fontes grandes pode ficar lenta. Se isso estiver acontecendo, a
performance pode ser melhorada desabilitando algumas funcionalidades em fontes grandes.
Desabilitar autocompletar - se ativada, para os fontes com linhas acima do informado, a facilidade de
autocompletar ser desativada para ele.
Desabilitar outline - se ativada, para os fontes com linhas acima do informado, a facilidade de estrutura
(outline) ser desativada para ele.
Prioridade do Job de Carga de Fontes - ao abrir um projeto, este necessita mapear os arquivos existentes, e
dependendo da quantidade pode demorar um pouco e elevar o uso de CPU ao extremo. Pode-se ajustar a
prioridade para baixa, de forma que isso no acontea.
5.2.4. Modelos
Nesta pgina possvel consultar, manter ou criar modelos de cdigos, que sero apresentados como opo na lista
de propostas ao acionar o autocompletar (control + barra de espaos).
5.2.5. Server
Permite configurar o comportamento do compilador, do pr-compilador e dos servidores.
5.2.6. Compilador/Pr-Compilador
Gera arquivos PPO na compilao - se ativado, depois da compilao gera o arquivo de pr-processamento
(extenso PPO).
Exibir contedo do AdvplASP progressivamente no browser - se ativado, os programas escritos em AdvplASP

iro enviar dados ao navegador (browser) durante o processamento desde o nicio e no s ao final (padro).
Incluir informaes de depurao em AdvplASP - se ativado, incorpora aos programas escritos em AdvplASP
informaes adicionais para sua depurao.
Visualizar PreComp CommandLine Result - se ativo, apresenta em console a linha de comando e o resultado
do processamento do pr-compilador.
5.2.7. Configuraes do servidor
14
Tempo de verificao de conexo do TOTVSAPPSERVER (segundos) - se preenchido, indica qual o intervalo

(em segundos) para que o TOTVS | Developer Studio verifique se a conexo com o servidor TOTVSAPPSERVER
ainda esta ativa ou no.
Tempo de verificao de conexo do TOTVSDBACCESS (segundos) - se preenchido, indica qual o intervalo (em
segundos) para que o TOTVS | Developer Studio verifique se a conexo com o servidor TOTVSDBACCESS
ainda esta ativa ou no.
Tempo de atualizao do AdvPL Monitor (segundos) - se preenchido, indica qual o intervalo (em segundos)
para que o TOTVS | Developer Studio solicite ao servidor informaes sobre atividades em execuo.
Velocidade de Atualizao das Infos do Monitor DBAccess - se preenchido, indica qual a frequncia para que
o TOTVS | Developer Studio solicite ao servidor DBAccess informaes sobre suas atividades.

Verso 11.5
5.3. Developer Studio Help

Permite configurar o local no qual encontram-se os arquivos de ajuda do TOTVS | Developer Studio, das linguagens e
processos.
5.4. Developer Studio Robo de Testes

Permite configuraes internas para geraes de patch.
5.5. Includes
Permite configuraes de arquivos de includes globais para serem adicionados aos projetos TOTVS.
5.6. Configurao de Servidores TOTVS

Para a adio de servidores TOTVS utilize a perspectiva TOTVS Server. Esta perspectiva rene as janelas mais comuns
para gerenciamento e acesso aos servidores.
5.6.1. Acessando a perspectiva TOTVS Server

Para acessar a perspectiva TOTVS Server, ou qualquer outra, selecione-a por meio do seletor de perspectiva ou pelo
menu Janela | Abrir perspectiva | Outros e escolha TOTVS Server. A perspectiva TOTVS Server apresenta diversas
vises, porm se destacam:
Viso Servers Extension localizada por padro esquerda do TDS, podemos definir quais servidores vamos
utilizar, permitindo tambm, efetuar configuraes e obter informaes sobre o processamento (quando
disponvel).
Viso TOTVS Server Outline localizada por padro direita do TDS, permite uma navegao rpida entre as
opes/abas de configurao de um servidor previamente selecionado.
Vises informativas geralmente localizadas na parte inferior do TDS, contm algumas vises (views) com
informaes adicionais sobre o servidor, tais como usurios conectados e pelo menu de contexto desta,
algumas operaes com o servidor.

Verso 11.5
15
Na imagem acima temos a perspectiva TOTVS Servers. No item A temos a viso Servers Extension, no item B temos a
viso TOTVS Server Outline e no item C temos a vises informativas, entre estas temos a viso TOTVS Application
Monitor e TOTVS DBAccess Monitor, respectivamente, as vises de monitoramento de servidores TOTVS e
servidores DBAccess.
Para acessar as diversas aes disponveis em servidores TOVS acione o menu de contexto sobre o elemento
Servidores da viso Servers Extension, item A da imagem acima. Entre as diversas opes esto:
16
Opo
Descrio da funo
Novo Grupo de Servidores
Permite criar um elemento na rvore que agrupa servidores.
Servidor de Aplicao
Apresenta a lista de tipos de servidores disponveis.
Servidor 4GL
Inicia a configurao de um servidor com suporte a 4GL.
Servidor 4GLP
Inicia a configurao de um servidor com suporte a 4GLP.
Servidor Adv/PL
Inicia a configurao de um servidor com suporte a Adv/PL.
Servidor DBAccess
Apresenta a lista de tipos de servidores disponveis.
Servidor DBAccess
Inicia a configurao de um servidor DBAccess.
Conexes ativas
Fora uma atualizao das abas informativas para os servidores

conectados.

Verso 11.5
Importante:
As opes acima podem variar de acordo com os adicionais instalados, por exemplo, caso tenha
instalado somente o adicional Adv/PL na opo Servidor de Aplicao acima, s ter disponvel o
Servidor Adv/PL. Para outros servidores de aplicao necessria a instalao de um adicional
especfico.
5.6.2. Adicionando um servidor

Para adicionar um servidor acione o menu de contexto sobre o elemento Servidores da rvore de navegao da
viso Server Extension, acione a opo Servidor de Aplicao | Servidor Adv/PL (ou o mais conveniente).
Aguarde que ser inicializado um assistente para que sejam informados os dados solicitados do servidor. Clique em
Concluir para terminar o cadastro do servidor.
possvel editar ou corrigir os dados de conexo deste servidor, modificando os dados disponveis nas pginas (na
parte de baixo da viso) e acionando a opo salva por meio do atalho CTRL + S.
Ao finalizar o cadastro do servidor, este aparecer na listagem de servidores. Ao acionar o menu contexto deste
elemento teremos algumas opes:
Opo
Descrio da funo
Conectar Servidor
Conecta-se ao servidor conforme as informaes constantes na configurao.
Remover
Remove as configuraes do servidor, tornando-o inacessvel.

Verso 11.5
17
5.6.3. Conectando-se ao servidor

Aps a configurao de um servidor acione o menu de contexto sobre o elemento na rvore de navegao e acione a
opo Conectar Servidor.
Os servidores com suporte a Adv/PL iro solicitar algumas informaes antes de efetuar a conexo. Informe os dados
solicitados. Se desejar, pode salvar o Usurio e Senha em um local seguro acionando a opo Salvar as informaes
de login em local seguro.
Importante:
Durante e depois do processo de conexo acompanhe as ocorrncias na viso console (geralmente
localizada na parte inferior do TDS).
Aps efetuar a conexo com o servidor, o menu de contexto do servidor passar a conter algumas outras opes:
Opo
Descrio da funo
Desconectar Servidor
Encerra a conexo com o servidor.
Conexes ativas
Fora uma atualizao das abas informativas para os servidores conectados.
Para o Servidor
Envia ao servidor um comando de parada (shutdown).
Desabilita conexo
Envia ao servidor um comando para rejeitar novas conexes.
5.6.4. Configurao do servidor

Aps a conexo clique duas vezes sobre o servidor previamente cadastrado e obtenha informaes sobre o servidor
em questo. Estas informaes sero apresentadas rea de editores, que sero as configuraes do servidor
oriundas do arquivo appserver.ini.
Ao cessar qualquer uma das pginas disponveis possvel efetuar modificaes de configurao, e ao salvar as
modificaes, estas sero persistidas no arquivo ini do servidor. Pode-se salvar a qualquer momento ao acionar a
tecla de atalho CTRL + S.
Importante:
Para saber como configurar e o que configurar em cada um dos servidores
consulte a documentao especfica.
Alm de todas as configuraes do servidor, nessa tela temos trs grandes funcionalidades, Inspetor de Objetos, Log
de Repositrio e Desfragmentar Repositrio.
5.6.4.1. Inspetor de Objetos

Esta funcionalidade utilizada para visualizar todos os Programas (Funes), os quais se encontram Compilados no
RPO em uso.
Para acessar os Inspetores de Objetos selecione a aba Environment. Selecione um ambiente e clique no boto
Inspetor de Objetos. Verifique se ser iniciado o carregamento do RPO.
18

Verso 11.5
Em seguida, ser apresentada uma lista com todos os arquivos fontes, contendo funes, arquivos HTML, ADVPLASP e imagens, que se encontram compilados no RPO em uso.
5.6.4.2. Log do Repositrio

Utilizado para visualizar todo o histrico sobre o RPO em uso, poderemos por meio desta opo visualizar as datas
dos ltimos patches aplicados, o contedo dos patches e a data da build utilizada.
Para acessar o Log do repositrio selecione a aba Environment. Selecione um ambiente e clique no boto Log do
Repositrio.
No lado esquerdo da tela visualizamos o histrico dos patches aplicados. Quando selecionarmos um dos registros,
no lado direito da tela ser informada mais detalhadamente a data de gerao e aplicao da patch, juntamente
com o contedo dela e a data da build.
5.6.4.3. Desfragmentar repositrio

Utilizado para desfragmentar repositrio do servidor e ambiente selecionado. Para acessar selecione a aba
Environment. Selecione um ambiente e clique no boto Desfragmentar repositrio.
Importante:
necessrio ter acesso exclusivo ao repositrio para desfragment-lo. Esse processo ir reduzir o
tamanho do repositrio reescrevendo-o e eliminando o espao ocupado por rotinas antigas. Este
processo pode demorar alguns momentos para ser executado.
5.6.5. Selecionando o servidor para a sua utilizao

Aps o cadastro, a configurao e a conexo de um servidor TOTVS tm que selecionar um servidor para utilizao
no TOTVS | Developer Studio. Para isso, selecione o servidor e ambiente localizados na barra de ferramentas.
Agora poderemos compilar programas, executando-os (run) e/ou depurando-os (debug).
Exerccio:
Adicione um servidor da Linha de Produto Microsiga Protheus, previamente instalado. Lembre-se de
conectar ao servidor. D um duplo clique no servidor cadastrado e visualize as informaes do servidor.
Altere alguma informao e salve-a.

Verso 11.5
19
6. Trabalhando com projetos

6.1. Iniciando um projeto
Uma vez inicializado um projeto TOTVS | Developer Studio e um servidor ter sido definido podemos iniciar os trabalhos
de desenvolvimento. Selecione a perspectiva TOTVS Developer (lembre-se que esta a perspectiva mais indicada para
o desenvolvimento).
A organizao inicial de um trabalho no TOTVS | Developer Studio o projeto. Em cada rea de trabalho (workspace)
possvel colocar quantos projetos desejar e fazer a administrao por meio da viso TOTVS Explorer.
Logo abaixo do ttulo da aba e da barra de ferramentas acione o menu de contexto e nas opes apresentadas acione
Novo | Outras ou Importar. Ser apresentado o assistente de novos elementos ou assistente de importao (conforme
a opo utilizada).
Utilizando a rvore de navegao localize TOTVS Wizard, expanda-o e obter as opes:
20
Importar projeto Adv/PL A partir de um arquivo de projetos (*.prj) preparado um projeto TOTVS.
Novo Projeto TOTVS inicializado um projeto TOTVS vazio, contendo uma estrutura bsica.

Verso 11.5
Importante:
Arquivos de projeto (*.prj) so utilizados no DevStudio (antigo IDE da Linha de Produto Microsiga
Protheus). O arquivo de projeto (*.prj) utilizado somente no momento da importao. Qualquer
modificao posterior neste arquivo, no ser refletida no projeto importado para o TDS e vice-versa.
Selecione a melhor opo e prossiga com a execuo do assistente.

Optando por importar o arquivo .prj do antigo TOTVS DevStudio, o wizard passar pelos seguintes passos, portanto,
informe:
O arquivo de projetos DevStudio (*.PRJ) a ser importado (item A). Para selecionar mais de um projeto acione
a tecla Ctrl junto com o boto direito, porm estes projetos devem estar sob o mesmo diretrio.
Indique se quer ou no importa-lo como um novo projeto (item B). Caso desmarque esta opo dever
selecionar o Destino deste projeto.
Indique o mtodo de importao (item C). Entre os mtodos disponveis esto:

-
Manter os fontes no diretrio de origem (legado) Ao utilizar esta opo, as pastas (folders) e
arquivos sero anexadas ao projeto TOVS por meio de uma ligao simblica (symbolic link), ou
seja, os arquivos continuam nos diretrios de origem e uma referncia a ele criada. Qualquer
edio efetuada, usando-se o TDS ou qualquer outro editor externo ser refletida em ambos os
ambientes. Como trata-se de uma ligao simblica, ao acionar a remoo ser apagado apenas a
referncia e no o arquivo fsico.

Verso 11.5
21
Copiar arquivos para a area de trabalho do TDS Esta opo efetua uma cpia fsica das pastas
(folders) e arquivos referenciados pelo arquivo de projeto (*.prj) para dentro da rea de trabalho
(workspace) em uso. Neste caso, qualquer alterao efetuada em uma das cpias, no ser
refletida no outro ambiente.
Em Diretrios para Busca (item D) - Adicione os diretrios que devero ser pesquisados para resoluo de
arquivos de definies (*.ch) que so referenciados nos fontes. Ao lado direito temos os botes para efetuar
estas operaes. Alm disso, possvel adicionar referncia s outras configuraes desta lista de busca
(item E), que ser utilizada juntamente com as outras. Para detalhes, veja Configurao de diretrios de
busca.
Finalize a edio e aguarde o processamento. Ao final obter mais um novo projeto TOTVS. Na viso TOTVS
Explorer teremos o projeto contendo as pastas, subpastas e os arquivos fontes contidos no antigo projeto.
Caso a escolha no TOTVS Wizard tiver sido por um novo projeto TOTVS ser criado um projeto com uma sugesto de
estrutura de pastas (folders).
Para isso, no wizard ser necessrio informar os seguintes dados:
Informe o nome do projeto (item A).
Em Diretrios para Busca (item B) adicione os diretrios que devero ser pesquisados para resoluo de
arquivos de definies (*.ch) que so referenciados nos fontes. Ao lado direito temos os botes para efetuar
estas operaes. Alm disso, possvel adicionar referncia s outras configuraes desta lista de busca
(item C), que ser utilizada juntamente com os que informar. Para detalhes veja Configurao de diretrios
de busca.
Exerccio:
Crie uma rea de trabalho e um novo projeto.
Caso tenha arquivos-fontes em Adv/PL ou possua um arquivo *.prj importe-o para o TOTVS | Developer Studio.
22

Verso 11.5
6.2. Criando arquivos-fonte

Para criar um novo arquivo fonte selecione o projeto e, opcionalmente, a pasta em que ser armazenado o arquivo
fonte.
Para criao de arquivo fonte, o TOTVS | Developer Studio disponibiliza um assistente de criao. Acione o menu de
contexto na viso TOTVS Explorer, acessando a opo Novo | Arquivo. possvel tambm acessar o menu Arquivo |
Novo, selecione a opo Outros. Faa a expanso das opes de criao de fontes da TOTVS.
Neste assistente estaro disponveis diversos tipos de arquivos-fontes TOTVS. Selecione um deles, uma pasta estar
disponvel por padro, porm se quiser modificar o local, utilize a rvore de navegao para selecionar a nova pasta
(itens A e B). No campo Nome do Arquivo (item C) informe o nome do arquivo fonte.
Logo abaixo, existe um o boto Avanado>>, que se acionado apresentar a opo para criar uma ligao simblica
(symbolic link) com um arquivo j existente do seu sistema de arquivos. Se desejar criar como ligao simblica marque
a opo Link to file in the file system e selecione o arquivo acionando o boto navegador (item D).
Finalize e aguarde o processamento. Ao final, ter o arquivo fonte criado conforme o tipo de arquivo fonte selecionado,
este arquivo fonte j vir preenchido com um template.
Importante:
Caso tenha optado pela ligao simblica, o arquivo j aparecer com o contedo e o cone ter uma
pequena seta a sua direita. Lembre-se que neste caso, todas as alteraes que efetuar sero gravadas
no arquivo fonte original.

Verso 11.5
23
6.3. Edio de arquivos-fonte

Durante a edio do arquivo fonte, a viso Outline ser atualizada com a identificao dos principais blocos do seu
arquivo fonte. Se o mouse for acionado sobre um destes itens, seu arquivo fonte ser reposicionado para este
elemento.
Na viso TOTVS Explorer possvel tambm obter a lista dos principais blocos, se expandir o elemento (click no
tringulo vazado).
A edio de arquivos-fontes bem simples. Localize na rvore de navegao do TOTVS Explorer o arquivo desejado e
efetue um duplo clique ou acione o menu de contexto sobre o arquivo e a opo Abrir.
6.4. Adio de arquivos de recursos

Extenses que no so reconhecidas como de arquivos-fontes pelo TOTVS | Developer Studio, por exemplo, a extenso
.bmp (arquivo de imagem), este arquivo adicionado como recurso e ao ser compilado ser anexado como tal, sendo
possvel acess-lo com o uso de funes especficas da linguagem.
6.5. Compilao de arquivos e projetos

Antes de efetuar a compilao de um arquivo, pasta ou projeto necessrio estar conectado a um servidor (veja
Perspectiva TOTVS Server), na barra de ferramentas necessrio indicar qual servidor ser utilizado e no caso de
Adv/PL, o ambiente.
Para compilar, depois de indicar o servidor e ambiente, acione Ctrl+F9 ou o menu de contexto sobre a rea do editor ou
sobre o elemento do arquivo (na rvore de navegao).
O referido fonte ser compilado e na viso console (uma das abas informativas) obteremos informaes relativas
compilao, tais como, se foi ou no bem sucedida, e neste caso, os motivos.
A viso TOTVS Explorer, tambm informa se h problemas de compilao, colocando um pequeno sinal indicativo.
Neste caso, tambm ser indicada na rea do editor linha que esta com erro (item A da imagem a seguir). Ao passar o
mouse sobre esta marca obtm-se uma janela popup indicando o erro.
24

Verso 11.5
No lado oposto temos uma barra indicativa, que na sua altura, representa o seu arquivo fonte e a as marcaes
existentes indicam o local relativo de erro (item B). Ao clicar nesta marca, o editor ser posicionado nesta posio.
Esta barra tambm pode conter outras indicaes baseadas em cor, indicando alguma ocorrncia, por exemplo, avisos
do compilador e mudanas ocorridas.
Na rea de abas informativas temos a viso Problemas, que possui uma lista de todas as ocorrncias da compilao,
erros e avisos (item C da imagem a seguir). Se a linha de mensagem for acionada com um duplo clique, o fonte ser
aberto e posicionado no local indicado.
Importante:
Para ativar a numerao de linhas e outros comportamentos do editor acione o menu de contexto do editor,
acesse a opo Preferncias e depois Show Line Numbers.
6.6. Compilando Pastas e Projetos

Para compilar pastas (folders) ou o projeto acione o menu de contexto sobre o elemento a ser compilado na rvore de
navegao da viso TOTVS Explorer e acione a uma das seguintes opes:
Recompilar Recompila todos os elementos do projeto ou pasta (folder).
Compilar - compila todos os elementos do projeto ou pasta que foram modificados ou que no existam no
repositrio (RPO). Nesta opo, os arquivos que no sofreram alteraes sero ignorados (ou skiped).
Como estes processos podem levar algum tempo ser aberta a viso Progresso, que efetuar o processamento em
paralelo e mostrar o resultado da execuo da tarefa ao ser executada.
Importante:
A viso Progresso utilizada em diversas situaes, normalmente naquelas que podem demandar algum
tempo de processamento.

Verso 11.5
25

Exerccio:
Compile os projetos criados no exerccio anterior. Visualize a ocorrncia de possveis erros e mensagens
informativas.
6.7. Gerenciamento de projetos

Na aba TOTVS Explorer, utilizando o menu de contexto possvel gerenciar seus projetos. As opes do menu de
contexto dependero do item da rvore de navegao que for selecionado.
Para identificao temos os seguintes cones:
Identifica projetos TOTVS.
Identifica pastas ou subpastas de projetos TOTVS.
Identifica arquivos-fontes TOTVS. Arquivos-fontes linkados tero uma seta inferior direita.
O menu de contexto para projetos TOTVS ser (verifique na coluna se aplica ):
Aplica-se
26
Opo
Descrio da Funo:
Novo
Submenu para novos elementos.
Projeto
Inicializa um novo Projeto.
Arquivo
Inicializa um novo Arquivo.
Pasta
Inicializa uma nova Pasta.
Outros
Inicializa o assistente de novos elementos.
Vai para
Coloca o elemento selecionado, como sendo o elemento raiz do

navegador (temporamente). Para restaurar acione Para cima na
barra de ferramentas, logo abaixo do ttulo.
Copiar (ou CTRL+C)
Copiar o elemento para a rea de transferncia.
Colar (ou CTRL+V)
Colar o contedo transferncia (clipboard).
Remover (ou DELETE)
Remove o elemento da rvore.
Renomear (ou F2)
Modifica o nome do elemento.
Importar...
Inicia o assistente de importao.
Exportar...
Inicia o assistente de exportao.
Atualizar (ou F5)
Atualiza a rvore de navegao.
Atualizar definio
WSDL
No caso de arquivo fonte conter uma definio de cliente de

web-service, ser reprocessado.
Fechar Projeto
Fecha o projeto, mas mantm o elemento.
Fechar Projetos no
relacionados
Fecha todos os projetos no relacionados entre si.
Recompilar
Recompila todos os elementos no projeto, pasta/subpasta ou

compila o elemento.
Compilar
Compila todos os elementos no projeto, pasta/subpasta ou

compila o elemento.
Executar como...
Permite executar o projeto.
Configurar
execucao...
Permite editar as configuraes de execuo.
Depurar como...
Permite executar o projeto em modo de depurao (debug).
Configurar
depurao...
Permite editar a configuraes de depurao.

Verso 11.5
Equipe
Opo que permite gerenciar trabalhos em equipe.
Comparar com...
Inicia o processo de comparao entre elementos.
Restaurar do
histrico local...
Permite recuperar verses anteriores a partir do histrico local.
Fonte
Subopes relacionadas s fontes de projeto.
Formatar
Executa a formatao de arquivos-fontes
Propriedades (ou
ALTER+ENTER)
Apresenta uma janela com informaes sobre o elemento.
6.8. Execuo de projetos

6.8.1. Bsico
Uma vez que o projeto esteja compilado e sem erros possvel execut-lo (run) ou depurar (debug) seus
programas. Tanto a execuo como a depurao realizada por meio de configuraes de executores (ou lauchers).
Para configur-los acione o menu suspenso do boto Executar ou Depurar, selecionando a opo Configurao...
(em ingls Run Configurations...).
Na janela de configurao possvel adicionar, duplicar e remover executores. Selecione a opo TOTVS Launcher e
acione a opo Novo na barra de ferramentas (item A da imagem a seguir).
Na tela apresentada temos os campos:
Nome: informe um identificador para o novo executor (item A da imagem a seguir).
No bloco Ambiente de execuo (item B da imagem a seguir), com:

Verso 11.5
27
Utilizar servidor de aplicao interno: se estiver marcado exige o uso de um servidor interno configurado e
ser utilizado o executvel do SmartClient (remote) que encontra-se na instalao do TOTVS | Developer
Studio.
Executvel do Remote: informe ou selecione o caminho do executvel do remote SmartClient TOTVS.
Parametros do remote: informe os parmetros da linha de comando que ser utilizada na execuo do
SmartClient (remote).
Programa Inicial: informe o nome do programa que ser executado (programa principal). Pode-se deixar
esta opo em branco, neste caso quando houver a execuo ou depurao ser necessrio informar o
programa inicial.
Parametros do programa: informe os parmetros de execuo e/ou depurao requisitaos pelo programa
inicial. Pode-se deixar esta opo em branco, neste caso quando houver execuo ou depurao ser
necessrio informar os parametros do programa inicial.
Habilita profile de execuo: se marcado, ao final da execuo ser apresentados os resultados do profile
desta execuo.
Para salvar as configuraes e continuar a edio acione Aplicar ou se desejar cancelar as alteraes efetuadas
acione Reverter. Ao informar os dados mnimos necessrios, o boto Executar ser habilitado e se acionado,
iniciar a execuo. O boto Fechar encerra a edio.
Se solicitar a execuo pelo acionamento do boto Executar ou pelo menu suspenso dos botes Executar ou
Depurar ser apresentada a tela de confirmao.
Na caixa suspensa informe o nome do programa a ser executado.
Caso o campo Programa Inicial seja preenchido, ser usado como valor padro para a caixa suspensa.
28

Verso 11.5
Depois de criar e usar um executor poder acion-lo diretamente pelo menu suspenso dos botes Executar ou
Depurar, selecionando a configurao ou utilizando as teclas de atalho F11 e Ctrl+F11, para executar a ltima
configurao utilizada para depurar ou executar (respectivamente).
6.8.2.
Avanado
Na configurao avanada, utilizamos as demais abas com opes especficas.

A aba Cobertura de Cdigo (ou em ingls Coverage) permite habilitar a cobertura do cdigo nos fontes. Para isso,
marque a opo Habilitar cobertura de cdigo (item A da imagem a seguir) e utilizando os botes direita (item B
da imagem a seguir), informe os fontes que sero analisados.
Na aba Fontes (ou em ingls Source) informe onde o depurador deve procurar os fontes (item A da imagem a
seguir), sendo o padro o seu projeto. Utilize os botes direita, para adicionar outros diretrios para a busca (item
B da imagem a seguir).

Verso 11.5
29
A aba Comun (ou em ingls Common), contm algumas opes de configurao da visibilidade e outras opes
ligadas diretamente configurao do executor. Estas opes raramente sero modificadas.
Nesta aba temos:
30
Salvar como (item A da imagem acima): indique se os dados de configurao sero salvos localmente (no
seu workspace) ou em rea compartilhada (externa).
Apresentar como favorito (item B da imagem acima): indique em qual menu suspenso a configurao deve
aparecer. Caso no selecione nenhuma, esta ser apresentada em todos os menus suspensos.
Encoding (item C da imagem acima), permite definir o formato da codificao do arquivo de configurao.
Entrada e sada padro (item D da imagem acima), permite configurar a apresentao ou no da viso
console ou a sua gravao em arquivo.

Verso 11.5
6.9. Depurao de projetos

A configurao do executor (laucher) com depurao exatamente o mesmo utilizado na execuo, portanto, o
executor configurado poder ser utilizado tanto na execuo como na depurao de projetos.
Importante:
Caso tenha efetuado a configurao do executor, j possuir a mesma configurao para a depurao.
Para demonstrar o uso do depurador com pontos de parada e outras funcionalidades usaremos o programa abaixo
e passaremos passo a passo pela depurao deste programa. Sugerimos que o copie e cole em um novo arquivo
fonte Adv/PL.
user function calcFatorial()

local n
conout("Calculo de Fatoriais")
resultado := "Numero = Fatorial" + chr(13)
for n := 1 to 5 step 2
calcula(n*2)
next
conout(resultado)
return
static function calcula(anNumber)
local x := anNumber
local total := 1
while (x > 1)
total := total * x
x-end
resultado += str(anNumber,3) + " "
resultado += transform(total, "@E 9,999,999,999")
resultado += chr(13)
return
Aps a compilao do arquivo fonte acima, execute-o acionando o boto Executar (se necessrio configure um
executor). Aps encerrar a execuo e com o editor ativo (a aba fica destacada), acione Ctrl+F10 e ative a
numerao de linhas.

Verso 11.5
31
Efetue um duplo clique sobre o nmero 6 (linha 6). Repare que na barra cinza do lado esquerdo aparece uma marca
azul. Esta marca indica um ponto de parada (breakpoint). Teremos algo semelhante imagem abaixo, note a marca
caracterstica do ponto de parada perto do nmero 6.
Importante:
Quando iniciarmos a depurao, o depurador ir parar a execuo nos pontos de parada que tiverem
sido atribudos ao arquivo fonte e aguardar instrues do desenvolvedor. No caso em que o arquivo
fonte no possua pontos de parada, a depurao no ir parar em nenhum momento.
Inicie o depurador acessando o boto do menu suspenso Depurar (boto localizado ao lado do Executar) e
selecione o executador.
Aguarde alguns instantes e ser solicitado o programa inicial, informe o programa inicial. Devido o ponto de parada
definido na linha 6, o depurador ser selecionado.
Como a perspectiva atual, TOTVS Developer, no a mais indicada para depurao ser sugerido troca para a
perspectiva TOTVS Debuger. Aceite a troca e a perspectiva de depurao chamada Debug que ser apresentada.
32

Verso 11.5
Importante:
A linha corrente em que a depurao estiver parada ficar destacada das demais linhas.
Na perspectiva de depurao (debug) teremos diversas novas vises, entre elas as Vises Debug, Breakpoint,
Adv/PL Commands, Tabela de Dados, Variables, Expression entre outras. Existem diversas abas informativas que
do apoio ao desenvolvedor no momento de depurao.
Abaixo detalharemos as principais vises.
6.9.1.
Viso Debug
A viso Debug apresenta a pilha de execuo, indicando o caminho efetuado at chegar ao ponto de parada.
Teremos na barra de ferramentas desta viso, as seguintes funcionalidades:
Remove o histrico de execuo j finalizada (item 1).
Continua a execuo at encontrar um novo ponto parado ou o trmino do programa (item 2).
Pausa a execuo (item 3).
Encerra a execuo (item 4).
Executa um passo, se for chamada de mtodo ou funo, para na primeira instruo desta (item 5).
Executa um passo, se for chamada de mtodo ou funo, execute-a sem parar dentro desta (item 6).
Verso 11.5
33
6.9.2.
Executa at finalizar (retornar) do mtodo ou funo (item 7).
Viso Breakpoint
A viso Breakpoint apresenta a lista de pontos de paradas (ou em ingls Breakpoint), definida nos projetos que
esto em aberto no workspace.
Temos na barra de ferramentas desta viso as seguintes funcionalidades:
Remove os pontos de parada selecionados (item 1).
Remove todos (item 2).
Abre e posiciona-se no arquivo fonte associado (item 3).
Ignora todos os pontos de parada (item 4).
Importante:
Ao clicar na definio de um ponto de parada, o desenvolvedor ser levado at o ponto em que o ponto de
parada foi definido.
6.9.3.
Viso Tabela de Dados
A viso Tabela de dados apresenta as tabelas da Linha de Produto Microsiga Protheus abertas durante o
processamento da depurao. Esta viso no possui funcionalidades, servindo para auxiliar no acesso e consulta s
tabelas e campos abertos.
6.9.4.
Viso Adv/PL Commands
A viso Adv/PL commands permite ao desenvolvedor realizar os comandos Adv/PL em tempo de execuo com
resposta imediata.
6.9.5.
Viso Variables
A viso de Variables permite verificar os valores das variveis declaradas no programa que foi depurado. Por meio
da barra de ferramentas desta viso possvel configurar a visibilidade, baseada em escopo, das variveis que sero
apresentadas.
6.9.6.
Viso Expression
A Viso de Expressions permite definir expresses que so avaliadas a cada passo.

Voltando ao nosso processo de depurao, neste momento estamos parados na linha 6 do calcFatorial. Acione F5
para executar um passo.
34

Verso 11.5
Repare que na linha 8, do lado esquerdo h uma pequena seta azul, indicando a prxima linha a ser executada.
Acione F5, at que seja possvel entrar na funo calcula.
Repare que a viso Variveis teve seu contedo atualizado. Estando dentro de um mtodo ou funo, se acionar F7
a execuo prosseguir, parando somente quando sair do mtodo ou funo. Neste exemplo, o depurador vai
executar toda a funo calcula, parando somente na linha 10 (logo aps a chamada).
possvel tambm adicionar pontos de parada a qualquer momento, efetuando um duplo clique sobre o nmero
da linha. Faa isso na linha 26.
Acionando F8 (continuar execuo), o processamento ir ser executado at o prximo ponto de parada, nesse caso
ser o ponto de parada na linha 26. Acione o F8 para continuar a execuo.
Exerccio:
Crie um arquivo fonte contendo o cdigo do exemplo de depurao:
user function calcFatorial()
local n
conout("Calculo de Fatoriais")
resultado := "Numero = Fatorial" + chr(13)
for n := 1 to 5 step 2
calcula(n*2)
next
conout(resultado)
return
static function calcula(anNumber)
local x := anNumber
local total := 1
while (x > 1)
total := total * x
x-end
resultado += str(anNumber,3) + " "
resultado += transform(total, "@E 9,999,999,999")
resultado += chr(13)
return
Crie um executor TOTVS. Execute-o. Aps a execuo, coloque alguns pontos de parada pelo cdigo
fonte.
Veja as diveras vises da perspectiva Debug. Execute alguns comandos via viso Adv/PL Commands.
Adicione as variveis n e x viso Varivel.
Depure o arquivo fonte acima e veja o resultado ao percorrer a depurao do arquivo. Lembre-se
das teclas de atalho, F5, F6, F7 e F8, estas sero de grande valia.

Verso 11.5
35
7. Assistente de Cdigo
O TOTVS | Developer Studio disponibiliza um assistente de cdigo que ao ser acionado, auxiliar o desenvolvedor na criao
de programas Adv/PL com funcionalidades especficas, conforme as informaes fornecidas.
Para acess-lo acione menu: Arquivo | Novo | Assistente de Cdigo
Indique o Local em que o arquivo fonte ser salvo e informe o Nome do Fonte. Selecione na listagem Tipos de Assistente, o
tipo de assistente. Acione o boto Prximo.
Conforme o Tipo de Assistente selecionado, seremos guiados por uma ou mais pginas para complementar os dados
necessrios para a gerao do arquivo fonte. Hoje existem 4 tipos de assistente:
36
Cadastro
Gerao de Arquivo Texto
Importao de Arquivo Texto
Processamento Genrico

Verso 11.5
7.1. Assistente de cdigo: Cadastro

Este tipo de assistente auxilia na criao arquivos-fontes, capazes de efetuar manuteno de dados em tabelas.
Selecione o tipo template, em Cadastro - Tipo de arquivo, conforme a origem da definio da tabela. Existem 2 tipos,
Arquivo Padro ou Arquivo Especfico.
Caso a opo escolhida em Cadastro - Tipo de arquivo tenha sido por Arquivo Padro teremos a seguinte tela:
O Arquivo padro (item A da imagem acima) utilizado quando a definio da tabela a mesma do dicionrio de
dados, preenchendo os dados solicitados.
Parmetros: identifica uma Pergunta definida no dicionrio de dados da Linha de Produto Microsiga
Protheus.
Alias, (item B): no caso de arquivo padro, este ser utilizado para localizar as definies no dicionrio de
dados, caso seja arquivo especfico ser utilizado para identificar a rea de trabalho (select area).
A ordem de apresentao dos dados definida por uma das seguintes opes:
Utilize ndice padro (item C): indica qual o nmero do ndice do dicionrio de dados, associado ao alias, que
ser utilizado.
Utiliza ndice temporrio (item D): informe uma expresso Adv/PL vlida para indicar a ordem dos dados.
Este ndice de uso temporrio, sendo eliminado depois do seu uso.

Verso 11.5
37
Caso a opo escolhida em Cadastro - Tipo de arquivo tenha sido por Arquivo Especfico teremos a seguinte tela:
O Arquivo especfico utilizado para uma estrutura livre da tabela.
Parmetros (item A): identifica uma Pergunta definida no dicionrio de dados da Linha de Produto Microsiga
Protheus.
Estrutura (item B): utilizado para definir a estrutura da tabela. Utilize os botes direita para adicionar ou
remover atributos (campos).
Indexado (item C): se marcado indica que a tabela ser ordenada pela expresso Adv/PL informada no
campo Chave.
Acione Prximo (ou Next) no item D para ir para a prxima etapa, em que sero complementados os dados, podendo
detalhar funcionalidades.
Selecione o template de cadastro, conforme a visualizao e comportamento desejado:
38
axCadastro: cadastro Padronizado, que ir utilizar a funo axCadastro da biblioteca Adv/PL.
Mbrowse: definindo opes, que iro utilizar a funo mBrowse da biblioteca Adv/PL.

Verso 11.5
Nas abas abaixo possvel efetuar algumas customizaes:
Aba Botes - utilizada somente pela opo de template Mbrowse, e permite adicionar ou remover
funcionalidades a tela.
Aba Campos: permite indicar campos e customizar alguns atributos. Caso os campos no sejam
especificados, sero utilizados todos os definidos no dicionrio de dados ou na definio de tabela
customizada.
Configuraes: permite definir propriedades opcionais como o Titulo a ser utilizado na janela e Campo
Diferenciador e expresso Adv/PL, utilizada pela mBrowse para agrupar os dados.
Ao preencher todos os dados obrigatrios solicitados, finalize o processo. Ser criado um arquivo fonte conforme o
nome e local escolhido, contendo o cdigo gerado pelo assistente.
7.2. Assistente de cdigo: Gerao de Arquivo Texto

Este tipo de assistente auxilia na criao dos arquivos-fontes, capazes de gerar arquivos textos a partir de uma tabela
de dados. Existem dois modelos ou tipos de gerao de arquivo texto. So eles por Arquivo Padro e por Arquivo
Especfico.
Caso a opo escolhida em Gerao de TXT - Tipo de arquivo tenha sido por Arquivo Padro teremos a seguinte tela:

Verso 11.5
39
A Gerao de Arquivo Texto por Arquivo padro utilizada quando a definio da tabela a mesma do dicionrio de
dados, preenchendo os dados solicitados. Ser necessrio preencher as seguintes informaes:
Parmetros: identificado por A na imagem acima, identifica uma Pergunta definida no dicionrio de dados da
Linha de Produto Microsiga Protheus.
Alias: identificado por B na imagem acima, ser utilizado para localizar as definies no dicionrio de dados. Caso
seja arquivo especfico ser utilizado para identificar a rea de trabalho (select area).
A ordem de leitura dos dados definida por uma das opes no item C:
Utilize ndice padro: indica qual o nmero do ndice do dicionrio de dados, associado ao alias, que ser
utilizado.
Utiliza ndice temporrio: informe uma expresso Adv/PL vlida para indicar a ordem dos dados. Este
ndice de uso temporrio, sendo eliminado depois de seu uso.
Caso a opo escolhida em Gerao de TXT - Tipo de arquivo tenha sido por Arquivo Especfico teremos a seguinte
tela:
A Gerao de Arquivo Especfico utilizada para uma estrutura livre da tabela. Ser necessrio preencher as seguintes
informaes:
Parmetros: identificado por A na imagem acima, identifica uma Pergunta definida no dicionrio de dados
da Linha de Produto Microsiga Protheus.
Estrutura: identificado por B na imagem acima, utilizado para definir a estrutura da tabela. Utilize os
botes direita para adicionar ou remover atributos (campos).
Indexado: identificado por C na imagem acima, se marcado, indica que a tabela ser ordenada pela
expresso Adv/PL informada em Chave.
Depois de preencher os dados avance para a pgina seguinte e complemente os dados, detalhando como ser o
arquivo texto. Neste passo tambm teremos duas opes: Definido ou Parametrizado.
Caso a opo escolhida tenha sido por Definido, os valores sero fixos e informados no campo logo abaixo.
40

Verso 11.5
Informe o Nome do Arquivo Texto (item B) e o Finalizador de Linha (item C).

Caso a opo escolhida tenha sido por Parametrizado, os valores sero lidos a partir de uma varivel (normalmente
escopo privado - private) que dever ser informada no campo.
Informe a Varivel com o nome do arquivo Texto (item B) e o Finalizador de Linha (item C).
A aba Posies existente nessa etapa ser utilizada para definir o leiaute do arquivo de sada. Veja a imagem a seguir:

Verso 11.5
41
Defina o layout informando os dados: Campo, Posio, Tamanho, Nmero de Decimais e Tipo. Para adicionar ou
remover campos utilize os botes do lado direito.
Ao preencher todos os dados obrigatrios solicitados, finalize o processo. Localize a entrada de funo user function e
coloque um nome mais significativo, salve e compile.
7.3. Assistente de cdigo: Importao de Arquivo Texto

Este tipo de assistente auxilia na criao dos arquivos-fontes, capazes de importar arquivos textos a partir de uma
tabela de dados. Existem dois modelos ou tipos de importao de arquivo texto. So eles por Arquivo Padro e por
Arquivo Especfico.
Caso a opo escolhida em Importao de TXT - Tipo de arquivo tenha sido por Arquivo Padro teremos a seguinte
tela:
O Arquivo padro utilizado quando a definio da tabela a mesma do dicionrio de dados, preenchendo os dados
solicitados.
42
Protheus.
Alias: no caso de arquivo padro, este ser utilizado para localizar as definies no dicionrio de dados. Caso
seja arquivo especfico ser utilizado para identificar a rea de trabalho (select area).

Verso 11.5
A ordem de leitura dos dados definida por uma das opes:
Utilize ndice padro (item C): indica qual o nmero do ndice do dicionrio de dados associado ao alias, que
ser utilizado.
Utilize ndice temporrio (item D): informe uma expresso Adv/PL vlida para indicar a ordem dos dados.
Este ndice de uso temporrio, sendo eliminado depois de seu uso.
Caso a opo escolhida em Importao de TXT - Tipo de arquivo tenha sido por Arquivo Especfico teremos a seguinte
tela:
O Arquivo especfico utilizado para uma estrutura livre da tabela. Ser necessrio preencher as seguintes
informaes:
Protheus.
Indexado (iem C): se marcado, indica que a tabela ser ordenada pela expresso Adv/PL informada em
Chave.
Aps preencher os dados, avance para a pgina seguinte, na qual sero complementados os dados, detalhando o
arquivo texto de entrada.
Neste passo tambm teremos duas opes: Definido ou Parametrizado.
Caso a opo escolhida tenha sido por Definido, os valores sero fixos e informados no campo logo abaixo.

Verso 11.5
43
Informe o Nome do Arquivo Texto (item B) e o Finalizador de Linha (item C).

Caso a opo escolhida tenha sido por Parametrizado, os valores sero lidos a partir de uma varivel (normalmente
escopo privado - private) que dever ser informada no campo.
Informe a Varivel com o nome do arquivo Texto (item B) e o Finalizador de Linha (item C).
A aba Posies existente nessa etapa ser utilizada para definir o leiaute do arquivo de sada. Veja a imagem a seguir:
44

Verso 11.5
Defina o leiaute informando os dados: Campo, Posio, Tamanho, Nmero de Decimais e Tipo. Para adicionar ou
remover campos utilize os botes do lado direito.
7.4. Assistente de cdigo: Processamento Genrico

Este tipo de assistente auxilia na criao dos arquivos-fontes, com um esqueleto para processamentos genricos.
Existem dois modelos ou tipos de processamento genrico. So eles por Arquivo Padro e por Arquivo Especfico.
Caso a opo escolhida em Processamento Genrico - Tipo de arquivo tenha sido Arquivo Padro teremos a seguinte
tela:
O Arquivo padro utilizado quando a definio da tabela a mesma do dicionrio de dados, preenchendo os dados
solicitados.
Protheus.
Alias (item B): no caso de arquivo padro, este ser utilizado para localizar as definies no dicionrio de
dados. Caso seja arquivo especfico ser utilizado para identificar a rea de trabalho (select area).

Verso 11.5
45
A ordem de leitura dos dados definida por uma das opes:
Utilize ndice padro (item C): indica o nmero do ndice do dicionrio de dados, associado ao alias, que ser
utilizado.
Utiliza ndice temporrio (item D) - informe uma expresso Adv/PL vlida para indicar a ordem dos dados.
Este ndice de uso temporrio, sendo eliminado depois de seu uso.
Caso a opo escolhida em Processamento Genrico - Tipo de arquivo tenha sido por Arquivo Especfico teremos a
seguinte tela:
O Arquivo especfico utilizado para uma estrutura livre da tabela.
Parmetros (iem A): identifica uma Pergunta definida no dicionrio de dados da Linha de Produto Microsiga
Protheus.
Indexado (item C): se marcado, indica que a tabela ser ordenada pela expresso Adv/PL informada em
Chave.
7.5. Nova Classe Adv/PL

Este tipo de assistente auxilia na criao dos arquivos-fontes, com um esqueleto para definio de uma classe em
Adv/PL.
Informe os dados solicitados:
46
Local (folder) (item A da imagem a seguir): indica o local (folder) em que o arquivo fonte ser salvo.
Nome da Classe (item B da imagem a seguir): nome da classe.
Herda a classe (item C da imagem a seguir): nome da classe pai, quando tratar-se de classe com herana.
Criar arquivo como referncia (item D da imagem a seguir): o arquivo ser gravado no campo Diretrio de
Destino, e no local ser criado uma ligao simblica (link).

Verso 11.5
Aps informar os dados solicitados, finalize o processo e crie uma nova classe Adv/PL.
7.6. Nova Funo Adv/PL

Este tipo de assistente auxilia na criao dos arquivos-fontes, com um esqueleto para definio de uma nova funo em
Adv/PL.
Nome da funo (item B da imagem a seguir): nome da funo.
Destino e no local ser criado uma ligao simblica (link).
Aps informar os dados solicitados, finalize o processo e crie uma nova classe Adv/PL.

Verso 11.5
47
7.7. Novo Fonte WSDL Adv/PL

Este tipo de assistente auxilia na criao dos arquivos-fontes, com a definio de um cliente de servio web (web
service client) a partir da sua definio WSDL.
Este assistente depende de uma definio do servidor da Linha de Produto Microsiga Protheus e da seleo deste na
barra de ferramentas. Caso o servio web a ser utilizado esteja fora da rede do usurio, o servidor da Linha de Produto
Microsiga Protheus dever ter privilgios de acesso.
Nome da funo (item B da imagem a seguir): nome do arquivo fonte que conter a definio WSDL.
URL (item C da imagem a seguir): informe a URL em que est o servio web desejado.
Destino e no local ser criado uma ligao simblica (link).
Aps informar os dados solicitados, finalize o processo e crie uma nova definio de um cliente de servi web.
Importante:
Este assistente depende de uma definio de servidor Da Linha de Produto Microsiga Protheus e da seleo
deste na barra de ferramentas. Caso o servio web a ser utilizado esteja fora da rede do usurio, o servidor
Da Linha de Produto Microsiga Protheus dever ter privilgios de acesso.
Exerccio:
Crie uma nova funo Adv/PL
Crie uma nova classe Adv/PL
Crie um novo fonte WSDL Adv/PL
48

Verso 11.5
8. Trabalhando com pacotes de atualizao (patch)

Para gerar ou aplicar patch (pacotes de atualizaes) use os botes existentes na barra de ferramentas.
8.1. Gerao de pacotes de atualizao (patch)

Acione o boto de gerao do pacote de atualizao (patch).
Nas caixas de seleo indique a melhor opo:
Servidor (item A): selecione o servidor da Linha de Produto Microsiga Protheus que ser utilizado para a
gerao do pacote. Todos os servidores registrados na viso TOTVS Server sero listados.
Ambiente (item B): selecione o ambiente (obtido a partir do servidor selecionado).
Processo (item C): indica qual procedimento ser adotado na gerao dos pacotes. Este item pode ser por
Comparao, por Programa e por Grupo de Projetos:
por Comparao: este procedimento compara o seu RPO com um RPO mestre, gerando um pacote pela
diferena entre eles.
por Programas selecionados a partir do RPO. Este procedimento permitir indicar qual ou quais
programas sero colocados no pacote, a partir do RPO.
por Programas selecionados a partir de Projetos. Este procedimento permitir indicar qual ou quais
programas sero colocados no pacote, a partir dos projetos na rea de trabalho.
por Projetos permite a escolha de um ou mais projetos que iro fazer parte do pacote.
Salvar em (item D): selecione o local em que o arquivo de atualizao ser salvo aps sua gerao. Pode ser
na mquina local ou no servidor.

Verso 11.5
49
Arquivo (sem extenso) (item E): caso o item D seja para salvar o arquivo localmente possvel definir um
nome diferentemente do nome padro.
8.1.1. Gerao de pacotes de atualizao por Comparao

Este processo compara o RPO atual do servidor/ambiente selecionado com um RPO denominado mestre, que
encontra-se em um diretrio do servidor. Para efetuar o procedimento de gerao por comparao informe os dados
solicitados, no campo Processo selecione Por Comparao, RPO atual com um mestre e ao avanar para a prxima
pgina ser necessrio selecionar o diretrio no qual encontra-se o RPO mestre.
Acione Finalizar e aguarde o trmino do processamento. No console sero apresentadas algumas mensagens sobre a
gerao de patch.
8.1.2. Gerao de pacotes de atualizao por Programa, selecionados a partir do RPO

Este processo permite selecionar os programas que sero gravados no pacote de atualizao, selecionando somente
os programas contidos no RPO. Para efetuar o procedimento de gerao por programa informe os dados solicitados,
no campo Processo selecione Por Programa, selecionados a partir do RPO e ao avanar para a prxima pgina,
selecione os programas ou recursos/arquivos que faro parte do pacote de atualizao. Para facilitar a seleo de
programas possvel utilizar o campo Procurar fonte e/ou Procurar.
Recurso para localizar mais rapidamente um arquivo por meio dos caracteres coringa * e ?
50

Verso 11.5
gerao de patch.
8.1.3. Gerao de pacotes de atualizao por Programa selecionados a partir des Projetos
Este processo permite selecionar os programas que sero gravados no pacote de atualizao, selecionando os
programas contidos nos projetos da rea de trabalho (ou workspace). Para efetuar o procedimento de gerao por
programa informe os dados solicitados, no campo Processo selecione Por Programa, selecionados a partir de
Projetos e ao avanar para a prxima pgina selecione os programas ou recursos/arquivos que faro parte do pacote
de atualizao.
gerao de patch.
8.1.4. Gerao de pacotes de atualizao por Grupo de Projeto

Este processo permite gerar o pacote de atualizao, selecionando projetos da sua rea de trabalho (workspace).
Para efetuar o procedimento de gerao por grupo de projeto informe os dados solicitados, no campo Processo
selecione Por Grupo de Projeto e ao avanar para a prxima pgina, selecione na lista os projetos apresentados que
faro parte do patch. Todos os arquivos contidos nos projetos selecionados faro parte do patch gerado.
gerao de patch.
8.2. Aplicao de pacote de atualizao

Acione o boto de aplicao do pacote de atualizao (patch) e preencha os dados solicitados.

Verso 11.5
51
Servidor (item A): selecione o servidor da Linha de Produto Microsiga Protheus que ser utilizado para a
gerao do pacote. Todos os servidores registrados na viso TOTVS Server sero listados.
Ambiente (item B): selecione o ambiente (obtido a partir do servidor selecionado).
Pacote (item C): selecione o local onde encontra-se o arquivo de atualizao a ser aplicado. Pode ser na
mquina local ou no servidor.
Importante:
Ao selecionar o pacote (item C), este ser validado, podendo demorar alguns momentos para esta validao.
aplicao de patch.
Exerccio:
Gere um patch por grupo de projeto, utilizando o seu projeto criado. Depois de gerado, aplique o patch
em outro servidor e/ou ambiente.
52

Verso 11.5
9. Compilao de verso
Este processo permite que seja efetuada a gerao de pacotes de atualizao (patch), com a opo de compilar ou no os
fontes envolvidos, em mltiplos ambientes.
Para efetuar o processo de Compilao de verso use o boto existente na barra de ferramentas.
Servidor (item A): selecione o servidor da Linha de Produto Microsiga Protheus que ser utilizado para a compilao
e gerao do pacote. Todos os servidores registrados na viso TOTVS Server sero listados.
Ambiente (item B): selecione o(s) ambiente(s) (obtido(s) a partir do servidor selecionado) no qual o processo ser
executado.
Ler configuraes (item C): permite recuperar as configuraes de um arquivo externo gerado pelo acionamento do
boto Salvar Configurao (ver funcionalidade na prxima tela).
Acione Prximo e na tela apresentada informe os dados solicitados:

Verso 11.5
53
Itens do pacote (item B): na rvore de seleo apresentada, selecione os itens que deseja que faam parte do pacote
a ser compilado/gerado. possvel filtrar os arquivos com os caracteres coringa * e ? no item A.
Compilar selecionados (item C): quando acionada esta opo, os itens selecionados sero compilados em todos os
ambientes selecionados na tela anterior.
Gerar patch da seleo de projetos (item D): ser executado o processo de gerao de pacote de atualizao, para
todos os ambientes selecionados.
Local (item E): selecione o local em que ser gravado o pacote de atualizao (se a opo anterior estiver marcada).
Salvar configuraes (item F): permite salvar as configuraes efetuadas em um arquivo externo, para posterior
reutilizao carregando este arquivo por meio do boto Carregar Configurao da pgina anterior.
Importante:
Faz-se necessrio selecionar pelo menos uma das opes acima: Compilar selecionados e/ou Gerar patch
da seleo de projetos.
compilao de verso.
Exerccio:
Realize o procedimento de Compilao de verso. Caso tenha um servidor com mais de um ambiente utilize
das opes de compilao e compile os seus programas em mais de um ambiente. E por fim, gere o patch da
verso compilada.
54

Verso 11.5
10. Desempenho de programas (profile)

Muitas vezes, ao terminar uma nova rotina, percebemos que h pontos de lentido. Mas, onde est o problema? Qual rotina
est demorando? Por que est demorando? Com as ltimas alteraes que foram feitas houve melhorias?
O TOTVS | Developer Studio, por meio da ferramenta Profile (Perfil) ajudar a responder estas questes. Para utiliz-la o
processo bastante simples.
Utilizando o programa de exemplo calcFatorial iremos demonstr-la.
10.1. Obtendo perfil (profile)

Por meio de uma configurao de executor (ou laucher) podemos ativ-la quando necessrio.
1.
Acesse a configurao de executores (laucher) para depurao.
Importante:
O profile s ser gerado a partir da Depurao (Debug) de um arquivo fonte.
2.
3.
Adicione uma nova configurao e preencha os dados solicitados da mesma forma que em uma execuo
normal.
Habilite a execuo do profile marcando a opo Habilita Profile de execuo (item A na imagem a seguir).
Importante:
Observe que temos duas configuraes. Uma padro, em que no est habilitado o profile
e outra em que o profile est habilitado. Dessa forma, fica fcil e rpido us-lo ou no.
4.
5.
Acione a configurao com o profile ativado e depure seu programa normalmente at o final.
Abra a viso Profile, acessando Janela | Apresentar viso | Outras... na janela apresentada digite Profile
(sem aspas) e selecione a opo Adv/PL Profile.

Verso 11.5
55
6.
Efetue um duplo clique sobre o nome da viso para maximiz-la.
10.2. Analisando perfil

Usando o perfil de execuo obtido, temos diversas informaes que nos auxiliaram a detectar onde pode estar
ocorrendo o problema e como podemos resolv-lo. Nesta tela temos:
Fontes (item A na imagem acima): lista de arquivos-fontes que foram carregados para a execuo do teste.
Dados (item B na imagem acima): dados estatsticos de cada programa/funo executada.
10.2.1. Informaes resumidas

As informaes resumidas proporcionaro uma viso geral do perfil da execuo que acabou de ser realizada.
Analisando Fontes vemos que o arquivo fonte calcFatorial.prw consumiu cerca de 67% do tempo total de
processamento. J os identificados como internal (funes internas da Linha de Produto Microsiga Protheus)
consumiram cerca de 33% e os demais, a medio foi insignificante (0%).
Selecione, em Fontes, o arquivo fonte calcFatorial, obtendo algo semelhante a:
Na rea de dados (item A da imagem acima) temos:
56
Programa/Funo: identifica o nome do programa ou funo.
Chamadas: nmero de vezes que foi chamado.
Linha: identifica a linha do fonte (ver Informao detalhada).
Tempo Mdio (ms): tempo mdio de execuo por chamada (em milissegundos).
Tempo Total (ms): tempo total de todas as chamadas (em milissegundos).
Fonte: arquivo fonte onde est definida a entrada da funo.

Verso 11.5
10.2.2. Informao detalhada

Ao passar o mouse sobre a rea de dados aparecer do lado esquerdo de cada nome do programa/funo (Tela
122 B) uma pequena seta. Ao acion-la obter um detalhamento daquela funo/programa.
Se voc acionar um duplo clique sobre uma linha dos dados, o editor abrir o fonte e posicionando-o na linha do
arquivo fonte. A coluna Chamadas indica o nmero de vezes que a linha foi executada e a coluna Linha identifica o
nmero da linha do fonte.
Analisando-se os tempos e nmero de chamadas/execues, podemos efetuar alteraes no fonte, visando
melhorar o seu desempenho.
Importante:
Funes/programa que possuem interao com o usurio, por exemplo, a MsgAlert e entrada de
dados (get e similares), podem gerar distores em funo da velocidade de resposta do usurio.
Exerccio:
Realize o procedimento de estudo passo a passo. Visualize todos os dados disponveis.
Execute o profile em seus outros arquivos-fontes.

Verso 11.5
57
11. Cobertura de cdigo (coverage code)

Cobertura de cdigo (ou no ingls coverage code) define que um programa testado aquele em que TODAS as suas instrues
foram executadas ao menos uma vez. Isso realizado por testes sucessivos, tentando que cobrir todas as situaes tratadas no
cdigo.
O TOTVS | Developer Studio disponibiliza aos desenvolvedores uma ferramenta que os ajudar no processo de testes,
identificando qual parte do cdigo j foi executado.
Importante:
Passar por todas as linhas do seu cdigo, no significa que ele est livre de erros, apenas minimiza as chances
disto ocorrer.
Para demonstrar o uso desta ferramenta utilizaremos o programa abaixo.

user function escolheNum()
local n, cResp, cMsg := ""
local aOpcoes := {}
for n := 1 to 5
aAdd(aOpcoes, strZero(n,1,0))
next
while !(cResp == "*")
cResp := tela(aOpcoes)
if cResp == "1"
cMsg := "Voc escolheu o numero 1"
elseif cResp == "2"
elseif cResp == "3"
elseif cResp == "4"
elseif cResp == "5"
else
cMsg := "Nenhum nmero escolhido"
endif
if !empty(cResp)
if cResp == "2" .or. cResp == "4"
cMsg += " e PAR"
else
cMsg += " e IMPAR"
endif
endif
if !(cResp == "*")
msgAlert(cMsg)
endif
enddo
return
static function tela(aaOpcoes)
Local oDlg,oSay1,oBtn
private cOpcao := ""
if !(valType(aaOpcoes) == "A")
58

Verso 11.5
msgAlerta("Parametro aaOpcoes no uma lista (array)")

return cOpcao
endif
oDlg := MSDIALOG():Create()
oDlg:cName := "oDlg"
oDlg:cCaption := "Escolha um numero"
oDlg:nLeft := 0
oDlg:nTop := 0
oDlg:nWidth := 400
oDlg:nHeight := 250
oDlg:lCentered := .T.
oSay1 := TSAY():Create(oDlg)
oSay1:cName := "oSay1"
oSay1:cCaption := "Escolha um nmero acionando um dos botes abaixo."
oSay1:nLeft := 10
oSay1:nTop := 28
oSay1:nWidth := 250
oSay1:nHeight := 17
oSay1:lTransparent := .T.
oBtn := TButton():Create(oDlg)
oBtn:cCaption := "<nenhum>"
oBtn:blClicked := {|| cOpcao := "", oDlg:end() }
oBtn:nWidth := 90
oBtn:nTop := 90
oBtn:nLeft := 10
oBtn := TButton():Create(oDlg)
oBtn:cCaption := "<encerrar>"
oBtn:blClicked := {|| cOpcao := "*", oDlg:end() }
oBtn:nWidth := 90
oBtn:nTop := 90
oBtn:nLeft := 110
aEval(aaOpcoes, { |x,i| ;
oBtn := TButton():Create(oDlg),;
oBtn:cCaption := x,;
oBtn:blClicked := &("{|| cOpcao := '"+x+"', oDlg:end() }"),;
oBtn:nWidth := 30,;
oBtn:nTop := 60,;
oBtn:nLeft := (10 * i) + (oBtn:nWidth*(i-1));
})
oDlg:Activate()
Return cOpcao

Verso 11.5
59
11.1. Ativao da cobertura de cdigo

Para ativar este recurso acesse a configurao de um executor.
Na janela apresentada, selecione a aba Cobertura de Cdigo (item A da prxima imagem).
Nesta pgina preencha os dados solicitados:
Habilitar cobertura de cdigo (item B): habilita ou no a cobertura de cdigo.
Informe os fontes para cobertura (item C): lista de arquivos-fontes aos quais se deseja efetuar a cobertura
de cdigo. Para selecion-los, utilize os botes direita (item D).
Aps selecionar os fontes e ativar a cobertura inicie a execuo, acionando o boto Debug.
11.2. Plano de teste

Ao executar o programa sugerido teremos:
60

Verso 11.5
Com base no referido programa, elaboramos os planos de testes. Cada um destes itens, Teste 1 e Teste 2, devero
ser executados um aps o outro.
1. Teste 1
1.1. Acionar boto 1
1.2. Acionar boto 5
1.3. Acionar boto <encerrar>
2. Teste 2
2.1. Acionar boto 3
2.2. Acionar boto 4
2.3. Acionar boto <nenhum>
Execute o plano de teste. Teste primeiro 1 e depois o Teste 2.
11.3. Analisando a cobertura de cdigo

Acione a viso Cobertura de Cdigo (ou em ingls Coverage), acessando Janela | Apresentar viso | Outras
localize TOTVS Profile e acione Cobertura de Cdigo (ou em ingls Coverage). Obtendo algo semelhante a:
Na viso recm-aberta (item A da imagem acima) teremos o registro dos testes efetuados. Faa a expanso do
primeiro registro, acionando a seta esquerda (item B) da caixa de seleo.
Com a expanso obter uma lista de fontes que tiveram sua execuo monitorada. Selecione o arquivo fonte
escolheNum.prw (item A) e as linhas que foram processadas ao menos uma vez, sero destacadas no editor.

Verso 11.5
61
Se utilizarmos o plano de teste 1 como referncia e analisarmos o cdigo destacado, veremos que h coerncia entre
eles. Ou seja, o cdigo esperado para o teste 1 foi executado de forma satisfatria. Na linha de identificao do fonte
h algumas informaes, que so:
Cobertura %: indicando o percentual de linhas que foram executadas.
Executado: o nmero de linhas executada.
Total Linhas: total executado de linhas.
Faa a expanso do registro de execuo do segundo teste e selecione a linha do arquivo fonte escolheNum.prw.
Da mesma forma que no 1 teste, veremos em destaque se o cdigo que foi executado est coerente com o nosso
teste.
62

Verso 11.5
Observe que, em ambos, existe um indicador do percentual de cdigo coberto (Cobertura %). Quanto mais alto for o
ndice de cobertura (individual), menos erros sero apresentados. Cobrir um programa em 100% pode ser bastante
difcil ou mesmo invivel devido s regras de negcios. Por isso, temos que efetuar planos de testes o mais
abrangente possvel e depois de executados, verificarmos a cobertura de cada um isoladamente e depois em
conjunto.
Para efetuar a analise em conjunto, executamos um processo de fuso (merge) dos registros de testes.
Selecione os registros de testes e acione o boto (item A na imagem acima) para iniciar a fuso (merge) e aguarde.
Os registros de testes selecionados sero fundidos em um nico registro. Faa a expanso, selecione o arquivo fonte
e veja como fica a cobertura (ver a imagem a seguir).

Verso 11.5
63
Verifique que, o ndice de cobertura representa o percentual coberto agregado (60% no exemplo acima). Analisando
o que est destacado com os planos de testes veremos que continuam coerentes. Observando o arquivo fonte
veremos que a linha 15 no est destacada. Isso demonstra que em nenhum dos testes anteriores o cdigo foi
executado. Com base nestas informaes montamos mais um teste de forma que o cdigo seja executado.
3. Teste 3 (em adio ao criado em Plano de teste original)
3.1. Acionar boto 2
Execute este novo teste e obteremos mais um novo arquivo de cobertura. Ver a imagem a seguir.
Analisando o 3 teste nos resultou em uma cobertura de cdigo de 57%.
64

Verso 11.5
Clicando neste resultado analisamos o cdigo destacado e vemos que est coerente com o nosso 3 teste. Agora
devemos efetuar a fuso (merge) deste teste com o registro da fuso anterior e obteremos como resultado uma
cobertura de cdigo total de 61%.
Realizaremos estes procedimentos at que tenhamos coberto o mximo possvel dos cdigos. Utilizando-se de vrios
planos de testes possvel chegarmos a 100% de cobertura.
Exerccio:
Realize o procedimento de estudo passo a passo. Visualize todos os dados disponveis. Tente criar mais
testes e chegar ao 100% de cobertura de cdigo.
Execute a cobertura do cdigo em seus outros arquivos-fontes.

Verso 11.5
65
12. Monitoramento de servidores

Ao selecionar a perspectiva TOTVS Server, o desenvolvedor pode monitorar os servidores registrados e conectados.
Ao selecionar o n principal (Servers detalhado na imagem acima), todas as vises de monitoramento dos servidores abaixo,
sero atualizadas.
Caso selecione um servidor especfico (como no destaque da imagem abaixo), somente a viso de monitoramento ser
atualizada e as demais ficaro sem informao.
66

Verso 11.5
Acima temos o monitor de um servidor de aplicao TOTVS. Abaixo temos o monitor DBAccess TOTVS.

Verso 11.5
67
13. Principais comandos do TOTVS | Developer Studio

Ao editar arquivos-fontes temos as seguintes teclas de atalho:
Comando / Atalho
Descrio da Funo:
CTRL + ALT + UP
Duplica o bloco acima.
CTRL + ALT + DOWN
Duplica o bloco abaixo.
CTRL + BACK
Exclui a palavra anterior.
CTRL + DEL
Exclui a prxima palavra.
ALT + UP
Move a linha para cima.
ALT + DOWN
Move a linha para baixo.
CTRL + SHIFT + X
Coloca o bloco selecionado em maisculo.
CTRL + SHIFT + Y
Coloca o bloco selecionado em minsculo.
CTRL + I
Efetua a identificao do arquivo fonte ou do trecho selecionado.
INSERT
Alterna entre modo de insero e sobrescrita.
DELETE
Remove a letra direita ou o bloco selecionado.
CTRL + F9
Inicia compilao.
ALT + /
Completa as palavras sem mostrar a janela popup de opes. Pressione novamente para
alternar as opes disponveis.
CTRL + ESPAO
Ativa a janela popup de completar/autocompletar.
CTRL + D
Remove a linha atual.
CTRL + M
Alterna entre janela mxima e mnima da viso corrente.
CTRL + O
Abre a viso outline em janela popup.
CTRL + F10
Abre um menu popup com algumas opes avanadas.
CTRL + SHIFT + I
Efetua a identificao do arquivo fonte ou bloco selecionado.
CTRL + F
Localizao e substituio de texto.
CTRL + K
Localiza prxima ocorrncia.
CTRL + SHIFT + K
Localiza a ocorrncia anterior.
CTRL + SHIFT + U
Lista todas as ocorrncias da palavra selecionada ou que est sob o cursor.
CTRL + L
Move o cursor para uma linha especfica.
CTRL + SHIFT + R
Exibe a lista de recursos, entre eles os fontes dos projetos abertos.
Ao editar arquivos fontes temos as seguintes teclas de atalho:
68
Comando / Atalho
Descrio da Funo:
CTRL + PAGE DOWN
Move para a prxima aba do editor.
CTRL + PAGE UP
Move para a aba anterior do editor.
CTRL + 3
Exibe o navegador rpido. Digite uma palavra para iniciar a busca de todas as vises,
menus e barra de ferramentas.
CTRL + E
Navega entre os elementos em edio.
CTRL + F6
Alterna entre os arquivos abertos no editor.
CTRL + F7
Alterna entre as vises abertas.
CTRL + F8
Alterna entre as perspectivas abertas.

Verso 11.5
No processo de depurao (debug) de arquivos-fontes temos as seguintes teclas de atalho:

Comando / Atalho
Descrio da Funo:
F5
Percorre a linha
F6
Pula linha
F8
Executa
Outras teclas de atalho:

Comando / Atalho
Descrio da Funo:
CTRL + SHIFT + L
Exibe a lista de atalhos. Pressionando duas vezes CTRL+SHIFT+L ser

exibida a tela de configurao de atalhos. Para trocar alguma das teclas de
atalho selecione o comando e no campo Bind insira a nova tecla de atalho.
ALT + SHIFT + Q -?
Apresenta lista de vises disponveis. O caractere ? representa uma das

letras disponveis e deve ser pressionado logo em seguida ao comando
ALT+SHIFT+Q. Exemplo de ALT+SHIFT+Q, Q para abrir a Viso de
Breakpoints.
CTRL + F11
Exibe o navegador rpido. Digite uma palavra para iniciar a busca de todas
as vises, menus e barra de ferramentas.
F11
Navegar entre os elementos em edio.
ou ou { ou [ ou ( ou |
Alterna entre os arquivos abertos no editor.
Operaes com blocos de texto tm as seguintes teclas de atalho:

Comando / Atalho
Descrio da Funo:
<Bloco_de_Texto_Selecio
nado> + TAB
Adiciona uma tabulao no incio de cada linha do bloco selecionado.
nado> + SHIFT + TAB
Remove uma tabulao no incio de cada linha do bloco selecionado.
nado> +
Coloca o bloco selecionado entre aspas duplas, resultando em

<Bloco_de_Texto_Selecionado>.
nado> +
Coloca o bloco selecionado entre aspas simples, resultando em

<Bloco_de_Texto_Selecionado>.
nado> + {
Coloca o bloco selecionado

{<Bloco_de_Texto_Selecionado>}.
nado> + [
Coloca o bloco selecionado

[<Bloco_de_Texto_Selecionado>].
nado> + |
Coloca o bloco selecionado entre barras verticais, resultando em

|<Bloco_de_Texto_Selecionado>|.
entre
entre
chaves,
resultando
em
colchetes,
resultando
em

Verso 11.5
69

Apostila MP TOTVS Developer Studio 11 5

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Apostila MP TOTVS Developer Studio 11 5

Uploaded by

Copyright:

Available Formats

Todos os direitos autorais reservados pela TOTVS S.A.

Proibida a reproduo total ou parcial, bem como a armazenagem em sistema de recuperao e a

Habilitar o participante nas funcionalidades do ambiente de

TOTVS | Developer Studio

Instalando o TOTVS | Developer Studio ............................................................................................. 6

Iniciando TOTVS | Developer Studio .................................................................................................. 7

Termo de aceite ................................................................................................................................. 7

Trabalhando com reas de Trabalho ou Workspaces .......................................................................... 7

Instalao de adicionais ...................................................................................................................... 8

Perspectivas e Vises ......................................................................................................................... 9

Ajustando as preferncias do TOTVS | Developer Studio .................................................................. 12

Developer Studio Editor ..................................................................................................................... 12

5.2.1. Auto-complete ................................................................................................................................... 13

Developer Studio Help ........................................................................................................................ 15

Developer Studio Robo de Testes ....................................................................................................... 15

Configurao de Servidores TOTVS ..................................................................................................... 15

5.6.1. Acessando a perspectiva TOTVS Server ............................................................................................... 15

Trabalhando com projetos................................................................................................................. 20

Iniciando um projeto .......................................................................................................................... 20

Criando arquivos-fonte ....................................................................................................................... 23

Edio de arquivos-fonte .................................................................................................................... 24

Adio de arquivos de recursos .......................................................................................................... 24

Compilao de arquivos e projetos ..................................................................................................... 24

Compilando Pastas e Projetos ............................................................................................................ 25

TOTVS | Developer Studio Linha de Produto Microsiga Protheus

TOTVS | Developer Studio

Gerenciamento de projetos ................................................................................................................ 26

Execuo de projetos ......................................................................................................................... 27

6.8.1. Bsico ................................................................................................................................................ 27

Depurao de projetos ....................................................................................................................... 31

6.9.1. Viso Debug ....................................................................................................................................... 33

Assistente de Cdigo ......................................................................................................................... 36

Assistente de cdigo: Cadastro ........................................................................................................... 37

Assistente de cdigo: Gerao de Arquivo Texto ................................................................................. 39

Assistente de cdigo: Importao de Arquivo Texto ............................................................................ 42

Assistente de cdigo: Processamento Genrico .................................................................................. 45

Nova Classe Adv/PL ............................................................................................................................ 46

Nova Funo Adv/PL .......................................................................................................................... 47

Novo Fonte WSDL Adv/PL ................................................................................................................... 48

Trabalhando com pacotes de atualizao (patch) .............................................................................. 49

Gerao de pacotes de atualizao (patch) ......................................................................................... 49

8.1.1. Gerao de pacotes de atualizao por Comparao .......................................................................... 50

Aplicao de pacote de atualizao .................................................................................................... 51

Compilao de verso ........................................................................................................................ 53

Desempenho de programas (profile) ................................................................................................. 55

Obtendo perfil (profile) ...................................................................................................................... 55

Analisando perfil ................................................................................................................................ 56

10.2.1. Informaes resumidas ...................................................................................................................... 56

Cobertura de cdigo (coverage code) ................................................................................................ 58

Ativao da cobertura de cdigo ........................................................................................................ 60

Plano de teste .................................................................................................................................... 60

Analisando a cobertura de cdigo....................................................................................................... 61

Monitoramento de servidores ........................................................................................................... 66

Principais comandos do TOTVS | Developer Studio ........................................................................... 68

TOTVS | Developer Studio - Linha de Produto Microsiga Protheus

TOTVS | Developer Studio

Ao trmino do treinamento, o treinando dever ser capaz de:

Conhecer e empregar adequadamente os conceitos e funcionalidades do TOTVS | Developer Studio.

Desenvolvimento de rotinas personalizadas referentes s customizaes em ERPs TOTVS.

TOTVS | Developer Studio Linha de Produto Microsiga Protheus

TOTVS | Developer Studio

TOTVS | Developer Studio - Linha de Produto Microsiga Protheus

TOTVS | Developer Studio

3. Instalando o TOTVS | Developer Studio