256647526-Apostila-MP-TOTVS-Developer-Studio-11-5

Prévia do material em texto

Todos os direitos autorais reservados pela TOTVS S.A. 
 
Proibida a reprodução total ou parcial, bem como a armazenagem em sistema de recuperação e a 
transmissão, de qualquer modo ou por qualquer outro meio, seja este eletrônico, mecânico, de fotocópia, de 
gravação, ou outros, sem prévia autorização por escrito da proprietária. 
 
O desrespeito a essa proibição configura em apropriação 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 
 
Linha de 
Produto 
Microsiga 
Protheus 
11.5 
 
Habilitar o participante nas funcionalidades do ambiente de 
desenvolvimento TOTVS | Developer Studio, abordando suas diversas 
funcionalidades. 
 
 TOTVS | Developer Studio 
 
2 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 
Índice 
 
1. Objetivos ........................................................................................................................................... 4 
2. Introdução ......................................................................................................................................... 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. Instalação de adicionais ...................................................................................................................... 8 
4.4. Perspectivas e Visões ......................................................................................................................... 9 
5. Ajustando as preferências do TOTVS | Developer Studio .................................................................. 12 
5.1. Autorização ........................................................................................................................................ 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. Configurações do servidor .................................................................................................................. 14 
5.3. Developer Studio Help ........................................................................................................................ 15 
5.4. Developer Studio Robo de Testes ....................................................................................................... 15 
5.5. Includes .............................................................................................................................................. 15 
5.6. Configuração 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. Configuração do servidor ................................................................................................................... 18 
5.6.4.1.Inspetor de Objetos ............................................................................................................................ 18 
5.6.4.2.Log do Repositório .............................................................................................................................. 19 
5.6.4.3. Desfragmentar repositório ................................................................................................................. 19 
5.6.5. Selecionando o servidor para a sua utilização ..................................................................................... 19 
6. Trabalhando com projetos ................................................................................................................. 20 
6.1. Iniciando um projeto .......................................................................................................................... 20 
6.2. Criando arquivos-fonte ....................................................................................................................... 23 
6.3. Edição de arquivos-fonte .................................................................................................................... 24 
6.4. Adição de arquivos de recursos .......................................................................................................... 24 
6.5. Compilação de arquivos e projetos ..................................................................................................... 24 
6.6. Compilando Pastas e Projetos ............................................................................................................ 25 
 TOTVS | Developer Studio 
 
 3 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
6.7. Gerenciamento de projetos ................................................................................................................ 26 
6.8. Execução de projetos ......................................................................................................................... 27 
6.8.1. Básico ................................................................................................................................................ 27 
6.8.2. Avançado ........................................................................................................................................... 29 
6.9. Depuração de projetos ....................................................................................................................... 31 
6.9.1. Visão Debug ....................................................................................................................................... 33 
6.9.2. Visão Breakpoint ................................................................................................................................ 34 
6.9.3. Visão Tabela de Dados........................................................................................................................ 34 
6.9.4. Visão Adv/PL Commands .................................................................................................................... 34 
6.9.5. Visão Variables ...................................................................................................................................34 
6.9.6. Visão Expression ................................................................................................................................. 34 
7. Assistente de Código ......................................................................................................................... 36 
7.1. Assistente de código: Cadastro ........................................................................................................... 37 
7.2. Assistente de código: Geração de Arquivo Texto ................................................................................. 39 
7.3. Assistente de código: Importação de Arquivo Texto ............................................................................ 42 
7.4. Assistente de código: Processamento Genérico .................................................................................. 45 
7.5. Nova Classe Adv/PL ............................................................................................................................ 46 
7.6. Nova Função Adv/PL .......................................................................................................................... 47 
7.7. Novo Fonte WSDL Adv/PL ................................................................................................................... 48 
8. Trabalhando com pacotes de atualização (patch) .............................................................................. 49 
8.1. Geração de pacotes de atualização (patch) ......................................................................................... 49 
8.1.1. Geração de pacotes de atualização por Comparação .......................................................................... 50 
8.1.2. Geração de pacotes de atualização por Programa, selecionados a partir do RPO ................................. 50 
8.1.3. Geração de pacotes de atualização por Programa selecionados a partir des Projetos .......................... 51 
8.1.4. Geração de pacotes de atualização por Grupo de Projeto ................................................................... 51 
8.2. Aplicação de pacote de atualização .................................................................................................... 51 
9. Compilação de versão ........................................................................................................................ 53 
10. Desempenho de programas (profile) ................................................................................................. 55 
10.1. Obtendo perfil (profile) ...................................................................................................................... 55 
10.2. Analisando perfil ................................................................................................................................ 56 
10.2.1. Informações resumidas ...................................................................................................................... 56 
10.2.2. Informação detalhada ........................................................................................................................ 57 
11. Cobertura de código (coverage code) ................................................................................................ 58 
11.1. Ativação da cobertura de código ........................................................................................................ 60 
11.2. Plano de teste .................................................................................................................................... 60 
11.3. Analisando a cobertura de código ....................................................................................................... 61 
12. Monitoramento de servidores ........................................................................................................... 66 
13. Principais comandos do TOTVS | Developer Studio ........................................................................... 68 
 
 TOTVS | Developer Studio 
 
4 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 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: 
- Princípios básicos de desenvolvimento de programas usando a plataforma TOTVS. 
 
 Habilidades: 
- Domínio conceitual e prático em desenvolvimento e lógica de programação. 
- Conhecimentos nos ambientes ERP TOTVS, Microsiga Protheus ou outros. 
 
 Técnicas: 
- Operacionalização do ambiente. 
- Desenvolviemento de funcionalidades e/ou customizações em ERPs TOTVS. 
- Aplicação e utilização das funcionalidades da ferramenta. 
 
Ao término 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 customizações em ERPs TOTVS. 
 
 TOTVS | Developer Studio 
 
 5 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
2. Introdução 
 
O TOTVS | Developer Studio é um ambiente de desenvolvimento integrado, que permite ao usuário editar, compilar e depurar 
programas escritos na Linguagem de Programação ADVPL. 
 
Como Ferramenta de Edição possui todos os recursos das ferramentas mais populares, como Cortar e Colar, Levar o Cursor até 
determinada linha do código, Localização e Substituição de Texto, assim como recursos adicionais, como Identificação de 
Código, Inserção de Comentários de Documentação etc. 
 
Como Ferramenta de Debug dispõe de ações como Percorrer Linha, Pular Linha, Executar, Seguir até o Retorno, Pausar 
Execução, Derrubar Client, permitindo ao usuário executar e depurar suas rotinas de dentro de seu ambiente integrado, 
inspecionando o ambiente de execução de suas rotinas por meio de diversas visões contendo informações de depuração, como 
variáveis (divididas entre variáveis locais, variáveis públicas, variáveis privadas e variáveis estáticas), expressões, Tabelas de 
dados, Índices e Campos, Break Points, Programas Registrados (Inspetor de Objetos), Pilha de Chamadas entre outras 
informações. 
 
Além disso, os programas criados são compilados diretamente do TOTVS | Developer Studio, os quais são mantidos em 
Projetos. 
Os Projetos facilitam a compilação de um ou mais projetos de arquivos, utilizando conceitos de Repositórios e Diretivas de 
Compilação, possibilitando inclusive a manutenção de bibliotecas de rotinas do usuário. 
 
O TOTVS | Developer Studio foi construído sob a plataforma Eclipse, que é um ambiente de desenvolvimento de uso geral 
configurável e extensível a várias 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 não conheça o Eclipse passaremos aqui as informações 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 edição de programas, execução, depuração (debug), análise de desempenho, configuração de 
servidores entre outras. Para ativá-las é necessário instalar adicionais ao seu TDS, para as diversas linguagens que a TOTVS 
possui. 
 
http://www.eclipse.org/
 TOTVS | Developer Studio 
 
6 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
3. Instalando o TOTVS | Developer Studio 
 
Diferentemente dos ambientes de desenvolvimento anteriores, o TOTVS | Developer Studio não é disponibilizado em conjuntocom os binários 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 prévia 
instalação de uma Máquina 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. 
 
Máquina Virtual Java (JVM) 
Em ambientes Windows, o instalador do TOTVS | Developer Studio efetuará uma verificação, e se necessário fará atualização 
ou instalação da JVM de forma automática, após confirmação. 
 
Ao acionar o instalador do TOTVS | Developer Studio, este o guiará pelos procedimentos necessários para a instalação. 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 instalação. 
 Leia os termos e condições do licenciamento e selecione a opção que corresponde ao aceite. 
 Selecione o local de instalação. 
 Aguarde o fim da instalação. 
 Ao término da instalação, o ambiente de desenvolvimento estará pronto para ser usado. Para isso, acione o atalho 
no desktop do computador ou no menu de programas. 
 
 
 
 
 
 
 
 
 
Exercício: 
Baixe e Instale o TOTVS | Developer Studio em sua máquina. 
Saiba Mais: 
Para mais informações acesse: 
http://tdn.totvs.com/pages/viewpage.action?pageId=6066171 
 
http://suporte.totvs.com.br/
http://tdn.totvs.com/pages/viewpage.action?pageId=6066171
 TOTVS | Developer Studio 
 
 7 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 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 
específico do TOTVS | Developer Studio. 
Ao utilizar o TOTVS | Developer Studio pela primeira vez é necessário que você esteja cadastrado pela TOTVS para a 
utilização deste software e aceite o termo de utilização. Com isso, no primeiro acesso será apresentada uma tela 
contendo este termo de utilização. Leia-o com atenção e somente se estiver de acordo, preencha os campos 
solicitados, acione a opção 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 contrário será apresentado o motivo da recusa. 
 
 
 
 
4.2. Trabalhando com Áreas de Trabalho ou Workspaces 
 
Após o aceite do termo de utilização, será apresentada uma tela para seleção de uma Área de Trabalho (ou em inglês 
Workspace). O conceito de área de trabalho consiste em um local no qual seus trabalhos podem ser armazenados e/ou 
acessados via ligação simbólica (symbolic link) ou fisicamente. Contém também informações de gerenciamento e 
organização dos fontes e outras informações necessárias ao funcionamento do TOTVS | Developer Studio. 
 
 TOTVS | Developer Studio 
 
8 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
É possível manter quantas áreas de trabalho desejar, organizando seus trabalhos da forma que achar mais confortável 
e natural. Por exemplo, mantendo uma área para cada produto/versão, cliente, projetos pessoais etc. 
Usando as ligações simbólicas (symbolic links) é possível compartilhar diretórios e arquivos, que são comuns a vários 
projetos. 
Ao iniciar o TOTVS | Developer Studio será necessário informar uma workspace. Indique um diretório de workspace ou 
aceite o local padrão. Caso o diretório selecionado não exista, este será criado. 
Logo abaixo do campo workspace existe uma caixa de marcação, a qual é optativa para que seja a sua área de trabalho 
padrão. Se for marcada, na próxima vez em que entrar no TOTVS | Developer Studio, não será solicitado à área. É 
possível alterar de diretório workspace, posteriormente, acessando o menu Arquivo e depois Alterar Workspace. 
Recomenda-se que a área de trabalho seja colocada em diretório diferente do local de instalação do TOTVS | Developer 
Studio. Este procedimento facilitará manter cópias de segurança e futuras atualizações do produto. 
Após a seleção da área de trabalho aguarde alguns instantes enquanto o TOTVS | Developer Studio é inicializado e 
apresente a tela de boas-vindas. 
 
 
4.3. Instalação de adicionais 
 
