Totvs Developer Studio Eclipse PDF

TOTVS | Developer Studio - Verso 11.
1. Apresentao
Objetivo
O "TOTVS | Developer Studio", um conjunto de aplicaes e ferramentas que interagem entre si, disponibiliza
aos desenvolvedores de produtos TOTVS, um ambiente de desenvolvimento gil, confortvel e poderoso.
Pblico
Desenvolvedores de produtos TOTVS, que utilizem uma ou mais das linguagens de programao abaixo:
4GL;
4GLP;
Adv/PL e Adv/PL-asp
Pr-requisitos
Conhecimentos:
Sistema operacional adotado;
Configurao e execuo da aplicao servidora Protheus (opcional);
Conhecimentos da linguagem a ser utilizada.
Sistema Operacional (qualquer um destes):
MS-Windows 32 ou 64 bits, verso XP ou superior;
Linux 32 ou 64 bits.
Mquina Virtual Java (JVM), JRE verso 6 ou superior, de acordo com o sistema operacional em uso.
Servidores Protheus com suporte :
Adv/PL, verso 7.00.101202A ou superior, de acordo com o sistema operacional em uso;
4GL, verso 7.00.101202A ou superior, de acordo com o sistema operacional em uso;
4GLP, verso 7.00.100812P ou superior, de acordo com o sistema operacional em uso.
Instalador do TOTVS | Developer Studio.
O instalador pode ser obtido atravs do endereo: http://suporte.totvs.com, na sesso "downloads".
2. Instalao
Verificao do ambiente
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,
a atualizao ou instalao da JVM de forma automtica, aps confirmao.
Notas:
1. Dependendo das diretrizes de segurana de sua rede, o procedimento pode no ser efetuado, neste caso
efetue os procedimentos manualmente.
2. Em alguns ambientes, apesar da JVM estar instalada e atualizada, o instalador no consegue reconhec-la.
Se, lhe for solicitado a instalao e voc tem certeza que a JVM esta instalada e atualizada, no confirme o
procedimento.
Caso j a tenha instalado, verifique a verso usando os procedimentos conforme seu sistema operacional.
Windows
Acesse "Painel de Controle"
Acione o icone "Java"
Na aba "Geral", acione "Sobre"
Linux
Acesse o terminal
Digite o cdigo: java -version.
Caso no tenha ou a verso esteja desatualizava, acesse a pgina web do fornecedor e siga as instrues de
instalao ou atualizao fornecidas por ele.
Endereo web onde pode ser obtido a JVM:

http://java.com/en/download/manual.jsp
Instalao do TOTVS | Developer Studio

Passo a passo
1. Inicie o instalador do TOTVS | Developer Studio, conforme o seu sistema operacional.
Todas as telas apresentadas so do TOTVS | Developer Studio sob sistema operacional Windows 7, porm
pode-se us-las como referncia para os demais sistemas operacionais, salvo se dito ao contrrio.
2. Selecione o idioma que deseja utilizar durante o processo de instalao.
Tela 1: Seleo de idioma do instalador

3. Leia os termos e condies do licenciamento e selecione a opo que corresponde ao aceite A no aceitao
dos termos e condies de uso implica no cancelamento da instalao. e prossiga.
Tela 2: Termos e condies de uso

4. Selecione o local de instalao e avance.
Tela 3: Local de instalao

5. Aguarde a instalao e
Tela 4: Instalao
6. .. o aviso de trmino.
Tela 5: Instalao concluda

7. Em sua rea de trabalho (desktop), sero criados atalhos de acesso, um para cada idioma suportado.
Tela 6: rea de trabalho (desktop)
3. Iniciando o TOTVS | Developer Studio

Para iniciar o uso do TOTVS | Developer Studio, execute o procedimento adequado ao seu sistema operacional.
Assim que este iniciar, lhe ser solicitado que informe o local da rea de trabalho ( workspace).
rea de trabalho (workspace) Local onde seus trabalhos podem ser armazenados e/ou acessados via
ligao simblica (symbolic link) ou fisicamente, informaes de gerenciamento e organizao dos fontes e
outras informaes necessrias ao funcionamento do TOTVS | Developer Studio.
Voc pode manter quantas reas de trabalho desejar, organizando seus trabalhos da forma que voc achar
mais confortvel e natural. Por exemplo, mantendo uma rea para cada produto/verso, cliente, projetos
pessoais, etc.
Usando as ligaes simblicas (symbolic links), voc pode compartilhar diretrios e arquivos, que so comuns
a vrios projetos.
Na caixa de texto "workspace" (Tela 7 A), selecione um diretrio para ser o ponto de partida (diretrio raiz) da sua
rea. Logo abaixo, voc tem uma caixa de marcao (Tela 7 B) na qual voc pode optar para que esta seja a sua
rea de trabalho padro. Se voc a marcar, na prxima vez que entrar no TOTVS | Developer Studio, no lhe ser
solicitado a rea. Caso o diretrio selecionado no exista, este ser criado.
Tela 7: Seleo da rea de trabalho (workspace)

NOTA : Utilize esta opo se voc no pretende ter vrias reas ou se ela for a rea em que voc costuma
trabalhar. Nos menus do TOTVS | Developer Studio, voc ter acesso a um gerenciador de reas de trabalho ou
solicitar a troca da rea em tempo de execuo.
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.
Tela 8: TOTVS | Developer Studio sendo inicializado
Termo de aceite
Para a plena utilizao do TOTVS | Developer Studio, necessrio que voc aceite o termo de utilizao. Leia-a
com ateno e se estiver de acordo, preencha os campos solicitados, acione a opo "Aceito os termos" e envie-o.
Este ser validado por um de nossos servidores e se estiver correto, o TDS passar para a tela de "Bos Vindas",
caso contrrio lhe ser apresentado o motivo da recusa.
Tela 9: Termo de aceite do TOTVS | Development Studio
Boas-vindas
Voc pode fechar a aba de boas-vindas acionando o X (Tela 10 A). Caso deseje acessar esta aba novamente,
acione menu Ajuda | Boas-vindas.
Tela 10: Tela de Boas-Vindas

Esta tela de boas vindas, contm indicaes de onde voc pode obter documentao mais completa e com
indicaes das primeiras tarefas a serem executadas por voc, para customizar o TDS a suas necessidades de
desenvolvimento.
provvel, que voc esteja vendo parte das telas em ingls. Este o idioma padro do Eclipse, que a base de
construo do TDS. Para coloc-lo em seu idioma veja o "Anexo III: TOTVS Developer Studio no seu idioma", que
est no final do manual.
Tela principal
Se ainda no o fez, feche a aba de boas-vindas.
Como j dito, o TOTVS | Developer Studio, foi construdo sob o Eclipse Endereo web dos responsveis pelo Eclips
e: http://www.eclipse.org/,(acessado em Fevereiro/2012). Que uma ferramenta de uso geral configurvel e
extensvel para vrias tarefas. Caso voc 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.
Se voc no conhece o Eclipse, passaremos aqui as informaes primordiais, para que possa utilizar o TOTVS |
Developer Studio e caso queira se aprofundar, recomendamos a leitura de " Eclipse Indigo (3.7) Documentation".
Para acesso a citada documentao (em ingls), acesse: http://help.eclipse.org/indigo/index.jsp (acessado em
Fevereiro/2012)
Atentar que algumas informaes disponveis nesta documentao podem no existir ou ser diferentes no
comportamento ou em algum detalhe em funo das especificidades do ambiente Protheus e neste caso,
trataremos aqui.
Para obter material sobre o Eclipse em sue idioma, efetue uma busca em sites de busca, que h farto material
disponibilizado por terceiros.
O TOTVS | Developer Studio uma ferramenta de desenvolvimento integrada (IDE). Por isso, voc possui uma
vasta gama de funcionalidades, tais como edio de programas, execuo, depurao (debug), anlise de
desempenho, configurao de servidores e muitas outras funcionalidades. Para ativ-las necessrio instalar
adicionais ao seu TDS.
Instalao de adicionais
Acesse o "Gerenciador de Atualizaes" do TOTVS | Developer Studio, acionando o menu Ajuda | Instalar
novo software.... Lhe ser apresentada uma janela semelhante a:
Tela 11: Instalao de adicionais (plugins)

