Arquitetura e Instalação - P11

Arquitetura e Instalao
2 Arquitetura e Instalao

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

Arquitetura e Instalao - 3
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:
Dominar e articular com propriedade a linguagem prpria soluo Microsiga.

Definies

Caractersticas da Tecnologia
O Protheus 11 uma tecnologia desenvolvida a partir do Sistema Advanced, que teve a
Inteligncia toda dividida em quatro camadas, a saber: Servidor de Aplicao
Application Server (AppServer), SmartClient (SmartClient), 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 seja ele
Codebase, ADS, Ctree ou DbAccess.
uma Aplicao Thin-Client que realiza apenas a Interface com o usurio.

Principais Caractersticas da Tecnologia Protheus 11
Possibilidade de grande variao de Topologias de Redes e Processamentos
Distribudos;
Baixo trfego de rede entre Application Server e o Smart Client;
Utilizao de Configuraes, possibilitando o uso de Conexes Simultneas, por
meio de Protocolos diferentes e o acesso a diferentes Repositrios de APOs e
Diretrios (O que permite o uso de diferentes idiomas e Interfaces, acessando a
mesma Base de Dados);
Diferentes possibilidades de impresso de relatrios;
o Arquivo;
o Spool;
o Direto na Porta;
o Email;
o Planilha;
o HTML.

Algumas opes de impresso so disponveis mediante
configurao de parmetros;
As impresses realizadas em Arquivo baixam o trfego na
Rede;
As impresses realizadas em Planilha so geradas em XML;
Opes de impresso so privilgios que podem ser definidas por
usurios ou grupos;

Camadas do Protheus 11

O Protheus 11 dividido em quatro camadas. So elas:

Servidor de Aplicao - Application Server

O Application Server (AppServer) 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 (Advanced Protheus Objects)
individuais em Repositrios.
Isso permite que as mesmas sejam carregadas e descarregadas dinamicamente da memria
da mquina em que o Servidor est sendo executado, ou seja, de acordo com a necessidade
de execuo dos Terminais conectados.
Isto facilita a atualizao aps correes de No Conformidades ou Criao de Melhorias,
pois apenas os APOs modificados necessitam ser atualizados.
Desse modo a Performance Alta e no requer muito da mquina para a execuo do
servidor.

Terminais Thin - Smart Client Protheus

O SmartClient a aplicao encarregada da Interface com o usurio. No existe
Processamento Local, por isso o Trfego de Rede entre o Terminal e o Servidor de
Aplicao Baixo, tratando apenas de comandos, para o Desenho das Telas e tratamento
do teclado e mouse.

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.


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.

Aplicativos do Protheus 11

O Protheus 11 possui basicamente quatro aplicativos utilizados com diferentes finalidades.

So eles:

Application Server (AppServer)
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.

Smart Client - (SmartClient)
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.

Development Studio (DevStudio)
Trata-se do Ambiente de Desenvolvimento Integrado do Protheus 11. por meio 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.

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 .


Instalao do Protheus 11

Neste tpico do curso, iremos Instalar o Application Server e o Smart Client,
juntamente com todas as Ferramentas que o Protheus 11 disponibiliza.
O primeiro passo para instalao do Protheus 11 a instalao do Application Server.
A instalao do AppServer, assim como do SmartClient e das ferramentas auxiliares
(DevStudio, Wizard e o Monitor) realizada por meio do Instalador do Server, localizado
no DVD do Protheus 11.
Este programa de instalao permite ao administrador instalar o Protheus 11 de dois
modos:

Exerccio 1 - Como Instalar o Protheus para bases de dados relacionais (DbAccess):
AutoRun
O AutoRun executado automaticamente se o Windows estiver configurado com este
recurso. Porm, possvel execut-lo pelo comando:
X:\AUTORUN.EXE em que: X a unidade de DVD

Execuo dos seguintes programas a partir do respectivo DVD

Instalao do Server no Windows
WINDOWS\BYYOU APPLICATION SERVER\SETUP.EXE

Instalao do Client no Windows
WINDOWS\BYYOU SMARTCLIENT\SETUP.EXE

Instalao do Help no Windows
\WINDOWS\HELPONLINE\PORTUGUESE\SETUP.EXE

1. Coloque o DVD no drive e aguarde a exibio da tela de abertura conforme a seguir.

Na parte inferior da tela, so apresentados os idiomas disponveis para apresentao do
instalador do Protheus. Clique no cone correspondente ao idioma que deseja utilizar.

No lado direito da tela, so apresentadas as opes dos aplicativos para instalao:
Instalao do ByYou Application Server
Instalao do ByYou Smart Client
Instalao do ByYou DbAccess
Instalao do ByYou Processor
Instalao do Office Interface Integration
Instalao do Protheus Search
Instalao do Help Online