Após os procedimentos acima, o TOTVS | Developer Studio estará inicializado, porém falta a instalação de um 
adicional específico para a linguagem de programação 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 questão, conterá informações sobre cada uma das linguagens de 
programação TOTVS, suas janelas, especificações entre outras informações. 
 
Para esta instalação acesse o Gerenciador de Atualizações 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 instalação do adicional. 
 TOTVS | Developer Studio 
 
 9 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
Tomaremos como exemplo, que desejamos desenvolver aplicativos utilizando a linguagem de programação Adv/PL da 
TOTVS. 
Para isso, no campo Work With (item A na imagem a seguir), informe (digitando ou colando) o endereço 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 seleção dos adicionais desejados. No caso selecione a raiz da árvore, ou seja, Adv/PL. 
Acione Avançar (item C na imagem a seguir), aceite o termo de utilização e siga as instruções do Gerenciador de 
Atualizações. 
 
Ao finalizar a instalação e reiniciar o TOTVS | Developer Studio teremos um ambiente pronto para a programação em 
Adv/PL da TOTVS. 
 
 
 
 
 
 
 
 
4.4. Perspectivas e Visões 
 
As funcionalidades adicionadas ou estendidas por meio dos adicionais (plugins) no caso acima de Adv/PL são agrupadas 
em perspectivas. As perspectivas são configurações pré-definidas, que podem ser customizadas posteriormente pelo 
usuário desenvolvedor, e que permite de uma forma rápida, modificar o seu ponto de vista (perspectiva) em relação ao 
trabalho que esta sendo executado ou que será necessário fazer. 
 
Cada perspectiva terá uma ou mais visões, que se relacionam de alguma forma entre si e com o trabalho a ser 
executado. As visões são janelas acopláveis (do inglês dockable) que adicionam funcionalidades ou informações à 
perspectiva que a contém. 
 
É possível selecionar ou mudar de uma perspectiva utilizando as opções disponíveis por meio dos botões e ícones de 
seleção, presentes na barra de ferramentas ou acessando o menu: Janela | Abrir perspectiva | Outros 
Importante: 
O processo de instalação de adicionais é semelhante a todas as linguagens suportadas (Adv/PL, 4GL e 
4GLP), mudando apenas os endereços em que os adicionais estão disponíveis. Acesse 
http://ds.totvs.com para obter a lista dos endereços e mais informações. 
 
http://ds.totvs.com/updates/advpl
http://ds.totvs.com/
http://ds.totvs.com/
 TOTVS | Developer Studio 
 
10 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
 
Também é possível selecionar diretamente na barra de perspectivas, como na imagem a seguir no item A. 
 
 
 
Como exemplo, ao instalar o adicional da linguagem de programação Adv/PL no TOTVS | Developer Studio, ele virá com 
as perspectivas básicas para o desenvolvedor de produtos TOTVS em Adv/PL, cuja perspectiva conterá diversas visões 
específicas para o ambiente de desenvolvimentoda Linha de Produto Microsiga Protheus. 
 
Para entendermos melhor esses conceitos abra o TOTVS | Developer Studio. A perspectiva inicial é a de Informações 
(ou em inglês Resources). Para melhor visualização acesse a seleção de perspectivas (conforme citado acima) e 
selecione a perspectiva Totvs Developer. Esta é a perspectiva que reordenará as visões de acordo com o adicional para 
a linguagem de programação 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 rápido etc. 
 
No TOTVS | Developer Studio utilizaremos 4 perspectivas principais na maior parte do tempo, sendo elas: 
 TOTVS Developer: responsável pela organização e disposição das principais funcionalidades relacionadas ao 
desenvolvimento de projetos e programas. 
 TOTVS Servers: responsável pela organização e disposição do cadastro e suas funcionalidades, assim como o 
monitoramento de servidores de aplicação TOTVS. 
 Debug: responsável por servir funcionalidades e informações acerca do debug/deburação de programas. 
 TOTVS Store: responsável pela organização e integração do TOTVS | Developer Studio com a TOTVS | Store. 
 
 
 
http://www.dicio.com.br/utilizaremos/
 TOTVS | Developer Studio 
 
 11 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Importante: 
Visão ou Janela acoplável (dockable) permite a configuração visual da forma que for mais 
conveniente. Arraste uma das visões que estão em abas informativas e verá que, conforme for se 
movimentando pela tela aparecerá um quadro pontilhado indicando onde será acoplada se soltar 
o botão do mouse. 
Exercício: 
Instale o adicional para programação em Adv/PL TOTVS em seu TOTVS | Developer Studio. 
Verifique a perspectiva TOTVS Developer e as suas visões. 
 TOTVS | Developer Studio 
 
12 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
5. Ajustando as preferências do TOTVS | Developer Studio 
 
O TOTVS | Developer Studio possui alguns comportamentos que podem ser configurados pelo usuário, de acordo com suas 
preferências ou ainda, ajudá-lo no seu dia a dia. 
Acione o menu Janela, opção Preferências, obtendo uma tela semelhante a: 
 
 
 
Na árvore de navegação (à esquerda) temos vários grupos de opções a serem explorados. Aqui, abordamos apenas as opções 
específicas do TOTVS | Developer Studio. 
 
 
 
 
 
 
 
 
 
5.1. Autorização 
 
Tela de preferência para informar a chave especial de compilação para fontes AdvPL. 
 
5.2. Developer Studio Editor 
 
Ao acionar o nó Developer Studio Editor serão exibidas as preferências gerais, permitindo assim as configurações sobre 
o comportamento do editor. 
 Salva fonte automaticamente antes de compilar - se ativada, ao compilar os fontes sofrerá edição desde a 
última compilação. Serão salvos sem solicitar confirmação. 
 Habilitar auto-aspas - se ativada, ao ser digitado “ (aspas duplas), ' (aspas simples), [ (colchetes), ( 
