COMPONENETES

Estruturao
Reviso: 22/02/2005 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 8.11 Verses Anteriores

A estrutura de diretrios do Advanced Protheus

A estrutura de diretrios do Advanced Protheus depende da verso instalada.

Verso AP5
Diretrio Contedo Diretrio inicial do Protheus. a partir deste diretrio que o sistema ir \ap5\ localizar os caminhos informados em parmetros, customizaes, etc. \ap5\apo\ Diretrio onde sero localizados os arquivos de repositrio de APOs. Diretrio onde so localizados os arquivos do ncleo do Protheus: \ap5\bin\ executveis, bibliotecas de carga dinmica (DLLs) e arquivos de configurao do sistema. Similar ao \SIGAADV\ das verses Advanced 2.0x/4.0x. o diretrio onde se encontram os arquivos de configurao do sistema ERP \ap5\sigaadv\ Advanced, arquivos de menus, etc. tambm o diretrio inicial de execuo no Remote. Similar ao \DADOSADV\ das verses Advanced 2.0x/4.0x. o diretrio \ap5\dadosadv\ onde se localizam os arquivos de base de dados para verses no SQL. Similar ao \RELATO\ das verses Advanced 2.0x/4.0x. Diretrio para \ap5\relato\ gravao de arquivos de impresso em disco. Similar ao \CPROVA\ das verses Advanced 2.0x/4.0x. Diretrio para \ap5\cprova\ gravao de arquivos de contabilizao. Diretrio de localizao de programas de exemplo escritos em AdvPl, \ap5\ixbpad\ nos padres definidos pela Microsiga Software S.A. Diretrio de arquivos de incluso padro (extenso .CH) necessrios \ap5\include\ para a compilao de programas escritos em AdvPl. \ap5\util\ Diretrio de ferramentas adicionais do Protheus.

Verso AP6
Diretrio Contedo

Diretrio inicial do Protheus. a partir deste diretrio que o sistema ir localizar os caminhos informados em parmetros, customizaes, etc. \ap6\apo\ Diretrio onde sero localizados os arquivos de repositrio de APOs. Diretrio onde so localizados os arquivos do ncleo do Protheus \ap6\bin\server\ Server: executveis, bibliotecas de carga dinmica (DLLs) e arquivos de configurao. Diretrio onde so localizados os arquivos das aplicaes clientes \ap6\bin\remote\ (Remote, IDE, Monitor, etc): executveis, bibliotecas de carga dinmica (DLLs) e arquivos de configurao. Similar ao \SIGAADV\ das verses Advanced 2.0x/4.0x. o diretrio onde se encontram os arquivos de configurao do sistema ERP \ap6\sigaadv\ Advanced, arquivos de menus, etc. tambm o diretrio inicial de execuo no Remote. Similar ao \DADOSADV\ das verses Advanced 2.0x/4.0x. o \ap6\dadosadv\ diretrio onde se localizam os arquivos de base de dados para verses no SQL. Similar ao \RELATO\ das verses Advanced 2.0x/4.0x. Diretrio para \ap6\relato\ gravao de arquivos de impresso em disco. Similar ao \CPROVA\ das verses Advanced 2.0x/4.0x. Diretrio para \ap6\cprova\ gravao de arquivos de contabilizao. Diretrio de localizao de programas de exemplo escritos em AdvPl, \ap6\ixbpad\ nos padres definidos pela Microsiga Software S.A. Diretrio de arquivos de incluso padro (extenso .CH) necessrios \ap6\include\ para a compilao de programas escritos em AdvPl. \ap6\

Verso Protheus8
\Protheus8 (Ncleo) Diretrio onde armazenado o ncleo (kernel) do Protheus 8. Toda a parte de tecnologia Protheus 8. \Protheus8\APO Diretrio onde so encontrados os repositrios de APOs. \Protheus8\BIN\SERVER nele que so encontrados os arquivos executveis, dlls e arquivos de configurao do sistema que devem ser executados no Servidor. \Protheus8\BIN\REMOTE nele que so encontrados os arquivos executveis, dlls e arquivos de configurao do sistema para acesso ao Client. \Protheus8\INCLUDE Aqui esto as bibliotecas necessrias para a compilao de programas ADVPL. \Protheus8\MYPROJECTS

