Apostila MP TOTVS Developer Studio 11 5

7/18/2019 Apostila MP TOTVS Developer Studio 11 5

1/69

Todos os direitos autorais reservados pela TOTVS S.A.

Proibida a reproduo total ou parcial, bem como a armazenagem em sistema de recuperao e atransmisso, de qualquer modo ou por qualquer outro meio, seja este eletrnico, mecnico, de fotocpia, de

gravao, ou outros, sem prvia autorizao por escrito da proprietria.

O desrespeito a essa proibio configura em apropriao indevida dos direitos autorais e patrimoniais daTOTVS.

Conforme artigos 122 e 130 da LEI no. 5.988 de 14 de Dezembro de 1973.

TOTVS |Developer Studio

Linha deProdutoMicrosigaProtheus11.5

Habilitar o participante nas funcionalidades do ambiente de

desenvolvimento TOTVS | Developer Studio, abordando suas diversasfuncionalidades.


2/69

TOTVS | Developer Studio

2 TOTVS | Developer StudioLinha de Produto Microsiga Protheus

Verso 11.5

ndice

1. Objetivos ........................................................................................................................................... 4

2. Introduo ......................................................................................................................................... 5

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

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

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

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

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

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

5. Ajustando as preferncias do TOTVS | Developer Studio .................................................................. 125.1. Autorizao........................................................................................................................................ 12

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

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

5.2.2. Decorator AdvPL................................................................................................................................ 13

5.2.3. Performance...................................................................................................................................... 14

5.2.4. Modelos............................................................................................................................................. 14

5.2.5. Server................................................................................................................................................ 14

5.2.6. Compilador/Pr-Compilador............................................................................................................... 14

5.2.7. Configuraes do servidor.................................................................................................................. 14

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

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

5.5. Includes.............................................................................................................................................. 15

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

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

5.6.2. Adicionando um servidor.................................................................................................................... 17

5.6.3. Conectando-se ao servidor................................................................................................................. 18

5.6.4. Configurao do servidor................................................................................................................... 18

5.6.4.1.Inspetor de Objetos............................................................................................................................ 18

5.6.4.2.Log do Repositrio.............................................................................................................................. 19

5.6.4.3.Desfragmentar repositrio................................................................................................................. 19

5.6.5. Selecionando o servidor para a sua utilizao..................................................................................... 19

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

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

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

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

6.4. Adio de arquivos de recursos.......................................................................................................... 246.5. Compilao de arquivos e projetos..................................................................................................... 24

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


3/69


3TOTVS | Developer Studio - Linha de Produto Microsiga Protheus

Verso 11.5

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

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

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

6.8.2. Avanado........................................................................................................................................... 29

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

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

6.9.2. Viso Breakpoint................................................................................................................................ 34

6.9.3. Viso Tabela de Dados........................................................................................................................ 34

6.9.4. Viso Adv/PL Commands.................................................................................................................... 34

6.9.5. Viso Variables................................................................................................................................... 34

6.9.6. Viso Expression................................................................................................................................. 34

7. Assistente de Cdigo ......................................................................................................................... 367.1. Assistente de cdigo: Cadastro........................................................................................................... 37

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

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

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

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

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

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

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

8.1. Gerao de pacotes de atualizao (patch)......................................................................................... 498.1.1. Gerao de pacotes de atualizao por Comparao.......................................................................... 50

8.1.2. Gerao de pacotes de atualizao por Programa, selecionados a partir do RPO ................................. 50

8.1.3. Gerao de pacotes de atualizao por Programa selecionados a partir des Projetos .......................... 51

8.1.4. Gerao de pacotes de atualizao por Grupo de Projeto................................................................... 51

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

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

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

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

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

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

10.2.2. Informao detalhada........................................................................................................................ 57

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

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

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

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

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

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


4/69



Verso 11.5

1. Objetivos

O objetivo deste curso ensinar aos futuros desenvolvedores como utilizar a Ferramenta de Desenvolvimento TOTVS |Developer Studio, com todos os recursos oferecidos.

No decorrer deste treinamento esperado que o treinando desenvolva-se nos seguintes aspectos:

Conceitos:

- Princpios bsicos de desenvolvimento de programas usando a plataforma TOTVS.

Habilidades:

- Domnio conceitual e prtico em desenvolvimento e lgica de programao.

- Conhecimentos nos ambientes ERP TOTVS, Microsiga Protheus ou outros.

Tcnicas:

- Operacionalizao do ambiente.

- Desenvolviemento de funcionalidades e/ou customizaes em ERPs TOTVS.

- Aplicao e utilizao das funcionalidades da ferramenta.

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

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

Desenvolvimento de rotinas personalizadas referentes s customizaes em ERPs TOTVS.


5/69



Verso 11.5

2. Introduo

O TOTVS | Developer Studio um ambiente de desenvolvimento integrado, que permite ao usurio editar, compilar e depurar

programas escritos na Linguagem de Programao ADVPL.

Como Ferramenta de Edio possui todos os recursos das ferramentas mais populares, como Cortar e Colar, Levar o Cursor at

determinada linha do cdigo, Localizao e Substituio de Texto, assim como recursos adicionais, como Identificao de

Cdigo, Insero de Comentrios de Documentao etc.

Como Ferramenta de Debug dispe de aes como Percorrer Linha, Pular Linha, Executar, Seguir at o Retorno, Pausar

Execuo, Derrubar Client, permitindo ao usurio executar e depurar suas rotinas de dentro de seu ambiente integrado,

inspecionando o ambiente de execuo de suas rotinas por meio de diversas vises contendo informaes de depurao, como

variveis (divididas entre variveis locais, variveis pblicas, variveis privadas e variveis estticas), expresses, Tabelas de

dados, ndices e Campos, Break Points, Programas Registrados (Inspetor de Objetos), Pilha de Chamadas entre outras

informaes.

Alm disso, os programas criados so compilados diretamente do TOTVS | Developer Studio, os quais so mantidos em

Projetos.

Os Projetos facilitam a compilao de um ou mais projetos de arquivos, utilizando conceitos de Repositrios e Diretivas de

Compilao, possibilitando inclusive a manuteno de bibliotecas de rotinas do usurio.

O TOTVS | Developer Studio foi construdo sob a plataforma Eclipse, que um ambiente de desenvolvimento de uso geral

configurvel e extensvel a vrias tarefas. Caso tenha familiaridade com o Eclipse ver que o funcionamento do TOTVS |

Developer Studio praticamente o mesmo de quando o utilizamos para desenvolvimento em Java ou outras linguagens

suportadas por ele.

Caso no conhea o Eclipsepassaremos aqui as informaes primordiais para utilizar o TOTVS | Developer Studio, e caso queira

se aprofundar, recomendamos acessar o site do Eclipse:http://www.eclipse.org/.

O TOTVS | Developer Studio uma ferramenta de desenvolvimento integrada (IDE), por isso, possui uma vasta gama de

funcionalidades, tais como edio de programas, execuo, depurao (debug), anlise de desempenho, configurao de

servidores entre outras. Para ativ-las necessrio instalar adicionais ao seu TDS, para as diversas linguagens que a TOTVS

possui.
http://www.eclipse.org/http://www.eclipse.org/http://www.eclipse.org/http://www.eclipse.org/


6/69



Verso 11.5

3. Instalando o TOTVS | Developer Studio

Diferentemente dos ambientes de desenvolvimento anteriores, o TOTVS | Developer Studio no disponibilizado em conjunto

com os binrios TOTVS. Para ser utilizado, deve ser baixado do sitehttp://suporte.totvs.com.bre previamente instalado.Para isso, atente-se a dois pr-requisitos: o sistema operacional em que o TOVS | Developer Studio ser instalado e a prvia

instalao de uma Mquina Virtual Java (JVM).

Sistema Operacional

Certifique-se que o sistema operacional que ser utilizado, seja homologado para uso do TOTVS | Developer Studio e

devidamente atualizado.

Mquina Virtual Java (JVM)

Em ambientes Windows, o instalador do TOTVS | Developer Studio efetuar uma verificao, e se necessrio far atualizao

ou instalao da JVM de forma automtica, aps confirmao.

Ao acionar o instalador do TOTVS | Developer Studio, este o guiar pelos procedimentos necessrios para a instalao. Seguem

os passos:

Inicie o instalador do TOTVS | Developer Studio, conforme o seu sistema operacional.

Selecione o idioma que deseja utilizar durante o processo de instalao.

Leia os termos e condies do licenciamento e selecione a opo que corresponde ao aceite.

Selecione o local de instalao.

Aguarde o fim da instalao.

Ao trmino da instalao, o ambiente de desenvolvimento estar pronto para ser usado. Para isso, acione o atalhono desktopdo computador ou no menu de programas.

Exerccio:

Baixe e Instale o TOTVS | Developer Studio em sua mquina.

Saiba Mais:

Para mais informaes acesse:

http://tdn.totvs.com/pages/viewpage.action?pageId=6066171
http://suporte.totvs.com.br/http://suporte.totvs.com.br/http://suporte.totvs.com.br/http://tdn.totvs.com/pages/viewpage.action?pageId=6066171http://tdn.totvs.com/pages/viewpage.action?pageId=6066171http://suporte.totvs.com.br/


7/69



Verso 11.5

4. Iniciando TOTVS | Developer Studio

4.1.

Termo de aceite

Para iniciar o TOTVS | Developer Studio clique no cone no seu desktopou acesse via menu de programas, o atalho

especfico do TOTVS | Developer Studio.

Ao utilizar o TOTVS | Developer Studio pela primeira vez necessrio que voc esteja cadastrado pela TOTVS para a

utilizao deste software e aceite o termo de utilizao. Com isso, no primeiro acesso ser apresentada uma tela

contendo este termo de utilizao. Leia-o com ateno e somente se estiver de acordo, preencha os campos

solicitados, acione a opo Aceito os termose envie-o. Ser validado por um de nossos servidores e se estiver correto,

ser apresentada a tela de Boas Vindas, caso contrrio ser apresentado o motivo da recusa.

4.2.

Trabalhando com reas de Trabalho ou Workspaces

Aps o aceite do termo de utilizao, ser apresentada uma tela para seleo de umarea de Trabalho(ou em ingls

Workspace). O conceito de rea de trabalho consiste em um local no qual seus trabalhos podem ser armazenados e/ou

acessados via ligao simblica (symbolic link) ou fisicamente. Contm tambm informaes de gerenciamento e

organizao dos fontes e outras informaes necessrias ao funcionamento do TOTVS | Developer Studio.


8/69



Verso 11.5

possvel manter quantas reas de trabalho desejar, organizando seus trabalhos da forma que achar mais confortvel

e natural. Por exemplo, mantendo uma rea para cada produto/verso, cliente, projetos pessoais etc.

Usando as ligaes simblicas (symbolic links) possvel compartilhar diretrios e arquivos, que so comuns a vriosprojetos.

Ao iniciar o TOTVS | Developer Studio ser necessrio informar uma workspace.Indique um diretrio de workspaceou

aceite o local padro. Caso o diretrio selecionado no exista, este ser criado.

Logo abaixo do campo workspaceexiste uma caixa de marcao, a qual optativa para que seja a sua rea de trabalho

padro. Se for marcada, na prxima vez em que entrar no TOTVS | Developer Studio, no ser solicitado rea.

possvel alterar de diretrio workspace, posteriormente, acessando o menu Arquivo e depois Alterar Workspace.

Recomenda-se que a rea de trabalho seja colocada em diretrio diferente do local de instalao do TOTVS | Developer

Studio. Este procedimento facilitar manter cpias de segurana e futuras atualizaes do produto.

Aps a seleo da rea de trabalho aguarde alguns instantes enquanto o TOTVS | Developer Studio inicializado e

apresente a tela de boas-vindas.

4.3.Instalao de adicionais

Aps os procedimentos acima, o TOTVS | Developer Studio estar inicializado, porm falta a instalao de um

adicionalespecfico para a linguagem de programaoque iremos utilizar. O conceito de Adicional (plugins eclipse)

consiste em um ou mais pacotes de softwares que adicionam capacidades ou que estendem funcionalidades j

existentes plataforma Eclipse, no caso em questo, conter informaes sobre cada uma das linguagens de

programao TOTVS, suas janelas, especificaes entre outras informaes.

Para esta instalao acesse o Gerenciador de Atualizaesdo TOTVS | Developer Studio, acionando o menuAjuda |

Instalar novo software. Ser apresentada uma janela para informar o adicional a ser instalado, mais precisamente a url

de instalao do adicional.


9/69



Verso 11.5

Tomaremos como exemplo, que desejamos desenvolver aplicativos utilizando a linguagem de programao Adv/PL da

TOTVS.

Para isso, no campo Work With(item A na imagem a seguir), informe (digitando ou colando) o endereo do pacote a

ser adicionado, no caso do Adv/PL serhttp://ds.totvs.com/updates/advplque foi obtido no sitehttp://ds.totvs.com

Acione ENTER e depois de alguns instantes (pode demorar algum tempo), ser apresentada uma rvore (item B na

imagem a seguir), para a seleo dos adicionais desejados. No caso selecione a raiz da rvore, ou seja,Adv/PL.Acione Avanar (item C na imagem a seguir), aceite o termo de utilizao e siga as instrues do Gerenciador de

Atualizaes.

Ao finalizar a instalao e reiniciar o TOTVS | Developer Studio teremos um ambiente pronto para a programao em

Adv/PL da TOTVS.

4.4.

Perspectivas e Vises

As funcionalidades adicionadas ou estendidas por meio dos adicionais (plugins) no caso acima de Adv/PL so agrupadas

em perspectivas. As perspectivas so configuraes pr-definidas, que podem ser customizadas posteriormente pelo

usurio desenvolvedor, e que permite de uma forma rpida, modificar o seu ponto de vista (perspectiva) em relao ao

trabalho que esta sendo executado ou que ser necessrio fazer.

Cada perspectiva ter uma ou mais vises, que se relacionam de alguma forma entre si e com o trabalho a ser

executado. As vises so janelas acoplveis (do ingls dockable) que adicionam funcionalidades ou informaes

perspectiva que a contm.

possvel selecionar ou mudar de uma perspectiva utilizando as opes disponveis por meio dos botes e cones de

seleo, presentes na barra de ferramentas ou acessando o menu: Janela | Abrir perspectiva | Outros

Importante:

O processo de instalao de adicionais semelhante a todas as linguagens suportadas (Adv/PL, 4GL e

4GLP), mudando apenas os endereos em que os adicionais esto disponveis. Acesse

http://ds.totvs.compara obter a lista dos endereos e mais informaes.
http://ds.totvs.com/updates/advplhttp://ds.totvs.com/updates/advplhttp://ds.totvs.com/updates/advplhttp://ds.totvs.com/http://ds.totvs.com/http://ds.totvs.com/http://ds.totvs.com/http://ds.totvs.com/http://ds.totvs.com/http://ds.totvs.com/http://ds.totvs.com/updates/advpl


10/69



Verso 11.5

Tambm possvel selecionar diretamente na barra de perspectivas, como na imagem a seguir no item A.

Como exemplo, ao instalar o adicional da linguagem de programao Adv/PL no TOTVS | Developer Studio, ele vir com

as perspectivas bsicas para o desenvolvedor de produtos TOTVS em Adv/PL, cuja perspectiva conter diversas vises

especficas para o ambiente de desenvolvimento da Linha de Produto Microsiga Protheus.

Para entendermos melhor esses conceitos abra o TOTVS | Developer Studio. A perspectiva inicial a de Informaes

(ou em ingls Resources). Para melhor visualizao acesse a seleo de perspectivas (conforme citado acima) e

selecione a perspectiva Totvs Developer. Esta a perspectiva que reordenar as vises de acordo com o adicional para

a linguagem de programao Adv/PL, previamente instalado.

Ao abrir a perspectiva TOTVS Developer teremos o TOTVS | Developer Studio dividido em diversas partes: Menu

principal, barra de ferramentas, Navegador de projetos, Estrutura de programas/classes, rea de editores, Abasinformativas e retorno e rea de trabalho das abas informativas, barra destatuse menu de acesso rpido etc.

No TOTVS | Developer Studioutilizaremos4 perspectivas principais na maior parte do tempo, sendo elas:

TOTVS Developer: responsvel pela organizao e disposio das principais funcionalidades relacionadas aodesenvolvimento de projetos e programas.

TOTVS Servers: responsvel pela organizao e disposio do cadastro e suas funcionalidades, assim como omonitoramento de servidores de aplicao TOTVS.

Debug:responsvel por servir funcionalidades e informaes acerca do debug/deburao de programas.

TOTVS Store: responsvel pela organizao e integrao do TOTVS | Developer Studio com a TOTVS |Store.
http://www.dicio.com.br/utilizaremos/http://www.dicio.com.br/utilizaremos/http://www.dicio.com.br/utilizaremos/http://www.dicio.com.br/utilizaremos/


11/69



Verso 11.5

Importante:

Viso ou Janela acoplvel (dockable) permite a configurao visual da forma que for mais

conveniente. Arraste uma das vises que esto em abas informativas e ver que, conforme for semovimentando pela tela aparecer um quadro pontilhado indicando onde ser acoplada se soltar

o boto do mouse.

Exerccio:

Instale o adicional para programao em Adv/PL TOTVS em seu TOTVS | Developer Studio.

Verifique a perspectiva TOTVS Developer e as suas vises.


12/69



Verso 11.5

5. Ajustando as preferncias do TOTVS | Developer Studio

O TOTVS | Developer Studio possui alguns comportamentos que podem ser configurados pelo usurio, de acordo com suas