2. Clique na opo ByYou Application Server.
O instalador ser iniciado. A janela para escolha de idioma apresentada.

3. Tela de Bem-Vindo.

4. Contrato de licena.

5. Local de instalao do Protheus 11.

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, diminui o risco de erros em eventuais
desinstalaes do Sistema


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".

importante, antes de iniciar a atualizao, fazer backup
das bases de dados, arquivos de configuraes (dicionrio
de dados, parmetros, tabelas, CNAB, SISPAG, etc),
menus e programas especficos dos usurios.
Aps a instalao, atualize os atalhos de acesso ao TOTVS
Application Server e ByYou Smart Client para o novo caminho
e execute o programa Assistente de Configurao para importar
o arquivo de configurao .INI.

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.

7. Definies do Repositrio de objetos.

Nesta tela, deve-se selecionar:
Os tipos de repositrios disponveis no Protheus:
SQL (DbAccess - integrado com os bancos de dados homologados);
ADS (Advantage Database Server);
ISAM padro DBF;
CTree.
Por meio de alteraes no arquivo de configurao do Application Server e cpia do
repositrio correto, possvel fazer com que a mesma instalao do Protheus utilize dois
tipos de base de dados.

O idioma do RPO a ser instalado.

O pas para instalao do arquivo "SXS<pas>.TXT". Este arquivo gravado
no diretrio\Protheus_Data\SYSTEMLOAD, sendo responsvel pela criao do
dicionrio de dados e demais arquivos especficos para o pas selecionado.

Selecione SQL, Portugus e Brasil respectivamente para Banco de dados, Idioma e
Pas e clique no boto Avanar para prosseguir.


8. DLLs do Sigaloja.

Escolha Sim se utilizar os ambientes de Automao Comercial, desta forma, sero
instalados os arquivos de DLLs para comunicao com os perifricos homologados.

9. Confirmao das configuraes.

Verifique as configuraes de instalao e confirme o incio;
Avanar. Se precisar alterar alguma opo, clique em Voltar.

10. Status da Instalao.

Informadas as variveis de instalao, iniciado o processo de descompactao e cpia dos
arquivos.

11. Servidor de Licenas.

Nesta janela, deve-se informar o nome ou endereo IP (prefervel) do Servidor de Licenas
e a porta de conexo.
Se o equipamento onde o TOTVS Application Server est sendo instalado tambm
for o Servidor de Licenas, deve-se marcar a caixa "Este servidor tambm um servidor
de licenas".

12. Executar o Assistente (Wizard).


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.

Clique no boto "No" se no desejar executar o Assistente de Configurao, neste
momento. O Assistente de Configurao pode ser acessado aps a instalao, por meio do
menu Iniciar, pasta "Protheus 11/Ferramentas/Assistente de Configurao".

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).

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.


2. Contrato de Licena. Leia o contrato de licena com ateno e clique no boto Sim para
prosseguir

4. Pasta de instalao do Help. Escolha a pasta e clique em Avanar.

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.


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.

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

O servidor de licenas uma instalao do AppServer, sem definio de ambientes e que
deve conter na pasta do aplicativo um arquivo totvslic.key ou applylic.key, enviado pela
TOTVS, que contm as licenas que o cliente adquiriu.
O servio de licenas definido pela presena da seo [licenseserver]. Como o exemplo
abaixo:
[licenseserver]
Enable=1
Port=5555

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


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).

Exerccio 2 Como instalar o ByYou DbAccess:
1. Clique na opo ByYou DBAccess. A janela de escolha do idioma ser apresentada.

2. O Install Shield ser iniciado. A janela de Bem-vindo apresentada.

3. Local de destino.

4. Clique no boto Avanar para prosseguir.

5. Clique no boto Avanar para iniciar o processo de instalao.


6. Clique no boto Concluir e finalize a instalao.

DbAccess Monitor

Na opo Monitor possvel dar incio s operaes de conexo do servidor e,
alm disso, sair do aplicativo.

Exerccio 3 - Para utilizar a opo de Monitor:

1. Na janela principal do DbAccess, 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;

2. Selecione uma das opes, conforme necessidade;


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 DbAccess, alm de apresentar as
informaes do aplicativo.

Pasta "Informaes"

Na abertura do Monitor apresentada a primeira pasta, "Informaes", com os
dados de registro do DbAccess, verso, quantidade de usurios conectados, tabelas em
uso, servidor de base etc.

Exerccio 4 - Para gerenciar os dados da pasta "Informaes":

1. Os dados apresentados como "Informaes" do DbAccess, referem-se ao seguinte:

Verso do DbAccess e respectiva Build.
Nmero de usurios registrados para utilizao.
Servidor em que atua o DbAccess (o logotipo apresentado varia conforme
o ambiente utilizado pelo servidor).

2. Na rea "Estatsticas", o monitor apresenta valores e grficos referentes a:

Usurios: quantidade de usurios utilizando o banco de dados.

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.

3. O boto "Desabilitar conexes" deve ser utilizado para no permitir novas
conexes no DbAccess.

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 5 - 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.

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" .

Boto "Atividades"

O boto "Atividades" permite relacionar e salvar as respectivas atividades do usurio no
sistema.

Exerccio 6 - Para verificar as atividades de um usurio:

1. Na pasta "Usurios", posicione o cursor sobre o registro do usurio desejado,
e clique no boto
"Atividades".

Ser apresentada a tela para salvar as atividades do usurio.

2. Selecione o diretrio desejado e clique no boto "Salvar".
Observe no arquivo salvo as atividades que estavam sendo executadas pelo usurio.

O sistema retornar janela principal de usurios.

Boto "Locks"

O boto "Locks" relaciona na tela os usurios que esto utilizando o sistema no exato
momento.

Exerccio 7 - Para verificar as atividades de um usurio:

1. Na pasta "Usurios", posicione o cursor sobre o registro do usurio desejado, e clique
no boto "Locks".
O sistema apresenta nova tela, relacionando as informaes de atividade do usurio,
divididas em quatro colunas:

Visualizar todas as threads.
Permite visualizar os registros bloqueados de todos usurios.

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

Relaciona a tabela em uso.
Recno
Relaciona o registro que est em uso para o usurio.

2. Os dados so atualizados constantemente, ou seja, estas informaes esto sempre em
movimento na tela.

3. Na base desta tela, esto disponveis os botes:

Boto Funcionalidade
Salvar Grava os dados apresentados at o momento.
Fechar Fecha a tela de Locks.

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 8 - 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.

2. Na base desta tela, esto disponveis os botes:
Boto Funcionalidade
Copiar Copia a linha selecionada.

Pausa
Faz a pausa da tela, para checar as instrues que esto sendo enviadas
para o banco de dados.
Limpar Apaga os registros da tela, reiniciando o rastreamento das consultas.
Salvar Grava os dados apresentados at o momento.
Fechar Fecha a tela de rastreamento.
4. Quando selecionado o boto "Pausa", o Sistema cria um novo boto, o "Retomar" ,
utilizado para retornar movimentao inicial dos dados na tela.
5. Clique sobre o boto desejado, conforme necessidade.

Pasta "Mensagens"
Na pasta "Mensagens" so apresentadas as mensagens de erro e ocorrncias reportadas
pelo servidor de banco de dados.

Exerccio 9 - Para controlar mensagens:
1. As informaes so distribudas em colunas que, por sua vez, relacionam os seguintes
dados:

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 Descrio
Atualizar Atualiza as mensagens, datas e horrios apresentados.

Limpar
Apaga as mensagens apresentadas e respectivos horrios e
datas.
Salvar Grava as mensagens geradas e respectivas datas e horrios.

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;

2 . Abra a opo TopConnect e clique no item TopConnect;


3 . Clique no icone Editar Configurao, preencha as Configuraes, informando os
dados a seguir:

4 . Clique no opo Finalizar e confirme as telas a seguir;