Este diretrio sugerido para armazenar projetos e fontes das customizaes do cliente. \Protheus8\UPDATES Este diretrio sugerido para armazenar as atualizaes do sistema. \Protheus8_Data\SYSTEMLOAD Contm o dicionrio de dados em formato TXT, responsvel pela gerao dos arquivos customizadores (SXs), conforme a localizao de pas definida pelo usurio na entrada do sistema. \Protheus8_Data\SYSTEM Contm os arquivos de menus e os customizadores (SXs) gerados a partir do SYSTEMLOAD. \Protheus8_Data\DATA Contm a base de dados do cliente. \Protheus8_Data\SPOOL Neste diretrio so gravados os relatrio gerados em disco. \Protheus8_Data\SAMPLES Neste diretrio, esto os programas de exemplo e arquivos ADVPL padres da Microsiga.

Estas so as estruturas para uma instalao padro do Protheus de acordo com a verso utilizada. Porm a localizao de instalao pode variar de acordo com o local de instalao.

Aplicativos do Advanced Protheus

O Advanced Protheus possui, basicamente, quatro aplicativos utilizados com diferentes finalidades. So eles: Trata-se do servidor de aplicao do Advanced Protheus esta a parte do sistema que ser executada no Servidor e ser responsvel pela comunicao Protheus entre o Cliente, a Base de Dados e o Repositrio de Apos. O nome do Server executvel depende da verso e sistema operacional utilizados, por exemplo: AP5SRV.EXE ou AP6SRVWIN.EXE. o Remote que utilizamos para interagir com todo o sistema, ele poder ser instalado de duas maneiras, no servidor ou na prpria estao de trabalho. O Remote nome do executvel depende da verso utilizada, por exemplo: AP5RMT.EXE ou AP6RMT.EXE. IDE Trata-se do ambiente de desenvolvimento integrado do Advanced Protheus. atravs deste aplicativo que todos os acessos aos repositrios de Apos (compilao de customizaes, visualizao de funes existentes etc.) so efetuados, e tambm a ferramenta para desenvolvimento e depurao de

Monitor

aplicaes/customizaes. O nome do executvel depende da verso utilizada, por exemplo: AP5IDE.EXE ou AP6IDE.EXE. Esta ferramenta permite a interao com os usurios conectados ao sistema: Analisar os programas em uso, derrubar conexes pendentes, enviar mensagens ao usurios etc. O nome do executvel depende da verso utilizada, por exemplo: AP5MONIT.EXE ou AP6MONIT.EXE

Alem destas aplicaes, o Siga Advanced Protheus conta ainda com outros utilitrios diversos, como o Diff (utilizado para comparao de arquivos texto) e Dump (utilizado para edio de arquivos binrios).

Nomenclaturas Utilizadas
Estas so as principais nomeclaturas utilizadas no Advanced Protheus:

Build: Verso completa do sistema com seus executveis, Dlls e RPO completo. A build do sistema pode ser identificado atravs da opo Miscelneas | Sobre dentro dos mdulos do sistema. RPO: o arquivo binrio de repositrio de APOs, com o cdigo AdvPl. Patch: Arquivo binrio semelhante ao repositrio contendo apenas atualizaes de APOs, correes disponibilizadas pela Microsiga Software S.A., que ser aplicado no repositrio atravs do IDE. Verso Master: Mesma definio de build porm neste caso a verso ser utilizada como referncia para a gerao de atualizaes do sistema (patchs). Quando gerada, a verso encaminhada a todos os envolvidos em processos de implantao/utilizao do sistema via correio ou disponibilizada no site de FTP do Protheus.