Os adicionais (plugins), so pacotes de softwares que adicionam capacidades ou estende funcionalidades j
existente ao TDS. Tomaremos como exemplo, que desejamos desenvolver aplicativos utilizado a linguagem de
programao Adv/PL.
1. No campo "Work With" ( Tela 11 A), informe (digitando ou colando) o endereo do pacote a ser adicionado,
no nosso caso ser http://ds.totvs.com/updates/advpl, que foi obtido no site http://ds.totvs.com;
2. Acione ENTER e aps alguns instantes, lhe ser apresentada uma rvore ( Tela 11 B), para a seleo dos
adicionais desejados. Selecione "Adv/PL";
3. Acione "Avanar" ( Tela 11 C) e siga as instrues do "Gerenciador de Atualizaes".
Perspectivas
As funcionalidades adicionadas ou estendidas por adicionais (plugins), so agrupadas em perspectivas (perpective
s). Ao instalar um dos adicionais do TOTVS | Developer Studio, ele vir com as perspectivas bsicas para o
desenvolvedor de produtos TOTVS.
Perspectivas (perspective) So "configuraes" pr-definidas, que podem ser customizadas pelo
desenvolvedor, que permite de uma forma rpida, modificar o seu ponto de vista (perspectiva) em relao ao
trabalho que esta sendo executado ou que seja necessrio fazer na perspectiva, voc tem uma ou mais
vises, que se relacionam de alguma forma entre si e com o trabalho a ser executado.
Voc pode selecionar uma perspectiva utilizando as opes disponveis atravs dos botes e cones de seleo,
presentes na barra de ferramentas (Tela 12 C).
Tela 12: Seletor de perspectiva

Ou acessando o menu Janela | Abrir perspectiva | Outros..., voc ter acesso a outras perspectivas.
A perspectiva inicial a "Informaes (Resources)", que neste momento no nos interessante. Acesse a seleo
de perspectivas (conforme citado) e selecione a perspectiva Totvs Developer ().
Tela 13: Seleo de perspectiva "TOTVS Developer"

Na janela principal, alm do seletor de perspectiva (Tela 14 C), tambm temos: Menu principal (Tela 14 A), barra de
ferramentas (Tela 14 B), navegador de projetos (Tela 14 D), estrutura de programas/classes (Tela 14 E), rea de
editores (Tela 14 F), abas informativas e retorno (Tela 14 G) e rea de trabalho das abas informativas (Tela 14 H) e
barra de status e menu de acesso rpido (Tela 14 I).
Tela 14: Perspectiva "TOTVS Developer" selecionada

Todos os elementos, exceto o menu principal e barra de ferramentas, so denominados de vises (views) e so
acoplveis (dockable).
Viso (view) As vises so janelas acoplveis (dockable) que adicionam funcionalidades ou informaes a
perspectiva atual. Para ativar uma viso, acesse o menu " Janela | Viso | Outras" e na rvore de
navegao apresentada, localize a viso desejada e selecione-a. Se desejar, pode fechar uma viso
acionando o X existente ao lado do titulo dela.
Janela acoplvel (dockable) - Essa caracterstica permite que voc configure o visual da forma que lhe for
mais conveniente. Experimente arrastar uma das vises que esto em abas informativas e voc ver que
conforme for se movimentando pela tela, aparece um quadro pontilhado indicando onde voc vai acopl-la se
soltar o boto do mouse.
1. Iniciando um projeto
A organizao inicial de um trabalho, o projeto. Em cada rea de trabalho ( workspace) voc pode colocar quantos
projetos desejar e faz a administrao atravs da viso "TOTVS Explorer".
Tela 15: Viso "TOTVS Explorer"

Logo abaixo do ttulo da aba e da barra de ferramentas, acione o menu de contexto e nas opes apresentadas
acione Novo | Outras.... ou Importar. Lhe ser apresentado o assistente de novos elementos ou assistente
de importao (conforme a opo utilizada).
Tela 16: Assistente de novos elementos

Nota: Dependendo do licenciamento e verso do "TDS", algumas opes podem estar indisponveis ou no
existirem.
Utilizando a rvore de navegao, localize "TOTVS Wizard", expanda-o e obter as opes (Tela 16 destacado).
Importar projeto Adv/PL A partir de um arquivo de projetos (prj) lhe preparado um projeto "TOTVS".
Novo Projeto TOTVS inicializado um projeto "TOTVS" vazio, contendo uma estrutura bsica.
NOTA : O arquivo de projeto (*.prj) utilizado somente no momento da importao. Qualquer modificao posterior
neste arquivo, no ser refletido no projeto importado para o "TDS" e vice-versa.
Selecione a opo que melhor lhe atende e prossiga com a execuo do assistente.
Importar projeto Adv/PL
Tela 17: Assistente de importao de projetos DevStudio

1. Selecione o arquivo de projetos DevStudio (*.PRJ) (Tela 17 A) desejado. Para selecionar mais de um
projeto, acione a tecla Control junto com o boto direito, porm estes projetos devem estar sob o mesmo
diretrio;
2. Indique se voc quer importa-lo como um novo projeto (Tela 17 B), ou no. Caso desmarque esta opo,
dever selecionar o "Destino" deste projeto.
3. Indique o mtodo de de importao(Tela 17 C);
a. Manter os fontes no diretrio de origem (legado) Ao utilizar esta opo, as pastas ( folders) e
arquivos sero anexados ao projeto TOVS por meio de uma ligao simblica ( symbolic link), ou seja,
os arquivos continuam nos diretrios de origem e uma referncia a ele criada. Qualquer edio
efetuada, usando-se o TDS ou qualquer outro editor externo, ser refletido em ambos os ambientes.
Como trata-se de uma ligao simblica, ao acionar a remoo, voc ir apagar apenas a referncia e
no o arquivo fisico.
b. Copiar arquivos para a area de trabalho do TDS Esta opo, efetua uma cpia fsica das pastas (fol
ders) e arquivos referenciados pelo arquivo de projeto (*.prj) para dentro da rea de trabalho ( workspa
ce) em uso. Neste caso, qualquer alterao efetuada em uma das cpias, no ser refletido no outro
ambiente.
4. Em "Diretrios para Busca" (Tela 17 D), adicione os diretrios que devero ser pesquisados para resoluo
de arquivos de definies (*.ch) que so referenciados nos fontes. Ao lado direito, voc tem os botes para
efetuar estas operaes. Alm disso, voc pode adicionar referencia a outras configuraes desta lista de
busca, que ser utilizada juntamente com os que informar. Para detalhes, veja "Configurao de diretrios
de busca".
5. As ligaes (Tela 17 E), lhe do acesso aos outros locais de definio de lista de busca;
6. Finalize a edio e aguarde o processamento. Ao final, obter algo semelhante a Tela 18.
Tela 18: Perspectiva TOTVS Developer aps a importao de um arquivo de projetos (.prj)
Na viso TOTVS Explorer, voc tem as pastas (folders) (Tela 18 A) e os arquivos do projeto. Repare que os
arquivos esto identificados com um cone contendo uma pequena seta, indicando que trata-se de uma ligao
simblica (symbolic link). Na viso Console (Tela 18 B), voc tem as ocorrncias durante o processo de
importao.
Novo Projeto TOTVS