Para Configurarmos o DbAccess, devemos ter previamente
instalado o Banco de Dados e tambm criado uma fonte de dados
ODBC, localizado no Painel de Controle do Windows, pois por
meio dele que o DbAccess localiza o Banco de Dados.
Nota sobre a Configurao do DbAccess:
1. Aps instalar o DbAccess: entrar Servios do Windows. A seguir
deixar o DbAccess iniciado e com iniciao automtica.
2. Instalar o servio do Banco de Dados e o Gerenciador do banco
(por exemplo o MSSQL).
3. No gerenciado do banco de dados, crie um novo banco de
dados obedecendo a homologao de paginao para cada banco
(collation no MSSQL, character set no Oracle, etc.
4. ODBC Criar uma System DSN. Observar que:
Nos Sistemas Operacionais de 32 e 64 bits o aplicativo chama-se
Odbcad32.exe. Existe DbAccess para as duas arquiteturas e
Bancos de dados tambm para as duas arquiteturas.
Porm, caso o SO seja 64 bits e, por algum motivo, seja necessrio
utilizar o DbAccess 32 bits, deve executar o aplicativo
odbcad32.exe que encontra-se na pasta c:\windows\syswow64\.

Utilizando o ByYou DbAccess

Todas as configuraes e monitoramentos possveis atravs do DBAccess ocorrem neste
monitor, permitindo gerenciar informaes como:

Usurios logados
Bancos de dados em utilizao
Ambiente dos bancos
Testes de conexo
Monitores de ndices
Informaes gerais, etc.

DBMonitor

Exerccio 11 - Para utilizar o DBAccess Monitor:

1. Acesse o cone do programa criado no sistema operacional: "DbAccess 4.2" ;
O sistema apresenta uma pequena janela referente s configuraes de Monitor.

2. Informe os dados necessrios e confirme.

1. A prxima tela apresenta as opes de gerenciamento de informaes do
DBAccess, subdividindo-as em pastas, sendo:

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.

Cada uma dessas pastas apresentam os campos necessrios informao dos
principais dados, fundamentais ao gerenciamento oferecido pelo DbAccess.

4. Na barra de ferramentas da tela Monitor, esto disponveis as opes:

Monitor: Informaes de conexo ao servidor.
Visualizar: Configurao da visualizao das informaes estatsticas.
Ajuda: Informaes sobre o aplicativo e acionamento dos itens de ajuda.

5. Acesse cada uma das opes conforme necessidade.

Parmetros do Atalho do Application Server

Para iniciarmos o Aplicativo AppServer.exe, devemos inicialmente entender seus
Parmetros de Inicializao:

Parmetro Console ou Debug como uma janela console.
Executado como uma Janela Console, as informaes recebidas das conexes com o
AppServer, estas conexes so exibidas diretamente na tela do console do Application
Server, bem como informaes de No Conformidades, e a execuo do ByYou
Application Server pode ser interrompida com o pressionamento da combinao de teclas
[Ctrl]+[Break];

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.

Exerccio 12 Como Configurar os Parmetros do servidor de aplicao do Protheus
11:
1. Acesse o Windows Explorer;
2. Localize a pasta C:\TOTVS 11\Microsiga\Protheus\bin\appserver;
3. Crie um atalho do arquivo APPSERVER.EXE, para a rea de Trabalho do Windows;
4. Clique com o boto direito do mouse no atalho e selecione a opo Propriedades;
5.Clique na pasta Atalho e observe que o caminho deve ser: C:\TOTVS
11\Microsiga\Protheus\bin\appserver;

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;

7. Confira os dados e confirme.

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.


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;

8. Confira os dados e confirme.

Acessando o Protheus 11 pela Primeira Vez
Exerccio 14 - como acessar o protheus pela primeira vez:

1.Execute o Servidor do Protheus 11, atravs do cone AppServer;

2. Execute o Client do Protheus 11, atravs do cone SmartClient;
3. Confira os dados e confirme os Parmetros Iniciais;


4.Escolha o tema de interface desejada:

5. Confirme Usurio Admin e senha em branco;

5. Confirme a Data Base, Empresa/Filial e Ambiente;

6. Os arquivos de Helps dos Campos, sero atualizados;

7. Na janela Localizao, selecione Brasil e confirme;

8. Agora o Protheus 11 ir criar os Arquivos do dicionrio de dados .

9. Ao aparecer a janela Diretrio dos Arquivos de Dados, a partir do Servidor,
selecione o diretrio \Data\, confirme-a.

Neste momento j temos todo o Ambiente pronto, para iniciar os
Testes necessrios, para a Efetiva Implementao do Protheus 11.


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:

AppServer.INI: Por meio dele poderemos configurar praticamente todas as
funcionalidades disponveis no Protheus 11.

SmartClient.INI: Aqui realizaremos as configuraes pertinentes ao ByYou
Smart Client, tais como: Direcionar a Conexo, Definir Protocolos Utilizados
entre outros;

DevStudio.INI: Neste arquivo ficam gravadas todas as opes do ByYou
Development Studio, tais como: Posio de Janelas, Fonte Utilizada, ltimos
Arquivos Abertos, Preferncias de Idioma, Diretrio para Localizao de
Fontes entre outros. (Este arquivo no deve ser alterado manualmente);

Adslocal.CFG: Este arquivo permite diversas configuraes como: Nmero de
Usurios, Nmero Mximo de Tabelas a serem abertas, Nmero de WorkAreas
disponveis entre outros.
(Este arquivo s utilizado para instalaes que possuam o Parmetro
localfiles = ads, no Arquivo AppServer.INI);

DevStudio.CFG: Aqui ficam guardadas todas as Configuraes de
Comunicao, realizadas no ByYou Development Studio (No deve ser alterado
manualmente).


ByYou Development Studio (DevStudio)

A Ferramenta de Desenvolvimento Development Studio a ferramenta de edio,
compilao e depurao de erros do Protheus.
Com esta Ferramenta, podemos aplicar Paths que so as Correes e/ou Atualizaes que
a TOTVS, envia a seus clientes.
A ferramenta de desenvolvimento DevStudio est apta a reconhecer a sintaxe da
Linguagem ADVPL, que uma Linguagem Proprietria da TOTVS.
A ferramenta de desenvolvimento DevStudio o nico modo de compilar os Arquivos de
Programas em APOs, para serem executados pelo AppServer.
Para a utilizao da ferramenta de desenvolvimento DevStudio, alguns pontos devem ter
ateno especial:

A instalao da ferramenta de desenvolvimento DevStudio, deve ser realizada
atravs do mesmo Programa de Instalao do ByYou Application Server ;
Para iniciarmos ferramenta de desenvolvimento DevStudio, devemos ter
necessariamente o AppServer iniciado na mesma mquina.

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;

D Tipo de banco de dados.
Exemplo:
D=Codebase, A=ADS, T=Top Connect, C=Ctree, B=Btrieve);