A definio dos nomes dos arquivos dos repositrios de APO's e Patchs seguem o mesmo padro (diferenciando-se apenas na extenso Patch=.PAT e repositrio=RPO) e efetuada da seguinte maneira AP12345.RPO: Posio 1 2 3 4 5 Contedo (D)bf, (T)op, (A)ds, (B)trieve, (C)Tree; (P)ortuguese, (E)nglish, (S)panish; Verso; Verso; Verso;

Por exemplo, APAP710.RPO ser um repositrio de APO's para base de dados ADS, idioma Portugus e verso 710

IDE - Integrated Development Environment

Reviso: 22/02/2005 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

O IDE (Integrated Development Environment) uma ferramenta de edio, compilao e depurao de erros. atravs do IDE que o sistema ERP Siga Advanced desenvolvido. Tambm atravs do IDE que os analistas da Microsiga e os usurios do Protheus podem criar e manter suas rotinas especficas. O IDE o nico modo de compilar os arquivos de programas escritos em AdvPl para a gerao dos APO's no repositrio. Como ferramenta de edio e depurao, engloba todos os recursos disponveis nas melhores ferramentas de desenvolvimento do mercado.

Caractersticas do IDE

Para a execuo do IDE no necessrio conectar-se ao Protheus Server, exceto nas operaes de atualizao ou consulta de um repositrio (compilao, obteno do Mapa de Objetos, aplicao de patchs, etc) e durante o processo de depurao. No aconselhvel executar o IDE remotamente (via Internet ou via modem), pois a conexo do IDE ao Protheus Server mais lenta.

Passos para Desenvolvimento

Os passos para o desenvolvimento de programas em AdvPl utilizando o IDE so:

Criao do cdigo atravs do editor. Na linguagem AdvPl, os analistas e os usurios do Protheus tm todos os recursos disponveis para o desenvolvimento de suas rotinas. E diferentemente do antigo RDMAKE, no mais uma linguagem interpretada. Por isso, a performance das rotinas especficas dez vezes maior do que era nos RDMAKEs antigos. Montagem do Grupo de Projetos. O Grupo de Projetos um gerenciador existente dentro do IDE, onde o usurio pode manter os arquivos de cdigo separados por projetos e pastas. Com um grupo de projetos os arquivos podem ser organizados de uma forma lgica, em projetos e pastas. Compilao. Durante a compilao, os arquivos so enviados ao Protheus Server. Toda a compilao e a gravao no repositrio so efetuadas no servidor.

Depurao. O IDE permite aos usurios depurar as rotinas criadas, executandoas linha a linha ou em modo de animao. Permite visualizar informaes como variveis em diferentes escopos, pilha de chamadas, lista de break points, etc. Exatamente como as melhores ferramentas de desenvolvimento existentes no mercado. No IDE pode-se depurar pontos de entrada simplesmente colocando-se um ponto de parada (break point) em uma linha qualquer do cdigo do ponto de entrada;

Monitor
Reviso: 22/02/2005 Abrangncia Verso 5.07 Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

O Monitor utilizado para monitorar as conexes de terminais ao Protheus Server. Atravs dele pode-se:

Verificar as conexes ativas. Enviar mensagens para uma ou mais conexes. Desabilitar novas conexes. Isto til quando se precisa efetuar alguma manuteno e se precisa evitar que outros usurios se conectem.

Informaes Bsicas das Conexes

Usurio. o nome do usurio na rede local. Para conexes remotas este nome est em branco. Computador. Nome da mquina onde o Remote est sendo executado. Conexo. Indica a data e hora de incio da conexo do Remote. Tempo de Uso. Indica o tempo em horas, minutos e segundos desde que o Remote se conectou. Programa Inicial. o nome do programa inicial (APO) com o qual o Remote iniciou a execuo. Environment. Nome do ambiente sendo utilizado pelo terminal.

Sistemas Operacionais e Plataformas

Reviso: 23/02/2005 Abrangncia

Verso 6.09

Verso 7.10

Verso 8.11

Sistemas Operacionais e Plataformas (verso AP6 e posteriores)

