169493082 Totvs Developer Studio Eclipse

TOTVS | Developer Studio - Versão 11.1

1. Apresentação

Objetivo

O " ", é um conjunto de aplicações e ferramentas que interagem entre si, disponibilizaTOTVS | Developer Studioaos desenvolvedores de produtos TOTVS, um ambiente de desenvolvimento ágil, confortável e poderoso.

Público

Desenvolvedores de produtos TOTVS, que utilizem uma ou mais das linguagens de programação abaixo:

4GL;4GLP;Adv/PL e Adv/PL-asp

Pré-requisitosConhecimentos:

Sistema operacional adotado;Configuração e execução da aplicação servidora Protheus (opcional);Conhecimentos da linguagem a ser utilizada.

Sistema Operacional (qualquer um destes):MS-Windows 32 ou 64 bits, versão XP ou superior;Linux 32 ou 64 bits.

Máquina Virtual Java (JVM), JRE versão 6 ou superior, de acordo com o sistema operacional em uso.Servidores Protheus com suporte à:

Adv/PL, versão 7.00.101202A ou superior, de acordo com o sistema operacional em uso;4GL, versão 7.00.101202A ou superior, de acordo com o sistema operacional em uso;4GLP, versão 7.00.100812P ou superior, de acordo com o sistema operacional em uso.

Instalador do TOTVS | Developer Studio.

O instalador pode ser obtido através do endereço: , na sessão " ".http://suporte.totvs.com downloads

http://suporte.totvs.com/

2. Instalação

Verificação do ambiente

Sistema Operacional

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

Máquina Virtual Java ( )JVM

Em ambientes Windows, o instalador do efetuará uma verificação e se necessário,TOTVS | Developer Studioa atualização ou instalação da JVM de forma automática, após confirmação.

Notas:

1. Dependendo das diretrizes de segurança de sua rede, o procedimento pode não ser efetuado, neste casoefetue os procedimentos manualmente.

2. Em alguns ambientes, apesar da JVM estar instalada e atualizada, o instalador não consegue reconhecê-la.Se, lhe for solicitado a instalação e você tem certeza que a JVM esta instalada e atualizada, não confirme oprocedimento.

Caso já a tenha instalado, verifique a versão usando os procedimentos conforme seu sistema operacional.

WindowsAcesse "Painel de Controle"Acione o icone "Java"Na aba "Geral", acione "Sobre"

LinuxAcesse o terminalDigite o código: java -version.

Caso não tenha ou a versão esteja desatualizava, acesse a página do fornecedor e siga as instruções dewebinstalação ou atualização fornecidas por ele.

Endereço onde pode ser obtido a JVM:web

http://java.com/en/download/manual.jsp

Instalação do TOTVS | Developer Studio

Passo a passo

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

Todas as telas apresentadas são do sob sistema operacional Windows 7, porémTOTVS | Developer Studiopode-se usá-las como referência para os demais sistemas operacionais, salvo se dito ao contrário.

2. Selecione o idioma que deseja utilizar durante o processo de instalação.



Tela 1: Seleção de idioma do instalador

3. Leia os termos e condições do licenciamento e selecione a opção que corresponde ao aceite A não aceitaçãodos termos e condições de uso implica no cancelamento da instalação. e prossiga.

Tela 2: Termos e condições de uso

4. Selecione o local de instalação e avance.

Tela 3: Local de instalação

5. Aguarde a instalação e

Tela 4: Instalação

6. .. o aviso de término.

Tela 5: Instalação concluída

7. Em sua área de trabalho (desktop), serão criados atalhos de acesso, um para cada idioma suportado.

Tela 6: Área de trabalho (desktop)

3. Iniciando o TOTVS | Developer StudioPara iniciar o uso do , execute o procedimento adequado ao seu sistema operacional.TOTVS | Developer StudioAssim 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 vialigação simbólica ( ) ou fisicamente, informações de gerenciamento e organização dos fontes esymbolic linkoutras informações necessárias ao funcionamento do TOTVS | Developer Studio.Você pode manter quantas áreas de trabalho desejar, organizando seus trabalhos da forma que você acharmais confortável e natural. Por exemplo, mantendo uma área para cada produto/versão, cliente, projetospessoais, etc.Usando as ligações simbólicas ( ), você pode compartilhar diretórios e arquivos, que são comunssymbolic linksa vários projetos.

Na caixa de texto " (Tela 7 A), selecione um diretório para ser o ponto de partida (diretório raiz) da suaworkspace"área. Logo abaixo, você tem uma caixa de marcação (Tela 7 B) na qual você pode optar para que esta seja a suaárea de trabalho padrão. Se você a marcar, na próxima vez que entrar no , não lhe seráTOTVS | Developer Studiosolicitado a área. Caso o diretório selecionado não exista, este será criado.

Tela 7: Seleção da área de trabalho (workspace)

Utilize esta opção se você não pretende ter várias áreas ou se ela for a área em que você costumaNOTA :trabalhar. Nos menus do TOTVS | Developer Studio, você terá acesso a um gerenciador de áreas de trabalho ousolicitar a troca da área em tempo de execução.

Recomenda-se que a área de trabalho seja colocada em diretório diferente do local de instalação do TOTVS | Este procedimento facilitará manter cópias de segurança e futuras atualizações do produto.Developer Studio.

Após a seleção da área de trabalho, aguarde alguns instantes enquanto o é inicializadoTOTVS | Developer Studioe apresente a tela de boas-vindas.

Tela 8: TOTVS | Developer Studio sendo inicializado

Termo de aceite

Para a plena utilização do , é necessário que você aceite o termo de utilização. Leia-aTOTVS | Developer Studiocom atenção e se estiver de acordo, preencha os campos solicitados, acione a opção "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",TDScaso contrário 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,Xacione menu .Ajuda | Boas-vindas

Tela 10: Tela de Boas-Vindas

Esta tela de boas vindas, contém indicações de onde você pode obter documentação mais completa e comindicações das primeiras tarefas a serem executadas por você, para customizar o TDS a suas necessidades dedesenvolvimento. É provável, que você esteja vendo parte das telas em inglês. Este é o idioma padrão do , que é a base deEclipseconstrução do . Para colocá-lo em seu idioma veja o "Anexo III: TOTVS Developer Studio no seu idioma", queTDSestá no final do manual.

Tela principal

Se ainda não o fez, feche a aba de boas-vindas.Como já dito, o foi construído sob o Endereço dos responsáveis pelo TOTVS | Developer Studio, Eclipse web Eclips

,(acessado em Fevereiro/2012). Que é uma ferramenta de uso geral configurável ee: http://www.eclipse.org/extensível para várias 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 outrasDeveloper Studiolinguagens suportadas por ele.Se você não conhece o passaremos aqui as informações 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 documentação (em inglês), acesse: (acessado emhttp://help.eclipse.org/indigo/index.jspFevereiro/2012)Atentar que algumas informações disponíveis nesta documentação podem não existir ou ser diferentes nocomportamento ou em algum detalhe em função das especificidades do ambiente e neste caso,Protheustrataremos aqui.Para obter material sobre o em sue idioma, efetue uma busca em de busca, que há farto materialEclipse sitesdisponibilizado por terceiros.