(parênteses), { (chaves) ou | (barra vertical), o editor irá inserir o seu equivalente para fechá-lo. 
Importante: 
Os grupos podem variar bastante de instalação para instalação, em função de pacotes adicionais (plug-ins) 
instalados. Cada adicional terá alguns grupos a mais, consulte a documentação de cada adicional para mais 
detalhes. 
 TOTVS | Developer Studio 
 
 13 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
 Tamanho da listas de arquivos recentemente abertos - informe a quantidade de arquivos que será mantida 
no histórico de arquivos recentes. 
 Mostrar várias guias do editor - se ativada apresentará diversas guias de apoio ao usuário, tais como linhas 
modificadas, limites de blocos de códigos entre outras. 
 Permitir editores de sistema no local - se ativada, o editor registrado no sistema será acionado para arquivos 
com extensões não 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 série de informações, tais como, arquivos abertos, diretórios expandidos na árvore de projeto, arquivo 
corrente entre outras. Ao iniciar o TOTVS | Developer Studio novamente, estes dados serão recuperados e a 
tela será reconstituída da mesma forma que você a deixou. 
 Fechar editores automaticamente - se ativo, quando a quantidade de editores abertos (arquivos em edição) 
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 (opções configuradas em Quando todos os 
editores estiverem sujos (editados) ou travados). 
 
Dentro deste grupo é possível efetuar configurações específicas para alguns processos. 
 
 
5.2.1. Auto-complete 
 
Configure a abrangência que será utilizada na obtenção de opções para seleção no autocompletar (control + barra de 
espaço). 
 
 
 
 
 
 
 Desabilitar pesquisa de funções/classes no RPO - ao ativar, o RPO será desprezado como fonte de propostas. 
 Pesquisa funções/classes do RPO (Sintaxe Highligh e Auto complete) - se ativada irá pesquisar todo o RPO 
para destacar sintaxe como fonte de propostas. 
 Pesquisa funções/classes do RPO (Auto complete) - se ativada irá pesquisar todo o RPO como fonte de 
propostas. Em máquinas não potentes, este processo pode ser bastante lento. Para minimizar esta situação 
indique o número mínimo de caracteres digitados necessários para que o autocompletar seja ativado. 
 
5.2.2. Decorator AdvPL 
 
Além da decoração tradicional (marcas de erro, avisos entre outras) é possível habilitar um indicador de arquivos não 
compilados no RPO em uso pelo ambiente selecionado, basta ativar a opção Marca arquivos que não estão 
compilados no RPO. 
 
 
 
 
Importante: 
O autocompletar utiliza somente a fonte corrente e opções de templates, como fonte de opções da 
lista. Esta configuração agrega maior abrangência. 
Importante: 
Este processo pode ser demorado. 
 TOTVS | Developer Studio 
 
14 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
5.2.3. Performance 
 
Em máquinas menos potentes, a edição 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 não aconteça. 
 
5.2.4. Modelos 
 
Nesta página é possível consultar, manter ou criar modelos de códigos, que serão apresentados como opção na lista 
de propostas ao acionar o autocompletar (control + barra de espaços). 
 
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 compilação - se ativado, depois da compilação gera o arquivo de pré-processamento 
(extensão PPO). 
 Exibir conteúdo do AdvplASP progressivamente no browser - se ativado, os programas escritos em AdvplASP 
irão enviar dados ao navegador (browser) durante o processamento desde o ínicio e não só ao final (padrão). 
 Incluir informações de depuração em AdvplASP -se ativado, incorpora aos programas escritos em AdvplASP 
informações adicionais para sua depuração. 
 Visualizar PreComp CommandLine Result - se ativo, apresenta em console a linha de comando e o resultado 
do processamento do pré-compilador. 
 
 
5.2.7. Configurações do servidor 
 
 Tempo de verificação de conexão do TOTVSAPPSERVER (segundos) - se preenchido, indica qual o intervalo 
(em segundos) para que o TOTVS | Developer Studio verifique se a conexão com o servidor TOTVSAPPSERVER 
ainda esta ativa ou não. 
 Tempo de verificação de conexão do TOTVSDBACCESS (segundos) - se preenchido, indica qual o intervalo (em 
segundos) para que o TOTVS | Developer Studio verifique se a conexão com o servidor TOTVSDBACCESS 
ainda esta ativa ou não. 
 Tempo de atualização do AdvPL Monitor (segundos) - se preenchido, indica qual o intervalo (em segundos) 
para que o TOTVS | Developer Studio solicite ao servidor informações sobre atividades em execução. 
 Velocidade de Atualização das Infos do Monitor DBAccess - se preenchido, indica qual a frequência para que 
o TOTVS | Developer Studio solicite ao servidor DBAccess informações sobre suas atividades. 
 
 TOTVS | Developer Studio 
 
 15 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 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 configurações internas para gerações de patch. 
 
5.5. Includes 
 
Permite configurações de arquivos de includes globais para serem adicionados aos projetos TOTVS. 
 
 
5.6. Configuração de Servidores TOTVS 
 
Para a adição de servidores TOTVS utilize a perspectiva TOTVS Server. Esta perspectiva reúne 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 
visões, porém se destacam: 
 Visão Servers Extension – localizada por padrão à esquerda do TDS, podemos definir quais servidores vamos 
utilizar, permitindo também, efetuar configurações e obter informações sobre o processamento (quando 
disponível). 
 Visão TOTVS Server Outline – localizada por padrão à direita do TDS, permite uma navegação rápida entre as 
opções/abas de configuração de um servidor previamente selecionado. 
 Visões informativas – geralmente localizadas na parte inferior do TDS, contêm algumas visões (views) com 
informações adicionais sobre o servidor, tais como usuários conectados e pelo menu de contexto desta, 
algumas operações com o servidor. 
 TOTVS | Developer Studio 
 
16 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
Na imagem acima temos a perspectiva TOTVS Servers. No item A temos a visão Servers Extension, no item B temos a 
visão TOTVS Server Outline e no item C temos a visões informativas, entre estas temos a visão TOTVS Application 
Monitor e TOTVS DBAccess Monitor, respectivamente, as visões de monitoramento de servidores TOTVS e 
servidores DBAccess. 
 
Para acessar as diversas ações disponíveis em servidores TOVS acione o menu de contexto sobre o elemento 
Servidores da visão Servers Extension, item A da imagem acima. Entre as diversas opções estão: 
 
Opção Descrição da função 
Novo Grupo de Servidores Permite criar um elemento na árvore que agrupa servidores. 
Servidor de Aplicação Apresenta a lista de tipos de servidores disponíveis. 
Servidor 4GL Inicia a configuração de um servidor com suporte a 4GL. 
Servidor 4GLP Inicia a configuração de um servidor com suporte a 4GLP. 
Servidor Adv/PL Inicia a configuração de um servidor com suporte a Adv/PL. 
Servidor DBAccess Apresenta a lista de tipos de servidores disponíveis. 
Servidor DBAccess Inicia a configuração de um servidor DBAccess. 
Conexões ativas 
Força uma atualização das abas informativas para os servidores 
conectados. 
 
 
 
 
 TOTVS | Developer Studio 
 
 17 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
 
 
 
 
 
 
5.6.2. Adicionando um servidor 
 
Para adicionar um servidor acione o menu de contexto sobre o elemento Servidores da árvore de navegação da 
visão Server Extension, acione a opção Servidor de Aplicação | 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. 
 
 
 
É possível editar ou corrigir os dados de conexão deste servidor, modificando os dados disponíveis nas páginas (na 
parte de baixo da visão) e acionando a opção 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 opções: 
 
Opção Descrição da função 
Conectar Servidor Conecta-se ao servidor conforme as informações constantes na configuração. 
Remover Remove as configurações do servidor, tornando-o inacessível. 
 
Importante: 
As opções acima podem variar de acordo com os adicionais instalados, por exemplo, caso tenha 
instalado somente o adicional Adv/PL na opção Servidor de Aplicação acima, só terá disponível o 
Servidor Adv/PL. Para outros servidores de aplicação é necessária a instalação de um adicional 
específico. 
 TOTVS | Developer Studio 
 
18 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
5.6.3. Conectando-se ao servidor 
 
Após a configuração de um servidor acione o menu de contexto sobre o elemento na árvore de navegação e acione a 
opção Conectar Servidor. 
Os servidores com suporte a Adv/PL irão solicitar algumas informações antes de efetuar a conexão. Informe os dados 
solicitados. Se desejar, pode salvar o Usuário e Senha em um local seguro acionando a opção Salvar as informações 
de login em local seguro. 
 
 
 
 
 
Após efetuar a conexão com o servidor, o menu de contexto do servidor passará a conter algumas outras opções: 
 
Opção Descrição da função 
Desconectar Servidor Encerra a conexão com o servidor. 
Conexões ativas Força uma atualização das abas informativas para os servidores conectados. 
Para o Servidor Envia ao servidor um comando de parada (shutdown). 
Desabilita conexão Envia ao servidor um comando para rejeitar novas conexões. 
 
 
5.6.4. Configuração do servidor 
 
Após a conexão clique duas vezes sobre o servidor previamente cadastrado e obtenha informações sobre o servidor 
em questão. Estas informações serão apresentadas à área de editores, que serão as configurações do servidor 
oriundas do arquivo appserver.ini. 
Ao cessar qualquer uma das páginas disponíveis é possível efetuar modificações de configuração, e ao salvar as 
modificações, estas serão persistidas no arquivo ini do servidor. Pode-se salvar a qualquer momento ao acionar a 
tecla de atalho CTRL + S. 
 
 
 
 
 
 
 
Além de todas as configurações do servidor, nessa tela temos três grandes funcionalidades, Inspetor de Objetos, Log 
de Repositório e Desfragmentar Repositório. 
 
5.6.4.1. Inspetor de Objetos 
 
Esta funcionalidade é utilizada para visualizar todos os Programas (Funções), 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 botão 
Inspetor de Objetos. Verifique se será iniciado o carregamento do RPO. 
Importante: 
Durante e depois do processo de conexão acompanhe as ocorrências na visão console (geralmente 
localizada na parte inferior do TDS). 
Importante: 
 Para saber como configurar e o que configurar em cada um dos servidores 
consulte a documentação específica. 
 TOTVS | Developer Studio19 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
Em seguida, será apresentada uma lista com todos os arquivos fontes, contendo funções, arquivos HTML, ADVPL-
ASP e imagens, que se encontram compilados no RPO em uso. 
 
 
5.6.4.2. Log do Repositório 
 
Utilizado para visualizar todo o histórico sobre o RPO em uso, poderemos por meio desta opção visualizar as datas 
dos últimos patches aplicados, o conteúdo dos patches e a data da build utilizada. 
Para acessar o Log do repositório selecione a aba Environment. Selecione um ambiente e clique no botão Log do 
Repositório. 
No lado esquerdo da tela visualizamos o histórico dos patches aplicados. Quando selecionarmos um dos registros, 
no lado direito da tela será informada mais detalhadamente a data de geração e aplicação da patch, juntamente 
com o conteúdo dela e a data da build. 
 
 
5.6.4.3. Desfragmentar repositório 
 
Utilizado para desfragmentar repositório do servidor e ambiente selecionado. Para acessar selecione a aba 
Environment. Selecione um ambiente e clique no botão Desfragmentar repositório. 
 
 
 
 
 
 
 
 
 
 
5.6.5. Selecionando o servidor para a sua utilização 
 
Após o cadastro, a configuração e a conexão de um servidor TOTVS têm que selecionar um servidor para utilização 
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). 
 
 
 
 
 
 
Exercício: 
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 informações do servidor. 
Altere alguma informação e salve-a. 
Importante: 
É necessário ter acesso exclusivo ao repositório para desfragmentá-lo. Esse processo irá reduzir o 
tamanho do repositório reescrevendo-o e eliminando o espaço ocupado por rotinas antigas. Este 
processo pode demorar alguns momentos para ser executado. 
 TOTVS | Developer Studio 
 
20 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
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 organização inicial de um trabalho no TOTVS | Developer Studio é o projeto. Em cada área de trabalho (workspace) é 
possível colocar quantos projetos desejar e fazer a administração por meio da visão TOTVS Explorer. 
Logo abaixo do título da aba e da barra de ferramentas acione o menu de contexto e nas opções apresentadas acione 
Novo | Outras ou Importar. Será apresentado o assistente de novos elementos ou assistente de importação (conforme 
a opção utilizada). 
Utilizando a árvore de navegação localize TOTVS Wizard, expanda-o e obterá as opções: 
• 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 básica. 
 
 
 
 
 TOTVS | Developer Studio 
 
 21 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
 
 
 
 
 
Selecione a melhor opção e prossiga com a execução 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 botão direito, porém estes projetos devem estar sob o mesmo diretório. 
 Indique se quer ou não importa-lo como um novo projeto (item B). Caso desmarque esta opção deverá 
selecionar o Destino deste projeto. 
 Indique o método de importação (item C). Entre os métodos disponíveis estão: 
- Manter os fontes no diretório de origem (legado) – Ao utilizar esta opção, as pastas (folders) e 
arquivos serão anexadas ao projeto TOVS por meio de uma ligação simbólica (symbolic link), ou 
seja, os arquivos continuam nos diretórios de origem e uma referência a ele é criada. Qualquer 
edição efetuada, usando-se o TDS ou qualquer outro editor externo será refletida em ambos os 
ambientes. Como trata-se de uma ligação simbólica, ao acionar a remoção será apagado apenas a 
referência e não o arquivo físico. 
Importante: 
Arquivos de projeto (*.prj) são utilizados no DevStudio (antigo IDE da Linha de Produto Microsiga 
Protheus). O arquivo de projeto (*.prj) é utilizado somente no momento da importação. Qualquer 
modificação posterior neste arquivo, não será refletida no projeto importado para o TDS e vice-versa. 
 
 TOTVS | Developer Studio 
 
22 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
- Copiar arquivos para a area de trabalho do TDS – Esta opção efetua uma cópia física das pastas 
(folders) e arquivos referenciados pelo arquivo de projeto (*.prj) para dentro da área de trabalho 
(workspace) em uso. Neste caso, qualquer alteração efetuada em uma das cópias, não será 
refletida no outro ambiente. 
 Em Diretórios para Busca (item D) - Adicione os diretórios que deverão ser pesquisados para resolução de 
arquivos de definições (*.ch) que são referenciados nos fontes. Ao lado direito temos os botões para efetuar 
estas operações. Além disso, é possível adicionar referência às outras configurações desta lista de busca 
(item E), que será utilizada juntamente com as outras. Para detalhes, veja Configuração de diretórios de 
busca. 
 Finalize a edição e aguarde o processamento. Ao final obterá mais um novo projeto TOTVS. Na visão 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 sugestão de 
estrutura de pastas (folders). 
 
 
 
Para isso, no wizard será necessário informar os seguintes dados: 
 Informe o nome do projeto (item A). 
 Em Diretórios para Busca (item B) adicione os diretórios que deverão ser pesquisados para resolução de 
arquivos de definições (*.ch) que são referenciados nos fontes. Ao lado direito temos os botões para efetuar 
estas operações. Além disso, é possível adicionar referência às outras configurações desta lista de busca 
(item C), que será utilizada juntamente com os que informar. Para detalhes veja Configuração de diretórios 
de busca. 
 
 
 
 
 
 
Exercício: 
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. 
 TOTVS | Developer Studio 
 
 23 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 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 criação de arquivo fonte, o TOTVS | Developer Studio disponibiliza um assistente de criação. Acione o menu de 