Esta opo inicializa um projeto TOTVS, com sugesto de estrutura de pastas ( folders).
Tela 19: Assistente de novo projeto TOTVS

1. Informe o nome do projeto (Tela 19 A);
2. Em "Diretrios para Busca" (Tela 19 B), adicione os diretrios que devero ser pesquisados para resoluo
de arquivos de definies (*.ch) que so referenciados nos fontes. Ao lado direito, voc tem os botes para
efetuar estas operaes. Alm disso, voc pode adicionar referencia a outras configuraes desta lista de
busca, que ser utilizada juntamente com os que informar. Para detalhes, veja "Configurao de diretrios
de busca".
3. As ligaes (Tela 19 C), lhe do acesso aos outros locais de definio de lista de busca;
4. Finalize a edio e aguarde o processamento. Ao final, obter algo semelhante a:
Tela 20: Novo projeto TOTVS inicializado
2. Gerenciamento de projetos
Na aba TOTVS Explorer, utilizando o menu de contexto voc pode gerenciar seus projetos. As opes do menu de
contexto, depender do item da rvore de navegao que esta selecionado.
Menu de contexto
Tela 21: Elemento "Projeto"
Tela 22: Elemento "pasta (folder)"
Tela 23: Elemento "Arquivo"
O menu de contexto, ser apresentado de acordo com o tipo de elemento. Veja abaixo as opes do menu de
contexto, conforme o elemento:
Aplica-se a
Opo
Descrio da funo
Novo
Submenu para novos elementos.
Projeto
Inicializa um novo projeto TOTVS.
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 (temporariamente). Para
restaurar acione "Para cima" na
barra de ferramentas, logo abaixo
do titulo.
Copiar ctrl+C
Copia o elemento para a rea de

transferncia (clipboard).
Colar ctrl+V
Cola o contedo da rea de

transferncia (clipboard).
Remover DELETE
Remove o elemento da rvore.
Renomear F2
Modifica o nome do elemento.
Importar...
Inicia o assistente de importao.
Exportar...
Inicia o assistente de exportao.
Atualizar F5
Atualiza a rvore de navegao.
Atualizar definio WSDL
No caso do arquivo-fonte conter

uma definio de cliente de web-ser
vice, o mesmo reprocessado.
Fechar projeto
Fecha o projeto, mas mantem o

elemento.
Fechar projetos no relacionados
Fecha todos os projetos que no

esto relacionados entre si.
Recompilar <elemento>
Recompila todos os elementos do

projeto ou pasta (folder).
Compilar <elemento>
Compila todos os elementos que

foram modificados ou que no
existam no repositrio (RPO).1
Executar como...
Permite executar o projeto1.
Configurar execuo...
Permite editar configuraes de

execuo.
Depurar como..
Permite executar o projeto em

modo depurao (debug)1.
Configurar depurao...
Permite editar configuraes de

depurao
Equipe
Opo que permite gerenciar

trabalhos em equipe.
Comparar com...
Inicia o processo de comparao

entre elementos.2
Restaurar do histrico local...
Permite recuperar verses

anteriores a partir do histrico local.
2
Projeto: Propriedades
Fonte
Sub-opes relacionadas a fontes

do projeto
Formatar
Executa a formatao de
arquivos-fonte.
Propriedades alt+ENTER
Apresenta uma janela com

informaes sobre o elemento
Tela 24: Propriedades do elemento "projeto"

Ao acionar a opo "Propriedades alt+ENTER ", voc pode verificar e editar algumas informaes sobre o projeto.
Para detalhes da opo "Includes", veja "Configurao de diretrios de buscas".
NOTA: Algumas propriedades sero propagadas para todas as pastas (folders) e arquivos.
A opo "Construtores", permite voc desativar ou ativar o "TOTVS Verificao de sintaxe", que processado
quando o "TDS" percebe que houve alteraes no arquivo. Quando isso ocorre, executa-se uma verificao da
sintaxe dos arquivos-fontes.
Tela 25: Propriedade "Construtores" do elemento "projeto"
Pastas: Propriedades
Tela 26: Propriedade do elemento pasta (folder)

Ao acionar a opo "Propriedades alt+ENTER ", voc pode verificar e editar algumas informaes sobre a pasta (fol
der). Para detalhes da opo "Run/Debug Settings", veja "Trabalhando com projetos: Execuo". Algumas
propriedades sero propagadas para todas as subpastas e arquivos.
Arquivos: Propriedades
Tela 27: Propriedades do elemento arquivo

Ao acionar a opo "Propriedades alt+ENTER ", voc pode verificar e editar algumas informaes sobre o arquivo.
Para detalhes da opo "Run/Debug Settings", veja "Trabalhando com Projetos: Depurao" e de "Breakpoint
Properties", veja "Depurao de Projetos: Depurao: Pontos de parada".
1. Acessando TOTVS Server

Para acessar a perspectiva TOTVS Server, ou qualquer outra, selecione-a atravs do seletor de perspectiva (Tela
28 C) ou pelo menu Janela | Abrir perspectiva | Outros e selecione TOTVS Server.
Tela 28: Seletor de perspectiva

A perspectiva TOTVS Server semelhante a:
Tela 29: Perspectiva "TOTVS Server"

Onde temos:
1. Servers Extension (Tela 29 A) podemos definir quais servidores que vamos utilizar, permitindo tambm,
efetuar configuraes e obter informaes sobre o processamento (quando disponvel).
2. TOTVS ServerOutline (Tela 29 B) permite uma navegao rpida entre as opes/abas de configurao
de um servidor previamente selecionado.
3. Abas informativas (Tela 29 C) contm algumas vises (views) com informaes adicionais sobre o
servidor, tais como usurios conectados e pelo menu de contexto desta, algumas operaes com o servidor.
2. Servers Extension: Menu de contexto

Nota: A partir da verso 11.1.27.201210011603 liberado em 01/09/2012, foi introduzido configurao de segurana
na edio de configuraes dos servidores.
Por padro, a edio de configuraes negada a qualquer usurio, exceto quando a conexo ao server for
efetuada por "localhost" (127.0.0.1). Para liberar a edio:
1. Abra o arquivo "appServer.ini" com um editor de textos simples. Este arquivo encontra-se no diretrio do
servidor de aplicaes Protheus (appServer.exe);
2. Localize (ou adicione) a sesso e chaves abaixo:
[TDS]
ALLOWEDIT=<estaes permitidas>
3. Salve o arquivo.
<estaes permitidas> = lista de ips ou nome das estaes, separados por vrgula, que podem efetuar alteraes
de configurao no servidor.
Tela 30: Viso "Server Extension"

Para acessar as aes disponveis, acione o menu de contexto sobre o elemento "Servidores" da rvore de
navegao. As opes so:
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
servidor com suporte a 4GLP.
Servidor Adv/PL
servidor com suporte a Adv/PL.
Servidor Interno
servidor com suporte a Adv/PL,
pr-configurado e de uso exclusivo
a partir do TDS Developer Studio.
Servidor DBAccess
Apresenta a lista de tipos de