http://www.eclipse.org/

http://help.eclipse.org/indigo/index.jsp

1.

2.

3.

O é uma ferramenta de desenvolvimento integrada ( ). Por isso, você possui umaTOTVS | Developer Studio IDEvasta gama de funcionalidades, tais como edição de programas, execução, depuração análise de(debug),desempenho, configuração de servidores e muitas outras funcionalidades. Para ativá-las é necessário instalaradicionais ao seu TDS.

Instalação de adicionais

Acesse o "Gerenciador de Atualizações" do , acionando o menu TOTVS | Developer Studio Ajuda | Instalar

Lhe será apresentada uma janela semelhante a:novo software....

Tela 11: Instalação de adicionais (plugins)

Os adicionais são pacotes de softwares que adicionam capacidades ou estende funcionalidades já(plugins),existente ao TDS. Tomaremos como exemplo, que desejamos desenvolver aplicativos utilizado a linguagem deprogramação .Adv/PL

No campo "Work With" ( Tela 11 A), informe (digitando ou colando) o endereço do pacote a ser adicionado,no nosso caso será , que foi obtido no site ;http://ds.totvs.com/updates/advpl http://ds.totvs.comAcione ENTER e após alguns instantes, lhe será apresentada uma árvore ( Tela 11 B), para a seleção dosadicionais desejados. Selecione "Adv/PL";Acione "Avançar" ( Tela 11 C) e siga as instruções do "Gerenciador de Atualizações".

Perspectivas

As funcionalidades adicionadas ou estendidas por adicionais ( ), são agrupadas em perspectivas (plugins perpective). Ao instalar um dos adicionais do , ele virá com as perspectivas básicas para os TOTVS | Developer Studio

desenvolvedor de produtos TOTVS.

– São "configurações" pré-definidas, que podem ser customizadas peloPerspectivas ( )perspective

http://ds.totvs.com/updates/advpl

http://ds.totvs.com/

desenvolvedor, que permite de uma forma rápida, modificar o seu ponto de vista (perspectiva) em relação aotrabalho que esta sendo executado ou que seja necessário fazer na perspectiva, você tem uma ou maisvisões, que se relacionam de alguma forma entre si e com o trabalho a ser executado.

Você pode selecionar uma perspectiva utilizando as opções disponíveis através dos botões e ícones de seleção,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 "Informações ( )", que neste momento não nos é interessante. Acesse a seleçãoResourcesde perspectivas (conforme citado) e selecione a perspectiva ().Totvs Developer

Tela 13: Seleção de perspectiva "TOTVS Developer"

Na janela principal, além do seletor de perspectiva (Tela 14 C), também temos: Menu principal (Tela 14 A), barra deferramentas (Tela 14 B), navegador de projetos (Tela 14 D), estrutura de programas/classes (Tela 14 E), área deeditores (Tela 14 F), abas informativas e retorno (Tela 14 G) e área de trabalho das abas informativas (Tela 14 H) ebarra de e menu de acesso rápido (Tela 14 I).status

Tela 14: Perspectiva "TOTVS Developer" selecionada