contexto na visão TOTVS Explorer, acessando a opção Novo | Arquivo. É possível também acessar o menu Arquivo | 
Novo, selecione a opção Outros. Faça a expansão das opções de criação de fontes da TOTVS. 
Neste assistente estarão disponíveis diversos tipos de arquivos-fontes TOTVS. Selecione um deles, uma pasta estará 
disponível por padrão, porém se quiser modificar o local, utilize a árvore de navegação 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 botão Avançado>>, que se acionado apresentará a opção para criar uma ligação simbólica 
(symbolic link) com um arquivo já existente do seu sistema de arquivos. Se desejar criar como ligação simbólica marque 
a opçãoLink to file in the file system e selecione o arquivo acionando o botão 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 ligação simbólica, o arquivo já aparecerá com o conteúdo e o ícone terá uma 
pequena seta a sua direita. Lembre-se que neste caso, todas as alterações que efetuar serão gravadas 
no arquivo fonte original. 
 
 TOTVS | Developer Studio 
 
24 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
6.3. Edição de arquivos-fonte 
 
Durante a edição do arquivo fonte, a visão Outline será atualizada com a identificação 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 visão TOTVS Explorer é possível também obter a lista dos principais blocos, se expandir o elemento (click no 
triângulo vazado). 
A edição de arquivos-fontes é bem simples. Localize na árvore de navegação do TOTVS Explorer o arquivo desejado e 
efetue um duplo clique ou acione o menu de contexto sobre o arquivo e a opção Abrir. 
 
 
 
 
6.4. Adição de arquivos de recursos 
 
Extensões que não são reconhecidas como de arquivos-fontes pelo TOTVS | Developer Studio, por exemplo, a extensão 
.bmp (arquivo de imagem), este arquivo é adicionado como recurso e ao ser compilado será anexado como tal, sendo 
possível acessá-lo com o uso de funções específicas da linguagem. 
 
 
6.5. Compilação de arquivos e projetos 
 
Antes de efetuar a compilação de um arquivo, pasta ou projeto é necessário estar conectado a um servidor (veja 
Perspectiva TOTVS Server), na barra de ferramentas é necessário 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 navegação). 
O referido fonte será compilado e na visão console (uma das abas informativas) obteremos informações relativas à 
compilação, tais como, se foi ou não bem sucedida, e neste caso, os motivos. 
A visão TOTVS Explorer, também informa se há problemas de compilação, colocando um pequeno sinal indicativo. 
Neste caso, também será indicada na área do editor à linha que esta com erro (item A da imagem a seguir). Ao passar o 
mouse sobre esta marca obtêm-se uma janela popup indicando o erro. 
 
 TOTVS | Developer Studio 
 
 25 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
No lado oposto temos uma barra indicativa, que na sua altura, representa o seu arquivo fonte e a as marcações 
existentes indicam o local relativo de erro (item B). Ao clicar nesta marca, o editor será posicionado nesta posição. 
Esta barra também pode conter outras indicações baseadas em cor, indicando alguma ocorrência, por exemplo, avisos 
do compilador e mudanças ocorridas. 
Na área de abas informativas temos a visão Problemas, que possui uma lista de todas as ocorrências da compilação, 
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. 
 
 
 
 
 
 
 
 
 
 
 
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 
navegação da visão TOTVS Explorer e acione a uma das seguintes opções: 
 Recompilar – Recompila todos os elementos do projeto ou pasta (folder). 
 Compilar - compila todos os elementos do projeto ou pasta que foram modificados ou que não existam no 
repositório (RPO). Nesta opção, os arquivos que não sofreram alterações serão ignorados (ou skiped). 
 
Como estes processos podem levar algum tempo será aberta a visão Progresso, que efetuará o processamento em 
paralelo e mostrará o resultado da execução da tarefa ao ser executada. 
 
 
 
 
 
 
 
Importante: 
Para ativar a numeração de linhas e outros comportamentos do editor acione o menu de contexto do editor, 
acesse a opção Preferências e depois Show Line Numbers. 
Importante: 
A visão Progresso é utilizada em diversas situações, normalmente naquelas que podem demandar algum 
tempo de processamento. 
 TOTVS | Developer Studio 
 
26 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
 
 
 
 
6.7. Gerenciamento de projetos 
 
Na aba TOTVS Explorer, utilizando o menu de contexto é possível gerenciar seus projetos. As opções do menu de 
contexto dependerão do item da árvore de navegação que for selecionado. 
 
Para identificação temos os seguintes ícones: 
 Identifica projetos TOTVS. 
 Identifica pastas ou subpastas de projetos TOTVS. 
 Identifica arquivos-fontes TOTVS. Arquivos-fontes linkados terão uma seta inferior à direita. 
 
O menu de contexto para projetos TOTVS será (verifique na coluna se aplica à): 
 
Aplica-se à Opção Descrição da Função: 
 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 título. 
 Copiar (ou CTRL+C) Copiar o elemento para a área de transferência. 
 Colar (ou CTRL+V) Colar o conteúdo transferência (clipboard). 
Remover (ou DELETE) Remove o elemento da árvore. 
Renomear (ou F2) Modifica o nome do elemento. 
Importar... Inicia o assistente de importação. 
Exportar... Inicia o assistente de exportação. 
Atualizar (ou F5) Atualiza a árvore de navegação. 
 Atualizar definição 
WSDL 
No caso de arquivo fonte conter uma definição de cliente de 
web-service, será reprocessado. 
 Fechar Projeto Fecha o projeto, mas mantém o elemento. 
Fechar Projetos não 
relacionados 
Fecha todos os projetos não 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 
execucação... 
Permite editar as configurações de execução. 
Depurar como... Permite executar o projeto em modo de depuração (debug). 
Configurar 
depuração... 
Permite editar a configurações de depuração. 
Exercício: 
Compile os projetos criados no exercício anterior. Visualize a ocorrência de possíveis erros e mensagens 
informativas. 
 
 
 TOTVS | Developer Studio 
 
 27 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
Equipe Opção que permite gerenciar trabalhos em equipe. 
Comparar com... Inicia o processo de comparação entre elementos. 
Restaurar do 
histórico local... 
Permite recuperar versões anteriores a partir do histórico local. 
Fonte Subopções relacionadas às fontes de projeto. 
Formatar Executa a formatação de arquivos-fontes 
Propriedades (ou 
ALTER+ENTER) 
Apresenta uma janela com informações sobre o elemento. 
 
 
6.8. Execução de projetos 
 
6.8.1. Básico 
 
Uma vez que o projeto esteja compilado e sem erros é possível executá-lo (run) ou depurar (debug) seus 
programas. Tanto a execução como a depuração é realizada por meio de configurações de executores (ou lauchers). 
Para configurá-los acione o menu suspenso do botão Executar ou Depurar, selecionando a opção Configuração... 
(em inglês Run Configurations...). 
 
 
Na janela de configuração é possível adicionar, duplicar e remover executores. Selecione a opção TOTVS Launcher e 
acione a opção Novo na barra de ferramentas (item A da imagem a seguir). 
 
 
 
Na tela apresentada temos os campos: 
 Nome: informe umidentificador para o novo executor (item A da imagem a seguir). 
 
 
No bloco Ambiente de execução (item B da imagem a seguir), com: 
 TOTVS | Developer Studio 
 
28 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 Utilizar servidor de aplicação interno: se estiver marcado exige o uso de um servidor interno configurado e 
será utilizado o executável do SmartClient (remote) que encontra-se na instalação do TOTVS | Developer 
Studio. 
 Executável do Remote: informe ou selecione o caminho do executável do remote SmartClient TOTVS. 
 Parametros do remote: informe os parâmetros da linha de comando que será utilizada na execução do 
SmartClient (remote). 
 Programa Inicial: informe o nome do programa que será executado (programa principal). Pode-se deixar 
esta opção em branco, neste caso quando houver a execução ou depuração será necessário informar o 
programa inicial. 
 Parametros do programa: informe os parâmetros de execução e/ou depuração requisitaos pelo programa 
inicial. Pode-se deixar esta opção em branco, neste caso quando houver execução ou depuração será 
necessário informar os parametros do programa inicial. 
 Habilita profile de execução: se marcado, ao final da execução será apresentados os resultados do profile 
desta execução. 
 
Para salvar as configurações e continuar a edição acione Aplicar ou se desejar cancelar as alterações efetuadas 
acione Reverter. Ao informar os dados mínimos necessários, o botão Executar será habilitado e se acionado, 
iniciará a execução. O botão Fechar encerra a edição. 
Se solicitar a execução pelo acionamento do botão Executar ou pelo menu suspenso dos botões Executar ou 
Depurar será apresentada a tela de confirmação. 
Na caixa suspensa informe o nome do programa a ser executado. 
Caso o campo Programa Inicial seja preenchido, será usado como valor padrão para a caixa suspensa. 
 
 
 
 TOTVS | Developer Studio 
 
 29 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
Depois de criar e usar um executor poderá acioná-lo diretamente pelo menu suspenso dos botões Executar ou 
Depurar, selecionando a configuração ou utilizando as teclas de atalho F11 e Ctrl+F11, para executar a última 
configuração utilizada para depurar ou executar (respectivamente). 
 
 
6.8.2. Avançado 
 
Na configuração avançada, utilizamos as demais abas com opções específicas. 
A aba Cobertura de Código (ou em inglês Coverage) permite habilitar a cobertura do código nos fontes. Para isso, 
marque a opção Habilitar cobertura de código (item A da imagem a seguir) e utilizando os botões à direita (item B 
da imagem a seguir), informe os fontes que serão analisados. 
 
 
 
Na aba Fontes (ou em inglês Source) informe onde o depurador deve procurar os fontes (item A da imagem a 
seguir), sendo o padrão o seu projeto. Utilize os botões à direita, para adicionar outros diretórios para a busca (item 
B da imagem a seguir). 
 TOTVS | Developer Studio 
 
30 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
A aba Comun (ou em inglês Common), contém algumas opções de configuração da visibilidade e outras opções 
ligadas diretamente à configuração do executor. Estas opções raramente serão modificadas. 
 
 
 
Nesta aba temos: 
 Salvar como (item A da imagem acima): indique se os dados de configuração serão salvos localmente (no 
seu workspace) ou em área compartilhada (externa). 
 Apresentar como favorito (item B da imagem acima): indique em qual menu suspenso a configuração deve 
aparecer. Caso não selecione nenhuma, esta será apresentada em todos os menus suspensos. 
 Encoding (item C da imagem acima), permite definir o formato da codificação do arquivo de configuração. 
 Entrada e saída padrão (item D da imagem acima), permite configurar a apresentação ou não da visão 
console ou a sua gravação em arquivo. 
 
 TOTVS | Developer Studio 
 
 31 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
6.9. Depuração de projetos 
 
A configuração do executor (laucher) com depuração é exatamente o mesmo utilizado na execução, portanto, o 
executor configurado poderá ser utilizado tanto na execução como na depuração de projetos. 
 
 
 
 
 
 
 