P Lngua.
Exemplo:
P=Portuguese, E=English, S=Spanish

110 Verso do Protheus 11.0.

RPO Identifica que se trata do Repositrio de Objetos.

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;

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

101 Verso do Protheus 11.0.

PAT Identifica que se trata do Arquivo de Correo do RPO.

Os arquivos de Patch tambm pode ter as seguintes extenses:
PTM, PAK, UPD e etc.

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.

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.

Exerccio 15 Como realizar Atualizaes de Builds:
1. Faa o Backup dos seguintes Diretrios: BIN, APO, INCLUDE, que se localizam
no diretrio C:\TOTVS 11\Microsiga\Protheus;
2. Para as atualizaes de build verso 11, acesse o site da TOTVS
www.totvs.com/suporte, faa o login informando usurio e senha,clique no link de acesso
da Central de Download, preencha as informaes sobre o produto (Microsiga,
Protheus,etc) e clique em pesquisar.


3 . Escolha ByYou Binrio na ComboBox Categoria e clique em Buscar.

4. Faa o Download do Binrio TOTVSTec para Plataforma Windows.

5 . Na sequncia, pesquise pela Palavra Chave 11 e Categoria Repositrio de Objetos e
clique em Buscar.

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.

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.

Exerccio 16 Como realizar as Atualizaes:
1. Baixe o servio do Protheus 11
2. Faa um Backup da pasta \BIN\
3.Faa um Backup do Repositrio que est na pasta \APO\
4. Descompacte os arquivo byyou binrio.zip, a partir dele, trs novos aquivos
compactados sero gerados:
APPSERVER.ZIP
SMARTCLIENT.ZIP
SMARTCLIENTACTIVEX.ZIP
Agora proceda da seguinte forma:
5. Descompacte o arquivo APPSERVER.ZIP, dentro do diretrio \AppServer\;
6. Descompacte o arquivo SMARTCLIENT.ZIP, dentro do diretrio \SmarClient\;
7. Descompacte o arquivo SMARTCLIENTACTIVEX.ZIP, dentro do diretrio
\SmarClint_ActiveX\;
8. Descompacte os arquivo Repositrio de Objetos.ZIP dentro do diretrio \Apo\;
9. Os arquivos de Update de Programas e Patch de Programa, devero ser descompactados
dentro do diretrio \protheus_data\updates\;

Exerccio 17 Como Atualizar e Aplicar Patches:

1. Acesse o Aplicativo DevStudio;

2 . Verifique se h uma Configurao de Ambiente criada, caso contrrio, ser necessrio
cri-la;

3 . Clique na opo Ferramentas, em seguida, Atualizao de repositrio;

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.

Configurao do Protheus 11

Wizard - Assistente de Configurao

O Wizard um assistente para configurao do Application Server e para instalao e
configurao dos mdulos Web, como: GE - Gesto Educacional, PP - Portal
Protheus, DW - Datawarehouse, BSC - Balanced Scored Card, WPS -
WebPrint/WebSpool, RH On-line - Terminal do Funcionrio, WS - Web Services, GPR
- Gesto de Pesquisas e Resultados e GAC - Gesto de Acervos.

Atravs do Wizard, possvel configurar os seguintes tpicos:

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.

O Wizard executado automaticamente ao final da instalao do Protheus 11, por
meio do assistente de instalao do DVD 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 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.

Exerccio 18 Como acessar o Assistente de Configurao do Protheus 11:
1. Selecione as seguintes opes Iniciar + Programas + Protheus 11 +
2. Caso o sistema apresente uma tela solicitando o Caminho para a localizao do arquivo
APPSERVER.INI, basta informar o Caminho a seguir:
C:\TOTVS 11\Microsiga\Protheus\bin\appserver
3. O Wizard ser carregado com sucesso.