preferncias ou ainda, ajud-lo no seu dia a dia.Acione o menu Janela, opo Preferncias, obtendo uma tela semelhante a:

Na rvore de navegao ( esquerda) temos vrios grupos de opes a serem explorados. Aqui, abordamos apenas as opes

especficas do TOTVS | Developer Studio.

5.1.

Autorizao

Tela de preferncia para informar a chave especial de compilao para fontes AdvPL.

5.2.

Developer Studio Editor

Ao acionar o n Developer Studio Editorsero exibidas as preferncias gerais, permitindo assim as configuraes sobre

o comportamento do editor.

Salva fonte automaticamente antes de compilar - se ativada, ao compilar os fontes sofrer edio desde altima compilao. Sero salvos sem solicitar confirmao.

Habilitar auto-aspas - se ativada, ao ser digitado (aspas duplas), ' (aspas simples), [ (colchetes), ((parnteses), { (chaves) ou | (barra vertical), o editor ir inserir o seu equivalente para fech-lo.

Importante:

Os grupos podem variar bastante de instalao para instalao, em funo de pacotes adicionais (plug-ins)

instalados. Cada adicional ter alguns grupos a mais, consulte a documentao de cada adicional para mais

detalhes.


13/69



Verso 11.5

Tamanho da listas de arquivos recentemente abertos -informe a quantidade de arquivos que ser mantidano histrico de arquivos recentes.

Mostrar vrias guias do editor -se ativada apresentar diversas guias de apoio ao usurio, tais como linhas

modificadas, limites de blocos de cdigos entre outras. Permitir editores de sistema no local-se ativada, o editor registrado no sistema ser acionado para arquivos

com extenses no tratadas pelo editor, como por exemplo, arquivos PNG (imagens).

Restaurar estado do editor no arranque -se ativada, ao sair do TOTVS | Developer Studio ser armazenadauma srie de informaes, tais como, arquivos abertos, diretrios expandidos na rvore de projeto, arquivocorrente entre outras. Ao iniciar o TOTVS | Developer Studio novamente, estes dados sero recuperados e atela ser reconstituda da mesma forma que voc a deixou.

Fechar editores automaticamente-se ativo, quando a quantidade de editores abertos (arquivos em edio)

atingir o valor especificado em Numero de editores abertos antes de fechar, o editor ir pedir para salvar umarquivo qualquer e reutilizar este editor ou abrir um novo editor (opes configuradas em Quando todos oseditores estiverem sujos (editados) ou travados).

Dentro deste grupo possvel efetuar configuraes especficas para alguns processos.

5.2.1.

Auto-complete

Configure a abrangncia que ser utilizada na obteno de opes para seleo no autocompletar (control + barra de

espao).

Desabilitar pesquisa de funes/classes no RPO- ao ativar, o RPO ser desprezado como fonte de propostas.

Pesquisa funes/classes do RPO (Sintaxe Highligh e Auto complete) - se ativada ir pesquisar todo o RPOpara destacar sintaxe como fonte de propostas.

Pesquisa funes/classes do RPO (Auto complete) - se ativada ir pesquisar todo o RPO como fonte depropostas. Em mquinas no potentes, este processo pode ser bastante lento. Para minimizar esta situaoindique o nmero mnimo de caracteres digitados necessrios para que o autocompletar seja ativado.

5.2.2. Decorator AdvPL

Alm da decorao tradicional (marcas de erro, avisos entre outras) possvel habilitar um indicador de arquivos no

compilados no RPO em uso pelo ambiente selecionado, basta ativar a opo Marca arquivos que no esto

compilados no RPO.

Importante:

O autocompletar utiliza somente a fonte corrente e opes de templates, como fonte de opes da

lista. Esta configurao agrega maior abrangncia.

Importante:

Este processo pode ser demorado.


14/69



Verso 11.5

5.2.3. Performance

Em mquinas menos potentes, a edio de arquivos-fontes grandes pode ficar lenta. Se isso estiver acontecendo, a

performance pode ser melhorada desabilitando algumas funcionalidades em fontes grandes.

Desabilitar autocompletar - se ativada, para os fontes com linhas acima do informado, a facilidade de

autocompletar ser desativada para ele.

Desabilitar outline - se ativada, para os fontes com linhas acima do informado, a facilidade de estrutura(outline) ser desativada para ele.

Prioridade doJobde Carga de Fontes- ao abrir um projeto, este necessita mapear os arquivos existentes, edependendo da quantidade pode demorar um pouco e elevar o uso de CPU ao extremo. Pode-se ajustar aprioridade para baixa, de forma que isso no acontea.

5.2.4.

Modelos

Nesta pgina possvel consultar, manter ou criar modelos de cdigos, que sero apresentados como opo na lista

de propostas ao acionar o autocompletar (control + barra de espaos).

5.2.5. Server

Permite configurar o comportamento do compilador, do pr-compilador e dos servidores.

5.2.6.

Compilador/Pr-Compilador

Gera arquivos PPO na compilao - se ativado, depois da compilao gera o arquivo de pr-processamento

(extenso PPO).

Exibir contedo do AdvplASP progressivamente no browser- se ativado, os programas escritos em AdvplASPiro enviar dados ao navegador (browser) durante o processamento desde o nicio e no s ao final (padro).

Incluir informaes de depurao em AdvplASP- se ativado, incorpora aos programas escritos em AdvplASPinformaes adicionais para sua depurao.

Visualizar PreComp CommandLine Result- se ativo, apresenta em consolea linha de comando e o resultadodo processamento do pr-compilador.

5.2.7.

Configuraes do servidor

Tempo de verificao de conexo do TOTVSAPPSERVER (segundos) - se preenchido, indica qual o intervalo(em segundos) para que o TOTVS | Developer Studio verifique se a conexo com o servidor TOTVSAPPSERVERainda esta ativa ou no.

Tempo de verificao de conexo do TOTVSDBACCESS (segundos) - se preenchido, indica qual o intervalo (emsegundos) para que o TOTVS | Developer Studio verifique se a conexo com o servidor TOTVSDBACCESSainda esta ativa ou no.

Tempo de atualizao do AdvPL Monitor (segundos) - se preenchido, indica qual o intervalo (em segundos)para que o TOTVS | Developer Studio solicite ao servidor informaes sobre atividades em execuo.

Velocidade de Atualizao das Infos do Monitor DBAccess- se preenchido, indica qual a frequncia para queo TOTVS | Developer Studio solicite ao servidor DBAccess informaes sobre suas atividades.


15/69



Verso 11.5

5.3.Developer Studio Help

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

processos.

5.4.

Developer Studio Robo de Testes

Permite configuraes internas para geraes de patch.

5.5.

Includes

Permite configuraes de arquivos de includes globais para serem adicionados aos projetos TOTVS.

5.6.

Configurao de Servidores TOTVS

Para a adio de servidores TOTVS utilize a perspectiva TOTVS Server. Esta perspectiva rene as janelas mais comuns

para gerenciamento e acesso aos servidores.

5.6.1. Acessando a perspectiva TOTVS Server

Para acessar a perspectiva TOTVS Server, ou qualquer outra, selecione-a por meio do seletor de perspectiva ou pelo

menu Janela | Abrir perspectiva | Outrose escolha TOTVS Server. A perspectiva TOTVS Server apresenta diversas

vises, porm se destacam:

Viso Servers Extension localizada por padro esquerda do TDS, podemos definir quais servidores vamosutilizar, permitindo tambm, efetuar configuraes e obter informaes sobre o processamento (quandodisponvel).

Viso TOTVS Server Outlinelocalizada por padro direita do TDS, permite uma navegao rpida entre as

opes/abas de configurao de um servidor previamente selecionado.

Vises informativasgeralmente localizadas na parte inferior do TDS, contm algumas vises (views) cominformaes adicionais sobre o servidor, tais como usurios conectados e pelo menu de contexto desta,algumas operaes com o servidor.


16/69



Verso 11.5

Na imagem acima temos a perspectiva TOTVS Servers. No item A temos a viso Servers Extension, no item B temos a

viso TOTVS Server Outlinee no item C temos a vises informativas, entre estas temos a viso TOTVS Application

Monitor e TOTVS DBAccess Monitor, respectivamente, as vises de monitoramento de servidores TOTVS e

servidores DBAccess.

Para acessar as diversas aes disponveis em servidores TOVS acione o menu de contexto sobre o elementoServidoresda viso Servers Extension, item A da imagem acima. Entre as diversas opes esto:

Opo Descrio da funo

Novo Grupo de Servidores Permite criar um elemento na rvore que agrupa servidores.

Servidor de Aplicao Apresenta a lista de tipos de servidores disponveis.

Servidor 4GL Inicia a configurao de um servidor com suporte a 4GL.

Servidor 4GLP Inicia a configurao de um servidor com suporte a 4GLP.