Para demonstrar o uso do depurador com pontos de parada e outras funcionalidades usaremos o programa abaixo 
e passaremos passo a passo pela depuração 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 
 
 
Após a compilação do arquivo fonte acima, execute-o acionando o botão Executar (se necessário configure um 
executor). Após encerrar a execução e com o editor ativo (a aba fica destacada), acione Ctrl+F10 e ative a 
numeração de linhas. 
 
 
Importante: 
Caso tenha efetuado a configuração do executor, já possuirá a mesma configuração para a depuração. 
 TOTVS | Developer Studio 
 
32 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
Efetue um duplo clique sobre o número 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 
característica do ponto de parada perto do número 6. 
 
 
 
 
 
 
 
 
 
 
 
 
Inicie o depurador acessando o botão do menu suspenso Depurar (botão 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, não é a mais indicada para depuração será sugerido à troca para a 
perspectiva TOTVS Debuger. Aceite a troca e a perspectiva de depuração chamada Debug que será apresentada. 
Importante: 
Quando iniciarmos a depuração, o depurador irá parar a execução nos pontos de parada que tiverem 
sido atribuídos ao arquivo fonte e aguardará instruções do desenvolvedor. No caso em que o arquivo 
fonte não possua pontos de parada, a depuração não irá parar em nenhum momento. 
 
 TOTVS | Developer Studio 
 
 33 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
 
 
 
 
 
 
Na perspectiva de depuração (debug) teremos diversas novas visões, entre elas as Visões Debug, Breakpoint, 
Adv/PL Commands, Tabela de Dados, Variables, Expression entre outras. Existem diversas abas informativas que 
dão apoio ao desenvolvedor no momento de depuração. 
Abaixo detalharemos as principais visões. 
 
 
6.9.1. Visão Debug 
 
A visão Debug apresenta a pilha de execução, indicando o caminho efetuado até chegar ao ponto de parada. 
 
Teremos na barra de ferramentas desta visão, as seguintes funcionalidades: 
 Remove o histórico de execução já finalizada (item 1). 
 Continua a execução até encontrar um novo ponto parado ou o término do programa (item 2). 
 Pausa a execução (item 3). 
 Encerra a execução (item 4). 
 Executa um passo, se for chamada de método ou função, para na primeira instrução desta (item 5). 
 Executa um passo, se for chamada de método ou função, execute-a sem parar dentro desta (item 6). 
Importante: 
A linha corrente em que a depuração estiver parada ficará destacada das demais linhas. 
 TOTVS | Developer Studio 
 
34 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 Executa até finalizar (retornar) do método ou função (item 7). 
 
6.9.2. Visão BreakpointA visão Breakpoint apresenta a lista de pontos de paradas (ou em inglês Breakpoint), definida nos projetos que 
estão em aberto no workspace. 
 
 
 
Temos na barra de ferramentas desta visão 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). 
 
 
 
 
 
6.9.3. Visão Tabela de Dados 
 
A visão Tabela de dados apresenta as tabelas da Linha de Produto Microsiga Protheus abertas durante o 
processamento da depuração. Esta visão não possui funcionalidades, servindo para auxiliar no acesso e consulta às 
tabelas e campos abertos. 
 
6.9.4. Visão Adv/PL Commands 
 
A visão Adv/PL commands permite ao desenvolvedor realizar os comandos Adv/PL em tempo de execução com 
resposta imediata. 
 
6.9.5. Visão Variables 
 
A visão de Variables permite verificar os valores das variáveis declaradas no programa que foi depurado. Por meio 
da barra de ferramentas desta visão é possível configurar a visibilidade, baseada em escopo, das variáveis que serão 
apresentadas. 
 
6.9.6. Visão Expression 
 
A Visão de Expressions permite definir expressões que são avaliadas a cada passo. 
Voltando ao nosso processo de depuração, neste momento estamos parados na linha 6 do calcFatorial. Acione F5 
para executar um passo. 
Importante: 
Ao clicar na definição de um ponto de parada, o desenvolvedor será levado até o ponto em que o ponto de 
parada foi definido. 
 
 TOTVS | Developer Studio 
 
 35 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
Repare que na linha 8, do lado esquerdo há uma pequena seta azul, indicando a próxima linha a ser executada. 
Acione F5, até que seja possível entrar na função calcula. 
Repare que a visão Variáveis teve seu conteúdo atualizado. Estando dentro de um método ou função, se acionar F7 
a execução prosseguirá, parando somente quando sair do método ou função. Neste exemplo, o depurador vai 
executar toda a função calcula, parando somente na linha 10 (logo após a chamada). 
É possível também adicionar pontos de parada a qualquer momento, efetuando um duplo clique sobre o número 
da linha. Faça isso na linha 26. 
Acionando F8 (continuar execução), o processamento irá ser executado até o próximo ponto de parada, nesse caso 
será o ponto de parada na linha 26. Acione o F8 para continuar a execução. 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Exercício: 
Crie um arquivo fonte contendo o código do exemplo de depuração: 
 
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. Após a execução, coloque alguns pontos de parada pelo código 
fonte. 
 Veja as diveras visões da perspectiva Debug. Execute alguns comandos via visão Adv/PL Commands. 
 Adicione as variáveis n e x à visão Variável. 
Depure o arquivo fonte acima e veja o resultado ao percorrer a depuração do arquivo. Lembre-se 
das teclas de atalho, F5, F6, F7 e F8, estas serão de grande valia. 
 
 TOTVS | Developer Studio 
 
36 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
7. Assistente de Código 
 
O TOTVS | Developer Studio disponibiliza um assistente de código que ao ser acionado, auxiliará o desenvolvedor na criação 
de programas Adv/PL com funcionalidades específicas, conforme as informações fornecidas. 
Para acessá-lo acione menu: Arquivo | Novo | Assistente de Código 
 
 
 
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 botão Próximo. 
 
 
 
Conforme o Tipo de Assistente selecionado, seremos guiados por uma ou mais páginas para complementar os dados 
necessários para a geração do arquivo fonte. Hoje existem 4 tipos de assistente: 
 Cadastro 
 Geração de Arquivo Texto 
 Importação de Arquivo Texto 
 Processamento Genérico 
 
 TOTVS | Developer Studio 
 
 37 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
7.1. Assistente de código: Cadastro 
 
Este tipo de assistente auxilia na criação arquivos-fontes, capazes de efetuar manutenção de dados em tabelas. 
Selecione o tipo template, em Cadastro - Tipo de arquivo, conforme a origem da definição da tabela. Existem 2 tipos, 
Arquivo Padrão ou Arquivo Específico. 
 
Caso a opção escolhida em Cadastro - Tipo de arquivo tenha sido por Arquivo Padrão teremos a seguinte tela: 
 
 
 
O Arquivo padrão (item A da imagem acima) é utilizado quando a definição da tabela é a mesma do dicionário de 
dados, preenchendo os dados solicitados. 
 Parâmetros: identifica uma Pergunta definida no dicionário de dados da Linha de Produto Microsiga 
Protheus. 
 Alias, (item B): no caso de arquivo padrão, este será utilizado para localizar as definições no dicionário de 
dados, caso seja arquivo específico será utilizado para identificar a área de trabalho (select area). 
 
A ordem de apresentação dos dados é definida por uma das seguintes opções: 
 Utilize índice padrão (item C): indica qual o número do índice do dicionário de dados, associado ao alias, que 
será utilizado. 
 Utiliza índice temporário (item D): informe uma expressão Adv/PL válida para indicar a ordem dos dados. 
Este índice é de uso temporário, sendo eliminado depois do seu uso. 
 
 
 TOTVS | Developer Studio 
 
38 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
Caso a opção escolhida em Cadastro - Tipo de arquivo tenha sido por Arquivo Específico teremos a seguinte tela: 
 
O Arquivo específico é utilizado para uma estrutura livre da tabela. 
 Parâmetros (item A): identifica uma Pergunta definida no dicionário de dados da Linha de Produto Microsiga 
Protheus. 
 Estrutura (item B): utilizado para definir a estrutura da tabela. Utilize os botões à direita para adicionar ou 
remover atributos (campos). 
 Indexado (item C): se marcado indica que a tabela será ordenada pela expressão Adv/PL informada no 
campo Chave. 
 
Acione Próximo (ou Next) no item D para ir para a próxima etapa, em que serão complementados os dados, podendo 
detalhar funcionalidades. 
 
 
 
Selecione o template de cadastro, conforme a visualização e comportamento desejado: 
 axCadastro: cadastro Padronizado, que irá utilizar a função axCadastro da biblioteca Adv/PL. 
 Mbrowse: definindo opções, que irão utilizar a função mBrowse da biblioteca Adv/PL. 
 
 
 
 TOTVS | Developer Studio 
 
 39 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
Nas abas abaixo é possível efetuar algumas customizações: 
 Aba Botões - utilizada somente pela opção de template Mbrowse, e permite adicionar ou remover 
funcionalidades a tela. 
 
 
 Aba Campos: permite indicar campos e customizar alguns atributos. Caso os campos não sejam 
especificados, serão utilizados todos os definidos no dicionário de dados ou na definição de tabela 
customizada. 
 Configurações: permite definir propriedades opcionais como o Titulo a ser utilizado na janela e Campo 
Diferenciador e expressão Adv/PL, utilizada pela mBrowse para agrupar os dados. 
 
Ao preencher todos os dados obrigatórios solicitados, finalize o processo. Será criado um arquivo fonte conforme o 
nome e local escolhido, contendo o código gerado pelo assistente. 
 
 
7.2. Assistente de código: Geração de Arquivo Texto 
 
Este tipo de assistente auxilia na criação dos arquivos-fontes, capazes de gerar arquivos textos a partir deuma tabela 
de dados. Existem dois modelos ou tipos de geração de arquivo texto. São eles por Arquivo Padrão e por Arquivo 
Específico. 
 
Caso a opção escolhida em Geração de TXT - Tipo de arquivo tenha sido por Arquivo Padrão teremos a seguinte tela: 
 
 TOTVS | Developer Studio 
 
40 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
A Geração de Arquivo Texto por Arquivo padrão é utilizada quando a definição da tabela é a mesma do dicionário de 
dados, preenchendo os dados solicitados. Será necessário preencher as seguintes informações: 
 
 Parâmetros: identificado por A na imagem acima, identifica uma Pergunta definida no dicionário de dados da 
Linha de Produto Microsiga Protheus. 
 Alias: identificado por B na imagem acima, será utilizado para localizar as definições no dicionário de dados. Caso 
seja arquivo específico será utilizado para identificar a área de trabalho (select area). 
A ordem de leitura dos dados é definida por uma das opções no item C: 
 Utilize índice padrão: indica qual o número do índice do dicionário de dados, associado ao alias, que será 
utilizado. 
 Utiliza índice temporário: informe uma expressão Adv/PL válida para indicar a ordem dos dados. Este 
índice é de uso temporário, sendo eliminado depois de seu uso. 
 
