0004 - Arquitetura
e Instalao
Protheus
11
Sumrio
Arquitetura e instalao ................................................................................................... 3
Definies ......................................................................................................................... 4
Camadas do Protheus 11 .................................................................................................. 5
Aplicativos do Protheus 11 ............................................................................................... 7
Instalao do Protheus 11 ................................................................................................ 8
Parmetros do Atalho do TOTVS Application Server (TotvsAppServer) ........................ 22
Parmetros do Atalho do TOTVS Smart Client Protheus (TotvsSmartClient) ................ 24
Acessando o Protheus 11 pela Primeira Vez .................................................................. 26
Arquivos de Configuraes ............................................................................................. 30
Totvs Development Studio (TotvsDevStudio) ................................................................ 31
Atualizao e e Backup do Protheus 11 ......................................................................... 32
Configurao do Protheus 11 ......................................................................................... 41
Configurao do TOTVS DBAcess ................................................................................... 52
Utilizando o TOTVS DBAccess ......................................................................................... 59
Configuraes de Servios .............................................................................................. 71
Configurao do Balanceamento de Carga .................................................................... 73
Modelo Base do TOTVSAppServer.INI ............................................................................ 77
Configurao do TOTVS Smart Client ............................................................................. 80
Protheus 11 Monitor ...................................................................................................... 82
Instalando o TOTVS Smart Client .................................................................................... 84
Auto-Atualizao do TOTVS Smart Client ....................................................................... 90
Configurao dos Recursos para Web ............................................................................ 91
Web Print e WebSpool ................................................................................................... 93
Viso Tcnica .................................................................................................................. 94
2 Arquitetura e Instalao
Arquitetura e instalao
Objetivos instrucionais do curso
So habilidades e competncias precisas e especficas que propiciam uma indicao
clara e completa sobre os conhecimentos pretendidos. Compreendem:
a) Conceitos a serem aprendidos:
- princpio epistemolgico do Protheus;
- nomenclatura Microsiga;
b) Habilidades a serem dominadas:
- domnio conceitual do Sistema;
- capacidade de anlise e adequao: necessidades X soluo Microsiga;
c) Tcnicas a serem aprendidas
- operacionalizao do ambiente;
d) Atitudes a serem desenvolvidas:
- capacidade para resoluo de problemas tcnico-operacionais do ambiente;
- capacidade de execuo.
Objetivos especficos do curso
Ao trmino do curso, o treinando dever ser capaz de:
Arquitetura e Instalao - 3
Definies
Caractersticas da Tecnologia
O Protheus 11 uma tecnologia desenvolvida a partir do Sistema Advanced, que teve
a Inteligncia toda, dividida em quatro Camadas saber: Servidor de Aplicao
TOTVS Application Server
(TotvsAppServer), TOTVS Smart Client Protheus
(TotvsSmartClient), Repositrio de Funes (RPO) e Banco de Dados.
Ou seja, uma aplicao Windows 32 bits, se encarrega: do Gerenciamento das
Conexes, da Execuo do Cdigo ADVPL e do Acesso aos recursos de Banco de Dados
atravs do Codebase, ADS, Btrieve, Ctree ou do TOTVS DBAccess .
uma Aplicao Thin-Client, que realiza apenas a Interface com o usurio.
Principais Caractersticas da Tecnologia Protheus 11
4 Arquitetura e Instalao
Camadas do Protheus 11
O Protheus 11 dividido em quatro Camadas, para a operao. So elas:
Servidor de Aplicao - TOTVS Application Server
O Protheus TOTVS Application Server (TotvsAppServer), a aplicao encarregada da
Compilao e Execuo do Cdigo em (ADVPL), no qual o Protheus 11, foi escrito a
partir da Verso 5.07.
Na Linguagem ADVPL, as rotinas so mantidas em APOs (Protheus 11 Objects)
individuais em Repositrios.
Isso permite que as mesmas sejam carregadas e descarregadas dinamicamente da
memria da mquina onde o Servidor est sendo executado, ou seja, de acordo com a
necessidade de execuo dos Terminais conectados.
Isso facilita a atualizao aps correes de No Conformidades ou Criao de
Melhorias, poisapenas os APOs modificados necessitam ser atualizados.
Desse modo, a Performance Alta e no requer muito da mquina, para a execuo
do servidor.
Arquitetura e Instalao - 5
Repositrios de APOs
nesta parte do sistema que estaro os Programas escritos em ADVPL, serem
acionados para a execuo de determinadas tarefas.
atravs dos Repositrios de Apos, que poderemos incluir Novas Customizaes no
sistema.
O Repositrio APO, um Arquivo Binrio Compilado, que por sua vez no pode ser
Editado ou Modificado, pois tratam os programas desenvolvidos pela TOTVS.
6 Arquitetura e Instalao
Aplicativos do Protheus 11
O Protheus 11, possui basicamente, quatro aplicativos utilizados com diferentes
finalidades.
So eles:
TOTVS Application Server (TotvsAppServer)
TotvsAppServer.exe Trata-se do Servidor de Aplicao do Protheus 11. Esta a parte
do sistema que ser executada no Servidor e ser responsvel pela Comunicao entre
o Cliente, a Base de Dados e o Repositrio de Apos.
TOTVS Smart Client Protheus - (TotvsSmartClient)
TotvsSmartClient.exe o Terminal Thin-Client, responsvel pela interface com o
usurio. o Remote que utilizamos, para interagir com todo o sistema, ele poder ser
instalado de duas maneiras: no Servidor de Aplicao ou nas prprias Estaes de
Trabalhos.
Totvs Development Studio (TotvsDevStudio)
TotvsDevStudio.exe Trata-se do Ambiente de Desenvolvimento Integrado do
Protheus 11. atravs deste Aplicativo, que iremos realizar todos os acessos aos
Repositrios de Apos (Compilao de Customizaes, Visualizao de Funes
existentes, etc...).Alm de Depurar Programas Customizados.
TOTVS Monitor Protheus (TotvsMonitor)
TotvsMonitor.exe Trata-se do Ambiente de Monitorao do Protheus 11. Atravs do
TotvsMonitor, poderemos interagir com os Usurios Conectados ao Sistema, Analisar
os Programas em Uso, Derrubar Conexes Pendentes, Enviar Mensagens ao Usurios,
etc.
Arquitetura e Instalao - 7
Instalao do Protheus 11
Neste tpico do curso, iremos Instalar o TOTVS Application Server e o TOTVS Smart
Client Protheus , juntamente com todas as Ferramentas que o Protheus 11,
disponibiliza.
O primeiro passo para instalao do Protheus 8 a instalao do TOTVS Application
Server.
A instalao do TotvsAppServe, assim como do TotvsSmartClient e das Ferramentas
auxiliares (TotvsDevStudio, MPDump e o TotvsMonitor) realizada, atravs do
Instalador do Server, localizado no CD do Protheus 11.
Este programa de instalao permite ao administrador instalar o Protheus 8 de dois
modos:
Exerccio 01 - Como Instalar o Protheus, para Ambientes Codebase:
AutoRun
O AutoRun executado automaticamente se o Windows estiver configurado com este
recurso. Porm, possvel execut-lo atravs do comando:
X:\AUTORUN.EXE onde: X a unidade de CD-ROM
Execuo dos seguintes programas a partir do respectivo CD
Instalao do Server no Windows (Discos 1 e 2)
WINDOWS\TOTVS APPLICATION SERVER\DISK1\SETUP.EXE
Instalao do Remote no Windows (Disco 1)
WINDOWS\TOTVS SMARTCLIENT\SETUP.EXE
Instalao do Help no Windows (Disco 3)
WINDOWS\PROTHEUS 11 HELP\PORTUGUESE\SETUP.EXE
8 Arquitetura e Instalao
Arquitetura e Instalao - 9
Leia o contrato de licena com ateno e clique no boto Sim para prosseguir.
10 Arquitetura e Instalao
Indique o caminho onde o TOTVS Application Server deve ser instalado. Clique no
boto Avanar para prosseguir.
.
Recomenda-se o uso do diretrio padro de instalao para que o
processo de suporte e treinamento seja facilitado.
Evite o uso de unidades lgicas (drives de rede), para tanto utilize
sempre o computador que faz o papel de servidor para efetuar a
instalao. Com isso, diminuise o risco de erros em eventuais
desinstalaes do sistema
Arquitetura e Instalao - 11
Atualizao/Primeira Instalao
Caso seja uma Atualizao de Verso - informe o diretrio onde est instalada a verso
7.11 do Protheus. Aps a instalao, o kernel do AP7 continuar a existir, porm, os
dados j estaro prontos para a atualizao da verso. Este diretrio ir conter os
dados (SYSTEM, DATA, SPOOL, etc). Consulte no help "A estrutura de diretrios do
Protheus".
12 Arquitetura e Instalao
Neste momento, pode-se optar por apenas uma base de dados, porm, atravs de
alteraes no arquivo de configurao do TOTVS Application Server e cpia do
repositrio correto, possvel fazer com que a mesma instalao do Protheus utilize
dois tipos de base de dados.
2. O idioma do RPO a ser instalado.
3. O pas para instalao do arquivo "SXS<pas>.TXT". Este arquivo gravado no
diretrio\Protheus_Data\SYSTEMLOAD, sendo responsvel pela criao dos dicionrio
de dados e demais arquivos especficos para o pas selecionado.
4. Clique no boto Avanar para prosseguir.
Arquitetura e Instalao - 13
Instalao de DLLs
14 Arquitetura e Instalao
Arquitetura e Instalao - 15
16 Arquitetura e Instalao
Instalando o Help
Para consultar a documentao on-line, necessrio instalar o Disco 3 - Help do
Protheus 11. A documentao acessada a partir dos ambientes do Protheus, pela
tecla[F1].
Arquitetura e Instalao - 17
Leia o contrato de licena com ateno e clique no boto Sim para prosseguir.
18 Arquitetura e Instalao
Nesta janela, deve ser informado o diretrio de instalao dos arquivos de helps.
Clique no boto "Avanar".
Localizao do TOTVS Application Server
Nesta janela, deve ser informado o diretrio onde est instalado o Protheus 8 Server
para que seja configurado corretamente pelo programa de instalao. Clique no boto
Avanar.
Arquitetura e Instalao - 19
Processo de Instalao
20 Arquitetura e Instalao
Arquitetura e Instalao - 21
Executado como uma (Janela Console), as informaes recebidas das conexes com o
TOTVS Application Server (TotvsAppServer) conectados so exibidas diretamente na
tela do console do TOTVS Application Server (TotvsAppServer), bem como informaes
de (No Conformidades), e a execuo do TOTVS Application Server (TotvsAppServer)
pode ser interrompida com o pressionamento da combinao de teclas [Ctrl]+[Break];
Parmetro (-Install)
22 Arquitetura e Instalao
Arquitetura e Instalao - 23
TOTVS
Smart
Client
24 Arquitetura e Instalao
Arquitetura e Instalao - 25
26 Arquitetura e Instalao
Arquitetura e Instalao - 27
28 Arquitetura e Instalao
Arquitetura e Instalao - 29
Arquivos de Configuraes
A partir de agora, iremos conhecer um pouco mais sobre os Arquivos de Configurao
do Protheus 11.
Dentre eles, aprofundaremos nosso conhecimento no arquivo (TotvsAppServer.INI),
que o Arquivo de Configurao, utilizado pelo TOTVS Application Server
(TotvsAppServer) e no arquivo (TotvsSmartClient.INI), que indica as configuraes,
para o TOTVS Smart Client (TotvsSmartClient).
A saber, existem os seguintes Arquivos de Configurao no Protheus 11os quais esto
localizados na pasta (\BIN), no diretrio raiz, do Protheus 11:
30 Arquitetura e Instalao
Arquitetura e Instalao - 31
32 Arquitetura e Instalao
Patch
Arquivos de Correes para o RPO.
Sua finalidade a correo do Arquivo Binrio que contm as Funes utilizadas pelos
Mdulos do sistema, a fim de se evitar que seja necessrio Atualizar o RPO por
completo, sempre que uma Funo for corrigida.
Sua Nomenclatura a seguinte:
TTDP111.PAT
Onde:
TT Totvs 111;
D Tipo de banco de Dados.
Exemplo:
D=Codebase, A=ADS, T=Top Connect, C=Ctree, B=Btrieve);
P Idioma
Exemplo:
P=Portuguese, E=English, S=Spanish
111 Verso do Protheus 11.1.
PAT Identifica que se trata do Arquivo de Correo do RPO.
Arquitetura e Instalao - 33
Atualizao de BUILD
A Atualizao da Build consiste em atualizar todas as alteraes realizadas, dentro da
estrurutra do Protheus 8, como por exemplo, as Dlls, os Executveis, as Correes dos
Utilitrios, os Aplicativos e etc...
recomendado que se atualize a Build a cada 3 (Trs) meses, pois normalmente, esse
o perodo em que o (FTP da MICROSIGA) atualizado, com excesso da Path, que
no tem data exata para a Atualizao.
Exerccio 05 Como realizar Atualizaes de Builds:
1. Faa o Backup dos seguintes Diretrios: BIN, APO, INCLUDE, que se localizam no
diretrio Protheus11;
2. Para as atualizaes de build verso 11, acesse o site da TOTVS www.totvs.com.br,
no link Portal do Cliente. Para acesso aos clientes ativos, necessitando de usurio e
senha.
34 Arquitetura e Instalao
Arquitetura e Instalao - 35
36 Arquitetura e Instalao
Arquitetura e Instalao - 37
P11APPSERVER.ZIP,
3. Descompacte o arquivo
Protheus11\Bin\SmarClint\;
P11SMARTCLIENT.ZIP,
dentro
dentro
do
diretrio
do
diretrio
38 Arquitetura e Instalao
Arquitetura e Instalao - 39
40 Arquitetura e Instalao
Configurao do Protheus 11
Ambientes;
Servidor de Licenas;
Mdulos Web;
Processos Comuns;
Conexo (Server/Remote);
TOTVS DBAccess;
Servidor CTREE;
Balanceamento de Carga;
Geral.
Protheus Search
(*) Esta opo apenas ser apresentada caso o TOTVS Application Server esteja sendo
executado em um ambiente Microsoft Windows.
O TOTVS Wizard executado automaticamente ao final da instalao do
Protheus 11, por meio do assistente de instalao do CD do Protheus. Porm, aps a
instalao do Protheus, tambm possvel execut-lo pela opo "Assistente de
Configurao do Servidor", na pasta "Protheus 11\Ferramentas" no menu Iniciar do
Arquitetura e Instalao - 41
Windows, ou pelo
"\BIN\SmarClient".
aplicativo
TotvsWizard.exe,
disponvel
no
diretrio
42 Arquitetura e Instalao
Configuraes de Ambientes
As sees de Ambiente, ou Environment, so criadas para identificar o
comportamento e execuo do TOTVS Application Server para as conexes clientes.
Quando o Protheus Remote se conecta ao TOTVS Application Server, deve informar,
entre outros parmetros, o nome do Ambiente utilizado para que o TOTVS Application
Server prepare a execuo daquele terminal.
no Ambiente que informaes como o idioma, a verso e o banco de dados
utilizado so configuradas. Quando o Protheus Remote se conecta e informa o
Ambiente que ser utilizado, o TOTVS Application Server executa os procedimentos
necessrios: abre o repositrio de objetos compilado parao idioma, banco de dados e
verso indicados, e realiza a conexo com o banco de dados selecionado. possvel,
atravs da configurao de mais de um ambiente, utilizar um Server Protheus para
executar simultaneamente mais de uma aplicao Advpl, com ambientes
completamente
independentes, utilizando apenas uma instncia do TOTVS
Application Server.
muito comum a criao de mais de um ambiente para o Protheus. Geralmente so
criados os ambientes Teste, Produo e Desenvolvimento.
Arquitetura e Instalao - 43
Nova Pasta
Descrio
C:\Protheus11\apo2
Repositrio Independente
C:\Protheus11\dataTST
C:\Protheus11\systemTST
Configuraes Independentes
44 Arquitetura e Instalao
Arquitetura e Instalao - 45
46 Arquitetura e Instalao
Arquitetura e Instalao - 47
14. Note que o caminho X2_PATH, mapeia o drive \DATA\, o qual devemos alterar
para \DATATST\, para desta maneira termos a Base de Dados, independente.
48 Arquitetura e Instalao
15. Clique nas seguintes opes Utilitario + Replace e note que o APSDU, abrir a
Ferramenta de Alterao, conjunta;
Arquitetura e Instalao - 49
50 Arquitetura e Instalao
Field
X2_Path
Width
\SYSTEMTST\
FOR
X2_PATH=\SYSTEM\
Arquitetura e Instalao - 51
52 Arquitetura e Instalao
Arquitetura e Instalao - 53
4. Clique no boto Avanar para prosseguir e ser exigida a tela de escolha do local de
destino.
54 Arquitetura e Instalao
Arquitetura e Instalao - 55
56 Arquitetura e Instalao
Arquitetura e Instalao - 57
58 Arquitetura e Instalao
Usurios logados
Testes de conexo
Monitores de ndices
TOTVSDBMonitor
Exerccio 14 - Para utilizar o TOTVSDBMonitor:
1. Acesse o cone do programa criado no sistema operacional: "TOTVSDBAccess 4.1" .
O sistema apresenta uma pequena janela referente s configuraes de Monitor.
Arquitetura e Instalao - 59
60 Arquitetura e Instalao
Monitor
Na opo Monitor possvel dar incio s operaes de conexo do servidor e,
alm disso, sair do aplicativo.
Exerccio 15 - Para utilizar a opo de Monitor:
1. Na janela principal do TOTVSDBAccess, selecione a opo "Monitor",
disponvel na barra de ferramentas.
O sistema relaciona as opes disponveis:
Conectar Servidor
Selecionada esta opo, o sistema apresenta uma pequena janela para informar os
dados de conexo ao servidor, devendo-se preencher os campos:
Servidor - informe o nmero/nome do servidor
Porta - informe o nmero da porta para a conexo
Arquitetura e Instalao - 61
Visualizar
Esta opo permite configurar as opes de atualizao das informaes estatsticas,
dentre as opes:
Rpida
Normal
Lenta
Selecione a opo desejada at que ela esteja visualmente selecionada (
).
Ajuda
Esta opo permite acessar os "helps" do TOTVSDBAccess, alm de apresentar
as informaes do aplicativo.
Pasta "Informaes"
Na abertura do TOTVSDBMonitor apresentada a primeira pasta, "Informaes",
com os dados de registro do TOTVSDBAccess, verso, quantidade de usurios
conectados, tabelas em uso, servidor de base etc.
62 Arquitetura e Instalao
Max IOs/Seg.: mximo de IOs por segundo, registrando a maior velocidade das
informaes
para no permitir
Arquitetura e Instalao - 63
Pasta "Usurios"
Nesta pasta esto relacionados todos os usurios conectados ao sistema e,
conseqentemente, base gerenciada.
Os dados apresentados referem-se s queries enviadas ao servidor pelo usurio
selecionado.
Exerccio 17 - Para monitorar usurios:
1. As informaes so distribudas em colunas que, por sua vez, relacionam os
seguintes dados:
ID
Relaciona o nmero de identificao do usurio.
Usurio
Relaciona o nome do usurio.
IOs
Relaciona o nmero de entradas e sadas do usurio.
64 Arquitetura e Instalao
Tabela
Procedure
Comentrios
Arquitetura e Instalao - 65
66 Arquitetura e Instalao
Visualizar por
ID
Ambiente
Tabela
Recno
Arquitetura e Instalao - 67
Boto
Funcionalidade
Salvar
Fechar
Rastrear
O boto "Rastrear" relaciona na tela os usurios conectados e suas respectivas
queries, ou seja, conforme as consultas vo sendo realizadas, esta tela apresenta a
movimentao do usurio.
Exerccio 19 - Para rastrear a atividade de um usurio:
1. Na pasta "Usurios", posicione o cursor sobre o registro do usurio desejado,
e clique no boto"Rastrear"
O sistema apresenta nova tela, relacionando as informaes de acesso do
usurio, divididas em duas colunas:
Tempo - informa o tempo utilizado para a consulta
Query - descreve as consultas realizadas
2. Os dados so atualizados constantemente, ou seja, estas informaes esto
sempre em movimento na tela.
68 Arquitetura e Instalao
Funcionalidad
e
Copia a linha selecionada.
Pausa
Limpar
Salvar
Fechar
Arquitetura e Instalao - 69
Data
Apresenta a data da mensagem.
Hora
Relaciona a hora da mensagem.
Mensagem
Relaciona as mensagens de erro do banco.
2. Para controlar as informaes , esto disponveis os botes:
Boto
Atualizar
Descri
o e horrios apresentados
Atualiza as mensagens, datas
Limpar
Salvar
70 Arquitetura e Instalao
Configuraes de Servios
Servio o processo utilizado, para que o Protheus 11, possa ser iniciado
Automaticamente, quando o Servidor for ligado. Podemos Configurar os Servios,
manualmente utilizando o Assistente de Configurao.
Exerccio 14 Como Configurar Servios do WinNT/ 2000:
1 . Selecione as seguintes opes Iniciar + Programas + Protheus 11 +
Ferramentas + Assistente de Configurao do Servidor;
2 . Abra a opo Servio do WindowsNT/2000 e posicione sobre Service e clique no
icone Editar Configurao, confirme a tela a seguir;
Arquitetura e Instalao - 71
72 Arquitetura e Instalao
Arquitetura e Instalao - 73
74 Arquitetura e Instalao
Arquitetura e Instalao - 75
Teste de Balanceamento
Exerccio 16 Como Testar o Balanceamento de Carga entre Servidores:
1. O Server_01, ser o Gerenciador do Balanceamento, pois ser ele que ir
efetivamente, direcionar as Requisies de Conexes, das Estaes do Protheus 11
SmartClient;
2. No Modelo apresentado, balanceamos (2 Servidores), com (1 Conexo) cada, isto
far com que a primeira Requisio de Conexo, entre no (Sevidor 01), pois o
mesmo, possui (1 Conexo Simultnea) apenas;
3. A segunda Requisio de Conexo, ser direcionada, para o (Servidor 02);
4. Quando iniciarmos os (Servidores TotvsAppServer.exe), veremos que estes,
tentaro se conectar pelo (Endereo IP), de cada um;
5 . Para que se possa Efetivar as Alteraes, no arquivo (TOTVSAPPSERVER.INI),
vamos testar o Sincronismo dos Servidores.
76 Arquitetura e Instalao
Arquitetura e Instalao - 77
Port=2222
ShowStatus=1
[Drivers]
Active=TCP
[TCP]
TYPE=TCPIP
Port=1234
[ServerNetWork]
Servers=Server_01,Server_02
MasterConnection=1
[Server_01]
Server=Endereo IP do Servidor 01
Port=1234
Connections=1
[Server_02]
Server=Endereo IP do Servidor 02
Port=1234
Connections=1
[Service]
Name=Microsiga
DisplayName= Protheus 11
[GENERAL]
InactiveTimeOut=<Valor em Segundos>
78 Arquitetura e Instalao
[HTTP]
Enable=1
Path=C:\Protheus11\Bin\smartclient_ActiveX
Port=80
RpcEnv=Environment
InactiveTimeOut=30
[UPDATE]
Enable=1
PathWindows=:\Protheus11\Bin\smartclient
PathLinux=:\Protheus11\Bin\smartclient_linux
Arquitetura e Instalao - 79
C:\PROTHEUS8\BIN\
80 Arquitetura e Instalao
Onde:
Arquitetura e Instalao - 81
Protheus 11 Monitor
O Protheus 11 Monitor utilizado para monitorar as Conexes ao TOTVS Application
Server
Atravs dele pode-se:
Isto ser til quando precisarmos realizar alguma manuteno e precisarmos evitar,
que outros usurios se conectem;
Desconectar Usurios:
Usurio:
Computador:
Conexo:
Tempo de Uso:
Indicar o Tempo em Horas, Minutos e Segundos, desde que TOTVS Smart Client,
estar se conectando;
82 Arquitetura e Instalao
Programa Inicial:
Ser o Nome do Programa Inicial (APO), com o qual o TOTVS Smart Client, ter iniciado
a Execuo;
Environment:
Arquivos Abertos:
Arquitetura e Instalao - 83
84 Arquitetura e Instalao
Arquitetura e Instalao - 85
Leia o contrato de licena com ateno e clique no boto "Sim" para prosseguir.
4. Indique o caminho onde o TOTVS Smart Client deve ser instalado. Clique no boto
Avanar para prosseguir.
5. Indique a pasta onde devem ser instaladas as opes de acesso aos aplicativos do
Protheus 11.
86 Arquitetura e Instalao
Arquitetura e Instalao - 87
88 Arquitetura e Instalao
Arquitetura e Instalao - 89
localizado
na
pasta
90 Arquitetura e Instalao
edite
arquivo
[HTTP]
Enable=1
Path=C:\Protheus11\Bin\smartclient_ActiveX
Port=80
RpcEnv=Environment
InactiveTimeOut=30
2. Acesse a pasta C:\PROTHEUS11\BIN\SMARTCLIENT_ACTIVEX\ e edite o arquivo
TotvsSmartClient.htm, fazendo as seguintes modificaes:
<param name="Server" value="Nome do Servidor"">
<param name="TCPPort" value="1124">
<param name="Environments" value="Environment">
<param name="Language" value="1">
<param name="StartProgram" value="sigaadv">
<param name="ReadOnly" value="OFF">
Arquitetura e Instalao - 91
92 Arquitetura e Instalao
2 . Ser apresentada uma Tela de Acesso, na qual dever ser digitado o Nome do
Usurio, sua respectiva Senha e Empresa/Filial, que ser utilizada para trabalho;
3 . Confirme clicando na opo Ok;
4 . Pronto, todas as opes de relatrios que existem no Protheus 11, esto
disiponveis atravs do Browser.
Arquitetura e Instalao - 93
Viso Tcnica
Customizaes
Flexibilizar sem despadronizar.
Esta a palavra de ordem das Ferramentas do Protheus 8.
H vrias tcnicas, para se customizar um sistema, no sentido de adapt-lo s
necessidades de cada usurio.
No Protheus 11, utilizamos algumas Ferramentas que facilitam a Personalizao do
Sistema, sem que seja necessrio, como ponto de partida, alteraes em fontes de
programas.
Essas Ferramentas so denominadas (Arquivos Customizadores), e tem por finalidade,
facilitar as manutenes do Sistema.
Assim, podemos resumir a Hierarquia de Customizaes em:
Parmetros;
Dicionrio de Dados;
Tabelas Genricas;
Tabelas (Arquivos);
Frmulas;
Relatrios;
Pastas Cadastrais;
Consultas Padres;
Perguntas e Respostas;
Sequncia de Documentos;
Schedule de Processos;
Pontos de Entradas;
94 Arquitetura e Instalao
Parmetros (Sx6)
A maneira mais primitiva de se Customizar um sistema atravs de Parmetros.
A Movimentao de Clculo de Custos On-Line, um exemplo bem caracterstico.
Esta Movimentao, se por um lado traz vantagens indiscutveis do ponto de vista
gerencial, do outro tem problemas tcnicos relacionados Performance, Seqncia de
Digitao e Cancelamentos de Movimentaes.
Assim, deve-se sempre dar ao usurio a deciso de adot-la ou no.
Uma soluo:
Cria-se um Parmetro, neste caso, denominado (MV_CUSMED), e dependendo do seu
Contedo (M Mensal ou O On-Line), h nos Programas condies que validam o
contedo destas variveis, ativando ou inibindo as respectivas Movimentaes dentro
do Sistema.
Os Parmetros compem o (Arquivo SX6) e atendem aos mais variados Tipos de
Customizao e podem ser analisados no Mdulo Configurador.
uma Forma Engessada de Customizao, pois qualquer alterao depende de
mudanas nos fontes, alm de deixar confusa a Lgica dos Programas.
Mas vlida em determinadas circunstncias.
O Protheus 8, tem no total (2096 Parmetros), que devem ser todos cuidadosamente
configurados de acordo com as Regras de Negcios de cada Empresa.
Dicionrio de Dados (SX3)
O Objetivo deste arquivo permitir a Flexibilizao da Base de Dados, atravs da
Incluso de Novos Campos, sua Alterao, Inibir o seu Uso e at Criar Novas
Tabelas, que passam a ser parte integrante do sistema.
Definir em que Pasta de Cadastro, os campos devero se posicionar e at mesmo
modificar o posicionamento de campos, que j faziam parte do sistema antes das
Customizaes.
Para tal, ao invs dos programas tratarem explicitamente os campos no fonte, tudo
realizado atravs de leituras ao Dicionrio de Dados.
Cada registro do Dicionrio de Dados, corresponde a um campo das mais de (1600
Tabelas) do sistema.
Todos os Processamentos, em especial, as telas de Cadastramentos, Consultas e
Relatrios Genricos, so baseados no seu contedo.
Tamanhos, Tipos, Pictures, Legendas, Validaes, Nveis de Acessos, Inicializaes,
Contextos Reais ou Virtuais, Usos ou No Usos, Obrigatoriedades, Ordens de
Apresentaes, Helps e Consultas via <F3>, so Propriedades definidas no Dicionrio
de Dados e passveis de alterao pelo prprio Administrador.
Arquitetura e Instalao - 95
96 Arquitetura e Instalao
Arquitetura e Instalao - 97
Pontos de Entradas
So Chamadas colocadas em lugares estratgicos dos programas e que, originalmente,
no fazem nada.
Assim que o usurio necessitar de uma interveno neste ponto, cria-se uma (Rotina),
d-se a ela o nome do Ponto de Entrada, citado na documentao do Protheus 8 e
compila-se programa.
Ao passar por ela, esta (Rotina) executada.
Claro est que, quem escreve rotinas em Pontos de Entradas, precisa saber muito
bem, sobre a Lgica do Programa em questo e mesmo qual a Situao da Memria
naquele momento.
No Quark (Documentao on-line), os inumeros Pontos de Entradas, so
detalhadamente documentados.
O conceito de Pontos de Entradas, o mesmo da herana adotada nas Linguagens
Orientadas a Objetos.
Alm das ferramentas originais de customizao do Protheus 11, podemos mencionar
mais recursos que resolvem muitos casos de forma mais rpida e prtica. mSo as
integraes com o (Crystal Report, Excel, Word e Project e Lotus).
Excel
A Integrao com o Excel, nada mais do que a possibilidade de se inserir nas
Clulas desta Planilha, User Functions desenvolvidas em ADVPL, semelhana das
Macros em Visual Basic. Como as User Functions tem acesso Base de Dados do
sistema e podem fazer processamentos ilimitados, fica fcil perceber como este
recurso pode integrar as duas ferramentas.
A Ferramenta Excel, precisa ser chamada, a partir do menu de algum Mdulo do
Protheus 11.
Word
A integrao com o Word a mais simples de todas, pois utiliza apenas chamadas em
variveis do Protheus 11, sem necessariamente utilizar funes da MICROSIGA.
Essa ferramenta muito utilizada em integraes com a Folha de Pagamento, na
elaborao de Documentos dos Mdulos de Qualidade, etc...
Crystal Report
A integrao com a Ferramenta Crystal Report semelhante, ou seja, pode-se chamar
User Functions desenvolvidas em (Linguagem de Programao ADVPL), na gerao
dos Grficos e Relatrios desenvolvidos com esta ferramenta.
98 Arquitetura e Instalao
Project
A integrao do MS-Project realizada, atravs do Mdulo de PCP, quando se gera a
Carga de Mquina (MRP II) ou com outros Mdulos como por exemplo WMS e OMS
(Logstica), para a Elaborao de Projetos.
Chaves de ndices (SIX)
Este arquivo responsvel pelas Chaves Primrias e Chaves Estrangeiras dos arquivos
do Sistema.
Atravs dele possvel configurar novas Chaves de ndices, para as Novas Tabelas que
forem criadas, alm da possibilidade de criar Novos Tipos de Pesquisas, para os
cadastros.
Relacionamento entre Arquivos (SX9)
o arquivo que documenta todo o Relacionamento entre as Tabelas do Protheus 8,
no que diz respeito a (Arquivos de Domnio e Contra-Domnio), ou seja, o (M.E.R.
Modelo de Entidades e Relacionamentos).
Pastas Cadastrais (SXA)
Trata todas as Pastas Cadastrais, utilizadas nas Telas de Cadastros e Movimentaes no
Protheus 8, atravs deste arquivo possivel configurar os campos que devero
aparecer dentro de cada uma das Pastas, alm da possibilidade da criao de outras
Pastas, alm das originais, com a finalidade de distribuir de maneira prtica os campos
entre elas, para melhor aproveitamento durante seus respectivos cadastros realizados
pelos usurios.
Consultas Padres (SXB)
ele quem define o modelo do (Combo Box), que ser utilizado no momento em que o
Usurio acionar a tecla <F3> ou clicar na cone , sobre campos que possuam ligao
com alguma Tabela do Sistema.
Sequncias de Documentos (SXE e SXF)
Este dois Arquivos so os responsveis pelo armazenamento dos Seqncias de
Campos Nmricos, como por exemplo: Cdigos de Cadastros, Numerao de Notas
Fiscais, enfim, qualquer Campo que deva seguir uma Numerao Seqncial.
O fato de existirem dois Arquivos ao invs de um, segue a seguinte Estrutura:
Arquitetura e Instalao - 99