Servidor Adv/PL Inicia a configurao de um servidor com suporte a Adv/PL.

Servidor DBAccess Apresenta a lista de tipos de servidores disponveis.

Servidor DBAccess Inicia a configurao de um servidor DBAccess.

Conexes ativasFora uma atualizao das abas informativas para os servidores

conectados.


17/69



Verso 11.5

5.6.2. Adicionando um servidor

Para adicionar um servidor acione o menu de contexto sobre o elemento Servidores da rvore de navegao da

viso Server Extension, acione a opo Servidor de Aplicao | Servidor Adv/PL (ou o mais conveniente).

Aguarde que ser inicializado um assistente para que sejam informados os dados solicitados do servidor. Clique em

Concluir para terminar o cadastro do servidor.

possvel editar ou corrigir os dados de conexo deste servidor, modificando os dados disponveis nas pginas (na

parte de baixo da viso) e acionando a oposalvapor meio do atalho CTRL + S.Ao finalizar o cadastro do servidor, este aparecer na listagem de servidores. Ao acionar o menu contexto deste

elemento teremos algumas opes:

Opo Descrio da funo

Conectar Servidor Conecta-se ao servidor conforme as informaes constantes na configurao.

Remover Remove as configuraes do servidor, tornando-o inacessvel.

Importante:

As opes acima podem variar de acordo com os adicionais instalados, por exemplo, caso tenha

instalado somente o adicional Adv/PL na opo Servidor de Aplicao acima, s ter disponvel o

Servidor Adv/PL. Para outros servidores de aplicao necessria a instalao de um adicionalespecfico.


18/69



Verso 11.5

5.6.3. Conectando-se ao servidor

Aps a configurao de um servidor acione o menu de contexto sobre o elemento na rvore de navegao e acione a

opo Conectar Servidor.Os servidores com suporte a Adv/PL iro solicitar algumas informaes antes de efetuar a conexo. Informe os dados

solicitados. Se desejar, pode salvar o Usurioe Senhaem um local seguro acionando a opo Salvar as informaes

de login em local seguro.

Aps efetuar a conexo com o servidor, o menu de contexto do servidor passar a conter algumas outras opes:

Opo Descrio da funo

Desconectar Servidor Encerra a conexo com o servidor.

Conexes ativas Fora uma atualizao das abas informativas para os servidores conectados.

Para o Servidor Envia ao servidor um comando de parada (shutdown).

Desabilita conexo Envia ao servidor um comando para rejeitar novas conexes.

5.6.4. Configurao do servidor

Aps a conexo clique duas vezes sobre o servidor previamente cadastrado e obtenha informaes sobre o servidor

em questo. Estas informaes sero apresentadas rea de editores, que sero as configuraes do servidor

oriundas do arquivo appserver.ini.

Ao cessar qualquer uma das pginas disponveis possvel efetuar modificaes de configurao, e ao salvar as

modificaes, estas sero persistidas no arquivo ini do servidor. Pode-se salvar a qualquer momento ao acionar a

tecla de atalho CTRL + S.

Alm de todas as configuraes do servidor, nessa tela temos trs grandes funcionalidades, Inspetor de Objetos, Log

de Repositrio e Desfragmentar Repositrio.

5.6.4.1.Inspetor de Objetos

Esta funcionalidade utilizada para visualizar todos os Programas (Funes), os quais se encontram Compilados no

RPO em uso.Para acessar os Inspetores de Objetos selecione a aba Environment. Selecione um ambiente e clique no boto

Inspetor de Objetos. Verifique se ser iniciado o carregamento do RPO.

Importante:

Durante e depois do processo de conexo acompanhe as ocorrncias na viso console (geralmente

localizada na parte inferior do TDS).

Importante:

Para saber como configurar e o que configurar em cada um dos servidores

consulte a documentao especfica.


19/69



Verso 11.5

Em seguida, ser apresentada uma lista com todos os arquivos fontes, contendo funes, arquivos HTML, ADVPL-

ASP e imagens, que se encontram compilados no RPO em uso.

5.6.4.2.

Log do Repositrio

Utilizado para visualizar todo o histrico sobre o RPO em uso, poderemos por meio desta opo visualizar as datas

dos ltimospatchesaplicados, o contedo dospatchese a data da buildutilizada.

Para acessar o Log do repositrio selecione a aba Environment. Selecione um ambiente e clique no boto Log do

Repositrio.

No lado esquerdo da tela visualizamos o histrico dospatchesaplicados. Quando selecionarmos um dos registros,

no lado direito da tela ser informada mais detalhadamente a data de gerao e aplicao dapatch, juntamente

com o contedo dela e a data da build.

5.6.4.3.

Desfragmentar repositrio

Utilizado para desfragmentar repositrio do servidor e ambiente selecionado. Para acessar selecione a aba

Environment. Selecione um ambiente e clique no boto Desfragmentar repositrio.

5.6.5.

Selecionando o servidor para a sua utilizao

Aps o cadastro, a configurao e a conexo de um servidor TOTVS tm que selecionar um servidor para utilizao

no TOTVS | Developer Studio. Para isso, selecione o servidor e ambiente localizados na barra de ferramentas.

Agora poderemos compilar programas, executando-os (run) e/ou depurando-os (debug).

Exerccio:

Adicione um servidor da Linha de Produto Microsiga Protheus, previamente instalado. Lembre-se de

conectar ao servidor.D um duplo clique no servidor cadastrado e visualize as informaes do servidor.Altere alguma informao e salve-a.

Importante:

necessrio ter acesso exclusivo ao repositrio para desfragment-lo. Esse processo ir reduzir o

tamanho do repositrio reescrevendo-o e eliminando o espao ocupado por rotinas antigas. Este

processo pode demorar alguns momentos para ser executado.


20/69



Verso 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 organizao inicial de um trabalho no TOTVS | Developer Studio o projeto. Em cada rea de trabalho (workspace)

possvel colocar quantos projetos desejar e fazer a administrao por meio da visoTOTVS Explorer.

Logo abaixo do ttulo da aba e da barra de ferramentas acione o menu de contexto e nas opes apresentadas acione

Novo | Outras ou Importar. Ser apresentado o assistente de novos elementos ou assistente de importao (conforme

a opo utilizada).

Utilizando a rvore de navegao localize TOTVS Wizard, expanda-o e obter as opes:

Importar projeto Adv/PLA partir de um arquivo de projetos (*.prj) preparado um projetoTOTVS.

Novo Projeto TOTVS inicializado um projeto TOTVSvazio, contendo uma estrutura bsica.


21/69



Verso 11.5

Selecione a melhor opo e prossiga com a execuo do assistente.

Optando por importar o arquivo .prj do antigo TOTVS DevStudio, o wizard passar pelos seguintes passos, portanto,

informe:

O arquivo de projetos DevStudio (*.PRJ) a ser importado (item A). Para selecionar mais de um projeto acionea tecla Ctrljunto com o boto direito, porm estes projetos devem estar sob o mesmo diretrio.

Indique se quer ou no importa-lo como um novo projeto (item B). Caso desmarque esta opo deverselecionar o Destinodeste projeto.

Indique o mtodo de importao (item C). Entre os mtodos disponveis esto:

- Manter os fontes no diretrio de origem (legado) Ao utilizar esta opo, as pastas (folders) earquivos sero anexadas ao projeto TOVS por meio de uma ligao simblica (symbolic link), ouseja, os arquivos continuam nos diretrios de origem e uma referncia a ele criada. Qualquer

edio efetuada, usando-se o TDS ou qualquer outro editor externo ser refletida em ambos osambientes. Como trata-se de uma ligao simblica, ao acionar a remoo ser apagado apenas areferncia e no o arquivo fsico.

Importante:

Arquivos de projeto (*.prj) so utilizados no DevStudio (antigo IDE da Linha de Produto Microsiga

Protheus). O arquivo de projeto (*.prj) utilizado somente no momento da importao. Qualquer

modificao posterior neste arquivo, no ser refletida no projeto importado para oTDSe vice-versa.


22/69



Verso 11.5

- Copiar arquivos para a area de trabalho do TDSEsta opo efetua uma cpia fsica das pastas(folders) e arquivos referenciados pelo arquivo de projeto (*.prj) para dentro da rea de trabalho(workspace) em uso. Neste caso, qualquer alterao efetuada em uma das cpias, no serrefletida no outro ambiente.

Em Diretrios para Busca(item D) - Adicione os diretrios que devero ser pesquisados para resoluo de

arquivos de definies (*.ch) que so referenciados nos fontes. Ao lado direito temos os botes para efetuarestas operaes. Alm disso, possvel adicionar referncia s outras configuraes desta lista de busca(item E), que ser utilizada juntamente com as outras. Para detalhes, veja Configurao de diretrios debusca.

Finalize a edio e aguarde o processamento. Ao final obter mais um novo projeto TOTVS. Na viso TOTVSExplorerteremos o projeto contendo as pastas, subpastas e os arquivos fontes contidos no antigo projeto.