servidores disponveis.
Servidor DBAccess
servidor DBAccess.
Conexes ativa
Fora uma atualizao das abas

informativas, para os servidores
conectados.
Adicionando um servidor
Para adicionar um servidor, acione o menu de contexto sobre o elemento "Servidores" da rvore de navegao da
viso Server Extension (Tela 30 A), acione a opo Servidor de Aplicao | Servidor Adv/PL (ou o que
lhe melhor convier). Aguarde que ser inicializado um assistente semelhante a:
Tela 31: Assistente para novo servidor

Informe os dados solicitados e finalize, obtendo algo semelhante a:
Tela 32: Propriedades de um servidor

NOTA: Para acessar a viso de edio de propriedades (Tela 32 B) de um servidor, efetue um duplo-click no
elemento que identifica o servidor (Tela 32 A).
Voc pode editar ou corrigir os dados de conexo deste servidor modificando os dados disponveis nas pginas (na
parte de baixo da viso) e acionando a salva atravs do atalho ctrl + S ou ao trocar de pgina. No menu de
contexto deste elemento, temos:
Opo
Descrio da funo
Conectar Servidor
Conecta-se ao servidor conforme as informaes

constantes na configurao(Tela 32 B).
Remover
Remove as configuraes do servidor, tornando-o

inacessvel.
Aps efetuar a conexo com o servidor, o menu de contexto passa a ter:

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.
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".
NOTA :Os servidores com suporte a Adv/PL iro solicitar algumas informaes antes de efetuar a conexo. Informe
os dados solicitados. Se desejar, pode salvar o "Usurio" e "Senha" em um local seguro acionando a opo "Salvar
as informaes de login em local seguro".
Tela 33: Conexo com servidor Adv/PL

Durante e aps o processo de conexo, acompanhe as ocorrncias na viso console.
Tela 34: Aba informativa console

NOTAS :e ela no estiver visvel, acesse o menu Janela | Apresentar viso | Outros e na rvore de
navegao apresentada, abra Geral e acione Console.
Configurao do servidor
Aps a conexo, na rea de editores, voc ter algumas informaes (Tela 35 B) sobre o ambiente do servidor e
acessando qualquer uma das pginas (Tela 35 C) disponveis, efetuar modificaes de configurao e salvando-as
ao acionar ctrl+S ou trocando-se a pgina.
Para saber como configurar e o que pode ser configurado em cada um dos servidores, consulte documentao
especfica.Servidor Adv/PLServidor 4GLServidor ABLServidor DBAccess
Tela 35: Servidor conectado
1. Trabalhando com projetos

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).
1. Criando arquivos-fonte
Para criar um novo arquivo-fonte, selecione o projeto e, opcionalmente, a pasta onde ser armazenado o
arquivo-fonte.
Caso no tenha um projeto, acione o menu de contexto na viso TOTVS Explorer, acessando a opo Novo
| Projeto e na rvore de navegao do assistente, abra TOTVS Wizard e selecione Novo projeto .(Tela
36, Tela 37 e Tela 38 )
Tela 36: Assistente de novo projeto
Tela 37: Identificador do novo projeto e lista de diretrios para include
Tela 38: Projeto inicializado

Acione o menu de contexto na viso TOTVS Explorer, acessando a opo Novo | Arquivo, acionando o
assistente de novos arquivos (Tela 39).
Tela 39: Criando um novo arquivo

Neste assistente, a pasta selecionada ser utilizada como "pasta pai" (Tela 39 A) padro. Se quiser modificar o
local, utilize a rvore de navegao (Tela 39 B). No campo "Nome do Arquivo" (Tela 39 C) informe o nome do
arquivo-fonte, incluindo a extenso.
Logo abaixo, h um o boto "Avanado>>", que se acionado apresenta opo para criar uma ligao simblica (sy
mbolic link) com um arquivo j existente do seu sistema de arquivos. Se desejar criar como ligao simblica,
marque a opo "Link to file in the file system" e selecione o arquivo acionando o boto "navegador".
Finalize e aguarde o processamento. Ao final deste, ter algo semelhante a Tela 40.
Tela 40: Novo programa para edio

NOTA : Caso tenha optado pela ligao simblica, o arquivo-fonte j ir aparecer com contedo e o cone de
identificao do fonte, ter uma pequena seta a sua direita embaixo. Lembre-se que, neste caso, todas as
alteraes que efetuar sero gravadas no fonte original.
Neste exemplo, criamos o arquivo-fonte "programa.prw", na pasta "src" do projeto "meuProjeto". O uso do editor de
fontes bastante semelhante a outros que voc deve estar acostumado, portanto saia digitando o seu cdigo. No
anexo I, voc possui a lista dos principais comandos do editor.
Copie o cdigo (sugesto), para continuar o aprendizado.
user function meuTeste()
msgalert("Funo do usurio meuTeste executada")
return
Obtendo algo semelhante a:
Tela 41: Exemplo de arquivo-fonte em edio

Durante a edio do fonte, a viso Outline (Tela 41 B) ser atualizada com a identificao dos principais blocos do
seu arquivo-fonte. Se voc acionar o mouse sobre um destes itens, seu arquivo-fonte ser reposicionado para este
elemento. Na viso TOTVS Explorer (Tela 41 A), voc tambm obtm a lista dos principais blocos, se expandir o
elemento (click no tringulo vazado).
2. Edio de arquivos-fonte
A edio de arquivos-fontes bem simples. Localize na rvore de navegao do TOTVS Explorer o arquivo
desejado e efetue um duplo-click ou acione o menu de contexto sobre o arquivo e a opo Abrir, obtendo algo
semelhante a Tela 41.
3. 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 adicionado como recurso e ao ser compilado ser anexado como tal,
sendo possvel acess-lo com o uso de funes especficas da linguagem.
4. Compilao de arquivos e projetos

Antes de efetuar a compilao de um arquivo, pasta ou projeto, voc precisa estar conectado a um servidor (veja
"Perspectiva TOTVS Server").
Na barra de ferramentas, voc deve indicar qual servidor ser utilizado e no caso de Adv/PL, o ambiente (Tela 42).
Tela 42: Botes para seleo de servidor e ambiente, para compilao e execuo
Arquivos
Para compilar, aps indicar o servidor e ambiente, acione Ctrl+F9 ou acione 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 (Tela 43 A), voc obter informaes relativas a compilao,
tais como se foi ou no bem sucedida e neste caso, os motivos (erros de compilao). A viso TOTVS Explorer,
tambm informa se h problemas de compilao. (Tela 43 B), colocando um pequeno sinal indicativo.
Tela 43: Resultado da compilao de um arquivo-fonte

Na Tela 43, como exemplo, temos o erro de arquivo de definio (*.ch) no encontrado. Neste caso, selecione o
elemento "projeto" na viso TOTVS Explorer e acione alt+enter (ou menu de contexto, opo Propriedades) e
verifique a lista de diretrios para busca de arquivo de definio.
Tela 44: Arquivo-fonte com erro de sintaxe.

Na rea do editor (Tela 44 A) h uma indicao da linha que esta com erro. Ao passar o mouse sobre a marca,
obtm-se uma janela popup indicando o erro. No lado oposto (Tela 44 B) temos uma barra indicativa, que na sua
altura, representa o seu arquivo-fonte e a as marcaes existentes indicam o local relativo de erro. Ao clicar-se nest
a 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 deste a ltima salva.
Na rea de abas informativas, temos a viso "Problemas" (Tela 44 C), que possui uma lista de todas as ocorrncias
da compilao (erros e avisos). Se a linha de mensagem for acionada com um duplo-click, o fonte ser aberto e
posicionado no local indicado.
Para ativar a numerao de linhas e outros comportamentos do editor, acione o menu de contexto do editor,
acessando a opo "Preferncias" e acione "Show Line Numbers".
Tela 45: Arquivo-fonte com avisos do compilar
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 uma das opes:
Recompilar <elemento>
Recompila todos os elementos do projeto ou pasta

