Apostila MP TOTVS Developer Studio 11 5
-
Upload
gustavosoad -
Category
Documents
-
view
224 -
download
24
description
Transcript of 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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
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
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
3/69
TOTVS | Developer Studio
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
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
4/69
TOTVS | Developer Studio
4 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
Verso 11.5
1. Objetivos
O objetivo deste curso ensinar aos futuros desenvolvedores como utilizar a Ferramenta de Desenvolvimento TOTVS |Developer Studio, com todos os recursos oferecidos.
No decorrer deste treinamento esperado que o treinando desenvolva-se nos seguintes aspectos:
Conceitos:
- Princpios bsicos de desenvolvimento de programas usando a plataforma TOTVS.
Habilidades:
- Domnio conceitual e prtico em desenvolvimento e lgica de programao.
- Conhecimentos nos ambientes ERP TOTVS, Microsiga Protheus ou outros.
Tcnicas:
- Operacionalizao do ambiente.
- Desenvolviemento de funcionalidades e/ou customizaes em ERPs TOTVS.
- Aplicao e utilizao das funcionalidades da ferramenta.
Ao trmino do treinamento, o treinando dever ser capaz de:
Conhecer e empregar adequadamente os conceitos e funcionalidades do TOTVS | Developer Studio.
Desenvolvimento de rotinas personalizadas referentes s customizaes em ERPs TOTVS.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
5/69
TOTVS | Developer Studio
5TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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/ -
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
6/69
TOTVS | Developer Studio
6 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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/18/2019 Apostila MP TOTVS Developer Studio 11 5
7/69
TOTVS | Developer Studio
7TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
8/69
TOTVS | Developer Studio
8 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
9/69
TOTVS | Developer Studio
9TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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 -
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
10/69
TOTVS | Developer Studio
10 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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/ -
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
11/69
TOTVS | Developer Studio
11TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
12/69
TOTVS | Developer Studio
12 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
13/69
TOTVS | Developer Studio
13TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
14/69
TOTVS | Developer Studio
14 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
15/69
TOTVS | Developer Studio
15TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
16/69
TOTVS | Developer Studio
16 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
17/69
TOTVS | Developer Studio
17TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
18/69
TOTVS | Developer Studio
18 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
19/69
TOTVS | Developer Studio
19TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
20/69
TOTVS | Developer Studio
20 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
21/69
TOTVS | Developer Studio
21TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
22/69
TOTVS | Developer Studio
22 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
23/69
TOTVS | Developer Studio
23TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
24/69
TOTVS | Developer Studio
24 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
25/69
TOTVS | Developer Studio
25TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
26/69
TOTVS | Developer Studio
26 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
27/69
TOTVS | Developer Studio
27TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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:
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
28/69
TOTVS | Developer Studio
28 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
29/69
TOTVS | Developer Studio
29TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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).
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
30/69
TOTVS | Developer Studio
30 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
31/69
TOTVS | Developer Studio
31TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
32/69
TOTVS | Developer Studio
32 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
33/69
TOTVS | Developer Studio
33TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
34/69
TOTVS | Developer Studio
34 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
35/69
TOTVS | Developer Studio
35TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
36/69
TOTVS | Developer Studio
36 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
37/69
TOTVS | Developer Studio
37TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
38/69
TOTVS | Developer Studio
38 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
39/69
TOTVS | Developer Studio
39TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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:
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
40/69
TOTVS | Developer Studio
40 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
41/69
TOTVS | Developer Studio
41TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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:
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
42/69
TOTVS | Developer Studio
42 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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).
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
43/69
TOTVS | Developer Studio
43TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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:
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 (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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
44/69
TOTVS | Developer Studio
44 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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:
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
45/69
TOTVS | Developer Studio
45TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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
coloque um nome mais significativo, salve e compile.
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.
Parmetros (item A): identifica uma Perguntadefinida no dicionrio de dados da Linha de Produto MicrosigaProtheus.
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).
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
46/69
TOTVS | Developer Studio
46 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
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 emChave.
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.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).
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
47/69
TOTVS | Developer Studio
47TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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.
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 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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
48/69
TOTVS | Developer Studio
48 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
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.
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 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
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
49/69
TOTVS | Developer Studio
49TOTVS | Developer Studio - Linha de Produto Microsiga Protheus
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.
-
7/18/2019 Apostila MP TOTVS Developer Studio 11 5
50/69
TOTVS | Developer Studio
50 TOTVS | Developer StudioLinha de Produto Microsiga Protheus
Verso 11.5
Arquivo (sem extenso) (item