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.