O Protheus Server foi desenvolvido em ANSI C++ e , portanto, independe de API's especficas para funcionar. Graas a isso, o ncleo do Protheus pode ser recompilado em todos os sistemas operacionais e plataformas que suportem ANSI C++. Outra preocupao durante o desenvolvimento do Protheus foi garantir total compatibilidade dos repositrios de objetos do Protheus (RPO's) e das correes dos repositrios (Patch's) entre os sistemas operacionais e plataformas.

Plataformas e SO's suportados

Windows e Linux Intel, Windows IA64 e Linux IA64, Sun Solaris ( RISC ), HP UX ( RISC ), IBM AIX ( Power PC e RS/6000 ),

O Protheus Remote pode ser executado:

Windows e Linux Intel

O S.Operacional do Servidor no depende da verso do Remote. Podemos mesclar numa mesma instalao verses Windows e Linux do Remote. No podemos mesclar Servidores Protheus de diferentes S.Operacionais, se utilizarmos Windows todos os servidores devem estar em Windows.

Topologia de Rede
Reviso: 28/08/2003 Abrangncia Verso 5.07 Verses Anteriores Verso 5.08 Verso 6.09 Verso 7.10 Verso 8.11

Devido sua diviso em camadas, a tecnologia Protheus permite montar o ambiente de execuo com diferentes topologias, priorizando a execuo, o trfego de rede ou os recursos individuais das mquinas existentes, o que torna o processamento distribudo. Essa uma das grandes vantagens da tecnologia Protheus.

Caractersticas e Possibilidades de Topologias de Rede

Pode-se manter um ou mais servidores de aplicao do Protheus (Protheus Server). Um Protheus Server pode estar na mesma mquina que o gerenciador de banco de dados. Mquinas melhores ou com mais recursos podem ter um Protheus Server sendo executado localmente (na estao) visando priorizar o processamento local. Porm h um aumento do trfego de rede entre o gerenciador de banco de dados e o Protheus Server local. Do mesmo modo, pode-se executar servidores remotamente priorizando o processamento de uma ou mais estaes. Utilizao do protocolo TCP-IP para as conexes. Na verso AP5 pode-se utilizar tambm o protocolo NAMED PIPES. Pode-se disponibilizar conexes via Internet atravs da montagem de um Web Server na empresa ou atravs de provedores de acesso (como a UOL e o ZAZ). Neste caso, o Protheus Server pode ser executado no provedor ou na empresa utilizando uma LP para a conexo ao provedor de acesso. A Internet utilizada apenas como o meio de comunicao, ou seja, a conexo TCP-IP entre o Remote e o Protheus Server. Alm da segurana oferecida pelo sistema Advanced, a segurana dever ser oferecida pela conexo. Por isso, aconselhvel que a mquina onde o servidor Web esteja sendo executado no seja o mesmo do servidor da banco de dados. O Protheus Server tambm pode ser executado como um servidor Internet, HTTP e/ou FTP. Pode-se manter uma pgina para o download do Remote, de modo que os usurio remotos possam efetuar o download para conectar-se e utilizar o sistema. Na verso AP6 pode-se configurar o Remote para se atualizar automaticamente a partir do Protheus Server sendo executado como um servidor FTP.

Dica :
A definio da melhor topologia para execuo um passo importante da implementao da tecnologia Protheus, pois influenciar totalmente na performance. O maior trfego de rede est localizado entre o Protheus Server e o Banco de Dados, j que o trfego entre o Protheus Server e o Remote limita-se s informaes para montagem de telas e controle de teclado e mouse. Desta forma, dependendo do tipo e da velocidade da conexo, pode se tornar invivel manter um Protheus Server em uma cidade conectado ao banco de dados em outra. Por outro lado, caso existam muitas conexes nesta outra cidade, ou caso estas conexes executem processamentos pesados,

priorizar o processamento disponibilizando um Protheus Server para ser executado localmente nesta cidade pode ser uma boa soluo.