(folder).
Compilar <elemento>
Compila todos os elementos que foram modificados ou

que no existam no repositrio (RPO).1
Como estes processos podem levar algum tempo, lhe ser aberta a viso " Progresso", que efetua um retorno visual
de como esta a execuo da tarefa (Telas 46 e 47).
Tela 46: Viso "Progresso" na barra de status (posio padro)
Tela 47: Viso "progresso" acoplada em outra posio

NOTA: A viso "Progresso" utilizada em diversas situaes, normalmente naquelas que podem demandar algum
tempo de processamento.
5. Execuo de projetos
Bsico
Uma vez que o projeto esteja compilado e sem erros, voc poder execut-lo ou depurar ( debug) seus programas.
Tanto a execuo como a depurao, so efetuados atravs de configuraes de executores ( lauchers). Para
configur-los voc deve acionar o menu suspenso do boto "Executar" ou "Depurar", selecionando a opo
"Configurao ..." (Tela 48).
Tela 48: Menu suspenso do boto "Executar"

Na janela de configurao, voc pode adicionar, duplicar e remover executores. Acione a opo "Novo" na barra de
ferramentas (Tela 49 A).
Tela 49: Configurao de execuo ou depurao

Na tela apresentada (Tela 50), temos os campos:
"Nome" (Tela 50 A), informe um identificador para o novo executor;
Tela 50: Tela de configurao de executores

O bloco "Ambiente de execuo Adv/PL" (Tela 50 B), com:
"Utilizar servidor de aplicao interno", se estiver marcado exige o uso de um servidor interno
configurado e ser utilizado o executvel do SmartClient (remote) que encontra-se na instalao do T
OTVS Developer Studio.
"Programa Inicial", informe o nome do programa que ser executado (programa principal);
"Parmetros do programa", informe os parmetros da linha de comando que ser utilizado na
execuo do SmartClient (remote).
"Habilita profile de execuo", se marcado, ao final da execuo lhe ser apresentada os resultados
do profile desta execuo.
Para salvar as configuraes e continuar a edio, acione "Aplicar" (Tela 50 C) ou se desejar cancelar as
alteraes efetuadas, acione "Reverter".
Ao informar os dados mnimos necessrios, o boto "Executar" (Tela 50 D) ser habilitado e se acionado, iniciar a
execuo. O boto "Fechar", encerra a edio.
Se solicitar a execuo pelo acionamento do boto "Executar" (Tela 50 D), ou pelo menu suspenso dos botes
"Executar" ou "Depurar"(Tela 13), lhe ser apresentada a tela de confirmao. Na caixa suspensa, informe o nome
do programa a ser executado.
Caso o campo "Programa Inicial" (Tela 50 B) preenchido, este ser usado como valor padro para a caixa
suspensa.
Tela 51: Janela para execuo

Depois que voc criou e usou um executor, poder acion-lo diretamente pelo menu suspenso do 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).
Avanado
Tela 52: Aba de configurao do "codeAverage"

Na configurao avanada, utilizamos as demais abas (telas 52, 53) com opes especficas. Tela 52: Aba de
configurao do "codeAverage"
A aba "codeAverage", permite habilitar a "cobertura" do cdigo e em quais fontes. Para habilitar, marque a opo
"Habilitar cobertura de cdigo" (Tela 52 A) e utilizando os botes a direita (Tela 52 B), informar quais os fontes que
sero analisados.
Tela 53: Aba "Fontes"

A aba "fontes", voc informa onde o depurador deve produrar os fontes, sendo o default o seu projeto (Tela 53 A).
Utilize os botes a direita (Tela 53 B), para adicionar outros diretrios para a busca.
Tela 54: Aba "Commom"

A aba "Comun" (Tela 54), contm algumas opes de configurao da visibilidade e outras opes ligadas
diretamente com a configurao do executor. Nesta aba, tempo:
"Salvar como" (Tela 54 A), indica se os dados de configurao sero salvos localmente (no seu workspace)
ou em rea compartilhada (externa).
"Apresentar como favorito" (Tela 54 B), indique em qual menu suspenso voc quer que a configurao
aparea. Caso no selecione nenhuma, esta ser apresentada em todos os menus suspensos.
"Encoding", permite voc definir o formato da codificao do arquivo de configurao.
"Entrada e sada padro" (Tela 54 D), permite configurar a apresentao ou no da viso console ou a sua
gravao em arquivo.
6. Depurao de projetos
A configurao do executor (laucher) com depurao exatamente o mesmo utilizado na execuo, portanto, para
configur-la utilize as instrues contidas em "Compilao de arquivos e projetos".
NOTA : Se voc j efetuou a configurao do executor, j possuir a mesma configurao para a depurao.
Para demonstrar o uso do depurador, usaremos o programa abaixo. Sugerimos que o copie e cole em um novo
arquivo-fonte Adv/PL.
user function calcFatorial()

local n
msgalert("Calculo de Fatoriais")
resultado := "Numero = Fatorial" + chr(13)
for n := 1 to 5 step 2
calcula(n*2)
next
msgAlert(resultado)
return
static function calcula(anNumber)
local x := anNumber
local total := 1
while (x > 1)
total := total * x
x-end
resultado += str(anNumber,3) + " "
resultado += transform(total, "@E 9,999,999,999")
resultado += chr(13)
return
Aps a compilao do arquivo-fonte acima, execute-o acionando o boto "Executar" (se necessrio configure um
executor). Aps encerrar a execuo, ter algo semelhante a:
Tela 55: Programa sugerido para depurao

Com o editor ativo (a aba fica destacada), acione Ctrl+F10 e ative a numerao de linhas.
Tela 56: Menu de opes do editor (Ctrl + F10)

Efetue um duplo-click 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). Quando iniciarmos a depurao, o depurador para
a execuo nos pontos de parada e aguarda instrues do desenvolvedor.
Tela 57: Ponto de parada definido na linha 6

Inicie o depurador, acessando o boto de menu suspenso "Depurar" e selecione o executor.
Tela 58: Disparando o depurador

Aguarde alguns instantes e lhe ser solicitado o programa inicial.
Tela 59: Informe o programa inicial

Informe o programa inicial e confirme, obtendo algo semelhante a:
Tela 60: Programa "calcFatorial" iniciado

Acione "OK". Devido ao ponto de parada definido (Tela 60), o depurador ser selecionado. A perspectiva atual,
TOTVS Developer, no a mais indicada para depurao. Por isso, voc ser convidado a troc-la para a
perspectiva TOTVS Debuger (Tela 61).
Tela 61: Convite para trocar a perspectiva atual para a de depurao

Aceite a troca e a perspectiva de depurao lhe ser apresentada.
Tela 62: Perspectiva de depurao (debug) Na perspectiva de depurao (debug), temos:

Viso "debug" (Tela 62 A) apresenta a pilha de execuo, indicando o "caminho" efetuado at chegar ao ponto
de parada. Tambm temos a barra de ferramentas desta viso, com as funcionalidades:
Tela 63: Barra de ferramentas da viso debug
1.
2.
3.
4.
5.
6.
7.
Remove histrico de execuo j finalizadas;