Todos os elementos, exceto o menu principal e barra de ferramentas, são denominados de visões (views) e sãodockable).acopláveis (

Visão ( )view – As visões são janelas acopláveis ( ) que adicionam funcionalidades ou informações adockableperspectiva atual. Para ativar uma visão, acesse o menu " " e na árvore deJanela | Visão | Outras

navegação apresentada, localize a visão desejada e selecione-a. Se desejar, pode fechar uma visãoacionando o existente ao lado do titulo dela.X

Janela acoplável ( )dockable - Essa característica permite que você configure o visual da forma que lhe formais conveniente. Experimente arrastar uma das visões que estão em abas informativas e você verá queconforme for se movimentando pela tela, aparece um quadro pontilhado indicando onde você vai acoplá-la sesoltar o botão do .mouse

1. Iniciando um projetoA organização inicial de um trabalho, é o projeto. Em cada área de trabalho ( ) você pode colocar quantosworkspaceprojetos desejar e faz a administração através da visão " .TOTVS Explorer"

Tela 15: Visão "TOTVS Explorer"

Logo abaixo do título da aba e da barra de ferramentas, acione o menu de contexto e nas opções apresentadasacione . ou . Lhe será apresentado o assistente de novos elementos ou assistenteNovo | Outras... Importar

de importação (conforme a opção utilizada).

Tela 16: Assistente de novos elementos

Nota: Dependendo do licenciamento e versão do "TDS", algumas opções podem estar indisponíveis ou nãoexistirem.

Utilizando a árvore de navegação, localize , expanda-o e obterá as opções (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 básica.

NOTA : O arquivo de projeto (*.prj) é utilizado somente no momento da importação. Qualquer modificação posteriorneste arquivo, não será refletido no projeto importado para o "TDS" e vice-versa.Selecione a opção que melhor lhe atende e prossiga com a execução do assistente.

Importar projeto Adv/PL

1.

2.

3. a.

b.

4.

5. 6.

Tela 17: Assistente de importação de projetos DevStudio

Selecione o arquivo de projetos DevStudio (*.PRJ) (Tela 17 A) desejado. Para selecionar mais de umprojeto, acione a tecla Control junto com o botão direito, porém estes projetos devem estar sob o mesmodiretório;Indique se você quer importa-lo como um novo projeto (Tela 17 B), ou não. Caso desmarque esta opção,deverá selecionar o "Destino" deste projeto.Indique o método de de importação(Tela 17 C);

Manter os fontes no diretório de origem (legado) – Ao utilizar esta opção, as pastas ( ) efoldersarquivos serão anexados ao projeto TOVS por meio de uma ligação simbólica ( ), ou seja,symbolic linkos arquivos continuam nos diretórios de origem e uma referência a ele é criada. Qualquer ediçãoefetuada, usando-se o TDS ou qualquer outro editor externo, será refletido em ambos os ambientes.Como trata-se de uma ligação simbólica, ao acionar a remoção, você irá apagar apenas a referência enão o arquivo fisico.Copiar arquivos para a area de trabalho do TDS – Esta opção, efetua uma cópia física das pastas (fol

) e arquivos referenciados pelo arquivo de projeto (*.prj) para dentro da área de trabalho (ders workspa) em uso. Neste caso, qualquer alteração efetuada em uma das cópias, não será refletido no outroce

ambiente.Em "Diretórios para Busca" (Tela 17 D), adicione os diretórios que deverão ser pesquisados para resoluçãode arquivos de definições (*.ch) que são referenciados nos fontes. Ao lado direito, você tem os botões paraefetuar estas operações. Além disso, você pode adicionar referencia a outras configurações desta lista debusca, que será utilizada juntamente com os que informar. Para detalhes, veja "Configuração de diretóriosde busca".As ligações (Tela 17 E), lhe dão acesso aos outros locais de definição de lista de busca;Finalize a edição e aguarde o processamento. Ao final, obterá algo semelhante a Tela 18.

6.

Tela 18: Perspectiva TOTVS Developer após a importação de um arquivo de projetos (.prj)

Na visão TOTVS Explorer, você tem as pastas ( ) (Tela 18 A) e os arquivos do projeto. Repare que osfoldersarquivos estão identificados com um ícone contendo uma pequena seta, indicando que trata-se de uma ligaçãosimbólica ( ). Na visão (Tela 18 B), você tem as ocorrências durante o processo desymbolic link Consoleimportação.

Novo Projeto TOTVS

Esta opção inicializa um projeto TOTVS, com sugestão 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 "Diretórios para Busca" (Tela 19 B), adicione os diretórios que deverão ser pesquisados para resoluçãode arquivos de definições (*.ch) que são referenciados nos fontes. Ao lado direito, você tem os botões paraefetuar estas operações. Além disso, você pode adicionar referencia a outras configurações desta lista debusca, que será utilizada juntamente com os que informar. Para detalhes, veja "Configuração de diretóriosde busca".As ligações (Tela 19 C), lhe dão acesso aos outros locais de definição de lista de busca;Finalize a edição e aguarde o processamento. Ao final, obterá algo semelhante a:

Tela 20: Novo projeto TOTVS inicializado

2. Gerenciamento de projetosNa aba , utilizando o menu de contexto você pode gerenciar seus projetos. As opções do menu deTOTVS Explorercontexto, dependerá do item da árvore de navegação 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 opções do menu decontexto, conforme o elemento:

Aplica-se a Opção Descrição da função

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

Vai para Coloca o elemento selecionado,como sendo o elemento raiz donavegador (temporariamente). Pararestaurar acione "Para cima" nabarra de ferramentas, logo abaixodo titulo.

Copiar ctrl+C Copia o elemento para a área detransferência ( ).clipboard

Colar ctrl+V Cola o conteúdo da área detransferência ( ).clipboard

Remover DELETE Remove o elemento da árvore.

Renomear F2 Modifica o nome do elemento.

Importar... Inicia o assistente de importação.

Exportar... Inicia o assistente de exportação.

Atualizar F5 Atualiza a árvore de navegação.

Atualizar definição WSDL No caso do arquivo-fonte conteruma definição de cliente de web-ser

, o mesmo é reprocessado.vice

Fechar projeto Fecha o projeto, mas mantem oelemento.

Fechar projetos não relacionados Fecha todos os projetos que nãoestão relacionados entre si.

Recompilar < >elemento Recompila todos os elementos doprojeto ou pasta ( ).folder

Compilar < >elemento Compila todos os elementos queforam modificados ou que não

existam no repositório ( ).RPO 1

Executar como... Permite executar o projeto .1

Configurar execução... Permite editar configurações deexecução.

Depurar como.. Permite executar o projeto em

modo depuração ( ) .debug 1

Configurar depuração... Permite editar configurações dedepuração

Equipe Opção que permite gerenciartrabalhos em equipe.

Comparar com... Inicia o processo de comparação

entre elementos.2

Restaurar do histórico local... Permite recuperar versõesanteriores a partir do histórico local.2

Fonte Sub-opções relacionadas a fontesdo projeto

Formatar Executa a formatação dearquivos-fonte.

Propriedades alt+ENTER Apresenta uma janela cominformações sobre o elemento

Projeto: Propriedades

Tela 24: Propriedades do elemento "projeto"

Ao acionar a opção "Propriedades alt+ENTER ", você pode verificar e editar algumas informações sobre o projeto.Para detalhes da opção "Includes", veja " ".Configuração de diretórios de buscas

: Algumas propriedades serão propagadas para todas as pastas (folders) e arquivos.NOTA

A opção "Construtores", permite você desativar ou ativar o "TOTVS Verificação de sintaxe", que é processadoquando o "TDS" percebe que houve alterações no arquivo. Quando isso ocorre, executa-se uma verificação dasintaxe dos arquivos-fontes.

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

Pastas: Propriedades

Tela 26: Propriedade do elemento pasta (folder)

Ao acionar a opção "Propriedades alt+ENTER ", você pode verificar e editar algumas informações sobre a pasta (fol). Para detalhes da opção " ", veja "Trabalhando com projetos: Execução". Algumasder Run/Debug Settings

propriedades serão propagadas para todas as subpastas e arquivos.

Arquivos: Propriedades

Tela 27: Propriedades do elemento arquivo

Ao acionar a opção "Propriedades alt+ENTER ", você pode verificar e editar algumas informações sobre o arquivo.Para detalhes da opção " ", veja "Trabalhando com Projetos: Depuração" e de "BreakpointRun/Debug SettingsProperties", veja "Depuração de Projetos: Depuração: Pontos de parada".

1.

2.

3.

1. Acessando TOTVS ServerPara acessar a perspectiva TOTVS , ou qualquer outra, selecione-a através do seletor de perspectiva (TelaServer28 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 também,efetuar configurações e obter informações sobre o processamento (quando disponível).

(Tela 29 BTOTVS ServerOutline ) – permite uma navegação rápida entre as opções/abas de configuraçãode um servidor previamente selecionado.Abas informativas (Tela 29 C) – contém algumas visões ( ) com informações adicionais sobre oviewsservidor, tais como usuários conectados e pelo menu de contexto desta, algumas operações com o servidor.

1.

2.

3.

2. Servers Extension: Menu de contextoNota: A partir da versão 11.1.27.201210011603 liberado em 01/09/2012, foi introduzido configuração de segurançana edição de configurações dos servidores.Por padrão, a edição de configurações é negada a qualquer usuário, exceto quando a conexão ao server forefetuada por "localhost" (127.0.0.1). Para liberar a edição:

Abra o arquivo "appServer.ini" com um editor de textos simples. Este arquivo encontra-se no diretório doservidor de aplicações Protheus (appServer.exe);Localize (ou adicione) a sessão e chaves abaixo:[TDS]ALLOWEDIT=<estações permitidas>Salve o arquivo.

<estações permitidas> = lista de ip´s ou nome das estações, separados por vírgula, que podem efetuar alteraçõesde configuração no servidor.

Tela 30: Visão "Server Extension"

Para acessar as ações disponíveis, acione o menu de contexto sobre o elemento "Servidores" da árvore denavegação. As opções são:

Opção Descrição da função

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

Servidor de Aplicação Apresenta a lista de tipos deservidores disponíveis.

Servidor 4GL Inicia a configuração de umservidor com suporte a .4GL

Servidor 4GLP Inicia a configuração de umservidor com suporte a .4GLP

Servidor Adv/PL Inicia a configuração de umservidor com suporte a .Adv/PL

Servidor Interno Inicia a configuração de umservidor com suporte a Adv/PL,pré-configurado e de uso exclusivoa partir do TDS Developer Studio.

Servidor DBAccess Apresenta a lista de tipos deservidores disponíveis.

Servidor DBAccess Inicia a configuração de umservidor .DBAccess

Conexões ativa Força uma atualização das abasinformativas, para os servidoresconectados.

Adicionando um servidor

Para adicionar um servidor, acione o menu de contexto sobre o elemento " " da árvore de navegação daServidoresvisão (Tela 30 A), acione a opção (ou o queServer Extension Servidor de Aplicação | Servidor Adv/PL

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 visão de edição de propriedades (Tela 32 B) de um servidor, efetue um duplo-click noelemento que identifica o servidor (Tela 32 A).

Você pode editar ou corrigir os dados de conexão deste servidor modificando os dados disponíveis nas páginas (naparte de baixo da visão) e acionando a salva através do atalho ctrl + S ou ao trocar de página. No menu decontexto deste elemento, temos:


Conectar Servidor Conecta-se ao servidor conforme as informaçõesconstantes na configuração(Tela 32 B).

Remover Remove as configurações do servidor, tornando-oinacessível.

Após efetuar a conexão com o servidor, o menu de contexto passa a ter:


Desconectar Servidor Encerra a conexão com o servidor.

Conexões ativas Força uma atualização das abas informativas, para osservidores conectados.

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

Desabilita conexão Envia ao servidor um comando para rejeitar novasconexões.

Conectando-se ao servidor

Após a configuração de um servidor, acione o menu de contexto sobre o elemento na árvore de navegação eacione a opção "."Conectar Servidor

:Os servidores com suporte a Adv/PL irão solicitar algumas informações antes de efetuar a conexão. InformeNOTAos dados solicitados. Se desejar, pode salvar o "Usuário" e "Senha" em um local seguro acionando a opção "Salvaras informações de login em local seguro".

Tela 33: Conexão com servidor Adv/PL

Durante e após o processo de conexão, acompanhe as ocorrências na visão console.

Tela 34: Aba informativa console

:e ela não estiver visível, acesse o menu e na árvore deNOTAS Janela | Apresentar visão | Outros

navegação apresentada, abra e acione .Geral Console

Configuração do servidor

Após a conexão, na área de editores, você terá algumas informações (Tela 35 B) sobre o ambiente do servidor eacessando qualquer uma das páginas (Tela 35 C) disponíveis, efetuar modificações de configuração e salvando-asao acionar ctrl+S ou trocando-se a página.Para saber como configurar e o que pode ser configurado em cada um dos servidores, consulte documentaçãoespecífica.Servidor Adv/PLServidor 4GLServidor ABLServidor DBAccess

Tela 35: Servidor conectado

1. Trabalhando com projetosUma vez inicializado um projeto e um servidor ter sido definido, podemos iniciar osTOTVS Developer Studiotrabalhos de desenvolvimento. Selecione a perspectiva (lembre-se que esta é a perspectivaTOTVS Developermais indicada para o desenvolvimento).

1. Criando arquivos-fontePara criar um novo arquivo-fonte, selecione o projeto e, opcionalmente, a pasta onde será armazenado oarquivo-fonte.

Caso não tenha um projeto, acione o menu de contexto na visão TOTVS Explorer, acessando a opção Novo .(Telae na árvore de navegação do assistente, abra TOTVS Wizard e selecione | Projeto Novo projeto

36, Tela 37 e Tela 38 )

Tela 36: Assistente de novo projeto

Tela 37: Identificador do novo projeto e lista de diretórios para include

Tela 38: Projeto inicializado

Acione o menu de contexto na visão , acessando a opção , acionando oTOTVS Explorer Novo | Arquivo

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) padrão. Se quiser modificar olocal, utilize a árvore de navegação (Tela 39 B). No campo "Nome do Arquivo" (Tela 39 C) informe o nome doarquivo-fonte, incluindo a extensão.Logo abaixo, há um o botão "Avançado>>", que se acionado apresenta opção para criar uma ligação simbólica (sy

) com um arquivo já existente do seu sistema de arquivos. Se desejar criar como ligação simbólica,mbolic linkmarque a opção " " e selecione o arquivo acionando o botão "navegador".Link to file in the file system

Finalize e aguarde o processamento. Ao final deste, terá algo semelhante a Tela 40.

Tela 40: Novo programa para edição

NOTA : Caso tenha optado pela ligação simbólica, o arquivo-fonte já irá aparecer com conteúdo e o ícone deidentificação do fonte, terá uma pequena seta a sua direita embaixo. Lembre-se que, neste caso, todas asalterações que efetuar serão gravadas no fonte original.Neste exemplo, criamos o arquivo-fonte "programa.prw", na pasta "src" do projeto "meuProjeto". O uso do editor defontes é bastante semelhante a outros que você deve estar acostumado, portanto saia digitando o seu código. Noanexo I, você possui a lista dos principais comandos do editor.

Copie o código (sugestão), para continuar o aprendizado.

user meuTeste() functionmsgalert( ) "Função do usuário meuTeste executada"return

Obtendo algo semelhante a:

Tela 41: Exemplo de arquivo-fonte em edição

Durante a edição do fonte, a visão (Tela 41 B) será atualizada com a identificação dos principais blocos doOutlineseu arquivo-fonte. Se você acionar o sobre um destes itens, seu arquivo-fonte será reposicionado para estemouseelemento. Na visão (Tela 41 A), você também obtêm a lista dos principais blocos, se expandir oTOTVS Explorerelemento ( no triângulo vazado).click

2. Edição de arquivos-fonteA edição de arquivos-fontes é bem simples. Localize na árvore de navegação do o arquivoTOTVS Explorerdesejado e efetue um ou acione o menu de contexto sobre o arquivo e a opção , obtendo algoduplo-click Abrir

semelhante a Tela 41.

3. Adição de arquivos de recursosExtensões que não são reconhecidas como de arquivos-fontes pelo , por exemplo aTOTVS Developer Studioextensão ".bmp" (arquivo de imagem), este é adicionado como recurso e ao ser compilado será anexado como tal,sendo possível acessá-lo com o uso de funções específicas da linguagem.

4. Compilação de arquivos e projetosAntes de efetuar a compilação 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: Botões para seleção de servidor e ambiente, para compilação e execução

Arquivos

Para compilar, após indicar o servidor e ambiente, acione Ctrl+F9 ou acione o menu de contexto sobre a área doeditor ou sobre o elemento do arquivo (na árvore de navegação).O referido fonte será compilado e na visão (Tela 43 A), você obterá informações relativas a compilação,consoletais como se foi ou não bem sucedida e neste caso, os motivos (erros de compilação). A visão ,TOTVS Explorertambém informa se há problemas de compilação. (Tela 43 B), colocando um pequeno sinal indicativo.

Tela 43: Resultado da compilação de um arquivo-fonte

Na Tela 43, como exemplo, temos o erro de arquivo de definição (*.ch) não encontrado. Neste caso, selecione oelemento "projeto" na visão e acione (ou menu de contexto, opção ) eTOTVS Explorer alt+enter Propriedades

verifique a lista de diretórios para busca de arquivo de definição.

Tela 44: Arquivo-fonte com erro de sintaxe.

Na área do editor (Tela 44 A) há uma indicação da linha que esta com erro. Ao passar o mouse sobre a marca,obtêm-se uma janela indicando o erro. No lado oposto (Tela 44 B) temos uma barra indicativa, que na suapopupaltura, representa o seu arquivo-fonte e a as marcações existentes indicam o local relativo de erro. Ao nestclicar-sea marca, o editor será posicionado nesta posição.Esta barra também pode conter outras indicações baseadas em cor, indicando alguma ocorrência, porexemplo,avisos do compilador e mudanças ocorridas deste a última salva.Na área de abas informativas, temos a visão "Problemas" (Tela 44 C), que possui uma lista de todas as ocorrênciasda compilação (erros e avisos). Se a linha de mensagem for acionada com um o fonte será aberto eduplo-click,posicionado no local indicado.

Para ativar a numeração de linhas e outros comportamentos do editor, acione o menu de contexto do editor,acessando a opção "Preferências" e acione "Show Line Numbers".

Tela 45: Arquivo-fonte com avisos do compilar

Pastas e Projetos

Para compilar pastas ( ) ou o projeto, acione o menu de contexto sobre o elemento a ser compilado na árvorefoldersde navegação da visão , e acione uma das opções:TOTVS Explorer

Recompilar <elemento> Recompila todos os elementos do projeto ou pasta( ). folder

Compilar <elemento> Compila todos os elementos que foram modificados ou

que não existam no repositório ( ).RPO 1

Como estes processos podem levar algum tempo, lhe será aberta a visão " ", que efetua um retorno visualProgressode como esta a execução da tarefa (Telas 46 e 47).

Tela 46: Visão "Progresso" na barra de status (posição padrão)

Tela 47: Visão "progresso" acoplada em outra posição

A visão "Progresso" é utilizada em diversas situações, normalmente naquelas que podem demandar algumNOTA:tempo de processamento.

5. Execução de projetos

Básico

Uma vez que o projeto esteja compilado e sem erros, você poderá executá-lo ou depurar ( ) seus programas.debugTanto a execução como a depuração, são efetuados através de configurações de executores ( ). Paralauchersconfigurá-los você deve acionar o menu suspensão do botão "Executar" ou "Depurar", selecionando a opção"Configuração ..." (Tela 48).

Tela 48: Menu suspenso do botão "Executar"

Na janela de configuração, você pode adicionar, duplicar e remover executores. Acione a opção "Novo" na barra deferramentas (Tela 49 A).

Tela 49: Configuração de execução ou depuração

Na tela apresentada (Tela 50), temos os campos:

"Nome" (Tela 50 A), informe um identificador para o novo executor;

Tela 50: Tela de configuração de executores

O bloco "Ambiente de execução Adv/PL" (Tela 50 B), com:"Utilizar servidor de aplicação interno", se estiver marcado exige o uso de um servidor internoconfigurado e será utilizado o executável do SmartClient (remote) que encontra-se na instalação do TOTVS Developer Studio."Programa Inicial", informe o nome do programa que será executado (programa principal);"Parâmetros do programa", informe os parâmetros da linha de comando que será utilizado naexecução do .SmartClient (remote)"Habilita de execução", se marcado, ao final da execução lhe será apresentada os resultadosprofiledo desta execução.profile

Para salvar as configurações e continuar a edição, acione "Aplicar" (Tela 50 C) ou se desejar cancelar asalterações efetuadas, acione "Reverter".

Ao informar os dados mínimos necessários, o botão "Executar" (Tela 50 D) será habilitado e se acionado, iniciará aexecução. O botão "Fechar", encerra a edição.

Se solicitar a execução pelo acionamento do botão "Executar" (Tela 50 D), ou pelo menu suspenso dos botões"Executar" ou "Depurar"(Tela 13), lhe será apresentada a tela de confirmação. Na caixa suspensa, informe o nomedo programa a ser executado.

Caso o campo "Programa Inicial" (Tela 50 B) preenchido, este será usado como valor padrão para a caixasuspensa.

Tela 51: Janela para execução

Depois que você criou e usou um executor, poderá acioná-lo diretamente pelo menu suspenso do botões"Executar" ou "Depurar", selecionando a configuração ou utilizando as teclas de atalho F11 e Ctrl+F11, paraexecutar a última configuração utilizada para depurar ou executar (respectivamente).

Avançado

Tela 52: Aba de configuração do "codeAverage"

Na configuração avançada, utilizamos as demais abas (telas 52, 53) com opções específicas. Tela 52: Aba de

configuração do "codeAverage"A aba " ", permite habilitar a "cobertura" do código e em quais fontes. Para habilitar, marque a opçãocodeAverage"Habilitar cobertura de código" (Tela 52 A) e utilizando os botões a direita (Tela 52 B), informar quais os fontes queserão 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 botões a direita (Tela 53 B), para adicionar outros diretórios para a busca.

Tela 54: Aba "Commom"

A aba "Comun" (Tela 54), contém algumas opções de configuração da visibilidade e outras opções ligadasdiretamente com a configuração do executor. Nesta aba, tempo:

"Salvar como" (Tela 54 A), indica se os dados de configuração serão salvos localmente (no seu )workspaceou em área compartilhada (externa)."Apresentar como favorito" (Tela 54 B), indique em qual menu suspenso você quer que a configuraçãoapareça. Caso não selecione nenhuma, esta será apresentada em todos os menus suspensos."Encoding", permite você definir o formato da codificação do arquivo de configuração."Entrada e saída padrão" (Tela 54 D), permite configurar a apresentação ou não da visão ou a suaconsolegravação em arquivo.

6. Depuração de projetosA configuração do executor ( ) com depuração é exatamente o mesmo utilizado na execução, portanto, paralaucherconfigurá-la utilize as instruções contidas em "Compilação de arquivos e projetos".

NOTA : Se você já efetuou a configuração do executor, já possuirá a mesma configuração para a depuração.

Para demonstrar o uso do depurador, usaremos o programa abaixo. Sugerimos que o copie e cole em um novoarquivo-fonte .Adv/PL

user calcFatorial()function n local

( ) msgalert "Calculo de Fatoriais"resultado := + (13) "Numero = Fatorial" chr

n := 1 5 2 for to stepcalcula(n*2)

next(resultado) msgAlert

return calcula(anNumber)static function

x := anNumberlocal total := 1 local (x > 1)while

total := total * xx--

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

Após a compilação do arquivo-fonte acima, execute-o acionando o botão "Executar" (se necessário configure umexecutor). Após encerrar a execução, terá algo semelhante a:

Tela 55: Programa sugerido para depuração

Com o editor ativo (a aba fica destacada), acione Ctrl+F10 e ative a numeração de linhas.

Tela 56: Menu de opções do editor (Ctrl + F10)

Efetue um sobre o número "6" (linha 6). Repare que na barra cinza do lado esquerdo, aparece umaduplo-clickmarca azul. Esta marca indica um ponto de parada ( ). Quando iniciarmos a depuração, o depurador parabreakpointa execução nos pontos de parada e aguarda instruções do desenvolvedor.

Tela 57: Ponto de parada definido na linha 6

Inicie o depurador, acessando o botão 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, não é a mais indicada para depuração. Por isso, você será convidado a trocá-la para aperspectiva (Tela 61).TOTVS Debuger

Tela 61: Convite para trocar a perspectiva atual para a de depuração

Aceite a troca e a perspectiva de depuração lhe será apresentada.

1. 2. 3. 4. 5. 6. 7.

Na perspectiva de depuração ( ), temos:Tela 62: Perspectiva de depuração (debug) debug

Visão "debug" (Tela 62 A) – apresenta a pilha de execução, indicando o "caminho" efetuado até chegar ao pontode parada. Também temos a barra de ferramentas desta visão, com as funcionalidades:

Tela 63: Barra de ferramentas da visão debug

Remove histórico de execução já finalizadas;Continua a execução até encontrar novo ponto de parado ou o término do programa;Pausa a execução;Encerra a execução;Executa um passo, se for chamada de método ou função, para na primeira instrução desta;Executa um passo, se for chamada de método ou função, execute-a sem parar dentro desta;Executa até finalizar (retornar) do método ou função.

Visão (Tela 64 B)breakpoints - apresenta a lista de pontos de paradas definidos. Também temos a barrade ferramentas desta visão, com as funcionalidades:

1. 2. 3. 4.

Tela 64: Barra de ferramentas da visão breakpoints

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 visões de apoio ao depurador.

Tela 65: Abas informativas com visões de apoio ao depurador

Tabela de dados -apresenta as tabelas abertas durante o processamento;

Tela 66: Visão Tabela de DadosAdv/PL Commands – permiti ao desenvolvedor executar comandos Adv/PL em tempo de execução comresposta imediata;

Tela 67: Visão Adv/PL CommandsVariables – permiti verificar os valores das variáveis declaradas;

Tela 68: Visão Variáveis

Através da barra de ferramentas, desta visão, você pode configurar a visibilidade, baseada em escopo, de quaisvariáveis serão apresentadas.

Expressions – permiti definir expressões que são avaliadas a cada passo.

Tela 69: Visão Expressão

Neste momento, estamos parados na linha 6 do . Acione F5 para executar um passo.calcFatorial

Tela 70: Perspectiva de depuração, após avançar um passo

Repare que na linha 8, do lado esquerdo há uma pequena seta azul, indicando a próxima linha a ser executada.Acione F5, até que você entre na função "calcula", tendo algo semelhante a:Repare, que a visão teve seu conteúdo atualizado. Estando dentro de um método ou função, se vocêVariáveisacionar F7 a execução prosseguirá, parando somente quando sair do método ou função. Neste exemplo, odepurador vai executar toda a função "calcula", pararando somente na linha 10 (logo após a chamada).

Tela 71: Depurando a função calcula

Você também pode adicionar pontos de parada a qualquer momento, efetuando um sobre o número daduplo-clicklinha. Faça isso na linha 26.

Tela 72: Adicionado um ponto de parada na linha 26

Acionando F8 (continuar execução), o processamento irá ser executado até o próximo ponto de parada. Acione oF8 para continuar a execução e ao final obterá algo semelhante a:

Tela 73: Tela final do calcFatorial

Para retornar a perspectiva de desenvolvimento selecione-a na área de seleção de perspectivas (Tela 10 C).

1.

2. 3. 4.

1. Assistentes de CódigoEste assistente, ao ser acionado, o auxiliará na criação de programas Adv/PL com funcionalidades específicasconforme as informações fornecidas.

Selecione o Local (Tela 74 A) onde o arquivo-fonte será salvo;

Tela 74: Tipos de assistentes no Assistente de Código

Informe o (Tela 74 B)Nome do FonteSelecione o (Tela 74 C)Tipo de AssistenteAcione o botão Próximo (Tela 74 D).

Conforme o selecionado, você será guiado por uma ou mais páginas para complementar osTipo de Assistentedados necessários para a geração do arquivo-fonte.

Assistente de código: Cadastro

Este tipo de assistente o auxilia a criar arquivos-fontes, capazes de efetuar manutenção de dados em tabelas.

1.

a.

b.

Tela 75: Definição de tipo de template com informações primordiais

Selecione o tipo template, em (Tela 75 A), conforme a origem da definição daCadastro - Tipo de arquivotabela.

Arquivo padrão utilizado quando a definição da tabela é a mesma do dicionário de dados,–preenchendo os dados solicitados.

Parâmetros – identifica uma definida no dicionário de dados do ;Pergunte ProtheusAlias (Tela 75 B) – no caso de arquivo padrão, este será utilizado para localizar as definiçõesno dicionário de dados, caso seja arquivo específico este será utilizado para identificar a áreade trabalho ( );select areaA ordem de apresentação dos dados é definido por uma das opções:

Utilize índice padrão (Tela 75 C)– indica qual o número do índice do dicionário dedados, associado ao alias, que será utilizado ;Utiliza índice temporário (Tela 75 D) – informe uma expressão Adv/PL válida paraindicar a ordem dos dados. Este índice é de uso temporário, sendo eliminado após o seuuso.

Arquivo específico – utilizado para uma estrutura livre da tabela.

Tela 76: Definição da estrutura para tipo de arquivo específico

Parâmetros (Tela 76 A) – identifica uma definida no dicionário de dados do ;Pergunte ProtheusEstrutura (Tela 76 B) - utilizado para definir a estrutura da tabela. Utilize os botões a direita para adicionarou remover atributos (campos).Indexado (Tela 76 C) – se marcado indica que a tabela será ordenada pela expressão informada emAdv/PL

.Chave

2. Após preencher os dados, avance para a página seguinte;3. Nesta página do assistente de código, você complementa os dados, podendo detalhar funcionalidades.

Tela 77: Definição do template de cadastro

de cadastro (Tela 76 A), conforme a visualização e comportamento desejado:4. Selecione o template, irá utilizar a função da biblioteca Adv/PL a) axCadastro – Cadastro Padronizado axCadastro

irá utilizar a função da biblioteca Adv/PL b) Mbrowse – definindo opções, mBrowse

5. Nas abas logo abaixo, você efetua algumas customizações: a)Aba "Botões" (Tela 78)- utilizada somente pela opção de Mbrowse e permite adicionar outemplateremover funcionalidades a tela utilizando os botões do lado direito;