Caso a opção escolhida em Geração de TXT - Tipo de arquivo tenha sido por Arquivo Específico teremos a seguinte 
tela: 
 
 
A Geração de Arquivo Específico é utilizada para uma estrutura livre da tabela. Será necessário preencher as seguintes 
informações: 
 Parâmetros: identificado por A na imagem acima, identifica uma Pergunta definida no dicionário de dados 
da Linha de Produto Microsiga Protheus. 
 Estrutura: identificado por B na imagem acima, utilizado para definir a estrutura da tabela. Utilize os 
botões à direita para adicionar ou remover atributos (campos). 
 Indexado: identificado por C na imagem acima, se marcado, indica que a tabela será ordenada pela 
expressão Adv/PL informada em Chave. 
 
Depois de preencher os dados avance para a página seguinte e complemente os dados, detalhando como será o 
arquivo texto. Neste passo também teremos duas opções: Definido ou Parametrizado. 
 
Caso a opção escolhida tenha sido por Definido, os valores serão fixos e informados no campo logo abaixo. 
 TOTVS | Developer Studio 
 
 41 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
Informe o Nome do Arquivo Texto (item B) e o Finalizador de Linha (item C). 
 
Caso a opção escolhida tenha sido por Parametrizado, os valores serão lidos a partir de uma variável (normalmente 
escopo privado - private) que deverá ser informada no campo. 
 
 
 
Informe a Variável com o nome do arquivo Texto (item B) e o Finalizador de Linha (item C). 
 
A aba Posições existente nessa etapa será utilizada para definir o leiaute do arquivo de saída. Veja a imagem a seguir: 
 
 TOTVS | Developer Studio 
 
42 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
Defina o layout informando os dados: Campo, Posição, Tamanho, Número de Decimais e Tipo. Para adicionar ou 
remover campos utilize os botões do lado direito. 
Ao preencher todos os dados obrigatórios solicitados, finalize o processo. Localize a entrada de função user function e 
coloque um nome mais significativo, salve e compile. 
 
 
7.3. Assistente de código: Importação de Arquivo Texto 
 
Este tipo de assistente auxilia na criação dos arquivos-fontes, capazes de importar arquivos textos a partir de uma 
tabela de dados. Existem dois modelos ou tipos de importação de arquivo texto. São eles por Arquivo Padrão e por 
Arquivo Específico. 
 
Caso a opção escolhida em Importação de TXT - Tipo de arquivo tenha sido por Arquivo Padrão teremos a seguinte 
tela: 
 
 
O Arquivo padrão é utilizado quando a definição da tabela é a mesma do dicionário de dados, preenchendo os dados 
solicitados. 
 Parâmetros (item A): identifica uma Pergunta definida no dicionário de dados da Linha de Produto Microsiga 
Protheus. 
 Alias: no caso de arquivo padrão, este será utilizado para localizar as definições no dicionário de dados. Caso 
seja arquivo específico será utilizado para identificar a área de trabalho (select area). 
 TOTVS | Developer Studio 
 
 43 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
A ordem de leitura dos dados é definida por uma das opções: 
 Utilize índice padrão (item C): indica qual o número do índice do dicionário de dados associado ao alias, que 
será utilizado. 
 Utilize índice temporário (item D): informe uma expressão Adv/PL válida para indicar a ordem dos dados. 
Este índice é de uso temporário, sendo eliminado depois de seu uso. 
 
Caso a opção escolhida em Importação de TXT - Tipo de arquivo tenha sido por Arquivo Específico teremos a seguinte 
tela: 
 
 
O Arquivo específico é utilizado para uma estrutura livre da tabela. Será necessário preencher as seguintes 
informações: 
 Parâmetros (item A): identifica uma Pergunta definida no dicionário de dados da Linha de Produto Microsiga 
Protheus. 
 Estrutura (item B): utilizado para definir a estrutura da tabela. Utilize os botões à direita para adicionar ou 
remover atributos (campos). 
 Indexado (iem C): se marcado, indica que a tabela será ordenada pela expressão Adv/PL informada em 
Chave. 
 
Após preencher os dados, avance para a página seguinte, na qual serão complementados os dados, detalhando o 
arquivo texto de entrada. 
Neste passo também teremos duas opções: Definido ou Parametrizado. 
 
Caso a opção escolhida tenha sido por Definido, os valores serão fixos e informados no campo logo abaixo. 
 TOTVS | Developer Studio 
 
44 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
Informe o Nome do Arquivo Texto (item B) e o Finalizador de Linha (item C). 
 
Caso a opção escolhida tenha sido por Parametrizado, os valores serão lidos a partir de uma variável (normalmente 
escopo privado - private) que deverá ser informada no campo. 
 
 
 
Informe a Variável com o nome do arquivo Texto (item B) e o Finalizador de Linha (item C). 
 
A aba Posições existente nessa etapa será utilizada para definir o leiaute do arquivo de saída. Veja a imagem a seguir: 
 TOTVS | Developer Studio 
 
 45 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
Defina o leiaute informando os dados: Campo, Posição, Tamanho, Número de Decimais e Tipo. Para adicionar ou 
remover campos utilize os botões do lado direito. 
Ao preencher todos os dados obrigatórios solicitados, finalize o processo. Localize a entrada de função user function e 
coloque um nome mais significativo, salve e compile. 
 
 
7.4. Assistente de código: Processamento Genérico 
 
Este tipo de assistente auxilia na criação dos arquivos-fontes, com um esqueleto para processamentos genéricos. 
Existem dois modelos ou tipos de processamento genérico. São eles por Arquivo Padrão e por Arquivo Específico. 
 
Caso a opção escolhida em Processamento Genérico - Tipo de arquivo tenha sido Arquivo Padrão teremos a seguinte 
tela: 
 
 
O Arquivo padrão é utilizado quando a definição da tabela é a mesma do dicionário de dados, preenchendo os dados 
solicitados. 
 Parâmetros (item A): identifica uma Pergunta definida no dicionário de dados da Linha de Produto Microsiga 
Protheus. 
 Alias (item B): no caso de arquivo padrão, este será utilizado para localizar as definições no dicionário de 
dados. Caso seja arquivo específico será utilizado para identificar a área de trabalho (select area). 
 
 TOTVS | Developer Studio 
 
46 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
A ordem de leitura dos dados é definida por uma das opções: 
 Utilize índice padrão (item C): indica o número do índice do dicionário de dados, associado ao alias, que será 
utilizado. 
 Utiliza índicetemporário (item D) - informe uma expressão Adv/PL válida para indicar a ordem dos dados. 
Este índice é de uso temporário, sendo eliminado depois de seu uso. 
 
Caso a opção escolhida em Processamento Genérico - Tipo de arquivo tenha sido por Arquivo Específico teremos a 
seguinte tela: 
 
 
O Arquivo específico é utilizado para uma estrutura livre da tabela. 
 Parâmetros (iem A): identifica uma Pergunta definida no dicionário de dados da Linha de Produto Microsiga 
Protheus. 
 Estrutura (item B): utilizado para definir a estrutura da tabela. Utilize os botões à direita para adicionar ou 
remover atributos (campos). 
 Indexado (item C): se marcado, indica que a tabela será ordenada pela expressão Adv/PL informada em 
Chave. 
 
Ao preencher todos os dados obrigatórios solicitados, finalize o processo. Localize a entrada de função user function e 
coloque um nome mais significativo, salve e compile. 
 
 
7.5. Nova Classe Adv/PL 
 
Este tipo de assistente auxilia na criação dos arquivos-fontes, com um esqueleto para definição de uma classe em 
Adv/PL. 
Informe os dados solicitados: 
 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 herança. 
 Criar arquivo como referência (item D da imagem a seguir): o arquivo será gravado no campo Diretório de 
Destino, e no local será criado uma ligação simbólica (link). 
 TOTVS | Developer Studio 
 
 47 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
Após informar os dados solicitados, finalize o processo e crie uma nova classe Adv/PL. 
 
 
7.6. Nova Função Adv/PL 
 
Este tipo de assistente auxilia na criação dos arquivos-fontes, com um esqueleto para definição de uma nova função em 
Adv/PL. 
Informe os dados solicitados: 
 Local (folder) (item A da imagem a seguir): indica o local (folder) em que o arquivo fonte será salvo. 
 Nome da função (item B da imagem a seguir): nome da função. 
 Criar arquivo como referência (item D da imagem a seguir): o arquivo será gravado no campo Diretório de 
Destino e no local será criado uma ligação simbólica (link). 
 
 
Após informar os dados solicitados, finalize o processo e crie uma nova classe Adv/PL. 
 
 
 TOTVS | Developer Studio 
 
48 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
7.7. Novo Fonte WSDL Adv/PL 
 
Este tipo de assistente auxilia na criação dos arquivos-fontes, com a definição de um cliente de serviço web (web 
service client) a partir da sua definição WSDL. 
Este assistente depende de uma definição do servidor da Linha de Produto Microsiga Protheus e da seleção deste na 
barra de ferramentas. Caso o serviço web a ser utilizado esteja fora da rede do usuário, o servidor da Linha de Produto 
Microsiga Protheus deverá ter privilégios de acesso. 
Informe os dados solicitados: 
 Local (folder) (item A da imagem a seguir): indica o local (folder) em que o arquivo fonte será salvo. 
 Nome da função (item B da imagem a seguir): nome do arquivo fonte que conterá a definição WSDL. 
 URL (item C da imagem a seguir): informe a URL em que está o serviço web desejado. 
 Criar arquivo como referência (item D da imagem a seguir): o arquivo será gravado no campo Diretório de 
Destino e no local será criado uma ligação simbólica (link). 
 
 
Após informar os dados solicitados, finalize o processo e crie uma nova definição de um cliente de serviç web. 
 
 
 
 
 
 
 
 
 
 
 
 
Importante: 
Este assistente depende de uma definição de servidor Da Linha de Produto Microsiga Protheus e da seleção 
deste na barra de ferramentas. Caso o serviço web a ser utilizado esteja fora da rede do usuário, o servidor 
Da Linha de Produto Microsiga Protheus deverá ter privilégios de acesso. 
 
Exercício: 
Crie uma nova função Adv/PL 
Crie uma nova classe Adv/PL 
Crie um novo fonte WSDL Adv/PL 
 
 
 TOTVS | Developer Studio 
 
 49 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
8. Trabalhando com pacotes de atualização (patch) 
 
Para gerar ou aplicar patch (pacotes de atualizações) use os botões existentes na barra de ferramentas. 
 
 
 
8.1. Geração de pacotes de atualização (patch) 
 
Acione o botão de geração do pacote de atualização (patch). 
 
 
Nas caixas de seleção indique a melhor opção: 
 Servidor (item A): selecione o servidor da Linha de Produto Microsiga Protheus que será utilizado para a 
geração do pacote. Todos os servidores registrados na visão TOTVS Server serão listados. 
 Ambiente (item B): selecione o ambiente (obtido a partir do servidor selecionado). 
 Processo (item C): indica qual procedimento será adotado na geração dos pacotes. Este item pode ser por 