Caso a escolha no TOTVS Wizardtiver sido por um novo projeto TOTVS ser criado um projeto com uma sugesto de

estrutura de pastas (folders).

Para isso, no wizard ser necessrio informar os seguintes dados:

Informe o nome do projeto (item A). Em Diretrios para Busca (item B) adicione os diretrios que devero ser pesquisados para resoluo de

arquivos de definies (*.ch) que so referenciados nos fontes. Ao lado direito temos os botes para efetuarestas operaes. Alm disso, possvel adicionar referncia s outras configuraes desta lista de busca(item C), que ser utilizada juntamente com os que informar. Para detalhes veja Configurao de diretriosde busca.

Exerccio:

Crie uma rea de trabalho e um novo projeto.

Caso tenha arquivos-fontes em Adv/PL ou possua um arquivo *.prj importe-o para o TOTVS |Developer Studio.


23/69



Verso 11.5

6.2.Criando arquivos-fonte

Para criar um novo arquivo fonte selecione o projeto e, opcionalmente, a pasta em que ser armazenado o arquivo

fonte.Para criao de arquivo fonte, o TOTVS | Developer Studio disponibiliza um assistente de criao. Acione o menu de

contexto na viso TOTVS Explorer, acessando a opo Novo | Arquivo. possvel tambm acessar o menu Arquivo |

Novo, selecione a opo Outros. Faa a expanso das opes de criao de fontes da TOTVS.

Neste assistente estaro disponveis diversos tipos de arquivos-fontes TOTVS. Selecione um deles, uma pasta estar

disponvel por padro, porm se quiser modificar o local, utilize a rvore de navegao para selecionar a nova pasta

(itens A e B). No campo Nome do Arquivo (item C) informe o nome do arquivo fonte.

Logo abaixo, existe um o boto Avanado>>, que se acionado apresentar a opo para criar uma ligao simblica

(symbolic link) com um arquivo j existente do seu sistema de arquivos. Se desejar criar como ligao simblica marque

a opo Link to file in the file systeme selecione o arquivo acionando o boto navegador(item D).

Finalize e aguarde o processamento. Ao final, ter o arquivo fonte criado conforme o tipo de arquivo fonte selecionado,este arquivo fonte j vir preenchido com um template.

Importante:

Caso tenha optado pela ligao simblica, o arquivo j aparecer com o contedo e o cone ter uma

pequena seta a sua direita. Lembre-se que neste caso, todas as alteraes que efetuar sero gravadas

no arquivo fonte original.


24/69



Verso 11.5

6.3.Edio de arquivos-fonte

Durante a edio do arquivo fonte, a viso Outline ser atualizada com a identificao dos principais blocos do seu

arquivo fonte. Se o mouse for acionado sobre um destes itens, seu arquivo fonte ser reposicionado para esteelemento.

Na viso TOTVS Explorer possvel tambm obter a lista dos principais blocos, se expandir o elemento (click no

tringulo vazado).

A edio de arquivos-fontes bem simples. Localize na rvore de navegao do TOTVS Explorer o arquivo desejado e

efetue um duplo clique ou acione o menu de contexto sobre o arquivo e a opo Abrir.

6.4.

Adio de arquivos de recursos

Extenses que no so reconhecidas como de arquivos-fontes pelo TOTVS | Developer Studio, por exemplo, a extenso

.bmp(arquivo de imagem), este arquivo adicionado como recurso e ao ser compilado ser anexado como tal, sendo

possvel acess-lo com o uso de funes especficas da linguagem.

6.5.

Compilao de arquivos e projetos

Antes de efetuar a compilao de um arquivo, pasta ou projeto necessrio estar conectado a um servidor (veja

Perspectiva TOTVS Server), na barra de ferramentas necessrio indicar qual servidor ser utilizado e no caso de

Adv/PL, o ambiente.

Para compilar, depois de indicar o servidor e ambiente, acione Ctrl+F9ou o menu de contexto sobre a rea do editor ou

sobre o elemento do arquivo (na rvore de navegao).

O referido fonte ser compilado e na viso console (uma das abas informativas) obteremos informaes relativas

compilao, tais como, se foi ou no bem sucedida, e neste caso, os motivos.

A viso TOTVS Explorer, tambm informa se h problemas de compilao, colocando um pequeno sinal indicativo.

Neste caso, tambm ser indicada na rea do editor linha que esta com erro (item A da imagem a seguir). Ao passar o

mouse sobre esta marca obtm-se uma janelapopupindicando o erro.


25/69



Verso 11.5

No lado oposto temos uma barra indicativa, que na sua altura, representa o seu arquivo fonte e a as marcaes

existentes indicam o local relativo de erro (item B). Ao clicar nesta marca, o editor ser posicionado nesta posio.

Esta barra tambm pode conter outras indicaes baseadas em cor, indicando alguma ocorrncia, por exemplo, avisos

do compilador e mudanas ocorridas.Na rea de abas informativas temos a viso Problemas, que possui uma lista de todas as ocorrncias da compilao,

erros e avisos (item C da imagem a seguir). Se a linha de mensagem for acionada com um duplo clique, o fonte ser

aberto e posicionado no local indicado.

6.6.Compilando Pastas e Projetos

Para compilar pastas (folders) ou o projeto acione o menu de contexto sobre o elemento a ser compilado na rvore de

navegao da viso TOTVS Explorer e acione a uma das seguintes opes: RecompilarRecompila todos os elementos do projeto ou pasta(folder).

Compilar- compila todos os elementos do projeto ou pasta que foram modificados ou que no existam norepositrio (RPO). Nesta opo, os arquivos que no sofreram alteraes sero ignorados (ouskiped).

Como estes processos podem levar algum tempo ser aberta a viso Progresso, que efetuar o processamento em

paralelo e mostrar o resultado da execuo da tarefa ao ser executada.

Importante:

Para ativar a numerao de linhas e outros comportamentos do editor acione o menu de contexto do editor,

acesse a opo Prefernciase depois Show Line Numbers.

Importante:

A viso Progresso utilizada em diversas situaes, normalmente naquelas que podem demandar algum

tempo de processamento.


26/69



Verso 11.5

6.7.Gerenciamento de projetos

Na aba TOTVS Explorer, utilizando o menu de contexto possvel gerenciar seus projetos. As opes do menu de

contexto dependero do item da rvore de navegao que for selecionado.

Para identificao temos os seguintes cones:

Identifica projetos TOTVS.

Identifica pastas ou subpastas de projetos TOTVS.

Identifica arquivos-fontes TOTVS. Arquivos-fontes linkados tero uma seta inferior direita.

O menu de contexto para projetos TOTVS ser (verifique na coluna se aplica ):

Aplica-se Opo Descrio da Funo:

Novo Submenu para novos elementos.

Projeto Inicializa um novo Projeto.

Arquivo Inicializa um novo Arquivo.

Pasta Inicializa uma nova Pasta.

Outros Inicializa o assistente de novos elementos.

Vai para Coloca o elemento selecionado, como sendo o elemento raiz do

navegador (temporamente). Para restaurar acione Para cimanabarra de ferramentas, logo abaixo do ttulo.

Copiar (ou CTRL+C) Copiar o elemento para a rea de transferncia.

Colar (ou CTRL+V) Colar o contedo transferncia (clipboard).

Remover (ou DELETE) Remove o elemento da rvore.

Renomear (ou F2) Modifica o nome do elemento.

Importar... Inicia o assistente de importao.

Exportar... Inicia o assistente de exportao.

Atualizar (ou F5) Atualiza a rvore de navegao.

Atualizar definio

WSDL

No caso de arquivo fonte conter uma definio de cliente de

web-service, ser reprocessado.Fechar Projeto Fecha o projeto, mas mantm o elemento.

Fechar Projetos no

relacionados

Fecha todos os projetos no relacionados entre si.

Recompilar Recompila todos os elementos no projeto, pasta/subpasta ou

compila o elemento.

Compilar Compila todos os elementos no projeto, pasta/subpasta ou

compila o elemento.

Executar como... Permite executar o projeto.

Configurar

execucao...

Permite editar as configuraes de execuo.

Depurar como... Permite executar o projeto em modo de depurao (debug).

Configurar

depurao...

Permite editar a configuraes de depurao.

Exerccio:

Compile os projetos criados no exerccio anterior. Visualize a ocorrncia de possveis erros e mensagens

informativas.


27/69



Verso 11.5

Equipe Opo que permite gerenciar trabalhos em equipe.

Comparar com... Inicia o processo de comparao entre elementos.

Restaurar do

histrico local...

Permite recuperar verses anteriores a partir do histrico local.

Fonte Subopes relacionadas s fontes de projeto.

Formatar Executa a formatao de arquivos-fontes

Propriedades (ou

ALTER+ENTER)