Tela 78: Configuração de botões para mBrowse

b)Aba "Campos" (Tela 79) - permiti você indicar quais campos e customizar alguns atributos. Caso nãoespecifique, será utilizado todos os campos definidos no dicionário de dados ou na definição de tabelacustomizada.

Tela 79: Seleção de campos e atributos

c) Configurações (Tela 80)– permiti definir propriedades opcionais.

Tela 80: Configurações opcionais do assistente

Titulo – informe o titulo a ser utilizado na janela; Campo Diferenciador – expressão , utilizada pela para agrupar os dadosAdv/PL mBrowse

Ao preencher todos os dados obrigatórios solicitados, finalize. Você obterá algo semelhante a Tela 81. Localize aentrada de função e coloque um nome mais significativo, salve e compile.user function

Tela 81: Exemplo de código gerado pelo Assistente

Assistente de código: Geração de Arquivo Texto

Este tipo de assistente o auxilia a criar arquivos-fontes, capazes de gerar arquivos textos a partir de uma tabela dedados.

1.

a.

Tela 82: Assistente para Geração de Arquivo Texto

Selecione o tipo , em (Tela 82 A), conforme a origem datemplate Geração de TXT - Tipo de arquivodefinição da tabela.


Parâmetros – identifica uma definida no dicionário de dados do ;Pergunte ProtheusAlias (Tela 82 B) – no caso de arquivo padrão, este será utilizado para localizar as definiçõesno dicionário de dados, caso seja arquivo específico este será utilizado para identificar a áreade trabalho ( );select areaA ordem de leitura dos dados é definido por uma das opções:


