Escolar Documentos
Profissional Documentos
Cultura Documentos
Arquitetura e Instalação - P11 PDF
Arquitetura e Instalação - P11 PDF
Sumrio
...........................................................................................................................................1
Sumrio.............................................................................................................................2
Arquitetura e instalao .................................................................................................3
Definies .........................................................................................................................4
Camadas do Protheus 11 ...............................................................................................5
Aplicativos do Protheus 11.............................................................................................7
Instalao do Protheus 11 .............................................................................................8
Configurao do DBAcess ............................................................................................22
DbAccess Monitor ..........................................................................................................25
Utilizando o ByYou DbAccess ......................................................................................37
Parmetros do Atalho do Application Server ............................................................39
Parmetros do Atalho do Smart Client.......................................................................41
Acessando o Protheus 11 pela Primeira Vez.............................................................43
Arquivos de Configuraes ..........................................................................................47
ByYou Development Studio (DevStudio) ...................................................................48
Atualizao e e Backup do Protheus 11.....................................................................49
Configurao do Protheus 11 ......................................................................................57
Configuraes de Servios ...........................................................................................61
Modelo Base do AppServer.INI ...................................................................................67
Protheus 11 Monitor .....................................................................................................72
Instalando o ByYou Smart Client ................................................................................74
Auto-Atualizao do ByYou Smart Client...................................................................79
Configurao dos Recursos para Web .......................................................................81
Web Print e WebSpool..................................................................................................83
Viso Tcnica .................................................................................................................84
2 Arquitetura e Instalao
Arquitetura e instalao
Arquitetura e Instalao - 3
Definies
Caractersticas da Tecnologia
4 Arquitetura e Instalao
Camadas do Protheus 11
Base de Dados
O Acesso aos Dados realizado pelo Servidor de Aplicao, atravs do padro ISAM
(Codebase), ADS (Para padro DBF), ou do ByYou DbAccess (Para padro SQL).
Para Bases de Dados (SQL), existe total suporte a Stored Procedures.
Na verso Protheus 11, todas as Bases de Dados tm suporte a Controle de Transaes,
inclusive a Base de Dados (Padro DBF).
O Protheus 11 permite a utilizao de Tecnologias de Replicao de Dados, como o
CISASync ou o prprio MSSQL Server.
Arquitetura e Instalao - 5
Repositrios de APOs
nesta parte do sistema que estaro os Programas escritos em ADVPL, a serem acionados
para a execuo de determinadas tarefas.
por meio 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 MICROSIGA.
Esse arquivo independente de plataforma, ou seja, ele pode ser armazenado num servidor
com Windows, Linux, AS400 ou Unix sem necessidade de configuraes especiais.
A necessidade de repositrios especficos ocorre apenas para a tecnologia utilizada para
armazenamento dos dados e idioma do sistema. Assim existem repositrios em Portugus,
Ingls e Espanhol nas tecnologias Codebase, ADS, Ctree e DbAccess para bases
relacionais.
O repositrio contm fontes compilados em ADVPL e ADVPL-ASP, pginas HTML
utilizadas em portais alm de imagens nos formatos BMP, JPG e PNG.
6 Arquitetura e Instalao
Aplicativos do Protheus 11
So eles:
Monitor (Monitor)
Trata-se do Ambiente de Monitorao do Protheus 11. Atravs do Monitor 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
8 Arquitetura e Instalao
1. Coloque o DVD no drive e aguarde a exibio da tela de abertura conforme a seguir.
Arquitetura e Instalao - 9
2. Clique na opo ByYou Application Server.
O instalador ser iniciado. A janela para escolha de idioma apresentada.
3. Tela de Bem-Vindo.
10 Arquitetura e Instalao
4. Contrato de licena.
Arquitetura e Instalao - 11
6. Pasta raiz do Protheus.
Caso seja uma Atualizao de Verso: Informe o diretrio em que est instalada a verso
7.10, 8.11 ou 10.1 do Protheus. Aps a instalao, o kernel do AP7, MP8 ou TT10
continuar a existir, porm, os dados j estaro prontos para a atualizao da verso. Este
diretrio conter os dados (SYSTEM, DATA, SPOOL, etc). Consulte no help "A
estrutura de diretrios do Protheus".
Caso seja a Primeira Instalao, indique o caminho onde os arquivos de dados do Protheus
11 devem ser gravados. Clique no boto Avanar para prosseguir.
12 Arquitetura e Instalao
7. Definies do Repositrio de objetos.
Arquitetura e Instalao - 13
8. DLLs do Sigaloja.
14 Arquitetura e Instalao
10. Status da Instalao.
Arquitetura e Instalao - 15
O programa de instalao prepara o ByYou Application Server com as configuraes
mnimas para a sua correta execuo. Porm, pode-se configur-lo por meio da
manuteno do arquivo de configuraes (AppServer.INI). As configuraes so
mantidas em diferentes sees de Environments, conforme a estrutura do arquivo de
configuraes.
No Windows, possvel configurar o arquivo AppServer.INI, utilizando este
Assistente de Configurao do ByYou Application Server.
Alm disso, o assistente permite a instalao e configurao dos mdulos Web do
Protheus: GE - Gesto Educacional, Portal Protheus, DW - Data Warehouse, BSC -
Balanced Scoredcard, WPS - WebPrint/WebSpool, RH On-line - Terminal do
Funcionrio e WS - Web Services.
Caso seja deseje executar o assistente de configurao, clique no boto "Sim". Consulte ao
final deste guia as informaes sobre as sees do arquivo de configurao
do servidor (AppServer.INI).
16 Arquitetura e Instalao
Instalando o Help
A documentao acessada a partir dos ambientes do Protheus, pela tecla F1. A instalao
do Protheus 11 Help ocupa cerca de 900Mb.
1-Clique na opo Help Online. O Install Shield ser iniciado. A janela de Bem-vindo
apresentada.
Arquitetura e Instalao - 17
2. Contrato de Licena. Leia o contrato de licena com ateno e clique no boto Sim para
prosseguir
18 Arquitetura e Instalao
5. Diretrio de Instalao do ByYou Application Server. Informe onde o Appserver est
instalado para que o programa de instalao edite o appserver.ini e clique em Avanar;
5. Status da Instalao.
Arquitetura e Instalao - 19
Com a configurao da instalao do help, ser iniciado o processo de cpia dos arquivos.
Este procedimento configura o acesso aos helps a partir do Application Server,
caso o usurio queira utilizar outro servidor de help, poder copiar os arquivos
instalados para outro servidor e alterar o arquivo AppServer.INI, indicando a sua
nova localizao, atravs da configurao da chave "PATH" da seo HTTP e da chave
HELPSERVER do ambiente utilizado. Para isto, pode ser utilizado o Assistente de
Configurao do ByYou Application Server.
20 Arquitetura e Instalao
Servidor de Licenas
A Microsiga envia, junto aos DVDs de instalao do Protheus 11 (exceto quando se tratar
de atualizao), um hardware de proteo que tem por objetivo a segurana de suas
informaes usando algoritmo de criptografia (recurso para proteo de mensagens
eletrnicas), baseados em chaves de 128 bits, liberando mecanismos mais eficientes
para proteger o sistema contra acessos indevidos. Aliado a isso, mais agilidade no processo
de liberao de senhas e grande ganho de performance nos processos de controle aos
acessos simultneos so obtidos.
O servidor de licenas deve ter conectado o Hardlock (dispositivo de segurana) na porta
paralela ouUSB e o driver do dispositivo instalado (se necessrio).
Para cada contrato de manuteno, a MICROSIGA est enviando um Hardlock, que pode
ser HASP ouProteq/SafeNet. A seguir, so descritos os procedimentos de instalao de
cada dispositivo.
Dispositivo com interface USB Dispositivo com interface paralela
Onde a chave enable=1 informa que o aplicativo tentar se conectar com o hardlock e
port=5555 informa a porta na qual ser servido o servio de licenas. As demais
instalaes do Protheus sero clientes de licenas e devero ter a seo [licenseclient],
como no exemplo abaixo:
[licenseclient]
server=servidor01
port=5555
Arquitetura e Instalao - 21
Configurao do DBAcess
Na seo [TOPCONNEC] ou [DBACCESS] do arquivo de configurao do
Application Server, devem ser definidas as opes de conexo padro dos ambientes
(environments) configurados no Servidor. Estas configuraes permitem a definio do
banco de dados utilizado, alias, servidor e demais opes. Estas informaes so apenas
para ambientes que utilizam o repositrio de objetos (APO) configurado para o ByYou
DbAccess como banco de dados principal.
Caso sejam utilizados mais de um ambiente com DBAccess e exista a necessidade
de estabelecer conexo com bancos de dados diferentes e/ou de estaes com outro
servidor ByYou DbAccess, possvel configurar os parmetros desta conexo com o
DBAccess na seo de configurao do prprio Ambiente (environment).
22 Arquitetura e Instalao
3. Local de destino.
Arquitetura e Instalao - 23
6. Clique no boto Concluir e finalize a instalao.
24 Arquitetura e Instalao
DbAccess Monitor
Selecionada esta opo, o sistema apresenta uma pequena janela para informar os dados
de conexo ao servidor, devendo-se preencher os campos:
Arquitetura e Instalao - 25
Visualizar
Esta opo permite configurar as opes de atualizao das informaes estatsticas, dentre
as opes:
Rpida
Normal
Lenta
Ajuda
Pasta "Informaes"
26 Arquitetura e Instalao
Tabelas: quantidade de tabelas acessadas.
IOs/Seg.: IOs por segundo (inputs/outputs = entradas e sadas), registrando a
velocidade das informaes.
Max IOs/Seg.: mximo de IOs por segundo, registrando a maior velocidade das
informaes.
Pasta "Usurios"
Arquitetura e Instalao - 27
Exerccio 5 - Para monitorar usurios:
ID
Relaciona o nmero de identificao do usurio.
Usurio
Relaciona o nome do usurio.
IOs
Relaciona o nmero de entradas e sadas do usurio.
Tabela
Relaciona o nmero de tabelas movimentadas pelo usurio.
Procedure
Relaciona qual procedure est sendo executada.
Comentrios
Descreve a Rotina sendo executada pelo usurio.
2.Para monitorar os processos em execuo pelo usurio est disponvel o boto
"Rastrear" .
3.Para encerrar a conexo do usurio, clique no boto "Encerrar" .
28 Arquitetura e Instalao
Boto "Atividades"
Arquitetura e Instalao - 29
Boto "Locks"
O boto "Locks" relaciona na tela os usurios que esto utilizando o sistema no exato
momento.
Visualizar por
ID - Relaciona os registros pela identificao do usurio.
Ambiente - Relaciona os registros por ambiente DbAccess.
ID
Relaciona o nmero da thread de identificao do usurio.
Ambiente
Relaciona o nome do ambiente DbAccess.
Tabela
30 Arquitetura e Instalao
Relaciona a tabela em uso.
Recno
Relaciona o registro que est em uso para o usurio.
Boto Funcionalidade
Rastrear
Arquitetura e Instalao - 31
2. Os dados so atualizados constantemente, ou seja, estas informaes esto sempre em
movimento na tela.
Faz a pausa da tela, para checar as instrues que esto sendo enviadas
Pausa
para o banco de dados.
32 Arquitetura e Instalao
Pasta "Mensagens"
Na pasta "Mensagens" so apresentadas as mensagens de erro e ocorrncias reportadas
pelo servidor de banco de dados.
Data
Apresenta a data da mensagem.
Hora
Relaciona a hora da mensagem.
Mensagem
Relaciona as mensagens de erro do banco.
Arquitetura e Instalao - 33
2. Para controlar as informaes , esto disponveis os botes:
Boto Descrio
34 Arquitetura e Instalao
Exerccio 10 Como configurar a Conexo com o ByYou DbAccess no Protheus 11:
1 . Selecione as seguintes opes Iniciar + Programas + Protheus 11 +
Ferramentas + Assistente de Configurao do Servidor;
Arquitetura e Instalao - 35
3 . Clique no icone Editar Configurao, preencha as Configuraes, informando os
dados a seguir:
36 Arquitetura e Instalao
Utilizando o ByYou DbAccess
Usurios logados
Bancos de dados em utilizao
Ambiente dos bancos
Testes de conexo
Monitores de ndices
Informaes gerais, etc.
DBMonitor
Arquitetura e Instalao - 37
Informaes: Relao dos dados de registro do DbAccess.
Usurios: Relao dos usurios conectados ao DbAccess.
Mensagens: Apresentao de mensagens referentes a erros e ocorrncias do banco
de dados.
Configuraes: Configurao de acesso, senhas, usurios, chaves, para cada um dos
bancos de dados suportados.
Assistentes: Configurao e monitoramento de conexes e ndices gerados.
38 Arquitetura e Instalao
Parmetros do Atalho do Application Server
Parmetro (-Install)
Se o ByYou Application Server no for instalado como um Servio durante a Instalao,
isto pode ser realizado, executando-o com a opo de Linha de Comando. Ao optar por
executar o ByYou Application Server, como um Servio durante o processo de Instalao,
o mesmo ser adicionado Lista de Servios e iniciado.
O administrador poder ento Iniciar ou Parar o Servio, por meio do Item Services, do
Painel de Controle do Windows, ou ainda remov-lo do servio, pelo Parmetro -Remove.
Arquitetura e Instalao - 39
6. Acrescente o Parmetro -Console, no Final do Atalho, para que o ByYou Application
Server possa ativar a console do Protheus 11, informando os dados a seguir: C:\TOTVS
11\Microsiga\Protheus\bin\appserver CONSOLE;
40 Arquitetura e Instalao
Parmetros do Atalho do Smart Client
O ByYou Smart Client pode receber parmetros de inicializao, assim como o ByYou
Application Server.
Estes Parmetros servem para configurarmos o ByYou Smart Client em sua inicializao.
As opes de Linhas de Comando, do ByYou Smart Client, so as seguintes:
-Q (Quiet) Indica que o ByYou Smart Client (SmartClient) no dever mostrar
o Splash (Imagem de Apresentao) e a tela de identificao de parmetros
iniciais, necessita ser acompanhada da (Clusula P);
-P (Main Program) identifica o programa (APO) inicial;
-E (Environment) nome da seo de Environment, no (Ini do Server), que ser
utilizada, para definies gerais;
-C (Connection) nome da seo de conexo, que ser utilizada, para a conexo
ao ByYou Application Server;
-L (ByYou Smart Client Log File) Para No Conformidades, que ocorram no
ByYou Smart Client, Antes que este possa se conectar ao ByYou Application
Server, gerado um Arquivo de Log, no diretrio de execuo do ByYou Smart
Client, esse arquivo tem o nome definido pelo nome do executvel
(SmartClient), mais um caracter de underscore (_), mais o nome da mquina em
que o ByYou Smart Client est sendo executado com a extenso (.LOG).
Esta opo permite informar um nome especfico para a gerao deste arquivo
de Log, visando automatizaes especficas que necessitem saber quando uma
No Conformidade ocorreu no ByYou Smart Client. Por exemplo:
Impossibilidade de Conexo;
-M (AllowMultiSession) Permite mltiplas instncias (Cpias) do ByYou Smart
Client, na mesma mquina, por padro o Protheus no permite.
Arquitetura e Instalao - 41
Exerccio 13 Como configurar os parmetros do atalho do SmartClient:
1. Acesse o Windows Explorer;
2. Localize a pasta C:\TOTVS 11\Microsiga\Protheus\bin\smartclient;
3. Crie um atalho do Arquivo SMARTCLIENT.EXE, para a rea de Trabalho, do
Windows;
4. Clique com o boto direito do mouse no atalho criado;
5. Selecione a opo Propriedades;
6. Clique na pasta Atalho e observe que o caminho do atalho, deve
ser : C:\TOTVS 11\Microsiga\Protheus\bin\smartclient\ SMARTCLIENT.EXE
7. Acrescente os Parmetros, informando os dados a seguir:
C:\TOTVS 11\Microsiga\Protheus\bin\smartclient\ SMARTCLIENT.EXE
Q P=Sigacom C=TCP E=Environment;
42 Arquitetura e Instalao
Acessando o Protheus 11 pela Primeira Vez
Exerccio 14 - como acessar o protheus pela primeira vez:
Arquitetura e Instalao - 43
4.Escolha o tema de interface desejada:
44 Arquitetura e Instalao
5. Confirme a Data Base, Empresa/Filial e Ambiente;
Arquitetura e Instalao - 45
9. Ao aparecer a janela Diretrio dos Arquivos de Dados, a partir do Servidor,
selecione o diretrio \Data\, confirme-a.
46 Arquitetura e Instalao
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 AppServer.INI, que o
Arquivo de Configurao, utilizado pelo ByYou Application Server e no arquivo
SmartClient.INI, que indica as configuraes, para o ByYou Smart Client.
A saber, existem os seguintes Arquivos de Configurao no Protheus 11, os quais esto
localizados na pasta \BIN do Protheus 11:
Arquitetura e Instalao - 47
ByYou Development Studio (DevStudio)
48 Arquitetura e Instalao
Atualizao e e Backup do Protheus 11
Nomenclaturas do Protheus 11
As principais Nomenclaturas do Protheus 11, so referentes Rotinas de Atualizao e
Desenvolvimento. So elas:
Build
a verso dos executveis e Dlls. A Build do sistema pode ser identificado por meio das
seguintes opes Ajuda + Sobre, dentro de qualquer Mdulo do sistema, ou na tela de
console do ByYou Application Server.
Repositrios RPO
Arquivos Binrios Compilados, os quais contm instrues de funcionamento, como
Funes e Aplicaes de todos os Mdulos do ERP, utilizadas pelo Protheus 11 e seguem
a seguinte nomenclatura:
TTDP101.RPO
Onde:
TT TOTVS;
P Lngua.
Exemplo:
P=Portuguese, E=English, S=Spanish
Arquitetura e Instalao - 49
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:
TTDP101.PAT
Onde:
TT Totvs 101;
P Idioma
Exemplo:
P=Portuguese, E=English, S=Spanish
ADVPL
a linguagem de programao, desenvolvida e utilizada pela MICROSIGA no que diz
respeito customizaes de funes, que sero implementadas no Protheus 11.
Essa linguagem utiliza o Padro (Xbase), ou seja, uma linguagem estruturada e sua
extenso sempre ser .PRW.
50 Arquitetura e Instalao
Atualizao de BUILD
A Atualizao da Build consiste em atualizar todas as alteraes realizadas, dentro da
estrurutra do Protheus 11, 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 portal TOTVS atualizado, com excesso dos Patches, que no tm data
exata para a Atualizao.
Arquitetura e Instalao - 51
3 . Escolha ByYou Binrio na ComboBox Categoria e clique em Buscar.
52 Arquitetura e Instalao
6. Faa o Download do Repositrio de Objetos, de acordo com seu ambiente de trabalho
(Code Base, Ctree ou Top Connect).
7 . Para baixar Updates, proceda da mesma forma como foi feito anteriormente, mas
Categoria busque por Update de Programas.
8 . Para baixar Patches, proceda da mesma forma como foi feito anteriormente, mas
Categoria busque por Patch de Programa. Existem Patches por mdulos e genricos, ou
seja, aplicam-se ao prprio ambiente do Protheus, chamado Lib.
Arquitetura e Instalao - 53
Verifique sempre as Datas dos Arquivos, que voc
estiver fazendo o Download, para garantir que no estar
sobrepondo uma Atualizao, que j se encontra correta;
Por praticidade, crie sub-pastas dentro da pasta updates
organizado por mdulos ou reas como FIN, FAT, GPE
pois assim ficar mais fcil documentar os Arquivos de
Atualizao;
Os patches devem ser gravados em alguma pasta dentro
do rootpath, utilize uma pasta chamada \Updates\
dentro de Protheus_Data para esse fim, arquivos
gravados diretamente na \protheus_data\ no sero
visveis pelo DevStudio;.
A atualizao de Patches, assim como as compilaes de
fontes, exige que se tenha Acesso Exclusivo ao Sistema,
ou seja, no deve existir nenhum usurio ou rotina
utilizando o repositrio.
54 Arquitetura e Instalao
Exerccio 17 Como Atualizar e Aplicar Patches:
1. Acesse o Aplicativo DevStudio;
Arquitetura e Instalao - 55
4 . Ser necessrio informar o Usurio e Senha do Administrador;
5 . Posicione com o cursor sobre o mesmo, confirme e Aplicao da Patch, ser iniciada.
56 Arquitetura e Instalao
Configurao do Protheus 11
Ambientes;
Servidor de Licenas;
Mdulos Web;
Servidor Internet (HTTP/FTP);
Hosts / URLs HTTP;
Processos Comuns;
Processos WEB / WEBEX;
Conexo (Server/Remote);
ByYou DbAccess;
Servidor CTREE;
Balanceamento de Carga;
Servio do Windows NT/2000 (*);
Geral.
Protheus Search
(*) Esta opo apenas ser apresentada caso o ByYou Application Server esteja sendo
executado em um ambiente Microsoft Windows.
Arquitetura e Instalao - 57
Servidor", na pasta "Protheus 11\Ferramentas" no menu Iniciar do Windows, ou pelo
aplicativo Wizard.exe, disponvel no diretrio \BIN\SmarClient.
importante ressaltar que a maioria das configuraes editadas por este Assistente
apenas tero validade quando o servidor do Protheus for finalizado e reiniciado. Porm,
determinadas configuraes podem ser reconhecidas sem que o TOTVS Application
Server seja reiniciado, e j passarem a fazer efeito, inclusive interferindo nos processos
(Threads) em execuo no servidor, o que pode acarretar em problemas no processamento.
Portanto, recomendvel que a utilizao deste assistente seja realizada sem que existam
processos em execuo no servidor e sem que existam usurios ou estaes remotas
conectadas ao ByYou Application Server.
Ao ser executado, o Wizard identifica, no arquivo AppServer.ini, as configuraes
atualmente definidas e apresenta a janela principal de trabalho do assistente.
58 Arquitetura e Instalao
Configuraes de Ambientes
Arquitetura e Instalao - 59
Configurao de Ambiente para Testes
[environment] [teste]
Sourcepath= Sourcepath=
Rootpath= Rootpath=
Startpath=\system\ Startpath=\system\
Rpodb=top Rpodb=top
Rpolanguage=portuguese Rpolanguage=portuguese
Rpoversion=110 Rpoversion=110
Topserver=localhost
Topdatabase=mssql
Topalias=teste
60 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.
Arquitetura e Instalao - 61
3 . Altere o campo Nome da Lista de Servios do Windows para MICROSIGA;
62 Arquitetura e Instalao
Configurao do Balanceamento de Carga
Arquitetura e Instalao - 63
3. Preencha as Configuraes, informando os dados a seguir:
64 Arquitetura e Instalao
5. Preencha o segundo Servidor Balanceado, informando os dados a seguir:
Arquitetura e Instalao - 65
Teste de Balanceamento
66 Arquitetura e Instalao
Modelo Base do AppServer.INI
[TopConnect]
DataBase=MSSQL
Server=localhost
Alias=producao
Port=7890
[LICENSECLIENT]
Server=10.0.0.1
Port=2222
[LICENSESERVER]
Enable=0
Port=2222
ShowStatus=1
Arquitetura e Instalao - 67
[Drivers]
Active=TCP
[TCP]
TYPE=TCPIP
Port=1234
[ServerNetWork]
Servers=Server_01,Server_02
MasterConnection=1
[Server_01]
Server=localhost
Port=1235
Connections=1
[Server_02]
Server=localhost
Port=1236
Connections=1
[Service]
Name=Totvs
DisplayName= Protheus 11
[GENERAL]
InactiveTimeOut600
[HTTP]
Enable=1
Path=C:\Protheus10\Bin\smartclient_ActiveX
Port=80
RpcEnv=Environment
InactiveTimeOut=30
68 Arquitetura e Instalao
[UPDATE]
Enable=1
PathWindows=p:\smartclient_upd
PathLinux=p:\smartclient_upd
Arquitetura e Instalao - 69
Configurao do ByYou Smart Client
70 Arquitetura e Instalao
Onde:
Config: Identifica as Informaes Gerais de Configurao, do TOTVS
SmartClient. Contm a lista dos ltimos Programas Iniciais, executados no do
TOTVS SmartClient.
Drivers: A seo Drivers define quais os Protocolos de Conexo podero
ser utilizados, para que o Terminal conecte-se ao ByYou Application Server e
tambm qual o Nome do Servio.
Drivers: Identifica qual o Servidor que dever ser localizado para a conexo
com o ByYou Application Server e tambm qual ser a porta utilizada para esta
Conexo.
Arquitetura e Instalao - 71
Protheus 11 Monitor
Isto ser til quando precisarmos realizar alguma manuteno e precisarmos evitar que
outros usurios se conectem;
Desconectar Usurios:
Esta opo possibilita desconectar usurios logados no sistema, independente da operao
que esteja sendo realizada.
Usurio:
Ser o nome do Usurio, na rede local.
Para Conexes Remotas, este nome estar em branco;
72 Arquitetura e Instalao
Computador:
Nome da mquina, onde o ByYou Smart Client estar sendo executado;
Conexo:
Indicar a data e hora, de incio da Conexo do ByYou Smart Client;
Tempo de uso:
Indicar o tempo em horas, minutos e segundos, desde que ByYou Smart Client estar se
conectando;
Programa Inicial:
Ser o nome do Programa Inicial (APO), com o qual o ByYou Smart Client ter iniciado a
execuo;
Environment:
Nome do Environment (Ambiente) que estar sendo utilizado pelo terminal;
Arquivos Abertos:
Nmero de arquivos (tabelas) que estaro abertos na Estao.
Arquitetura e Instalao - 73
Instalando o ByYou Smart Client
O ByYou Smart Client pode ser instalado fisicamente em uma estao, por meio de uma
opo da tela inicial de instalao do Protheus 11.
Este recurso til para instalao do ByYou Smart Client em computadores que no esto
conectados rede local, ou seja, que necessitam que os executveis estejam
fisicamente na mquina. Por exemplo, em casos de filiais que acessam a matriz por uma
linha discada atravs do protocolo TCP/IP.
Devemos ressaltar que o procedimento de instalao do TOTVS Smart Client nas
estaes s recomendado em casos especficos (utilizao remota, alto trfego
de dados na rede, etc). Preferencialmente, indicado o uso centralizado do ByYou
Smart Client no Servidor, pela criao de atalho para acesso.
74 Arquitetura e Instalao
Clique em Avanar e a janela de bem-vindo apresentada.
Leia o contrato de licena com ateno e clique no boto "Sim" para prosseguir.
Arquitetura e Instalao - 75
4. Indique o caminho onde o ByYou 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;
76 Arquitetura e Instalao
6. Clique no boto de opo "Sim", se utilizar os ambientes de Automao Comercial,
desta forma, sero instalados os arquivos de DLLs para comunicao com os perifricos
homologados;
Arquitetura e Instalao - 77
8. Verifique a configurao de instalao e confirme o seu incio, clicando no boto
"Avanar". Se precisar alterar alguma opo, clique em "Voltar";
78 Arquitetura e Instalao
Auto-Atualizao do ByYou Smart Client
Esta opo facilita a Atualizao das Estaes dos usurios que possuam o ByYou Smart
Client instalado.
Dessa maneira, todas as Estaes tero a sua Build atualizada automaticamente, assim que
o usurio tentar conectar-se ao sistema.
[UPDATE]
Enable=1
PathWindows=X:\SMARTCLIENT_UPD
PathLinux= X:\SMARTCLIENT_UPD
Onde X:\ a unidade onde esto gravados os arquivos atualizados do smartclient
4 . Salve o Arquivo e encerre o Editor de Textos;
5. Na sequncia, tente conectar-se ao Protheus 11, por meio das opes Iniciar +
Programas + ByYou Smart Client;
6. Repare que, assim que o ByYou Smart Client tentar conectar-se ao ByYou
Application Server, ir aparecer tela com mensagem de incompatibilidade
Arquitetura e Instalao - 79
7. Confirme a atualizao e observe a regua de progresso
8. Ao final, o ByYou Smart Client estar atualizada. Ser necessrio clicar novamente no
atalho do smartclient para executa-lo j na verso atualizada.
80 Arquitetura e Instalao
Configurao dos Recursos para Web
SmartClient Activex
O acesso ao ByYou Smart Client tambm pode ser realizado, por meio de um Browser de
Acesso Internet.
Este tipo de acesso permite que o Protheus 11 seja acessado em qualquer lugar, para isso
basta que seja configurado o (Web Server) e que o usurio, que utilizar o ByYou Smart
Client, tenha acesso Internet.
[HTTP]
Enable=1
Path=C:\Protheus10\Bin\smartclient_ActiveX
Port=80
RpcEnv=Environment
InactiveTimeOut=30
Arquitetura e Instalao - 81
3 . Acesse o Browser de Internet e digite na barra de Endereos os dados a seguir:
Http://Nome do Servidor/ SmartClient.htm;
Aps uma breve espera, ser solicitado o permisso para instalar a ferrramente ActiveX;
82 Arquitetura e Instalao
Web Print e WebSpool
A opo de WebPrint serve para que seja possvel a impresso de relatrios por meio do
uso de um Browser de Internet.
Atravs desta opo, ser possvel imprimir relatrios do Protheus 11, a partir de qualquer
estao que possua o SmartClient Activex instalado e uma conexo de Internet
configurada.
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 - 83
Viso Tcnica
Customizaes
Flexibilizar sem despadronizar.
Esta a palavra de ordem das Ferramentas do Protheus 11.
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.
Estas 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);
Expresses nos Prprios Campos (Validaes);
Frmulas;
Criao de Funes (Customizaes);
Relatrios;
Pastas Cadastrais;
Consultas Padres;
Perguntas e Respostas;
Sequncia de Documentos;
Modelo de Entidade e Relacionamento;
Schedule de Processos;
Pontos de Entradas;
Integraes (Excel, Word, Crystal Report, Project, Lotus 123).
84 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
nas fontes, alm de deixar confusa a Lgica dos Programas.
Mas vlida em determinadas circunstncias.
O Protheus 11, tem no total 2096 Parmetros que devem ser todos cuidadosamente
configurados, de acordo com as regras de negcios de cada empresa.
Arquitetura e Instalao - 85
Tabelas (SX5)
Da mesma forma, o Arquivo de Tabelas SX5 so mini-arquivos armazenadores de dados
especficos de cada Empresa e tem como finalidade Customizar Situaes, que dependam
de um conjunto de registros que dificilmente necessitaro de alteraes, tais como: Tipificar
os Produtos, os Grupos, os Tipos de Notas Fiscais, os Pagamentos, Feriados, etc.
Isso facilita o preenchimento dos campos pelo usurio e ao mesmo tempo faz a respectiva
validao quanto a informao digitada no mesmo.
86 Arquitetura e Instalao
Linguagem de Programao ADVPL
At aqui, falamos em customizaes, que no envolvem Cdigos de Programao.
So importantes, porm limitadas quando se quer algo mais especfico.
O AdvPl, por sua vez, uma Linguagem Estruturada que, embora compilada, tratada
pelo Sistema como uma Funo, e armazenada em um arquivo binrio denominado
Repositrio de Objetos (RPO).
Sempre que um usurio acessa algum mdulo do sistema, automaticamente realizada uma
carga dinmica deste RPO, desta forma todos os recursos existentes nesse arquivo sero
disponibilizados, para execuo imediata.
Gatilhos (SX7)
So disparados, quando se digita alguma informao nos Campos das Telas de Entradas de
Dados, ou seja, trata-se da atualizao de campos dependentes na tela de digitao a partir
do preenchimento de um Campo Origem, obedecendo uma determinada Regra, para tal
preenchimento.
Muitas vezes, para que a Regra atenda a determinadas situaes pode-se desenvolver
Funes em ADVPL e cham-las atravs das regras dos gatilhos.
Com ela, em todos os campos onde se pode escrever uma expresso, possvel evocar-se
uma funo, cujo retorno definir o seu contedo.
Funes
De forma anloga, e considerando que toda opo de menu do Protheus 11 na verdade
uma funo, possvel se desenvolver: novos relatrios, consultas, cadastros e mesmo,
sub-mdulos e acess-los diretamente atravs do menu.
Chegado a este ponto, pode-se dizer que o nico recurso que ainda faltaria, para se ter uma
flexibilizao completa, seria o acesso s fontes. Isto foi resolvido, em parte, com os
Pontos de Entradas.
Arquitetura e Instalao - 87
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 de Ponto de Entrada, citada na documentao do Protheus 11 e compila-se o
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 site tdn.totvs.com h vasta documentao sobre os pontos de entrada disponveis no
Protheus 11.
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. So 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.
Esta 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.
88 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.
Arquitetura e Instalao - 89
O fato de existirem dois arquivos ao invs de um, segue a seguinte Estrutura:
O Arquivo SXF sempre controla o prximo Nmero da Sequncia, e o Arquivo SXE grava
sempre mais um, isso garante maior segurana no momento da gerao destas sequncias.
90 Arquitetura e Instalao