COMPONENETES

Estruturação

Revisão: 22/02/2005

Abrangência

Versão 5.07 Versão 5.08 Versão 6.09 Versão 8.11 Versões Anteriores

A estrutura de diretórios do Advanced Protheus

A estrutura de diretórios do Advanced Protheus depende da versão instalada.

Versão AP5

Diretório Conteúdo
Diretório inicial do Protheus. É a partir deste diretório que o sistema irá
\ap5\
localizar os caminhos informados em parâmetros, customizações, etc.
\ap5\apo\ Diretório onde serão localizados os arquivos de repositório de APO´s.
Diretório onde são localizados os arquivos do núcleo do Protheus:
\ap5\bin\ executáveis, bibliotecas de carga dinâmica (DLL´s) e arquivos de
configuração do sistema.
Similar ao \SIGAADV\ das versões Advanced 2.0x/4.0x. É o diretório
onde se encontram os arquivos de configuração do sistema ERP
\ap5\sigaadv\
Advanced, arquivos de menus, etc. É também o diretório inicial de
execução no Remote.
Similar ao \DADOSADV\ das versões Advanced 2.0x/4.0x. É o diretório
\ap5\dadosadv\
onde se localizam os arquivos de base de dados para versões não SQL.
Similar ao \RELATO\ das versões Advanced 2.0x/4.0x. Diretório para
\ap5\relato\
gravação de arquivos de impressão em disco.
Similar ao \CPROVA\ das versões Advanced 2.0x/4.0x. Diretório para
\ap5\cprova\
gravação de arquivos de contabilização.
Diretório de localização de programas de exemplo escritos em AdvPl,
\ap5\ixbpad\
nos padrões definidos pela Microsiga Software S.A.
Diretório de arquivos de inclusão padrão (extensão .CH) necessários
\ap5\include\
para a compilação de programas escritos em AdvPl.
\ap5\util\ Diretório de ferramentas adicionais do Protheus.

Versão AP6

Diretório Conteúdo
\ap6\ Diretório inicial do Protheus. É a partir deste diretório que o sistema irá
 localizar os caminhos informados em parâmetros, customizações, etc.
\ap6\apo\ Diretório onde serão localizados os arquivos de repositório de APO´s.
Diretório onde são localizados os arquivos do núcleo do Protheus
\ap6\bin\server\ Server: executáveis, bibliotecas de carga dinâmica (DLL´s) e arquivos
de configuração.
Diretório onde são localizados os arquivos das aplicações clientes
\ap6\bin\remote\ (Remote, IDE, Monitor, etc): executáveis, bibliotecas de carga
dinâmica (DLL´s) e arquivos de configuração.
Similar ao \SIGAADV\ das versões Advanced 2.0x/4.0x. É o diretório
onde se encontram os arquivos de configuração do sistema ERP
\ap6\sigaadv\
Advanced, arquivos de menus, etc. É também o diretório inicial de
execução no Remote.
Similar ao \DADOSADV\ das versões Advanced 2.0x/4.0x. É o
\ap6\dadosadv\ diretório onde se localizam os arquivos de base de dados para versões
não SQL.
Similar ao \RELATO\ das versões Advanced 2.0x/4.0x. Diretório para
\ap6\relato\
gravação de arquivos de impressão em disco.
Similar ao \CPROVA\ das versões Advanced 2.0x/4.0x. Diretório para
\ap6\cprova\
gravação de arquivos de contabilização.
Diretório de localização de programas de exemplo escritos em AdvPl,
\ap6\ixbpad\
nos padrões definidos pela Microsiga Software S.A.
Diretório de arquivos de inclusão padrão (extensão .CH) necessários
\ap6\include\
para a compilação de programas escritos em AdvPl.

Versão Protheus8

\Protheus8 (Núcleo)

Diretório onde é armazenado o núcleo (kernel) do Protheus 8. Toda a parte de

tecnologia Protheus 8.

\Protheus8\APO

Diretório onde são encontrados os repositórios de APOs.

\Protheus8\BIN\SERVER

É nele que são encontrados os arquivos executáveis, dll’s e arquivos de

configuração do sistema que devem ser executados no Servidor.

\Protheus8\BIN\REMOTE

É nele que são encontrados os arquivos executáveis, dll’s e arquivos de

configuração do sistema para acesso ao Client.

\Protheus8\INCLUDE

Aqui estão as bibliotecas necessárias para a compilação de programas ADVPL.

\Protheus8\MYPROJECTS
 Este diretório é sugerido para armazenar projetos e fontes das customizações do
cliente.

\Protheus8\UPDATES

Este diretório é sugerido para armazenar as atualizações do sistema.

\Protheus8_Data\SYSTEMLOAD

Contém o dicionário de dados em formato TXT, responsável pela geração dos

arquivos customizadores (SXs), conforme a localização de país definida pelo
usuário na entrada do sistema.

\Protheus8_Data\SYSTEM