1.

a.

b.

2. 3.

Tela 83: Definição de arquivo específico

Arquivo específico – utilizado para uma estrutura livre da tabela.Parâmetros (Tela 83 A)– identifica uma definida no dicionário de dados do ;Pergunte ProtheusEstrutura (Tela 83 B) - utilizado para definir a estrutura da tabela. Utilize os botões a direitapara adicionar ou remover atributos (campos).Indexado (Tela 83 C) – se marcado indica que a tabela será ordenada pela expressão iAdv/PLnformada em .Chave

Após preencher os dados, avance para a página seguinte;Nesta página do assistente de código, você complementa os dados detalhando como será o arquivo texto.

Arquivo Texto (Tela 84) - Indique a origem dos demais dados, podendo ser:

1.

Tela 84: Definição do formato do arquivo texto definido

Definido (Tela 84 A) – os valores são fixos e informados logo abaixo;

Parametrizado (Tela 85 A)– os valores serão lidos a partir de uma variável (normalmente deescopo privado ( ).private

Tela 85: Definição do formato do arquivo-texto parametrizado

Informe os demais campos conforme solicitado (Tela 84 B e C, Tela 85 B e C)

1.

b) Posições – será utilizado para definir o do arquivo de saída.layout

Defina o informando os dados Campo, posição, tamanho, número de decimais e tipo.layoutPara adicionar ou remover campos, utilize os botões do lado direito.