Apresenta uma janela com informaes sobre o elemento.

6.8.

Execuo de projetos

6.8.1. Bsico

Uma vez que o projeto esteja compilado e sem erros possvel execut-lo (run) ou depurar (debug) seus

programas. Tanto a execuo como a depurao realizada por meio de configuraes de executores (oulauchers).

Para configur-los acione o menu suspenso do boto Executarou Depurar, selecionando a opo Configurao...

(em ingls Run Configurations...).

Na janela de configurao possvel adicionar, duplicar e remover executores. Selecione a opo TOTVSLaunchere

acione a opo Novona barra de ferramentas (item A da imagem a seguir).

Na tela apresentada temos os campos:

Nome: informe um identificador para o novo executor (item A da imagem a seguir).

No bloco Ambiente de execuo(item B da imagem a seguir), com:


28/69



Verso 11.5

Utilizar servidor de aplicao interno: se estiver marcado exige o uso de um servidor interno configurado eser utilizado o executvel doSmartClient(remote) que encontra-se na instalao do TOTVS | DeveloperStudio.

Executvel do Remote: informe ou selecione o caminho do executvel do remote SmartClientTOTVS. Parametros do remote: informe os parmetros da linha de comando que ser utilizada na execuo do

SmartClient (remote).

Programa Inicial: informe o nome do programa que ser executado (programa principal). Pode-se deixaresta opo em branco, neste caso quando houver a execuo ou depurao ser necessrio informar oprograma inicial.

Parametros do programa: informe os parmetros de execuo e/ou depurao requisitaos pelo programainicial. Pode-se deixar esta opo em branco, neste caso quando houver execuo ou depurao sernecessrio informar os parametros do programa inicial.

Habilitaprofilede execuo: se marcado, ao final da execuo ser apresentados os resultados doprofiledesta execuo.

Para salvar as configuraes e continuar a edio acione Aplicar ou se desejar cancelar as alteraes efetuadas

acione Reverter. Ao informar os dados mnimos necessrios, o boto Executar ser habilitado e se acionado,

iniciar a execuo. O boto Fecharencerra a edio.

Se solicitar a execuo pelo acionamento do boto Executar ou pelo menu suspenso dos botes Executar ou

Depurarser apresentada a tela de confirmao.

Na caixa suspensa informe o nome do programa a ser executado.

Caso o campo Programa Inicialseja preenchido, ser usado como valor padro para a caixa suspensa.


29/69



Verso 11.5

Depois de criar e usar um executor poder acion-lo diretamente pelo menu suspenso dos botes Executar ou

Depurar, selecionando a configurao ou utilizando as teclas de atalho F11 e Ctrl+F11, para executar a ltima

configurao utilizada para depurar ou executar (respectivamente).

6.8.2. Avanado

Na configurao avanada, utilizamos as demais abas com opes especficas.

A aba Cobertura de Cdigo(ou em ingls Coverage) permite habilitar a cobertura do cdigo nos fontes. Para isso,

marque a opo Habilitar cobertura de cdigo(item A da imagem a seguir) e utilizando os botes direita (item B

da imagem a seguir), informe os fontes que sero analisados.

Na aba Fontes (ou em ingls Source) informe onde o depurador deve procurar os fontes (item A da imagem a

seguir), sendo o padro o seu projeto. Utilize os botes direita, para adicionar outros diretrios para a busca (item

B da imagem a seguir).


30/69



Verso 11.5

A aba Comun (ou em ingls Common), contm algumas opes de configurao da visibilidade e outras opes

ligadas diretamente configurao do executor. Estas opes raramente sero modificadas.

Nesta aba temos:

Salvar como (item A da imagem acima): indique se os dados de configurao sero salvos localmente (no

seu workspace) ou em rea compartilhada (externa).

Apresentar como favorito (item B da imagem acima): indique em qual menu suspenso a configurao deveaparecer. Caso no selecione nenhuma, esta ser apresentada em todos os menus suspensos.

Encoding (item C da imagem acima), permite definir o formato da codificao do arquivo de configurao.

Entrada e sada padro (item D da imagem acima), permite configurar a apresentao ou no da visoconsoleou a sua gravao em arquivo.


31/69



Verso 11.5

6.9.Depurao de projetos

A configurao do executor (laucher) com depurao exatamente o mesmo utilizado na execuo, portanto, o

executor configurado poder ser utilizado tanto na execuo como na depurao de projetos.

Para demonstrar o uso do depurador com pontos de parada e outras funcionalidades usaremos o programa abaixo

e passaremos passo a passo pela depurao deste programa. Sugerimos que o copie e cole em um novo arquivo

fonte Adv/PL.

user function calcFatorial()local n

conout("Calculo de Fatoriais")

resultado := "Numero = Fatorial" + chr(13)

for n := 1 to 5 step 2calcula(n*2)

next

conout(resultado)

return

static function calcula(anNumber)local x := anNumberlocal total := 1

while (x > 1)total := total * xx--

end

resultado += str(anNumber,3) + " "resultado += transform(total, "@E 9,999,999,999")

resultado += chr(13)return

Aps a compilao do arquivo fonte acima, execute-o acionando o boto Executar (se necessrio configure um

executor). Aps encerrar a execuo e com o editor ativo (a aba fica destacada), acione Ctrl+F10 e ative a

numerao de linhas.

Importante:

Caso tenha efetuado a configurao do executor, j possuir a mesma configurao para a depurao.


32/69



Verso 11.5

Efetue um duplo clique sobre o nmero 6 (linha 6). Repare que na barra cinza do lado esquerdo aparece uma marca

azul. Esta marca indica um ponto de parada (breakpoint). Teremos algo semelhante imagem abaixo, note a marca

caracterstica do ponto de parada perto do nmero 6.

Inicie o depurador acessando o boto do menu suspenso Depurar (boto localizado ao lado do Executar) e

selecione o executador.

Aguarde alguns instantes e ser solicitado o programa inicial, informe o programa inicial. Devido o ponto de parada

definido na linha 6, o depurador ser selecionado.

Como a perspectiva atual, TOTVS Developer, no a mais indicada para depurao ser sugerido troca para a

perspectiva TOTVS Debuger. Aceite a troca e a perspectiva de depurao chamadaDebug que ser apresentada.

Importante:

Quando iniciarmos a depurao, o depurador ir parar a execuo nos pontos de parada que tiverem

sido atribudos ao arquivo fonte e aguardar instrues do desenvolvedor. No caso em que o arquivofonte no possua pontos de parada, a depurao no ir parar em nenhum momento.


33/69



Verso 11.5

Na perspectiva de depurao (debug) teremos diversas novas vises, entre elas as Vises Debug, Breakpoint,

Adv/PL Commands, Tabela de Dados, Variables, Expression entre outras. Existem diversas abas informativas que

do apoio ao desenvolvedor no momento de depurao.

Abaixo detalharemos as principais vises.

6.9.1.

Viso Debug

A viso Debugapresenta a pilha de execuo, indicando o caminhoefetuado at chegar ao ponto de parada.

Teremos na barra de ferramentas desta viso, as seguintes funcionalidades:

Remove o histrico de execuo j finalizada (item 1).

Continua a execuo at encontrar um novo ponto parado ou o trmino do programa (item 2).

Pausa a execuo (item 3).

Encerra a execuo (item 4). Executa um passo, se for chamada de mtodo ou funo, para na primeira instruo desta (item 5).

Executa um passo, se for chamada de mtodo ou funo, execute-a sem parar dentro desta (item 6).

Importante:

A linha corrente em que a depurao estiver parada ficar destacada das demais linhas.


34/69



Verso 11.5

Executa at finalizar (retornar) do mtodo ou funo (item 7).

6.9.2. Viso Breakpoint

A viso Breakpoint apresenta a lista de pontos de paradas (ou em ingls Breakpoint), definida nos projetos que

esto em aberto no workspace.

Temos na barra de ferramentas desta viso as seguintes funcionalidades:

Remove os pontos de parada selecionados (item 1).

Remove todos (item 2).

Abre e posiciona-se no arquivo fonte associado (item 3).

Ignora todos os pontos de parada (item 4).

6.9.3.

Viso Tabela de Dados

A viso Tabela de dados apresenta as tabelas da Linha de Produto Microsiga Protheus abertas durante o

processamento da depurao. Esta viso no possui funcionalidades, servindo para auxiliar no acesso e consulta s

tabelas e campos abertos.

6.9.4. Viso Adv/PL Commands

A viso Adv/PL commands permite ao desenvolvedor realizar os comandos Adv/PL em tempo de execuo com

resposta imediata.

6.9.5. Viso Variables

A viso de Variablespermite verificar os valores das variveis declaradas no programa que foi depurado. Por meio

da barra de ferramentas desta viso possvel configurar a visibilidade, baseada em escopo, das variveis que sero

apresentadas.

6.9.6. Viso Expression

A Viso de Expressions permite definir expresses que so avaliadas a cada passo.

