Escolar Documentos
Profissional Documentos
Cultura Documentos
Totvs Developer Studio Eclipse
Totvs Developer Studio Eclipse
1
1. Apresentao
Objetivo
O " ", um conjunto de aplicaes e ferramentas que interagem entre si, disponibiliza TOTVS | Developer Studio
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: , na sesso " ". http://suporte.totvs.com downloads
2. Instalao
Verificao do ambiente
Sistema Operacional
Certifique-se que o sistema operacional que ser utilizado, seja homologado para uso do TOTVS | Developer
e devidamente atualizado. Studio
Mquina Virtual Java ( ) JVM
Em ambientes Windows, o instalador do efetuar uma verificao e se necessrio, TOTVS | Developer Studio
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 do fornecedor e siga as instrues de web
instalao ou atualizao fornecidas por ele.
Endereo onde pode ser obtido a JVM: web
http://java.com/en/download/manual.jsp
Instalao do TOTVS | Developer Studio
Passo a passo
1. Inicie o instalador do , conforme o seu sistema operacional. TOTVS | Developer Studio
Todas as telas apresentadas so do sob sistema operacional Windows 7, porm TOTVS | Developer Studio
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 , execute o procedimento adequado ao seu sistema operacional. TOTVS | Developer Studio
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 ( ) ou fisicamente, informaes de gerenciamento e organizao dos fontes e symbolic link
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 ( ), voc pode compartilhar diretrios e arquivos, que so comuns symbolic links
a vrios projetos.
Na caixa de texto " (Tela 7 A), selecione um diretrio para ser o ponto de partida (diretrio raiz) da sua workspace"
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 , no lhe ser TOTVS | Developer Studio
solicitado a rea. Caso o diretrio selecionado no exista, este ser criado.
Tela 7: Seleo da rea de trabalho (workspace)
Utilize esta opo se voc no pretende ter vrias reas ou se ela for a rea em que voc costuma NOTA :
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 |
Este procedimento facilitar manter cpias de segurana e futuras atualizaes do produto. Developer Studio.
Aps a seleo da rea de trabalho, aguarde alguns instantes enquanto o inicializado TOTVS | Developer Studio
e apresente a tela de boas-vindas.
Tela 8: TOTVS | Developer Studio sendo inicializado
Termo de aceite
Para a plena utilizao do , necessrio que voc aceite o termo de utilizao. Leia-a TOTVS | Developer Studio
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 passar para a tela de "Bos Vindas", TDS
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 (Tela 10 A). Caso deseje acessar esta aba novamente, X
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 , que a base de Eclipse
construo do . Para coloc-lo em seu idioma veja o "Anexo III: TOTVS Developer Studio no seu idioma", que TDS
est no final do manual.
Tela principal
Se ainda no o fez, feche a aba de boas-vindas.
Como j dito, o foi construdo sob o Endereo dos responsveis pelo TOTVS | Developer Studio, Eclipse web Eclips
,(acessado em Fevereiro/2012). Que uma ferramenta de uso geral configurvel e e: http://www.eclipse.org/
extensvel para vrias tarefas. Caso voc tenha familiaridade com o ver que o funcionamento do Eclipse, TOTVS |
praticamente o mesmo de quando o utilizamos para desenvolvimento em Java ou outras Developer Studio
linguagens suportadas por ele.
Se voc no conhece o passaremos aqui as informaes primordiais, para que possa utilizar o Eclipse, TOTVS |
e caso queira se aprofundar, recomendamos a leitura de " " Developer Studio Eclipse Indigo (3.7) Documentation .
Para acesso a citada documentao (em ingls), acesse: (acessado em http://help.eclipse.org/indigo/index.jsp
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 e neste caso, Protheus
trataremos aqui.
Para obter material sobre o em sue idioma, efetue uma busca em de busca, que h farto material Eclipse sites
disponibilizado por terceiros.
1.
2.
3.
O uma ferramenta de desenvolvimento integrada ( ). Por isso, voc possui uma TOTVS | Developer Studio IDE
vasta gama de funcionalidades, tais como edio de programas, execuo, depurao anlise de (debug),
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 , acionando o menu TOTVS | Developer Studio Ajuda | Instalar
Lhe ser apresentada uma janela semelhante a: novo software....
Tela 11: Instalao de adicionais (plugins)
Os adicionais so pacotes de softwares que adicionam capacidades ou estende funcionalidades j (plugins),
existente ao TDS. Tomaremos como exemplo, que desejamos desenvolver aplicativos utilizado a linguagem de
programao . Adv/PL
No campo "Work With" ( Tela 11 A), informe (digitando ou colando) o endereo do pacote a ser adicionado,
no nosso caso ser , que foi obtido no site ; http://ds.totvs.com/updates/advpl http://ds.totvs.com
Acione ENTER e aps alguns instantes, lhe ser apresentada uma rvore ( Tela 11 B), para a seleo dos
adicionais desejados. Selecione "Adv/PL";
Acione "Avanar" ( Tela 11 C) e siga as instrues do "Gerenciador de Atualizaes".
Perspectivas
As funcionalidades adicionadas ou estendidas por adicionais ( ), so agrupadas em perspectivas ( plugins perpective
). Ao instalar um dos adicionais do , ele vir com as perspectivas bsicas para o s TOTVS | Developer Studio
desenvolvedor de produtos TOTVS.
So "configuraes" pr-definidas, que podem ser customizadas pelo Perspectivas ( ) perspective
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 , voc ter acesso a outras perspectivas. Janela | Abrir perspectiva | Outros...
A perspectiva inicial a "Informaes ( )", que neste momento no nos interessante. Acesse a seleo Resources
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 e menu de acesso rpido (Tela 14 I). status
Tela 14: Perspectiva "TOTVS Developer" selecionada
Todos os elementos, exceto o menu principal e barra de ferramentas, so denominados de vises (views) e so
dockable). acoplveis (
Viso ( ) view As vises so janelas acoplveis ( ) que adicionam funcionalidades ou informaes a dockable
perspectiva atual. Para ativar uma viso, acesse o menu " " e na rvore de Janela | Viso | Outras
navegao apresentada, localize a viso desejada e selecione-a. Se desejar, pode fechar uma viso
acionando o existente ao lado do titulo dela. X
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 ( ) voc pode colocar quantos workspace
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 . ou . Lhe ser apresentado o assistente de novos elementos ou assistente Novo | Outras... Importar
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 , expanda-o e obter as opes (Tela 16 destacado). "TOTVS Wizard"
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
1.
2.
3.
a.
b.
4.
5.
6.
Tela 17:Assistente de importao de projetos DevStudio
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;
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.
Indique o mtodo de de importao(Tela 17 C);
Manter os fontes no diretrio de origem (legado) Ao utilizar esta opo, as pastas ( ) e folders
arquivos sero anexados ao projeto TOVS por meio de uma ligao simblica ( ), ou seja, symbolic link
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.
Copiar arquivos para a area de trabalho do TDS Esta opo, efetua uma cpia fsica das pastas (fol
) e arquivos referenciados pelo arquivo de projeto (*.prj) para dentro da rea de trabalho ( ders workspa
) em uso. Neste caso, qualquer alterao efetuada em uma das cpias, no ser refletido no outro ce
ambiente.
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".
As ligaes (Tela 17 E), lhe do acesso aos outros locais de definio de lista de busca;
Finalize a edio e aguarde o processamento. Ao final, obter algo semelhante a Tela 18.
6.
Tela 18: Perspectiva TOTVS Developer aps a importao de um arquivo de projetos (.prj)
Na viso TOTVS Explorer, voc tem as pastas ( ) (Tela 18 A) e os arquivos do projeto. Repare que os folders
arquivos esto identificados com um cone contendo uma pequena seta, indicando que trata-se de uma ligao
simblica ( ). Na viso (Tela 18 B), voc tem as ocorrncias durante o processo de symbolic link Console
importao.
Novo Projeto TOTVS
Esta opo inicializa um projeto TOTVS, com sugesto de estrutura de pastas ( ) folders .
1.
2.
3.
4.
Tela 19: Assistente de novo projeto TOTVS
Informe o nome do projeto (Tela 19 A);
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".
As ligaes (Tela 19 C), lhe do acesso aos outros locais de definio de lista de busca;
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 , utilizando o menu de contexto voc pode gerenciar seus projetos. As opes do menu de TOTVS Explorer
contexto, depender do item da rvore de navegao que esta selecionado.
Menu de contexto
Tela 21: Elemento "Projeto"
Executar como...
Permite executar o projeto .
1
Configurar execuo... Permite editar configuraes de
execuo.
1.
2.
3.
1. Acessando TOTVS Server
Para acessar a perspectiva TOTVS , ou qualquer outra, selecione-a atravs do seletor de perspectiva (Tela Server
28 C) ou pelo menu e selecione . Janela | Abrir perspectiva | Outros TOTVS Server
Tela 28: Seletor de perspectiva
A perspectiva TOTVS Server semelhante a:
Tela 29: Perspectiva "TOTVS Server"
Onde temos:
Servers Extension (Tela 29 A) podemos definir quais servidores que vamos utilizar, permitindo tambm,
efetuar configuraes e obter informaes sobre o processamento (quando disponvel).
(Tela 29 B TOTVS ServerOutline ) permite uma navegao rpida entre as opes/abas de configurao
de um servidor previamente selecionado.
Abas informativas (Tela 29 C) contm algumas vises ( ) com informaes adicionais sobre o views
servidor, tais como usurios conectados e pelo menu de contexto desta, algumas operaes com o servidor.
1.
2.
3.
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:
Abra o arquivo "appServer.ini" com um editor de textos simples. Este arquivo encontra-se no diretrio do
servidor de aplicaes Protheus (appServer.exe);
Localize (ou adicione) a sesso e chaves abaixo:
[TDS]
ALLOWEDIT=<estaes permitidas>
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 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 Interno Inicia a configurao de um
servidor com suporte a Adv/PL,
pr-configurado e de uso exclusivo
a partir do TDS Developer Studio.
Acione o boto de aplicao de pacote de atualizao ( ) (Tela 102 B) e preencha os dados solicitados. patch
Tela 108: Aplicao de pacote de atualizao
1.Informe os dados solicitado:
a) Servidor (Tela 108 A) - selecione o servidor que ser utilizado para a gerao do pacote. Todos os Protheus
servidores registrados na viso sero listados. TOTVS Server
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.