Configuraes de Ambientes

As sees de Ambiente, ou Environment, so criadas para identificar o comportamento e
execuo do ByYou Application Server para as conexes clientes. Quando o Protheus
SmartClient se conecta ao ByYou Application Server, deve informar, entre outros
parmetros, o nome do Ambiente utilizado para que o ByYou 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 SmartClient se conecta e informa o
Ambiente que ser utilizado, o ByYou Application Server executa os procedimentos
necessrios: abre o repositrio de objetos compilado padro idioma, banco de dados e
verso indicados, e realiza a conexo com o banco de dados selecionado. possvel, por
meio 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 ByYou Application Server.
muito comum a criao de mais de um ambiente para o Protheus. Geralmente so
criados os ambientes Teste, Produo e Desenvolvimento.

Exerccio 19 Como configurar Ambientes:
2 . Clique na opo Ambientes e posicione no ambiente desejado;
3 .Na barra de ferramentas clique no icone Editar Ambiente; e verifique os Parmetros
do Ambiente Padro da Instalao, analisando os dados a seguir:
4 . Clique nos seguintes botes Avanar e Finalizar, para encerrar esta Configurao.


Configurao de Ambiente para Testes

Exerccio 20 Como configurar Ambientes para Testes:
1 . Duplique as Pastas, informando os dados a seguir:
Nova Pasta Descrio
\APOTST\ Repositrio Independente
\PROTHEUS_DATATST\ RootPath Independente

2. Crie um banco de dados Chamado Teste;
3. Crie uma System DSN apontando para o banco de Teste, nome-lo tambm como
Teste;
4 . Teste o novo DSN com o DbAccess Monitor
5. Edite o arquivo appserver.ini:
a) Duplique o ambiente [environment] e altere o nome do ambiente copiado para [teste];
b) Inclua as chaves abaixo no final do novo ambiente [teste]
topserver=localhost
topdatabase=MSSQL
topalias=teste
[environment]
Sourcepath=
Rootpath=
Startpath=\system\
Rpodb=top
Rpolanguage=portuguese
Rpoversion=110

[teste]
Sourcepath=
Rootpath=
Startpath=\system\
Rpodb=top
Rpolanguage=portuguese
Rpoversion=110
Topserver=localhost
Topdatabase=mssql
Topalias=teste

Exerccio 21 Seguindo os passos executados no exerccio anterior para criao do
Ambiente Teste, crie mais um ambientes [Desenvolvimento] e renomeie o [environment]
para [producao].

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 22 Como Configurar Servios do WinNT/ 2000:
1 . Selecione as seguintes opes Iniciar + Programas + Protheus 11 +
2 . Abra a opo Servio do WindowsNT/2000 e posicione sobre Service e clique no
icone Editar Configurao, confirme a tela a seguir;


3 . Altere o campo Nome da Lista de Servios do Windows para MICROSIGA;

4 . Clique no opo Finalizar;
5 . Confirme as telas a seguir, e o Servio do Protheus 11 estar Configurado com
sucesso.

Configurao do Balanceamento de Carga

A Tecnologia do Protheus 11 permite que a Execuo do Servidor possa ser distribuda em
mais de uma mquina ao mesmo tempo. Cada Servidor fica responsvel por um nmero
limitado de Requisies das Estaes, que se Auto-Gerenciam.
Este recurso utilizado quando a empresa possui processamento muito pesado e necessita
diminuir o tempo de resposta das Estaes com o Servidor.
Para este exerccio, iremos utilizar apenas (2 Servidores), mas a Tecnologia do Protheus 11
permite at (7 Servidores), sincronizados.

Exerccio 23 Como Configurar o Balanceamento do Servidor:
2. Clique na opo Balanceamento de Carga e no icone Novo Server para


3. Preencha as Configuraes, informando os dados a seguir:

4. Clique na opo Balanceamento de Carga e no icone Novo Server para

Note que o Servidor foi includo em Load Balance.

5. Preencha o segundo Servidor Balanceado, informando os dados a seguir:

6. Clique na opo Finalizar;
7. Confirme as telas a seguir e os servidores estaro Balanceados. Para saber mais sobre o
Assistente de Configurao, consulte o Manual do Usurio e/ou o Protheus 11 Help.

Teste de Balanceamento