Voltando ao nosso processo de depurao, neste momento estamos parados na linha 6 do calcFatorial. Acione F5

para executar um passo.

Importante:

Ao clicar na definio de um ponto de parada, o desenvolvedor ser levado at o ponto em que o ponto de

parada foi definido.


35/69



Verso 11.5

Repare que na linha 8, do lado esquerdo h uma pequena seta azul, indicando a prxima linha a ser executada.

Acione F5, at que seja possvel entrar na funo calcula.

Repare que a viso Variveis teve seu contedo atualizado. Estando dentro de um mtodo ou funo, se acionar F7

a execuo prosseguir, parando somente quando sair do mtodo ou funo. Neste exemplo, o depurador vai

executar toda a funo calcula, parando somente na linha 10 (logo aps a chamada).

possvel tambm adicionar pontos de parada a qualquer momento, efetuando um duplo clique sobre o nmero

da linha. Faa isso na linha 26.

Acionando F8 (continuar execuo), o processamento ir ser executado at o prximo ponto de parada, nesse caso

ser o ponto de parada na linha 26. Acione o F8 para continuar a execuo.

Exerccio:

Crie um arquivo fonte contendo o cdigo do exemplo de depurao:

user function calcFatorial()local nconout("Calculo de Fatoriais")resultado := "Numero = Fatorial" + chr(13)for n := 1 to 5 step 2

calcula(n*2)nextconout(resultado)

return

static function calcula(anNumber)local x := anNumberlocal total := 1

while (x > 1)total := total * xx--

end

resultado += str(anNumber,3) + " "resultado += transform(total, "@E 9,999,999,999")resultado += chr(13)

return

Crie um executor TOTVS. Execute-o. Aps a execuo, coloque alguns pontos de parada pelo cdigo

fonte.

Veja as diveras vises da perspectiva Debug. Execute alguns comandos via viso Adv/PLCommands.

Adicione as variveis ne x viso Varivel.De ure o ar uivo fonte acima e ve a o resultado ao ercorrer a de ura o do ar uivo. Lembre-se


36/69



Verso 11.5

7. Assistente de Cdigo

O TOTVS | Developer Studio disponibiliza um assistente de cdigo que ao ser acionado, auxiliar o desenvolvedor na criao

de programas Adv/PL com funcionalidades especficas, conforme as informaes fornecidas.Para acess-lo acione menu: Arquivo | Novo | Assistente de Cdigo

Indique o Localem que o arquivo fonte ser salvo e informe o Nome do Fonte. Selecione na listagemTipos de Assistente, o

tipo de assistente. Acione o boto Prximo.

Conforme o Tipo de Assistente selecionado, seremos guiados por uma ou mais pginas para complementar os dados

necessrios para a gerao do arquivo fonte. Hoje existem 4 tipos de assistente:

Cadastro

Gerao de Arquivo Texto

Importao de Arquivo Texto

Processamento Genrico


37/69



Verso 11.5

7.1.Assistente de cdigo: Cadastro

Este tipo de assistente auxilia na criao arquivos-fontes, capazes de efetuar manuteno de dados em tabelas.

Selecione o tipo template, em Cadastro -Tipo de arquivo, conforme a origem da definio da tabela. Existem 2 tipos,Arquivo Padroou Arquivo Especfico.

Caso a opo escolhida em Cadastro -Tipo de arquivotenha sido por Arquivo Padroteremos a seguinte tela:

O Arquivo padro (item A da imagem acima) utilizado quando a definio da tabela a mesma do dicionrio de

dados, preenchendo os dados solicitados.

Parmetros: identifica uma Pergunta definida no dicionrio de dados da Linha de Produto Microsiga

Protheus.

Alias, (item B): no caso de arquivo padro, este ser utilizado para localizar as definies no dicionrio dedados, caso seja arquivo especfico ser utilizado para identificar a rea de trabalho (select area).

A ordem de apresentao dos dados definida por uma das seguintes opes:

Utilize ndice padro (item C): indica qual o nmero do ndice do dicionrio de dados, associado aoalias, queser utilizado.

Utiliza ndice temporrio (item D): informe uma expresso Adv/PL vlida para indicar a ordem dos dados.Este ndice de uso temporrio, sendo eliminado depois do seu uso.


38/69



Verso 11.5

Caso a opo escolhida em Cadastro -Tipo de arquivotenha sido porArquivo Especficoteremos a seguinte tela:

O Arquivo especfico utilizado para uma estrutura livre da tabela.

Parmetros (item A): identifica uma Perguntadefinida no dicionrio de dados da Linha de Produto MicrosigaProtheus.

Estrutura (item B): utilizado para definir a estrutura da tabela. Utilize os botes direita para adicionar ouremover atributos (campos).

Indexado (item C): se marcado indica que a tabela ser ordenada pela expresso Adv/PL informada nocampo Chave.

Acione Prximo (ou Next) no item D para ir para a prxima etapa, em que sero complementados os dados, podendo

detalhar funcionalidades.

Selecione o template de cadastro, conforme a visualizao e comportamento desejado:

axCadastro: cadastro Padronizado, que ir utilizar a funo axCadastro da biblioteca Adv/PL.

Mbrowse: definindo opes, que iro utilizar a funo mBrowse da biblioteca Adv/PL.


39/69



Verso 11.5

Nas abas abaixo possvel efetuar algumas customizaes:

Aba Botes - utilizada somente pela opo de template Mbrowse, e permite adicionar ou removerfuncionalidades a tela.

Aba Campos: permite indicar campos e customizar alguns atributos. Caso os campos no sejam

especificados, sero utilizados todos os definidos no dicionrio de dados ou na definio de tabelacustomizada.

Configuraes: permite definir propriedades opcionais como o Titulo a ser utilizado na janela e CampoDiferenciadore expresso Adv/PL, utilizada pela mBrowsepara agrupar os dados.

Ao preencher todos os dados obrigatrios solicitados, finalize o processo. Ser criado um arquivo fonte conforme o

nome e local escolhido, contendo o cdigo gerado pelo assistente.

7.2.

Assistente de cdigo: Gerao de Arquivo Texto

Este tipo de assistente auxilia na criao dos arquivos-fontes, capazes de gerar arquivos textos a partir de uma tabela

de dados. Existem dois modelos ou tipos de gerao de arquivo texto. So eles por Arquivo Padro e por Arquivo

Especfico.

Caso a opo escolhida em Gerao de TXT -Tipo de arquivotenha sido porArquivo Padroteremos a seguinte tela:


40/69



Verso 11.5

A Gerao de Arquivo Texto por Arquivo padro utilizada quando a definio da tabela a mesma do dicionrio de

dados, preenchendo os dados solicitados. Ser necessrio preencher as seguintes informaes:

Parmetros: identificado por A na imagem acima, identifica uma Pergunta definida no dicionrio de dados daLinha de Produto Microsiga Protheus.

Alias: identificado por B na imagem acima, ser utilizado para localizar as definies no dicionrio de dados. Caso

seja arquivo especfico ser utilizado para identificar a rea de trabalho (select area).

A ordem de leitura dos dados definida por uma das opes no item C:

Utilize ndice padro: indica qual o nmero do ndice do dicionrio de dados, associado aoalias, que serutilizado.

Utiliza ndice temporrio: informe uma expresso Adv/PL vlida para indicar a ordem dos dados. Este

ndice de uso temporrio, sendo eliminado depois de seu uso.

Caso a opo escolhida em Gerao de TXT -Tipo de arquivotenha sido porArquivo Especficoteremos a seguinte

tela:

A Gerao de Arquivo Especfico utilizada para uma estrutura livre da tabela.Ser necessrio preencher as seguintes

informaes:

Parmetros: identificado por A na imagem acima, identifica uma Pergunta definida no dicionrio de dadosda Linha de Produto Microsiga Protheus.

Estrutura: identificado por B na imagem acima, utilizado para definir a estrutura da tabela. Utilize osbotes direita para adicionar ou remover atributos (campos).

Indexado: identificado por C na imagem acima, se marcado, indica que a tabela ser ordenada pelaexpresso Adv/PL informada em Chave.

Depois de preencher os dados avance para a pgina seguinte e complemente os dados, detalhando como ser o

arquivo texto. Neste passo tambm teremos duas opes:Definidoou Parametrizado.

Caso a opo escolhida tenha sido por Definido, os valores sero fixos e informados no campo logo abaixo.


41/69



Verso 11.5

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

Caso a opo escolhida tenha sido por Parametrizado, os valores sero lidos a partir de uma varivel (normalmente

escopo privado - private) que dever ser informada no campo.

Informe a Varivel com o nome do arquivo Texto(item B) e o Finalizador de Linha(item C).

A aba Posiesexistente nessa etapa ser utilizada para definir o leiautedo arquivo de sada. Veja a imagem a seguir:


42/69



Verso 11.5

