Guia de configurao TOTVS Developer Studio 11.

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: Servers Extension (Tela 29 A) podemos definir quais servidores que vamos utilizar, permitindo tambm, efetuar configuraes e obter informaes sobre o processamento (quando disponvel). TOTVS ServerOutline (Tela 29 B) permite uma navegao rpida entre as opes/abas de configurao de um servidor previamente selecionado.

Guia de configurao TOTVS Developer Studio 11.1

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

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 Novo Grupo de Servidores Servidor de Aplicao Servidor 4GL Servidor 4GLP Servidor Adv/PL Servidor Interno Servidor DBAccess Servidor DBAccess Conexes ativa Descrio da funo Permite criar um elemento na rvore que agrupa servidores. Apresenta a lista de tipos de servidores disponveis. Inicia a configurao de um servidor com suporte a 4GL. Inicia a configurao de um servidor com suporte a 4GLP. Inicia a configurao de um servidor com suporte a Adv/PL. Inicia a configurao de um servidor com suporte a Adv/PL, prconfigurado e de uso exclusivo a partir do TDS Developer Studio. Apresenta a lista de tipos de servidores disponveis. Inicia a configurao de um servidor DBAccess. Fora uma atualizao das abas informativas, para os servidores conectados.

Guia de configurao TOTVS Developer Studio 11.1

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).

Guia de configurao TOTVS Developer Studio 11.1

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 Conectar Servidor Remover Descrio da funo Conecta-se ao servidor conforme as informaes constantes na configurao(Tela 32 B). Remove as configuraes do servidor, tornando-o inacessvel.

Aps efetuar a conexo com o servidor, o menu de contexto passa a ter: Opo Desconectar Servidor Conexes ativas Para o Servidor Desabilita conexo Descrio da funo Encerra a conexo com o servidor. Fora uma atualizao das abas informativas, para os servidores conectados. Envia ao servidor um comando de parada (shutdown) 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 sa lvar 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 .

Guia de configurao TOTVS Developer Studio 11.1

Tela 34: Aba informativa consoleNOTAS :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 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. Para liberar a edio: Abra o arquivo appServer.ini com um editor de textos simples. Es te arquivo encontra-se no diretrio do servidor de aplicaes Protheus (appServer.exe); Adicione a sesso e chaves abaixo:[TDS]ALLOWEDIT= Salve o arquivo.

Guia de configurao TOTVS Developer Studio 11.1

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.

Guia de configurao TOTVS Developer Studio 11.1

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

Guia de configurao TOTVS Developer Studio 11.1

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.

Guia de configurao TOTVS Developer Studio 11.1

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 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 Eclipse: 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
9

Guia de configurao TOTVS Developer Studio 11.1

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. 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;

10

Guia de configurao TOTVS Developer Studio 11.1

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 (plugins), so agrupadas em perspectivas (perpectives). 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 ().

11

Guia de configurao TOTVS Developer Studio 11.1

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

12

Guia de configurao TOTVS Developer Studio 11.1

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.

13

Guia de configurao TOTVS Developer Studio 11.1

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
14

Guia de configurao TOTVS Developer Studio 11.1

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 (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. Copiar arquivos para a area de trabalho do TDS Esta 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 ser refletido no outro 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,
15

Guia de configurao TOTVS Developer Studio 11.1

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.

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).

16

Guia de configurao TOTVS Developer Studio 11.1

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 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 (Tela 19 A) que esta selecionado.

17

Guia de configurao TOTVS Developer Studio 11.1

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 Novo Projeto Arquivo Pasta Outros Vai para Descrio da funo Submenu para novos elementos. Inicializa um novo projeto by You Studio. Inicializa um novo arquivo. Inicializa uma nova pasta. Inicializa o assistente de novos elementos. 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. Copia o elemento para a rea de transferncia (clipboard). Cola o contedo da rea de transferncia (clipboard). 18

Copiar ctrl+C Colar ctrl+V

Guia de configurao TOTVS Developer Studio 11.1

Remover DELETE Renomear F2 Importar Exportar Atualizar F5 Atualizar definio WSDL 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. No caso do arquivo-fonte conter uma definio de cliente de web-service, o mesmo reprocessado. Fecha o projeto, mas mantem o elemento. Fecha todos os projetos que no esto relacionados entre si. Recompila todos os elementos do projeto ou pasta (folder). Compila todos os elementos que foram modificados ou que no existam no repositrio (RPO).1 Permite executar o projeto1. Permite editar configuraes de execuo. Permite executar o projeto em modo depurao (debug)1. Permite editar configuraes de depurao Opo que permite gerenciar trabalhos em equipe. Inicia o processo de comparao entre elementos.2 Permite recuperar verses anteriores a partir do histrico local.2 Sub-opes relacionadas a fontes do projeto Executa a formatao de arquivos-fonte. Apresenta uma janela com informaes sobre o elemento

Fechar projeto Fechar projetos no relacionados Recompilar Compilar

Executar como Configurar execuo Depurar como.. Configurar depurao Equipe Comparar com Restaurar do histrico local Fonte Formatar Propriedades alt+ENTER

19

Guia de configurao TOTVS Developer Studio 11.1

Projeto: Propriedades

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

20

Guia de configurao TOTVS Developer Studio 11.1

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 (folder). Para detalhes da opo Run/Debug Settings, veja Trabalhando com projetos: Execuo. Algumas propriedades sero propagadas para todas as subpastas e arquivos.

Arquivos: Propriedades

21

Guia de configurao TOTVS Developer Studio 11.1

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.

22