Contém os arquivos de menus e os customizadores (SXs) gerados a partir do

SYSTEMLOAD.

\Protheus8_Data\DATA

Contém a base de dados do cliente.

\Protheus8_Data\SPOOL

Neste diretório são gravados os relatório gerados em disco.

\Protheus8_Data\SAMPLES

Neste diretório, estão os programas de exemplo e arquivos ADVPL padrões da

Microsiga.

Estas são as estruturas para uma instalação padrão do Protheus de acordo com a versão
utilizada. Porém a localização de instalação pode variar de acordo com o local de
instalação.

Aplicativos do Advanced Protheus

O Advanced Protheus possui, basicamente, quatro aplicativos utilizados com diferentes

finalidades. São eles:

Trata-se do servidor de aplicação do Advanced Protheus esta é a parte do

sistema que será executada no Servidor e será responsável pela comunicação
Protheus
entre o Cliente, a Base de Dados e o Repositório de Apo’s. O nome do
Server
executável depende da versão 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 própria estação de trabalho. O
Remote
nome do executável depende da versão utilizada, por exemplo:
AP5RMT.EXE ou AP6RMT.EXE.
IDE Trata-se do ambiente de desenvolvimento integrado do Advanced Protheus. É
através deste aplicativo que todos os acessos aos repositórios de Apo’s
(compilação de customizações, visualização de funções existentes etc.) são
efetuados, e também é a ferramenta para desenvolvimento e depuração de
 aplicações/customizações. O nome do executável depende da versão utilizada,
por exemplo: AP5IDE.EXE ou AP6IDE.EXE.
Esta ferramenta permite a interação com os usuários conectados ao sistema:
Analisar os programas em uso, derrubar conexões pendentes, enviar
Monitor
mensagens ao usuários etc. O nome do executável depende da versão
utilizada, por exemplo: AP5MONIT.EXE ou AP6MONIT.EXE

Alem destas aplicações, o Siga Advanced Protheus conta ainda com outros utilitários
diversos, como o Diff (utilizado para comparação de arquivos texto) e Dump (utilizado
para edição de arquivos binários).

Nomenclaturas Utilizadas

Estas são as principais nomeclaturas utilizadas no Advanced Protheus:

 Build: Versão completa do sistema com seus executáveis, Dll’s e RPO

completo. A build do sistema pode ser identificado através da opção Miscelâneas
| Sobre dentro dos módulos do sistema.
 RPO: É o arquivo binário de repositório de APO’s, com o código AdvPl.
 Patch: Arquivo binário semelhante ao repositório contendo apenas atualizações
de APO’s, correções disponibilizadas pela Microsiga Software S.A., que será
aplicado no repositório através do IDE.
 Versão Master: Mesma definição de build porém neste caso a versão será
utilizada como referência para a geração de atualizações do sistema (patch’s).
Quando gerada, a versão é encaminhada a todos os envolvidos em processos de
implantação/utilização do sistema via correio ou disponibilizada no site de FTP
do Protheus.

A definição dos nomes dos arquivos dos repositórios de APO's e Patch´s seguem o
mesmo padrão (diferenciando-se apenas na extensão Patch=.PAT e repositório=RPO) e
é efetuada da seguinte maneira AP12345.RPO:

Posição Conteúdo
1 (D)bf, (T)op, (A)ds, (B)trieve, (C)Tree;
2 (P)ortuguese, (E)nglish, (S)panish;
3 Versão;
4 Versão;
5 Versão;

Por exemplo, APAP710.RPO será um repositório de APO's para base de dados ADS,
idioma Português e versão 710
IDE - Integrated Development Environment

Revisão: 22/02/2005

Abrangência

Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Versão 8.11

O IDE (Integrated Development Environment) é uma ferramenta de edição, compilação

e depuração de erros. É através do IDE que o sistema ERP Siga Advanced é
desenvolvido. Também é através do IDE que os analistas da Microsiga e os usuários do
Protheus podem criar e manter suas rotinas específicas. O IDE é o único modo de
compilar os arquivos de programas escritos em AdvPl para a geração dos APO's no
repositório.

Como ferramenta de edição e depuração, engloba todos os recursos disponíveis nas

melhores ferramentas de desenvolvimento do mercado.

Características do IDE

 Para a execução do IDE não é necessário conectar-se ao Protheus Server, exceto

nas operações de atualização ou consulta de um repositório (compilação,
obtenção do Mapa de Objetos, aplicação de patch´s, etc) e durante o processo de
depuração.
 Não é aconselhável executar o IDE remotamente (via Internet ou via modem),
pois a conexão do IDE ao Protheus Server é mais lenta.

Passos para Desenvolvimento

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

 Criação do código através do editor. Na linguagem AdvPl, os analistas e os