Exerccio 24 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 dois Servidores, com uma Conexo cada, isto
far com que a primeira Requisio de Conexo entre no Sevidor 01, pois este possui
uma Conexo Simultnea apenas;
3. A segunda Requisio de Conexo ser direcionada para o Servidor 02;
4. Quando iniciarmos os Servidores AppServer.exe, veremos que estes tentaro se
conectar pelo Endereo IP, de cada um;
5 . Para que se possa Efetivar as Alteraes, no arquivo APPSERVER.INI, vamos testar
o Sincronismo dos Servidores.

Modelo Base do AppServer.INI

Abaixo temos um modelo completo do arquivo AppServer.INI, que acabamos de
configurar:
[environment]
SourcePath= C:\TOTVS 11\Microsiga\Protheus\apo
RootPath= C:\TOTVS 11\Microsiga\Protheus_data
StartPath=\system\
RpoDb=top
RpoLanguage=portuguese
RpoVersion=110
LocalFiles=ads
localdbextension=.dbf
PictFormat=DEFAULT
DateFormat=DEFAULT
Helpserver=localhost
Rpcenv=Environment

[TopConnect]
DataBase=MSSQL
Server=localhost
Alias=producao
Port=7890

[LICENSECLIENT]
Server=10.0.0.1
Port=2222

[LICENSESERVER]
Enable=0
Port=2222
ShowStatus=1