Defina o layout informando os dados: Campo, Posio, Tamanho, Nmero de Decimais e Tipo. Para adicionar ou

remover campos utilize os botes do lado direito.

Ao preencher todos os dados obrigatrios solicitados, finalize o processo. Localize a entrada de funo user functione

coloque um nome mais significativo, salve e compile.

7.3.

Assistente de cdigo: Importao de Arquivo Texto

Este tipo de assistente auxilia na criao dos arquivos-fontes, capazes de importar arquivos textos a partir de uma

tabela de dados. Existem dois modelos ou tipos de importao de arquivo texto. So eles por Arquivo Padro e por

Arquivo Especfico.

Caso a opo escolhida em Importao de TXT -Tipo de arquivotenha sido porArquivo Padroteremos a seguinte

tela:

O Arquivo padro utilizado quando a definio da tabela a mesma do dicionrio de dados, preenchendo os dados

solicitados.

Parmetros (item A): identifica uma Perguntadefinida no dicionrio de dados da Linha de Produto Microsiga

Protheus. Alias: no caso de arquivo padro, este ser utilizado para localizar as definies no dicionrio de dados. Caso

seja arquivo especfico ser utilizado para identificar a rea de trabalho (select area).


43/69



Verso 11.5

A ordem de leitura dos dados definida por uma das opes:

Utilize ndice padro (item C): indica qual o nmero do ndice do dicionrio de dados associado ao alias, que

ser utilizado.

Utilize ndice temporrio (item D): informe uma expresso Adv/PL vlida para indicar a ordem dos dados.Este ndice de uso temporrio, sendo eliminado depois de seu uso.

Caso a opo escolhida em Importao de TXT -Tipo de arquivotenha sido porArquivo Especficoteremos a seguinte

tela:

O Arquivo especfico utilizado para uma estrutura livre da tabela. Ser necessrio preencher as seguintes

informaes:



Indexado (iem C): se marcado, indica que a tabela ser ordenada pela expresso Adv/PL informada emChave.

Aps preencher os dados, avance para a pgina seguinte, na qual sero complementados os dados, detalhando o

arquivo texto de entrada.

Neste passo tambm teremos duas opes: Definidoou Parametrizado.

Caso a opo escolhida tenha sido por Definido, os valores sero fixos e informados no campo logo abaixo.


44/69



Verso 11.5

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

Caso a opo escolhida tenha sido por Parametrizado, os valores sero lidos a partir de uma varivel (normalmente

escopo privado - private) que dever ser informada no campo.

Informe a Varivel com o nome do arquivo Texto(item B) e o Finalizador de Linha(item C).

A aba Posiesexistente nessa etapa ser utilizada para definir o leiautedo arquivo de sada. Veja a imagem a seguir:


45/69



Verso 11.5

Defina o leiaute informando os dados: Campo, Posio, Tamanho, Nmero de Decimais e Tipo. Para adicionar ou

remover campos utilize os botes do lado direito.Ao preencher todos os dados obrigatrios solicitados, finalize o processo. Localize a entrada de funo user functione


7.4.Assistente de cdigo: Processamento Genrico

Este tipo de assistente auxilia na criao dos arquivos-fontes, com um esqueleto para processamentos genricos.

Existem dois modelos ou tipos de processamento genrico. So eles porArquivo Padro e por Arquivo Especfico.

Caso a opo escolhida em Processamento Genrico -Tipo de arquivotenha sidoArquivo Padroteremos a seguinte

tela:

O Arquivo padro utilizado quando a definio da tabela a mesma do dicionrio de dados, preenchendo os dados

solicitados.


Alias (item B): no caso de arquivo padro, este ser utilizado para localizar as definies no dicionrio dedados. Caso seja arquivo especfico ser utilizado para identificar a rea de trabalho (select area).


46/69



Verso 11.5

A ordem de leitura dos dados definida por uma das opes:

Utilize ndice padro (item C): indica o nmero do ndice do dicionrio de dados, associado aoalias, que ser

utilizado.

Utiliza ndice temporrio (item D) - informe uma expresso Adv/PL vlida para indicar a ordem dos dados.Este ndice de uso temporrio, sendo eliminado depois de seu uso.

Caso a opo escolhida em Processamento Genrico -Tipo de arquivotenha sido porArquivo Especficoteremos a

seguinte tela:

O Arquivo especfico utilizado para uma estrutura livre da tabela.

Parmetros (iem A): identifica uma Pergunta definida no dicionrio de dados da Linha de Produto MicrosigaProtheus.


Indexado (item C): se marcado, indica que a tabela ser ordenada pela expresso Adv/PL informada emChave.

Ao preencher todos os dados obrigatrios solicitados, finalize o processo. Localize a entrada de funo user functione


7.5.Nova Classe Adv/PL

Este tipo de assistente auxilia na criao dos arquivos-fontes, com um esqueleto para definio de uma classe em

Adv/PL.

Informe os dados solicitados:

Local (folder) (item A da imagem a seguir): indica o local (folder) em que o arquivo fonte ser salvo.

Nome da Classe (item B da imagem a seguir): nome da classe.

Herda a classe (item C da imagem a seguir): nome da classe pai, quando tratar-se de classe com herana.

Criar arquivo como referncia (item D da imagem a seguir): o arquivo ser gravado no campo Diretrio deDestino, e no local ser criado uma ligao simblica (link).


47/69



Verso 11.5

Aps informar os dados solicitados, finalize o processo e crie uma nova classe Adv/PL.

7.6.Nova Funo Adv/PL

Este tipo de assistente auxilia na criao dos arquivos-fontes, com um esqueleto para definio de uma nova funo em

Adv/PL.



Nome da funo (item B da imagem a seguir): nome da funo.

Criar arquivo como referncia (item D da imagem a seguir): o arquivo ser gravado no campo Diretrio deDestino e no local ser criado uma ligao simblica (link).

Aps informar os dados solicitados, finalize o processo e crie uma nova classe Adv/PL.


48/69



Verso 11.5

7.7.Novo Fonte WSDL Adv/PL

Este tipo de assistente auxilia na criao dos arquivos-fontes, com a definio de um cliente de servio web (web

service client) a partir da sua definio WSDL.Este assistente depende de uma definio do servidor da Linha de Produto Microsiga Protheus e da seleo deste na

barra de ferramentas. Caso o servioweba ser utilizado esteja fora da rede do usurio, o servidor da Linha de Produto

Microsiga Protheus dever ter privilgios de acesso.



Nome da funo (item B da imagem a seguir): nome do arquivo fonte que conter a definio WSDL.

URL (item C da imagem a seguir): informe a URL em que est o servio web desejado.

Criar arquivo como referncia (item D da imagem a seguir): o arquivo ser gravado no campo Diretrio de

Destino e no local ser criado uma ligao simblica (link).

Aps informar os dados solicitados, finalize o processo e crie uma nova definio de um cliente de serviweb.

Importante:

Este assistente depende de uma definio de servidor Da Linha de Produto Microsiga Protheus e da seleo

deste na barra de ferramentas. Caso o servio web a ser utilizado esteja fora da rede do usurio, o servidor

Da Linha de Produto Microsiga Protheus dever ter privilgios de acesso.

Exerccio:

Crie uma nova funo Adv/PL

Crie uma nova classe Adv/PL

Crie um novo fonte WSDL Adv/PL


49/69



Verso 11.5

8. Trabalhando com pacotes de atualizao (patch)

Para gerar ou aplicarpatch(pacotes de atualizaes) use os botes existentes na barra de ferramentas.

8.1.Gerao de pacotes de atualizao (patch)

Acione o boto de gerao do pacote de atualizao (patch).

Nas caixas de seleo indique a melhor opo:

Servidor (item A): selecione o servidor da Linha de Produto Microsiga Protheus que ser utilizado para a

gerao do pacote. Todos os servidores registrados na viso TOTVS Serversero listados. Ambiente (item B): selecione o ambiente (obtido a partir do servidor selecionado).

Processo (item C): indica qual procedimento ser adotado na gerao dos pacotes. Este item pode serporComparao, por Programa e por Grupo de Projetos:

- por Comparao: este procedimento compara o seu RPO com um RPO mestre, gerando um pacote peladiferena entre eles.

- por Programas selecionados a partir do RPO. Este procedimento permitir indicar qual ou quaisprogramas sero colocados no pacote, a partir do RPO.

- por Programas selecionados a partir de Projetos. Este procedimento permitir indicar qual ou quaisprogramas sero colocados no pacote, a partir dos projetos na rea de trabalho.

-

por Projetos permite a escolha de um ou mais projetos que iro fazer parte do pacote. Salvar em (item D): selecione o local em que o arquivo de atualizao ser salvo aps sua gerao. Pode ser

na mquina local ou no servidor.


50/69



Verso 11.5

Arquivo (sem extenso) (item

Documents

Apostila MP TOTVS Developer Studio 11 5