Continua a execuo at encontrar novo ponto de parado ou o trmino do programa;
Pausa a execuo;
Encerra a execuo;
Executa um passo, se for chamada de mtodo ou funo, para na primeira instruo desta;
Executa um passo, se for chamada de mtodo ou funo, execute-a sem parar dentro desta;
Executa at finalizar (retornar) do mtodo ou funo.
Viso breakpoints (Tela 64 B) - apresenta a lista de pontos de paradas definidos. Tambm temos a barra
de ferramentas desta viso, com as funcionalidades:
Tela 64: Barra de ferramentas da viso breakpoints

1.
2.
3.
4.
Remove os pontos de parada selecionados;

Remove todos;
Abre e posiciona-se no arquivo-fonte associado;
Ignora todos os pontos de parada.
Abas informativas (Tela 65 C) -diversas vises de apoio ao depurador.
Tela 65: Abas informativas com vises de apoio ao depurador

Tabela de dados -apresenta as tabelas abertas durante o processamento;
Tela 66: Viso Tabela de Dados

Adv/PL Commands permiti ao desenvolvedor executar comandos Adv/PL em tempo de execuo com
resposta imediata;
Tela 67: Viso Adv/PL Commands

Variables permiti verificar os valores das variveis declaradas;
Tela 68: Viso Variveis

Atravs da barra de ferramentas, desta viso, voc pode configurar a visibilidade, baseada em escopo, de quais
variveis sero apresentadas.
Expressions permiti definir expresses que so avaliadas a cada passo.
Tela 69: Viso Expresso

Neste momento, estamos parados na linha 6 do calcFatorial. Acione F5 para executar um passo.
Tela 70: Perspectiva de depurao, aps avanar um passo

Repare que na linha 8, do lado esquerdo h uma pequena seta azul, indicando a prxima linha a ser executada.
Acione F5, at que voc entre na funo "calcula", tendo algo semelhante a:
Repare, que a viso Variveis teve seu contedo atualizado. Estando dentro de um mtodo ou funo, se voc
acionar F7 a execuo prosseguir, parando somente quando sair do mtodo ou funo. Neste exemplo, o
depurador vai executar toda a funo "calcula", pararando somente na linha 10 (logo aps a chamada).
Tela 71: Depurando a funo calcula

Voc tambm pode adicionar pontos de parada a qualquer momento, efetuando um duplo-click sobre o nmero da
linha. Faa isso na linha 26.
Tela 72: Adicionado um ponto de parada na linha 26

Acionando F8 (continuar execuo), o processamento ir ser executado at o prximo ponto de parada. Acione o
F8 para continuar a execuo e ao final obter algo semelhante a:
Tela 73: Tela final do calcFatorial

Para retornar a perspectiva de desenvolvimento selecione-a na rea de seleo de perspectivas (Tela 10 C).
1. Assistentes de Cdigo
Este assistente, ao ser acionado, o auxiliar na criao de programas Adv/PL com funcionalidades especficas
conforme as informaes fornecidas.
1. Selecione o Local (Tela 74 A) onde o arquivo-fonte ser salvo;
Tela 74: Tipos de assistentes no Assistente de Cdigo

2. Informe o Nome do Fonte (Tela 74 B)
3. Selecione o Tipo de Assistente (Tela 74 C)
4. Acione o boto Prximo (Tela 74 D).
Conforme o Tipo de Assistente selecionado, voc ser guiado por uma ou mais pginas para complementar os
dados necessrios para a gerao do arquivo-fonte.
Assistente de cdigo: Cadastro

Este tipo de assistente o auxilia a criar arquivos-fontes, capazes de efetuar manuteno de dados em tabelas.
Tela 75: Definio de tipo de template com informaes primordiais

1. Selecione o tipo template, em Cadastro - Tipo de arquivo(Tela 75 A), conforme a origem da definio da
tabela.
a. Arquivo padro utilizado quando a definio da tabela a mesma do dicionrio de dados,
preenchendo os dados solicitados.
Parmetros identifica uma Pergunte definida no dicionrio de dados do Protheus;
Alias (Tela 75 B) no caso de arquivo padro, este ser utilizado para localizar as definies
no dicionrio de dados, caso seja arquivo especfico este ser utilizado para identificar a rea
de trabalho (select area);
A ordem de apresentao dos dados definido por uma das opes:
Utilize ndice padro (Tela 75 C) indica qual o nmero do ndice do dicionrio de
dados, associado ao alias, que ser utilizado ;
Utiliza ndice temporrio (Tela 75 D) informe uma expresso Adv/PL vlida para
indicar a ordem dos dados. Este ndice de uso temporrio, sendo eliminado aps o seu
uso.
b. Arquivo especfico utilizado para uma estrutura livre da tabela.
Tela 76: Definio da estrutura para tipo de arquivo especfico

Parmetros (Tela 76 A) identifica uma Pergunte definida no dicionrio de dados do Protheus;
Estrutura (Tela 76 B) - utilizado para definir a estrutura da tabela. Utilize os botes a direita para adicionar
ou remover atributos (campos).
Indexado (Tela 76 C) se marcado indica que a tabela ser ordenada pela expresso Adv/PL informada em
Chave.
2. Aps preencher os dados, avance para a pgina seguinte;

3. Nesta pgina do assistente de cdigo, voc complementa os dados, podendo detalhar funcionalidades.
Tela 77: Definio do template de cadastro

4. Selecione o templatede cadastro (Tela 76 A), conforme a visualizao e comportamento desejado:
a) axCadastro Cadastro Padronizado, ir utilizar a funo axCadastro da biblioteca Adv/PL
b) Mbrowse definindo opes, ir utilizar a funo mBrowse da biblioteca Adv/PL
5. Nas abas logo abaixo, voc efetua algumas customizaes:
a)Aba "Botes" (Tela 78)- utilizada somente pela opo de template Mbrowse e permite adicionar ou
remover funcionalidades a tela utilizando os botes do lado direito;
Tela 78: Configurao de botes para mBrowse

b)Aba "Campos" (Tela 79) - permiti voc indicar quais campos e customizar alguns atributos. Caso no
especifique, ser utilizado todos os campos definidos no dicionrio de dados ou na definio de tabela
customizada.
Tela 79: Seleo de campos e atributos
c) Configuraes (Tela 80) permiti definir propriedades opcionais.
Tela 80: Configuraes opcionais do assistente

Titulo informe o titulo a ser utilizado na janela;
Campo Diferenciador expresso Adv/PL, utilizada pela mBrowse para agrupar os dados
Ao preencher todos os dados obrigatrios solicitados, finalize. Voc obter algo semelhante a Tela 81. Localize a
entrada de funo user function e coloque um nome mais significativo, salve e compile.
Tela 81: Exemplo de cdigo gerado pelo Assistente
Assistente de cdigo: Gerao de Arquivo Texto

Este tipo de assistente o auxilia a criar arquivos-fontes, capazes de gerar arquivos textos a partir de uma tabela de
dados.
Tela 82: Assistente para Gerao de Arquivo Texto

1. Selecione o tipo template, em Gerao de TXT - Tipo de arquivo (Tela 82 A), conforme a origem da
definio da tabela.
A ordem de leitura dos dados definido por uma das opes:
uso.
Tela 83: Definio de arquivo especfico