[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

[UPDATE]
Enable=1
PathWindows=p:\smartclient_upd
PathLinux=p:\smartclient_upd

Configurao do ByYou Smart Client

As Configuraes do SmartClient podem ser alteradas, editando-se o Arquivo
SmartClient.INI, localizado na Pasta \BIN\SMARTCLIENT.
Neste arquivo encontraremos as Configuraes do ByYou Smart Client, para conexo com
o AppServer, sendo este configurado manualmente.

Exerccio 25 Como Configurar o ByYou Smart Client
1 . Acesse o Windows Explorer;
2.Localize o Arquivo:
C:\TOTVS 11\Microsiga\Protheus\bin\asmartclient\SmartClient.INI;
3. Edite o Arquivo e siga os Parmetros a seguir:

4 . Vamos iniciar o entendimento do Arquivo de Configurao, observando a estrutura
bsica do arquivo SmartClient.INI a seguir:

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.

A Porta utilizada no TOTVS SmartClient dever ser a mesma que
est configurada no ByYou Application Server, caso contrrio a
Conexo no ser possvel.

5 . Confira os dados e confirme a Configurao do TOTVS SmartClient.

Protheus 11 Monitor

O Protheus 11 Monitor utilizado para monitorar as Conexes ao ByYou Application
Server.
Atravs dele pode-se:
Verificar as Conexes Ativas;
Enviar Mensagens, para uma ou mais Conexes;
Desabilitar Novas Conexes:

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.

As Informaes exibidas para cada Conexo sero as seguintes:

Usurio:
Ser o nome do Usurio, na rede local.
Para Conexes Remotas, este nome estar em branco;


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.


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.

Exerccio 26 - Para instalar o ByYou Smart Client com AutoRun:

No instalador, clique na opo ByYou SmartClient

Clique em Avanar e a janela de bem-vindo apresentada.

3. Clique no boto Avanar para prosseguir;

Leia o contrato de licena com ateno e clique no boto "Sim" para prosseguir.


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;

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;

7. Verifique a configurao de instalao e confirme o seu incio, clicando no boto
"Avanar". Se precisar alterar alguma opo, clique em "Voltar";


8. Verifique a configurao de instalao e confirme o seu incio, clicando no boto
"Avanar". Se precisar alterar alguma opo, clique em "Voltar";

9. Informadas as variveis de instalao, iniciado o processo de descompactao e
cpia dos arquivos;

10. Ao final da instalao, apresentada a tela sobre a concluso do processo. Clique no
boto Concluir para finalizar.

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.

Exerccio 27 Como habilitar a Auto-Atualizao do ByYou Smart Client:
1 . Instale o ByYou Smart Client na Estao de Trabalho, seguindo as Instrues
Padres de instalao;
2. Edite o arquivo C:\TOTVS 11\Microsiga\Protheus\bin\appserver \appserver.ini;
3. Insira a nova seo conforme as linhas a seguir:

[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


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.

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.

Exerccio 28 Como configurar o SmartClient Activex:

1.Acesse a pasta C:\PROTHEUS10\BIN\APPSERVER\ e edite o arquivo
APPSERVER.INI, acrecentando as seguintes instrues:

[HTTP]
Enable=1
Path=C:\Protheus10\Bin\smartclient_ActiveX
Port=80
RpcEnv=Environment
InactiveTimeOut=30

2. Acesse a pasta C:\TOTVS 11\Microsiga\Protheus\bin\smartclientActivex e edite o
arquivo SmartClient.htm, fazendo as seguintes modificaes:

<param name="Server" value="Nome do Servidor"">
<param name="TCPPort" value="1024">
<param name="Environments" value="Environment">
<param name="Language" value="1">
<param name="StartProgram" value="sigaadv">
<param name="ReadOnly" value="OFF">


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;

4 . Clique em Permitir Contedo Bloqueado... para continuar o processamento;

5 . O sistema apresentar a Tela de Parmetros Iniciais, para acesso ao
SmartClient Activex, com as opes de Programa Inicial e Ambiente,
editados no SmartClient.htm;

6 . Informe uma Senha Vlida e o Ambiente de Acesso desejado.

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.

Exerccio 29 Como utilizar a impresso de Relatrios via Webprint:
1. Acesse o Browser de Internet e informe na barra de Endereos os dados a seguir:
Http://Nome do Servidor/W_Aplogin.Apl

Para este recurso funcionar necessrio que no arquivo
AppServer.ini, na seo http, tenha a seguinte linha:
Rpcenv=Environment.

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.

No momento em que um Relatrio do WebPrint selecionado,
o usurio poder optar por impresso Via WebSpool ou E-
Mail.

Exerccio 30 Como Visualizar Relatrios atravs do WebSpool:
1. Aps enviar um Relatrio, para impresso atravs do Webprint;
2. Acesse a opo WebSpool, que se localiza logo abaixo no Menu;
3. Do lado direiro do Browser, sero demonstrados os Relatrios impressos. Todos os
relatrios impressos Via WebPrint estaro disponveis, para visualizao atravs do
WebSpool.

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).

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.

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 que j faziam parte do Sistema, antes das customizaes.
Para tal, ao invs dos programas tratarem explicitamente dos campos na fonte, tudo
realizado pelas leituras do 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.
Diz-se que o dicionrio de dados ativo, porque ao alter-lo, no necessrio recompilar
nenhum programa, para que a modificao entre imediatamente em funcionamento.

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.

Mapeamento de Arquivos (SX2)
Esse arquivo o responsvel por todo o Compartilhamento ou Exclusividade existente nas
Tabelas do Protheus 11, tais como: Cadastros, Movimentos, etc...
ele tambm quem direciona o Sistema, para realizar a leitura no diretrio onde esto
localizados os arquivos do banco de dados, possibilitando assim, a criao de vrias bases
de dados, para testes e outras finalidades.

Lanamentos Padronizados (SI5)
De forma similar ao Arquivo de Frmulas, mas sem ter um passo intermedirio, pode-se
tambm, em vrios pontos do sistema, escrever uma (Expresso), diretamente no Campo.
Tal ocorre no Arquivo de Lanamentos Padronizados (SI5), nos seus campos (Dbito,
Crdito, Histrico e Valor).
Sua aplicao simples, seja ela atravs da implementao de Macros, onde as mesmas
faro referncia s Tabelas e Campos do Sistema ou atravs de programas com Lgicas
mais complexas.
Da mesma forma, nos Campos de Validao do Usurio e Inicializador Padro do
Dicionrio de Dados, na Folha de Pagamento, para criar Clculos Especficos de
Vencimentos, Descontos e
Encargos, na Planilha de Formao de Preo de Venda, nas Clulas da Planilha Excel, nas
Regras dos Gatilhos, etc.

Perguntas e ltimas Respostas (SX1)
J o Arquivo de Perguntas e ltimas Respostas (SX1) armazena Parmetros Volteis, ou
seja, que so normalmente alterados a cada processamento.
Desta forma, so apresentados na prpria execuo de cada programa, para que o prprio
usurio os ajuste.
As Respostas so gravadas em Disco, de modo que se transformam sempre no (Default)
do prximo processamento.
Normalmente so utilizados em relatrios, para que os usurios possam parametrizar as
informaes que devem ser impressas e tambm em Rotinas de Processamentos, para
definir o que deve ser executado pelo sistema em relao quela opo.

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.

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.

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 11,
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 11, por meio 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 no 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 das 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:
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.

Schedules de Processos (SXD e SX4)
Este dois arquivos so responsveis pelo controle de Rotinas previamente configuradas
para serem executadas, automaticamente, atravs do Schedule de Processos, como por
exemplo: Relatrios, Rotinas do sistema, etc...
O Arquivo SXD ser o responsvel por controlar os agendamentos definidos e o Arquivo
SX4 quem controlar a agenda de processos, ou seja, os dias e horrios programados para
a execuo das tarefas.

Arquitetura e Instalação - P11

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Arquitetura e Instalação - P11

Enviado por

Direitos autorais:

Formatos disponíveis

Arquitetura e Instalao

Você também pode gostar