Comparação, por Programa e por Grupo de Projetos: 
- por Comparação: este procedimento compara o seu RPO com um RPO mestre, gerando um pacote pela 
diferença entre eles. 
- por Programas selecionados a partir do RPO. Este procedimento permitirá indicar qual ou quais 
programas serão colocados no pacote, a partir do RPO. 
- por Programas selecionados a partir de Projetos. Este procedimento permitirá indicar qual ou quais 
programas serão colocados no pacote, a partir dos projetos na área de trabalho. 
- por Projetos permite a escolha de um ou mais projetos que irão fazer parte do pacote. 
 Salvar em (item D): selecione o local em que o arquivo de atualização será salvo após sua geração. Pode ser 
na máquina local ou no servidor. 
 TOTVS | Developer Studio 
 
50 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 Arquivo (sem extensão) (item E): caso o item D seja para salvar o arquivo localmente é possível definir um 
nome diferentemente do nome padrão. 
 
8.1.1. Geração de pacotes de atualização por Comparação 
 
Este processo compara o RPO atual do servidor/ambiente selecionado com um RPO denominado mestre, que 
encontra-se em um diretório do servidor. Para efetuar o procedimento de geração por comparação informe os dados 
solicitados, no campo Processo selecione Por Comparação, RPO atual com um mestre e ao avançar para a próxima 
página será necessário selecionar o diretório no qual encontra-se o RPO mestre. 
 
 
Acione Finalizar e aguarde o término do processamento. No console serão apresentadas algumas mensagens sobre a 
geração de patch. 
 
8.1.2. Geração de pacotes de atualização por Programa, selecionados a partir do RPO 
 
Este processo permite selecionar os programas que serão gravados no pacote de atualização, selecionando somente 
os programas contidos no RPO. Para efetuar o procedimento de geração por programa informe os dados solicitados, 
no campo Processo selecione Por Programa, selecionados a partir do RPO e ao avançar para a próxima página, 
selecione os programas ou recursos/arquivos que farão parte do pacote de atualização. Para facilitar a seleção de 
programas é possível utilizar o campo Procurar fonte e/ou Procurar. 
Recurso para localizar mais rapidamente um arquivo por meio dos caracteres coringa * e ? 
 TOTVS | Developer Studio 
 
 51 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
Acione Finalizar e aguarde o término do processamento. No console serão apresentadas algumas mensagens sobre a 
geração de patch. 
 
8.1.3. Geração de pacotes de atualização por Programa selecionados a partir des Projetos 
 
Este processo permite selecionar os programas que serão gravados no pacote de atualização, selecionando os 
programas contidos nos projetos da área de trabalho (ou workspace). Para efetuar o procedimento de geração por 
programa informe os dados solicitados, no campo Processo selecione Por Programa, selecionados a partir de 
Projetos e ao avançar para a próxima página selecione os programas ou recursos/arquivosque farão parte do pacote 
de atualização. 
Acione Finalizar e aguarde o término do processamento. No console serão apresentadas algumas mensagens sobre a 
geração de patch. 
 
8.1.4. Geração de pacotes de atualização por Grupo de Projeto 
 
Este processo permite gerar o pacote de atualização, selecionando projetos da sua área de trabalho (workspace). 
Para efetuar o procedimento de geração por grupo de projeto informe os dados solicitados, no campo Processo 
selecione Por Grupo de Projeto e ao avançar para a próxima página, selecione na lista os projetos apresentados que 
farão parte do patch. Todos os arquivos contidos nos projetos selecionados farão parte do patch gerado. 
Acione Finalizar e aguarde o término do processamento. No console serão apresentadas algumas mensagens sobre a 
geração de patch. 
 
 
8.2. Aplicação de pacote de atualização 
 
Acione o botão de aplicação do pacote de atualização (patch) e preencha os dados solicitados. 
 TOTVS | Developer Studio 
 
52 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
Informe os dados solicitados: 
 Servidor (item A): selecione o servidor da Linha de Produto Microsiga Protheus que será utilizado para a 
geração do pacote. Todos os servidores registrados na visão TOTVS Server serão 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 atualização a ser aplicado. Pode ser na 
máquina local ou no servidor. 
 
 
 
 
Acione Finalizar e aguarde o término do processamento. No console serão apresentadas algumas mensagens sobre a 
aplicação de patch. 
 
 
 
 
 
 
 
Importante: 
Ao selecionar o pacote (item C), este será validado, podendo demorar alguns momentos para esta validação. 
 
Exercício: 
Gere um patch por grupo de projeto, utilizando o seu projeto criado. Depois de gerado, aplique o patch 
em outro servidor e/ou ambiente. 
 TOTVS | Developer Studio 
 
 53 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
9. Compilação de versão 
 
Este processo permite que seja efetuada a geração de pacotes de atualização (patch), com a opção de compilar ou não os 
fontes envolvidos, em múltiplos ambientes. 
Para efetuar o processo de Compilação de versão use o botão existente na barra de ferramentas. 
 
 
 
 
 
Informe os dados solicitados: 
 Servidor (item A): selecione o servidor da Linha de Produto Microsiga Protheus que será utilizado para a compilação 
e geração do pacote. Todos os servidores registrados na visão TOTVS Server serão listados. 
 Ambiente (item B): selecione o(s) ambiente(s) (obtido(s) a partir do servidor selecionado) no qual o processo será 
executado. 
 Ler configurações (item C): permite recuperar as configurações de um arquivo externo gerado pelo acionamento do 
botão Salvar Configuração (ver funcionalidade na próxima tela). 
 
Acione Próximo e na tela apresentada informe os dados solicitados: 
 TOTVS | Developer Studio 
 
54 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 Itens do pacote (item B): na árvore de seleção apresentada, selecione os itens que deseja que façam parte do pacote 
a ser compilado/gerado. É possível filtrar os arquivos com os caracteres coringa * e ? no item A. 
 Compilar selecionados (item C): quando acionada esta opção, os itens selecionados serão compilados em todos os 
ambientes selecionados na tela anterior. 
 Gerar patch da seleção de projetos (item D): será executado o processo de geração de pacote de atualização, para 
todos os ambientes selecionados. 
 Local (item E): selecione o local em que será gravado o pacote de atualização (se a opção anterior estiver marcada). 
 Salvar configurações (item F): permite salvar as configurações efetuadas em um arquivo externo, para posterior 
reutilização carregando este arquivo por meio do botão Carregar Configuração da página anterior. 
 
 
 
 
 
 
 
Acione Finalizar e aguarde o término do processamento. No console serão apresentadas algumas mensagens sobre a 
compilação de versão. 
 
 
 
 
 
Importante: 
Faz-se necessário selecionar pelo menos uma das opções acima: Compilar selecionados e/ou Gerar patch 
da seleção de projetos. 
 
 
Exercício: 
Realize o procedimento de Compilação de versão. Caso tenha um servidor com mais de um ambiente utilize 
das opções de compilação e compile os seus programas em mais de um ambiente. E por fim, gere o patch da 
versão compilada. 
 TOTVS | Developer Studio 
 
 55 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
10. Desempenho de programas (profile) 
 
Muitas vezes, ao terminar uma nova rotina, percebemos que há pontos de lentidão. Mas, onde está o problema? Qual rotina 
está demorando? Por que está demorando? Com as últimas alterações que foram feitas houve melhorias? 
O TOTVS | Developer Studio, por meio da ferramenta Profile (Perfil) ajudará a responder estas questões. 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 configuração de executor (ou laucher) podemos ativá-la quando necessário. 
 
1. Acesse a configuração de executores (laucher) para depuração. 
 
 
 
 
 
 
2. Adicione uma nova configuração e preencha os dados solicitados da mesma forma que em uma execução 
normal. 
3. Habilite a execução do profile marcando a opção Habilita Profile de execução (item A na imagem a seguir). 
 
 
 
 
 
 
 
 
 
4. Acione a configuração com o profile ativado e depure seu programa normalmente até o final. 
5. Abra a visão Profile, acessando Janela | Apresentar visão | Outras... na janela apresentada digite Profile 
(sem aspas) e selecione a opção Adv/PL Profile. 
Importante: 
Observe que temos duas configurações. Uma padrão, em que não está habilitado o profile 
e outra em que o profile está habilitado. Dessa forma, fica fácil e rápido usá-lo ou não. 
 
 
Importante: 
O profile só será gerado a partir da Depuração (Debug) de um arquivo fonte. 
 
 
 TOTVS | Developer Studio 
 
56 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 
6. Efetue um duplo clique sobre o nome da visão para maximizá-la. 
 
 
 
 
10.2. Analisando perfil 
 
Usando o perfil de execução obtido, temos diversas informações 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 execução do teste. 
 Dados (item B na imagem acima): dados estatísticos de cada programa/função executada. 
 
10.2.1. Informações resumidas 
 
As informações resumidas proporcionarão uma visão geral do perfil da execução 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 (funções internas da Linha de Produto Microsiga Protheus) 
consumiram cerca de 33% e os demais, a medição foi insignificante (0%). 
Selecione, em Fontes, o arquivo fonte calcFatorial, obtendo algo semelhante a: 
 
 
Na área de dados (item A da imagem acima) temos: 
 Programa/Função: identifica o nome do programa ou função. 
 Chamadas: número de vezes que foi chamado. 
 Linha: identifica a linha do fonte (ver Informação detalhada). 
 Tempo Médio (ms): tempo médio de execução por chamada (em milissegundos). 
 Tempo Total (ms): tempo total de todas as chamadas (em milissegundos). 
 Fonte: arquivo fonte onde está definida a entrada da função. 
 
 
 TOTVS | Developer Studio 
 
 57 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
10.2.2. Informação detalhada 
 
Ao passar o mouse sobre a área de dados aparecerá do lado esquerdo de cada nome doprograma/função (Tela 
122 B) uma pequena seta. Ao acioná-la obterá um detalhamento daquela função/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 número de vezes que a linha foi executada e a coluna Linha identifica o 
número da linha do fonte. 
Analisando-se os tempos e número de chamadas/execuções, podemos efetuar alterações no fonte, visando 
melhorar o seu desempenho. 
 
 
 
 
 
 
 
 
 
 
 
Importante: 
Funções/programa que possuem interação com o usuário, por exemplo, a MsgAlert e entrada de 
dados (get e similares), podem gerar distorções em função da velocidade de resposta do usuário. 
 
Exercício: 
Realize o procedimento de estudo passo a passo. Visualize todos os dados disponíveis. 
Execute o profile em seus outros arquivos-fontes. 
 TOTVS | Developer Studio 
 
58 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
11. Cobertura de código (coverage code) 
 