Estrutura (Tela 83 B) - utilizado para definir a estrutura da tabela. Utilize os botes a direita
para adicionar ou remover atributos (campos).
Indexado (Tela 83 C) se marcado indica que a tabela ser ordenada pela expresso Adv/PL i
nformada em Chave.
3. Nesta pgina do assistente de cdigo, voc complementa os dados detalhando como ser o arquivo texto.
Arquivo Texto (Tela 84) - Indique a origem dos demais dados, podendo ser:
Tela 84: Definio do formato do arquivo texto definido

Definido (Tela 84 A) os valores so fixos e informados logo abaixo;
1.
Parametrizado (Tela 85 A) os valores sero lidos a partir de uma varivel (normalmente de

escopo privado (private).
Tela 85: Definio do formato do arquivo-texto parametrizado

Informe os demais campos conforme solicitado (Tela 84 B e C, Tela 85 B e C)
b) Posies ser utilizado para definir o layout do arquivo de sada.

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.
Tela 86: Definio do layout do arquivo de sada

Tela 87: Tela aps a execuo do Assistente de Gerao de Arquivo Texto
Assistente de cdigo: Importao de Arquivo Texto

Este tipo de assistente o auxilia a criar arquivos-fontes, capazes de importar arquivos textos e gravando-os em uma
tabela de dados.
Tela 88: Assistente para importao de arquivos textos

1. Selecione o tipo template, em Importao de TXT - Tipo de arquivo(Tela 88 A), conforme a origem da
definio da tabela.
uso.
Arquivo especfico utilizado para uma estrutura livre da tabela.
Tela 89: Parmetros para importao do arquivo texto definido

Estrutura (Tela 89 B) - utilizado para definir a estrutura da tabela. Utilize os botes a direita para
adicionar ou remover atributos (campos).
Indexado (Tela 89 C) se marcado indica que a tabela ser ordenada pela expresso Adv/PL inform
ada em Chave.
3. Nesta pgina do assistente de cdigo, voc complementa os dados detalhando como o arquivo texto de
entrada.
a) Arquivo Texto (89) - Indique a origem dos demais dados, podendo ser:
Definido (Tela 89 A) os valores so fixos e informados logo abaixo;
Parametrizado (Tela 90 A) os valores sero lidos a partir de uma varivel
(normalmente de escopo privado (private)).
Tela 90: Definio dos parmetros para importao de arquivo texto

Informe os demais campos conforme solicitado (Tela 89 B e C, Tela 90 B e C)
b) Posies ser utilizado para definir o layoutdo arquivo de sada.
Tela 91: Definio do layout do arquivo de sada

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.
Tela 92: Cdigo gerado pelo assistente para importao de arquivos textos
Assistente de cdigo: Processamento genrico

Este tipo de assistente o auxilia a criar arquivos-fontes, com um esqueleto para processamentos genricos.
Tela 93: Iniciando o assistente de cdigo para processamento genrico

1. Selecione o tipo template, em Processamento Genrico - Tipo de arquivo (Tela 93 A), conforme a origem
da definio da tabela.
uso.
Tela 94 : Configurao de arquivo especfico

Estrutura (Tela 94 B) - utilizado para definir a estrutura da tabela. Utilize os botes a direita
para adicionar ou remover atributos (campos).
Indexado (Tela 94 C) se marcado indica que a tabela ser ordenada pela expresso Adv/PL i
nformada em Chave.
2. Aps preencher os dados, finalize.
Tela 95 : Janela aps execuo do assistentes para processamento genrico
2. Nova Classe AdvPL

Este tipo de assistente o auxilia na criao de arquivos-fontes, com um esqueleto para definio de uma classe em
Adv/PL.
Tela 96: Definio de uma classe Adv/PL via Assistente de Cdigo

Informe os dados solicitados:
Local (folder) (Tela 96 A) indica o local (folder) onde o arquivo-fonte ser salvo
Nome da Classe (Tela 96 B) nome da classe
Herda a classe (Tela 96 C) nome da classe pai, quando tratar-se de classe com herana
Criar arquivo como referncia (Tela 96 D) o arquivo ser gravado no Diretrio de Destino e no local ser
criado uma ligao simblica (link).
Aps informar os dados solicitados, finalize e obter algo semelhante a:
Tela 97: Tela aps executar o Assistente de Cdigo para uma nova classe Adv/PL
3. Nova Funo AdvPL

Este tipo de assistente o auxilia na criao de arquivos-fontes, com um esqueleto para definio de uma funo em
Adv/PL.
Tela 98: Assistente para uma nova funo Adv/PL

Nome da funo (Tela 98 B) nome da funo
Criar arquivo como referncia (Tela 98 C) o arquivo ser gravado no Diretrio de Destino e no local ser
criado uma ligao simblica (link).
Tela 99: Tela aps a execuo do assistente de nova funo
4. Novo Fonte WSDL AdvPL

Este tipo de assistente o auxilia na criao de arquivos-fontes, com a definio de um cliente de servio web (web
service client) a partir da sua definio WSDL.
Tela 100: Execuo do assistente de gerao de clientes de servios web (web service client)
Este assistente depende de uma definio de servidor Protheus e o selecionamento deste na barra de ferramentas.
Caso o servio web a ser utilizado esteja fora da rede do usurio, o servidor Protheus dever ter privilgios de
acesso.
Nome do fonte (Tela 100 B) nome do arquivo-fonte que conter a definio WSDL
URL (Tela 100 C) informe a URL de onde esta o servio web desejado
Criar arquivo como referncia (Tela 100 D) o arquivo ser gravado no Diretrio de Destino e no local
ser criado uma ligao simblica (link).
Tela 101: Tela aps a gerao de um cliente de servio web
1. Compilao de verso
Para efetuar um o processo de "Compilao de verso", use o boto existente na barra de ferramentas.
Tela 110: Boto para acionamento "Compilao de verso" em destaque.

Este processo permite que seja efetuado a gerao de pacotes de atualizao ( patch), com a opo de compilar ou
no os fontes envolvidos, em mltiplos ambientes.
1. Acione o boto de compilao de verso.
Tela 111: Parmetros iniciais para a compilao de verso

2. Informe os dados solicitados:
a. Servidor (Tela 111 A) - selecione o servidor Protheus que ser utilizado para a compilao e gerao
do pacote. Todos os servidores registrados na viso TOTVS Server sero listados.
b. Ambiente (Tela 111 B)- selecione o(s) ambiente(s) (obtido a partir do servidor selecionado) no qual o
processo ser executado.
c. Ler configuraes (Tela 111 C) permite recuperar as configuraes de um arquivo externo, gerado
pelo acionamento do boto "Salvar Configurao" (Tela 112 F).
Tela 112: Seleo de projetos e fontes na compilao de verso

3. Acione "Prximo" e na tela apresentada informe os dados solicitados:
a. Itens do pacote (Tela 112 B) na rvore de seleo apresentada, selecione os itens que deseja que
faam parte do pacote a ser compilado/gerado;
b. Compilar selecionados (Tela 112 C) quando acionada esta opo, os itens selecionados sero
compilados em todos os ambientes selecionados na tela anterior.
c. Gerar patch da seleo de projetos (Tela 112 D) ser executado o processo de gerao de
pacote de atualizao, para todos os ambientes selecionados;
NOTA: Faz-se necessrio selecionar uma delas ou as duas opes acima.
d. Local (Tela 112 E) selecione onde ser gravado o pacote de atualizao (se a opo anterior estiver
marcada).
e. Salvar configuraes (Tela 112 F) permite salvar as configuraes efetuadas em um arquivo
externo, para posterior reutilizao carregando este arquivo atravs do acionamento do boto "Ler Configurao"
(Tela 112 C).
4. Acione "Finalizar" e aguarde o trmino do processamento.
Tela 113: Exemplo de ocorrncias durante o processo de compilao de verso
1. Gerao de pacote de atualizao (Patch)