Tela 86: Definição do do arquivo de saídalayout

Ao preencher todos os dados obrigatórios solicitados, finalize. Você obterá algo semelhante a Tela 87. Localize aentrada de função user function e coloque um nome mais significativo, salve e compile.

Tela 87: Tela após a execução do Assistente de Geração de Arquivo Texto

Assistente de código: Importação de Arquivo Texto

Este tipo de assistente o auxilia a criar arquivos-fontes, capazes de importar arquivos textos e gravando-os em umatabela de dados.

1.

a.

Tela 88: Assistente para importação de arquivos textos

Selecione o tipo , em (Tela 88 A), conforme a origem datemplate Importação de TXT - Tipo de arquivodefinição da tabela.





Tela 89: Parâmetros para importação do arquivo texto definido

Parâmetros (Tela 89 A) – identifica uma definida no dicionário de dados do ;Pergunte ProtheusEstrutura (Tela 89 B) - utilizado para definir a estrutura da tabela. Utilize os botões a direita paraadicionar ou remover atributos (campos).Indexado (Tela 89 C) – se marcado indica que a tabela será ordenada pela expressão informAdv/PLada em .Chave

2. Após preencher os dados, avance para a página seguinte;3. Nesta página do assistente de código, você complementa os dados detalhando como é o arquivo texto deentrada.