usuários do Protheus têm todos os recursos disponíveis para o desenvolvimento
de suas rotinas. E diferentemente do antigo RDMAKE, não é mais uma
linguagem interpretada. Por isso, a performance das rotinas específicas é 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 usuário pode manter os arquivos de código
separados por projetos e pastas. Com um grupo de projetos os arquivos podem
ser organizados de uma forma lógica, em projetos e pastas.
 Compilação. Durante a compilação, os arquivos são enviados ao Protheus
Server. Toda a compilação e a gravação no repositório são efetuadas no servidor.
 Depuração. O IDE permite aos usuários depurar as rotinas criadas, executando-
as linha a linha ou em modo de animação. Permite visualizar informações como
variáveis 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 código do ponto de
entrada;

Monitor

Revisão: 22/02/2005

Abrangência

Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Versão 8.11

O Monitor é utilizado para monitorar as conexões de terminais ao Protheus Server.

Através dele pode-se:

 Verificar as conexões ativas.

 Enviar mensagens para uma ou mais conexões.
 Desabilitar novas conexões. Isto é útil quando se precisa efetuar alguma
manutenção e se precisa evitar que outros usuários se conectem.

Informações Básicas das Conexões

 Usuário. É o nome do usuário na rede local. Para conexões remotas este nome
está em branco.
 Computador. Nome da máquina onde o Remote está sendo executado.
 Conexão. Indica a data e hora de início da conexão 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 execução.
 Environment. Nome do ambiente sendo utilizado pelo terminal.

Sistemas Operacionais e Plataformas

Revisão: 23/02/2005

Abrangência

Versão 6.09 Versão 7.10 Versão 8.11

Sistemas Operacionais e Plataformas (versão AP6 e posteriores)

O Protheus Server foi desenvolvido em ANSI C++ e , portanto, independe de API's
específicas para funcionar. Graças a isso, o núcleo do Protheus pode ser recompilado em
todos os sistemas operacionais e plataformas que suportem ANSI C++.
Outra preocupação durante o desenvolvimento do Protheus foi garantir total
compatibilidade dos repositórios de objetos do Protheus (RPO's) e das correções dos
repositórios (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 não depende da versão do Remote.

Podemos mesclar numa mesma instalação versões Windows e Linux do Remote.

Não podemos mesclar Servidores Protheus de diferentes S.Operacionais, se utilizarmos

Windows todos os servidores devem estar em Windows.

Topologia de Rede

Revisão: 28/08/2003

Abrangência

Versão 5.07 Versão 5.08 Versão 6.09 Versão 7.10 Versão 8.11
Versões Anteriores

Devido à sua divisão em camadas, a tecnologia Protheus permite montar o ambiente de

execução com diferentes topologias, priorizando a execução, o tráfego de rede ou os
recursos individuais das máquinas existentes, o que torna o processamento distribuído.
Essa é uma das grandes vantagens da tecnologia Protheus.

Características e Possibilidades de Topologias de Rede

  Pode-se manter um ou mais servidores de aplicação do Protheus (Protheus
Server).
 Um Protheus Server pode estar na mesma máquina que o gerenciador de banco
de dados.
 Máquinas melhores ou com mais recursos podem ter um Protheus Server sendo
executado localmente (na estação) visando priorizar o processamento local.
Porém há um aumento do tráfego 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 estações.
 Utilização do protocolo TCP-IP para as conexões. Na versão AP5 pode-se
utilizar também o protocolo NAMED PIPES.
 Pode-se disponibilizar conexões via Internet através da montagem de um Web
Server na empresa ou através 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 conexão ao provedor de acesso.
 A Internet é utilizada apenas como o meio de comunicação, ou seja, a conexão
TCP-IP entre o Remote e o Protheus Server. Além da segurança oferecida pelo
sistema Advanced, a segurança deverá ser oferecida pela conexão. Por isso, é
aconselhável que a máquina onde o servidor Web esteja sendo executado não
seja o mesmo do servidor da banco de dados.
 O Protheus Server também pode ser executado como um servidor Internet,
HTTP e/ou FTP.
 Pode-se manter uma página para o download do Remote, de modo que os
usuário remotos possam efetuar o download para conectar-se e utilizar o sistema.
Na versão AP6 pode-se configurar o Remote para se atualizar automaticamente a
partir do Protheus Server sendo executado como um servidor FTP.

Dica :

A definição da melhor topologia para execução é um passo importante da

implementação da tecnologia Protheus, pois influenciará totalmente na performance. O
maior tráfego de rede está localizado entre o Protheus Server e o Banco de Dados, já
que o tráfego entre o Protheus Server e o Remote limita-se às informações para
montagem de telas e controle de teclado e mouse. Desta forma, dependendo do tipo e da
velocidade da conexão, pode se tornar inviável manter um Protheus Server em uma
cidade conectado ao banco de dados em outra. Por outro lado, caso existam muitas
conexões nesta outra cidade, ou caso estas conexões executem processamentos pesados,
priorizar o processamento disponibilizando um Protheus Server para ser executado
localmente nesta cidade pode ser uma boa solução.