Acione o boto de gerao de pacote de atualizao (patch) (Tela 102 A).
Tela 103: Parmetros iniciais para a gerao de pacotes de atualizao (patch)

Nas caixas de seleo, indique qual a melhor opo para voc:
Servidor (Tela 103 A) - selecione o servidor Protheus que ser utilizado para a gerao do pacote. Todos os
servidores registrados na viso TOTVS Server sero listados.
Ambiente (Tela 103 B)- selecione o ambiente (obtido a partir do servidor selecionado).
Processo(Tela 103 C) - indica qual procedimento ser adotado na gerao dos pacotes.
Comparao este procedimento compara o seu RPO com um RPO mestre, gerando um pacote pela
diferena entre eles;
Programa este procedimento permitir que voc indica qual ou quais programas sero colocados no
pacote;
Grupo de Projetos permite que voc escolha um ou mais projetos que iro fazer parte do pacote.
Salvar em (Tela 103 D) selecione onde o arquivo de atualizao ser salvo aps a sua gerao. Pode ser
na mquina local ou no servidor.
Por comparao
Este processo compara o RPO atual do servidor/ambiente selecionado com um RPO denominado "mestre", que
encontra-se em um diretrio do servidor. Para efetuar o procedimento:
a. Servidor (Tela 103 A) selecione o servidor que ser utilizado na comparao
b. Ambiente (Tela 103 B) selecione o ambiente
c. Processo (Tela 103 C) Por comparao
2. Prossiga para a prxima etapa.
2.
Tela 104: Configurao da gerao de pacote de atualizao por comparao

3. Selecione o diretrio no qual encontra-se o RPO "mestre" (Tela 104 B).
Tela 105: Pacote de atualizao por comparao realizado com sucesso.

4. Acione "Finalizar" e aguarde o final do processamento.
Por programa
Este processo permite voc selecionar os programas que sero gravados no pacote de atualizao. Os
procedimentos so:
c. Processo (Tela 103 C) Por programa
2. Prossiga para a prxima pgina (pode levar algum tempo).
Tela 106: Gerao do pacote de atualizao por programa

3. Selecione os programas ou recursos/arquivos (Tela 106) que faro parte do pacote de atualizao utilizando
o campo Procurar fonte ou Procurar recurso (Tela 106 A) e acionando o boto Filtrar correspondente, voc
pode localizar rapidamente um arquivo ou vrios, utilizando os caracteres coringa * e ?.
Por Grupo de Projeto

Este processo permite gerar o pacote de atualizao, selecionando projetos da sua rea de trabalho ( workspace).
Os procedimentos so:
c. Processo (Tela 103 C) Por Grupo de Projetos
2. Prossiga para a prxima pgina.
Tela 107: Seleo de projetos para a gerao do pacote de atualizao

3. Selecione os projetos na lista apresentada.
2. Aplicao de pacote de atualizao

Nota: A partir da verso 11.1.27.201210011603 liberado em 01/09/2012, foi introduzido configurao de segurana
na aplicao pacotes de atualizaes (patch).
Por padro, a aplicao pacotes de atualizaes (patch) negada a qualquer usurio, exceto quando a conexo ao
server for efetuada por "localhost" (127.0.0.1).
Para liberar a aplicao pacotes de atualizaes (patch):
Abra o arquivo "appServer.ini" com um editor de textos simples. Este arquivo encontra-se no diretrio do servidor
de aplicaes Protheus (appServer.exe);
1. Adicione a sesso e chaves abaixo:
[TDS]
allowApplyPatch=<estaes permitidas>
2. Salve o arquivo.
<estaes permitidas> = lista de ips ou nome das estaes, separados por vrgula, que podem aplicar pacotes de
atualizaes (patch). Para liberar a aplicao a partir de
qualquer estao, informe "*" (asterisco, sem aspas).
Acione o boto de aplicao de pacote de atualizao ( patch) (Tela 102 B) e preencha os dados solicitados.
Tela 108: Aplicao de pacote de atualizao

1. Informe os dados solicitado:
a) Servidor (Tela 108 A) - selecione o servidor Protheus que ser utilizado para a gerao do pacote. Todos os
servidores registrados na viso TOTVS Server sero listados.
b) Ambiente (Tela 108 B)- selecione o ambiente (obtido a partir do servidor selecionado).
c) Pacote (Tela 108 C) selecione onde o arquivo de atualizao a ser aplicado encontra-se. Pode ser na mquina
local ou no servidor.
Tela 109: Aplicao de pacote de atualizao finalizada.

Totvs Developer Studio Eclipse PDF

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Totvs Developer Studio Eclipse PDF

Enviado por

Direitos autorais:

Formatos disponíveis

TOTVS | Developer Studio - Verso 11.

Mquina Virtual Java (JVM)

Endereo web onde pode ser obtido a JVM:

Instalao do TOTVS | Developer Studio

Tela 1: Seleo de idioma do instalador

Tela 2: Termos e condies de uso

Tela 3: Local de instalao

Tela 5: Instalao concluda

Tela 6: rea de trabalho (desktop)

3. Iniciando o TOTVS | Developer Studio

Tela 7: Seleo da rea de trabalho (workspace)

Tela 8: TOTVS | Developer Studio sendo inicializado

Tela 9: Termo de aceite do TOTVS | Development Studio

Tela 10: Tela de Boas-Vindas

Tela 11: Instalao de adicionais (plugins)

Perspectivas (perspective) So "configuraes" pr-definidas, que podem ser customizadas pelo

Tela 12: Seletor de perspectiva

Tela 13: Seleo de perspectiva "TOTVS Developer"

Tela 14: Perspectiva "TOTVS Developer" selecionada

Tela 15: Viso "TOTVS Explorer"

Tela 16: Assistente de novos elementos

Importar projeto Adv/PL

Tela 17: Assistente de importao de projetos DevStudio

Novo Projeto TOTVS

Tela 19: Assistente de novo projeto TOTVS

Tela 20: Novo projeto TOTVS inicializado

Tela 21: Elemento "Projeto"

Tela 22: Elemento "pasta (folder)"

Tela 23: Elemento "Arquivo"

Submenu para novos elementos.

Inicializa um novo projeto TOTVS.

Inicializa um novo arquivo.

Inicializa uma nova pasta.

Inicializa o assistente de novos

Coloca o elemento selecionado,

Copia o elemento para a rea de

Cola o contedo da rea de

Remove o elemento da rvore.

Modifica o nome do elemento.

Inicia o assistente de importao.

Inicia o assistente de exportao.

Atualiza a rvore de navegao.

Atualizar definio WSDL

No caso do arquivo-fonte conter

Fecha o projeto, mas mantem o

Fechar projetos no relacionados

Fecha todos os projetos que no

Recompila todos os elementos do

Compila todos os elementos que

Permite executar o projeto1.

Permite editar configuraes de

Permite executar o projeto em

Permite editar configuraes de

Opo que permite gerenciar

Inicia o processo de comparao

Restaurar do histrico local...

Permite recuperar verses

Sub-opes relacionadas a fontes

Apresenta uma janela com

Tela 24: Propriedades do elemento "projeto"

Tela 25: Propriedade "Construtores" do elemento "projeto"

Tela 26: Propriedade do elemento pasta (folder)

Tela 27: Propriedades do elemento arquivo