a) Arquivo Texto (89) - Indique a origem dos demais dados, podendo ser:

Definido (Tela 89 A) – os valores são fixos e informados logo abaixo;Parametrizado (Tela 90 A) – os valores serão lidos a partir de uma variável(normalmente de escopo privado ( )).private

Tela 90: Definição dos parâmetros para importação de arquivo texto

Informe os demais campos conforme solicitado (Tela 89 B e C, Tela 90 B e C)b) Posições – será utilizado para definir o do arquivo de saída.layout

Tela 91: Definição do do arquivo de saídalayout

Defina o informando os dados Campo, posição, tamanho, número de decimais e tipo. Para adicionar oulayoutremover campos, utilize os botões do lado direito.

Tela 92: Código gerado pelo assistente para importação de arquivos textos

Ao preencher todos os dados obrigatórios solicitados, finalize. Você obterá algo semelhante a Tela 92. Localize aentrada de função user function e coloque um nome mais significativo, salve e compile.

Assistente de código: Processamento genérico

Este tipo de assistente o auxilia a criar arquivos-fontes, com um esqueleto para processamentos genéricos.

1.

a.

b.

Tela 93: Iniciando o assistente de código para processamento genérico

Selecione o tipo , em (Tela 93 A), conforme a origemtemplate Processamento Genérico - Tipo de arquivoda definição da tabela.



Utilize índice padrão (Tela 93 C)– indica qual o número do índice do dicionário dedados, associado ao alias, que será utilizado ;Utiliza índice temporário (Tela 93 D) – informe uma expressão válida paraAdv/PLindicar a ordem dos dados. Este índice é de uso temporário, sendo eliminado após o seuuso.


1.

b.

2.

Tela 94 : Configuração de arquivo específico

Parâmetros (Tela 94 A)– identifica uma definida no dicionário de dados do ;Pergunte ProtheusEstrutura (Tela 94 B) - utilizado para definir a estrutura da tabela. Utilize os botões a direitapara adicionar ou remover atributos (campos).Indexado (Tela 94 C) – se marcado indica que a tabela será ordenada pela expressão iAdv/PLnformada em .Chave

Após preencher os dados, finalize.

Ao preencher todos os dados obrigatórios solicitados, finalize. Você obterá algo semelhante a Tela 95. Localize aentrada de função e coloque um nome mais significativo, salve e compile.user function

Tela 95 : Janela após execução do assistentes para processamento genérico

2. Nova Classe AdvPLEste tipo de assistente o auxilia na criação de arquivos-fontes, com um esqueleto para definição de uma classe em

.Adv/PL

Tela 96: Definição de uma classe Adv/PL via Assistente de Código

Informe os dados solicitados:

Local ( ) (Tela 96 A) – indica o local ( ) onde o arquivo-fonte será salvofolder folderNome da Classe (Tela 96 B) nome da classe–Herda a classe (Tela 96 C) – nome da classe pai, quando tratar-se de classe com herançaCriar arquivo como referência (Tela 96 D) – o arquivo será gravado no Diretório de Destino e no local serácriado uma ligação simbólica ( ).link

Após informar os dados solicitados, finalize e obterá algo semelhante a:

Tela 97: Tela após executar o Assistente de Código para uma nova classe Adv/PL

3. Nova Função AdvPLEste tipo de assistente o auxilia na criação de arquivos-fontes, com um esqueleto para definição de uma função em

.Adv/PL

Tela 98: Assistente para uma nova função Adv/PL


Local ( ) (Tela 98 A)– indica o local ( ) onde o arquivo-fonte será salvofolder folderNome da função (Tela 98 B) nome da função–Criar arquivo como referência (Tela 98 C) – o arquivo será gravado no Diretório de Destino e no local serácriado uma ligação simbólica ( ).link


Tela 99: Tela após a execução do assistente de nova função

4. Novo Fonte WSDL AdvPLEste tipo de assistente o auxilia na criação de arquivos-fontes, com a definição de um cliente de serviço web (webservice client .) a partir da sua definição WSDL

Tela 100: Execução do assistente de geração de clientes de serviços web (web service client)

Este assistente depende de uma definição de servidor e o selecionamento deste na barra de ferramentas.ProtheusCaso o serviço web a ser utilizado esteja fora da rede do usuário, o servidor deverá ter privilégios deProtheusacesso.


Local ( ) (Tela 100 A) – indica o local ( ) onde o arquivo-fonte será salvofolder folderNome do fonte (Tela 100 B) nome do arquivo-fonte que conterá a definição – WSDLURL (Tela 100 C)– informe a URL de onde esta o serviço web desejadoCriar arquivo como referência (Tela 100 D) – o arquivo será gravado no Diretório de Destino e no localserá criado uma ligação simbólica ( ).link