Cobertura de código (ou no inglês coverage code) define que um programa testado é aquele em que TODAS as suas instruções 
foram executadas ao menos uma vez. Isso é realizado por testes sucessivos, tentando que cobrir todas as situações tratadas no 
código. 
O TOTVS | Developer Studio disponibiliza aos desenvolvedores uma ferramenta que os ajudará no processo de testes, 
identificando qual parte do código já foi executado. 
 
 
 
 
 
 
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" 
cMsg := "Você escolheu o numero 2" 
elseif cResp == "3" 
cMsg := "Você escolheu o numero 3" 
elseif cResp == "4" 
cMsg := "Você escolheu o numero 4" 
elseif cResp == "5" 
cMsg := "Você escolheu o numero 5" 
else 
cMsg := "Nenhum número 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") 
Importante: 
Passar por todas as linhas do seu código, não significa que ele está livre de erros, apenas minimiza as chances 
disto ocorrer. 
 TOTVS | Developer Studio 
 
 59 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
msgAlerta("Parametro aaOpcoes não é 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 número acionando um dos botões 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 
 
 
 
 
 
 
 
 
 
 
 TOTVS | Developer Studio 
 
60 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
11.1. Ativação da cobertura de código 
 
Para ativar este recurso acesse a configuração de um executor. 
Na janela apresentada, selecione a aba Cobertura de Código (item A da próxima imagem). 
 
 
 
Nesta página preencha os dados solicitados: 
 Habilitar cobertura de código (item B): habilita ou não a cobertura de código. 
 Informe os fontes para cobertura (item C): lista de arquivos-fontes aos quais se deseja efetuar a cobertura 
de código. Para selecioná-los, utilize os botões à direita (item D). 
 
Após selecionar os fontes e ativar a cobertura inicie a execução, acionando o botão Debug. 
 
 
11.2. Plano de teste 
 
Ao executar o programa sugerido teremos: 
 
 TOTVS | Developer Studio 
 
 61 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
Com base no referido programa, elaboramos os planos de testes. Cada um destes itens, Teste 1 e Teste 2, deverão 
ser executados um após o outro. 
1. Teste 1 
1.1. Acionar botão 1 
1.2. Acionar botão 5 
1.3. Acionar botão <encerrar> 
2. Teste 2 
2.1. Acionar botão 3 
2.2. Acionar botão 4 
2.3. Acionar botão <nenhum> 
2.4. Acionar botão <encerrar> 
 
Execute o plano de teste. Teste primeiro 1 e depois o Teste 2. 
 
 
11.3. Analisando a cobertura de código 
 
Acione a visão Cobertura de Código (ou em inglês Coverage), acessando Janela | Apresentar visão | Outras… 
localize TOTVS Profile e acione Cobertura de Código (ou em inglês Coverage). Obtendo algo semelhante a: 
 
 
 
Na visão recém-aberta (item A da imagem acima) teremos o registro dos testes efetuados. Faça a expansão do 
primeiro registro, acionando a seta à esquerda (item B) da caixa de seleção. 
Com a expansão obterá uma lista de fontes que tiveram sua execução monitorada. Selecione o arquivo fonte 
escolheNum.prw (item A) e as linhas que foram processadas ao menos uma vez, serão destacadas no editor. 
 TOTVS | Developer Studio 
 
62 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
Se utilizarmos o plano de teste 1 como referência e analisarmos o código destacado, veremos que há coerência entre 
eles. Ou seja, o código esperado para o teste 1 foi executado de forma satisfatória. Na linha de identificação do fonte 
há algumas informações, que são: 
 Cobertura %: indicando o percentual de linhas que foram executadas. 
 Executado: o número de linhas executada. 
 Total Linhas: total executado de linhas. 
 
Faça a expansão do registro de execução do segundo teste e selecione a linha do arquivo fonte escolheNum.prw. 
Da mesma forma que no 1º teste, veremos em destaque se o código que foi executado está coerente com o nosso 
teste. 
 TOTVS | Developer Studio 
 
 63 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
Observe que, em ambos, existe um indicador do percentual de código coberto (Cobertura %). Quanto mais alto for o 
índice de cobertura (individual), menos erros serão apresentados. Cobrir um programa em 100% pode ser bastante 
difícil ou mesmo inviável devido às regras de negócios. Por isso, temos que efetuar planos de testes o mais 
abrangente possível 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 fusão (merge) dos registros de testes. 
 
 
Selecione os registros de testes e acione o botão (item A na imagem acima) para iniciar a fusão (merge) e aguarde. 
Os registros de testes selecionados serão fundidos em um único registro. Faça a expansão, selecione o arquivo fonte 
e veja como fica a cobertura (ver a imagem a seguir). 
 TOTVS | Developer Studio 
 
64 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
 
 
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 não está destacada. Isso demonstra que em nenhum dos testes anterioreso código foi 
executado. Com base nestas informações montamos mais um teste de forma que o código seja executado. 
 
3. Teste 3 (em adição ao criado em Plano de teste original) 
3.1. Acionar botão 2 
3.2. Acionar botão <encerrar> 
 
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 código de 57%. 
 
 
 
 TOTVS | Developer Studio 
 
 65 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
Clicando neste resultado analisamos o código destacado e vemos que está coerente com o nosso 3º teste. Agora 
devemos efetuar a fusão (merge) deste teste com o registro da fusão anterior e obteremos como resultado uma 
cobertura de código total de 61%. 
 
 
Realizaremos estes procedimentos até que tenhamos coberto o máximo possível dos códigos. Utilizando-se de vários 
planos de testes é possível chegarmos a 100% de cobertura. 
 
 
 
 
 
 
Exercício: 
Realize o procedimento de estudo passo a passo. Visualize todos os dados disponíveis. Tente criar mais 
testes e chegar ao 100% de cobertura de código. 
Execute a cobertura do código em seus outros arquivos-fontes. 
 TOTVS | Developer Studio 
 
66 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
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 visões de monitoramento dos servidores abaixo, 
serão atualizadas. 
Caso selecione um servidor específico (como no destaque da imagem abaixo), somente a visão de monitoramento será 
atualizada e as demais ficarão sem informação. 
 
 
 
 TOTVS | Developer Studio 
 
 67 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
Acima temos o monitor de um servidor de aplicação TOTVS. Abaixo temos o monitor DBAccess TOTVS. 
 
 
 
 TOTVS | Developer Studio 
 
68 TOTVS | Developer Studio – Linha de Produto Microsiga Protheus 
Versão 11.5 
13. Principais comandos do TOTVS | Developer Studio 
 
Ao editar arquivos-fontes temos as seguintes teclas de atalho: 
Comando / Atalho Descrição da Função: 
CTRL + ALT + UP Duplica o bloco acima. 
CTRL + ALT + DOWN Duplica o bloco abaixo. 
CTRL + BACK Exclui a palavra anterior. 
CTRL + DEL Exclui a próxima palavra. 
ALT + UP Move a linha para cima. 
ALT + DOWN Move a linha para baixo. 
CTRL + SHIFT + X Coloca o bloco selecionado em maiúsculo. 
CTRL + SHIFT + Y Coloca o bloco selecionado em minúsculo. 
CTRL + I Efetua a identificação do arquivo fonte ou do trecho selecionado. 
INSERT Alterna entre modo de inserção e sobrescrita. 
DELETE Remove a letra à direita ou o bloco selecionado. 
CTRL + F9 Inicia compilação. 
ALT + / Completa as palavras sem mostrar a janela popup de opções. Pressione novamente para 
alternar as opções disponíveis. 
CTRL + ESPAÇO Ativa a janela popup de completar/autocompletar. 
CTRL + D Remove a linha atual. 
CTRL + M Alterna entre janela máxima e mínima da visão corrente. 
CTRL + O Abre a visão outline em janela popup. 
CTRL + F10 Abre um menu popup com algumas opções avançadas. 
CTRL + SHIFT + I Efetua a identificação do arquivo fonte ou bloco selecionado. 
CTRL + F Localização e substituição de texto. 
CTRL + K Localiza próxima ocorrência. 
CTRL + SHIFT + K Localiza a ocorrência anterior. 
CTRL + SHIFT + U Lista todas as ocorrências da palavra selecionada ou que está sob o cursor. 
CTRL + L Move o cursor para uma linha específica. 
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: 
Comando / Atalho Descrição da Função: 
CTRL + PAGE DOWN Move para a próxima aba do editor. 
CTRL + PAGE UP Move para a aba anterior do editor. 
CTRL + 3 Exibe o navegador rápido. Digite uma palavra para iniciar a busca de todas as visões, 
menus e barra de ferramentas. 
CTRL + E Navega entre os elementos em edição. 
CTRL + F6 Alterna entre os arquivos abertos no editor. 
CTRL + F7 Alterna entre as visões abertas. 
CTRL + F8 Alterna entre as perspectivas abertas. 
 
 
 
 
 
 
 
 TOTVS | Developer Studio 
 
 69 TOTVS | Developer Studio - Linha de Produto Microsiga Protheus 
Versão 11.5 
No processo de depuração (debug) de arquivos-fontes temos as seguintes teclas de atalho: 
Comando / Atalho Descrição da Função: 
F5 Percorre a linha 
F6 Pula linha 
F8 Executa 
 
Outras teclas de atalho: 
Comando / Atalho Descrição da Função: 
CTRL + SHIFT + L Exibe a lista de atalhos. Pressionando duas vezes CTRL+SHIFT+L será 
exibida a tela de configuração 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 visões disponíveis. O caractere ‘?’ representa uma das 
letras disponíveis e deve ser pressionado logo em seguida ao comando 
ALT+SHIFT+Q. Exemplo de ALT+SHIFT+Q, Q para abrir a Visão de 
Breakpoints. 
CTRL + F11 Exibe o navegador rápido. Digite uma palavra para iniciar a busca de todas 
as visões, menus e barra de ferramentas. 
F11 Navegar entre os elementos em edição. 
“ ou ‘ ou { ou [ ou ( ou | Alterna entre os arquivos abertos no editor. 
 
Operações com blocos de texto têm as seguintes teclas de atalho: 
Comando / Atalho Descrição da Função: 
<Bloco_de_Texto_Selecio
nado> + TAB 
Adiciona uma tabulação no início de cada linha do bloco selecionado. 
<Bloco_de_Texto_Selecio
nado> + SHIFT + TAB 
Remove uma tabulação no início de cada linha do bloco selecionado. 
<Bloco_de_Texto_Selecio
nado> + “ 
Coloca o bloco selecionado entre aspas duplas, resultando em 
“<Bloco_de_Texto_Selecionado>”. 
<Bloco_de_Texto_Selecio
nado> + ‘ 
Coloca o bloco selecionado entre aspas simples, resultando em 
‘<Bloco_de_Texto_Selecionado>’. 
<Bloco_de_Texto_Selecio
nado> + { 
Coloca o bloco selecionado entre chaves, resultando em 
{<Bloco_de_Texto_Selecionado>}. 
<Bloco_de_Texto_Selecio
nado> + [ 
Coloca o bloco selecionado entre colchetes, resultando em 
[<Bloco_de_Texto_Selecionado>]. 
<Bloco_de_Texto_Selecio
nado> + | 
Coloca o bloco selecionado entre barras verticais, resultando em 
|<Bloco_de_Texto_Selecionado>|.