Tela 101: Tela após a geração de um cliente de serviço web

1.

2. a.

b.

c.

1. Compilação de versãoPara efetuar um o processo de "Compilação de versão", use o botão existente na barra de ferramentas.

Tela 110: Botão para acionamento "Compilação de versão" em destaque.

Este processo permite que seja efetuado a geração de pacotes de atualização ( , com a opção de compilar oupatch)não os fontes envolvidos, em múltiplos ambientes.

Acione o botão de compilação de versão.

Tela 111: Parâmetros iniciais para a compilação de versão

Informe os dados solicitados:Servidor (Tela 111 A) - selecione o servidor que será utilizado para a compilação e geraçãoProtheusdo pacote. Todos os servidores registrados na visão serão listados.TOTVS ServerAmbiente (Tela 111 B)- selecione o(s) ambiente(s) (obtido a partir do servidor selecionado) no qual oprocesso será executado.Ler configurações (Tela 111 C) – permite recuperar as configurações de um arquivo externo, geradopelo acionamento do botão "Salvar Configuração" (Tela 112 F).

2.

c.

3. a.

b.

c.

Tela 112: Seleção de projetos e fontes na compilação de versão

Acione "Próximo" e na tela apresentada informe os dados solicitados:Itens do pacote (Tela 112 B) – na árvore de seleção apresentada, selecione os itens que deseja quefaçam parte do pacote a ser compilado/gerado;Compilar selecionados (Tela 112 C) – quando acionada esta opção, os itens selecionados serãocompilados em todos os ambientes selecionados na tela anterior.Gerar da seleção de projetospatch (Tela 112 D) – será executado o processo de geração depacote de atualização, para todos os ambientes selecionados;

NOTA: Faz-se necessário selecionar uma delas ou as duas opções acima.

d. (Tela 112 E) – selecione onde será gravado o pacote de atualização (se a opção anterior estiver Localmarcada).

e. (Tela 112 F) – permite salvar as configurações efetuadas em um arquivo Salvar configuraçõesexterno, para posterior reutilização carregando este arquivo através do acionamento do botão "Ler Configuração"(Tela 112 C).

4. Acione "Finalizar" e aguarde o término do processamento.

Tela 113: Exemplo de ocorrências durante o processo de compilação de versão

1. a. b. c.

2.

1. Geração de pacote de atualização (Patch)Acione o botão de geração de pacote de atualização ( ) (Tela 102 A).patch

Tela 103: Parâmetros iniciais para a geração de pacotes de atualização (patch)

Nas caixas de seleção, indique qual a melhor opção para você:

Servidor (Tela 103 A) - selecione o servidor que será utilizado para a geração do pacote. Todos osProtheusservidores registrados na visão serão listados.TOTVS ServerAmbiente (Tela 103 B)- selecione o ambiente (obtido a partir do servidor selecionado).Processo(Tela 103 C) - indica qual procedimento será adotado na geração dos pacotes.

Comparação – este procedimento compara o seu RPO com um RPO mestre, gerando um pacote peladiferença entre eles;Programa – este procedimento permitirá que você indica qual ou quais programas serão colocados nopacote;Grupo de Projetos – permite que você escolha um ou mais projetos que irão fazer parte do pacote.

Salvar em (Tela 103 D) – selecione onde o arquivo de atualização será salvo após a sua geração. Pode serna máquina local ou no servidor.

Por comparação

Este processo compara o RPO atual do servidor/ambiente selecionado com um RPO denominado "mestre", queencontra-se em um diretório do servidor. Para efetuar o procedimento:

Informe os dados solicitados:Servidor (Tela 103 A) – selecione o servidor que será utilizado na comparaçãoAmbiente (Tela 103 B) – selecione o ambienteProcesso (Tela 103 C) – Por comparação

Prossiga para a próxima etapa.

2.

3.

4.

1. a. b. c.

2.

Tela 104: Configuração da geração de pacote de atualização por comparação

Selecione o diretório no qual encontra-se o RPO "mestre" (Tela 104 B).

Tela 105: Pacote de atualização por comparação realizado com sucesso.

Acione " e aguarde o final do processamento."Finalizar

Por programa

Este processo permite você selecionar os programas que serão gravados no pacote de atualização. Osprocedimentos são:

Informe os dados solicitados:Servidor (Tela 103 A) – selecione o servidor que será utilizado na comparaçãoAmbiente (Tela 103 B) – selecione o ambienteProcesso (Tela 103 C) – Por programa

Prossiga para a próxima página (pode levar algum tempo).

1. a. b. c.

2.

Tela 106: Geração do pacote de atualização por programa

3. Selecione os programas ou recursos/arquivos (Tela 106) que farão parte do pacote de atualização utilizandoo campo ou (Tela 106 A) e acionando o botão Filtrar correspondente, vocêProcurar fonte Procurar recursopode localizar rapidamente um arquivo ou vários, utilizando os caracteres coringa * e ?.

4. Acione " " e aguarde o final do processamento.Finalizar

Por Grupo de Projeto

Este processo permite gerar o pacote de atualização, selecionando projetos da sua área de trabalho ( ).workspaceOs procedimentos são:

Informe os dados solicitados:Servidor (Tela 103 A) – selecione o servidor que será utilizado na comparaçãoAmbiente (Tela 103 B) – selecione o ambienteProcesso (Tela 103 C) – Por Grupo de Projetos

Prossiga para a próxima página.

2.

3. 4.

Tela 107: Seleção de projetos para a geração do pacote de atualização

Selecione os projetos na lista apresentada.Acione " " e aguarde o final do processamento.Finalizar

1.

2.

2. Aplicação de pacote de atualizaçãoNota: A partir da versão 11.1.27.201210011603 liberado em 01/09/2012, foi introduzido configuração de segurançana aplicação pacotes de atualizações ( ).patchPor padrão, a aplicação pacotes de atualizações ( ) é negada a qualquer usuário, exceto quando a conexão aopatchserver for efetuada por "localhost" (127.0.0.1).Para liberar a aplicação pacotes de atualizações ( ):patch

Abra o arquivo "appServer.ini" com um editor de textos simples. Este arquivo encontra-se no diretório do servidorde aplicações Protheus (appServer.exe);

Adicione a sessão e chaves abaixo:[TDS]allowApplyPatch=<estações permitidas>Salve o arquivo.

<estações permitidas> = lista de ip´s ou nome das estações, separados por vírgula, que podem aplicar pacotes deatualizações ( ). Para liberar a aplicação a partir depatchqualquer estação, informe "*" (asterisco, sem aspas).

Acione o botão de aplicação de pacote de atualização ( ) (Tela 102 B) e preencha os dados solicitados.patch

Tela 108: Aplicação de pacote de atualização

1. Informe os dados solicitado:

a) Servidor (Tela 108 A) - selecione o servidor que será utilizado para a geração do pacote. Todos osProtheusservidores registrados na visão serão 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 atualização a ser aplicado encontra-se. Pode ser na máquinalocal ou no servidor.

2. Acione " " e aguarde o final do processamento.Finalizar

Tela 109: Aplicação de pacote de atualização finalizada.

Documents

169493082 Totvs Developer Studio Eclipse