Escolar Documentos
Profissional Documentos
Cultura Documentos
Guia Arquitetura e Instalaçãoa e Instalação - P11
Guia Arquitetura e Instalaçãoa e Instalação - P11
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
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
Arquitetura e Instalao - 3
Definies
Caractersticas da Tecnologia
4 Arquitetura e Instalao
Camadas do Protheus 11
O Protheus 11 dividido em quatro camadas. So elas:
Servidor de Aplicao - Application Server
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
O Protheus 11 possui basicamente quatro aplicativos utilizados com diferentes finalidades.
So eles:
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)
Arquitetura e Instalao - 7
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:
8 Arquitetura e Instalao
Arquitetura e Instalao - 9
3. Tela de Bem-Vindo.
10 Arquitetura e Instalao
4. Contrato de licena.
Arquitetura e Instalao - 11
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
CTree.
Arquitetura e Instalao - 13
8. DLLs do Sigaloja.
14 Arquitetura e Instalao
Arquitetura e Instalao - 15
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. 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
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
24 Arquitetura e Instalao
DbAccess Monitor
Na opo Monitor possvel dar incio s operaes de conexo do servidor e,
alm disso, sair do aplicativo.
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
Max IOs/Seg.: mximo de IOs por segundo, registrando a maior velocidade das
informaes.
para no permitir
novas
Pasta "Usurios"
Arquitetura e Instalao - 27
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
Procedure
Comentrios
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
Ambiente
Tabela
30 Arquitetura e Instalao
Recno
Boto
Funcionalidade
Salvar
Fechar
Rastrear
Arquitetura e Instalao - 31
Funcionalidade
Copiar
Pausa
Faz a pausa da tela, para checar as instrues que esto sendo enviadas
para o banco de dados.
Limpar
Salvar
Fechar
32 Arquitetura e Instalao
Pasta "Mensagens"
Data
Apresenta a data da mensagem.
Hora
Relaciona a hora da mensagem.
Mensagem
Relaciona as mensagens de erro do banco.
Arquitetura e Instalao - 33
Boto
Descrio
Atualizar
Limpar
Salvar
34 Arquitetura e Instalao
Arquitetura e Instalao - 35
36 Arquitetura e Instalao
Usurios logados
Testes de conexo
Monitores de ndices
DBMonitor
Arquitetura e Instalao - 37
38 Arquitetura e Instalao
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)
Arquitetura e Instalao - 39
40 Arquitetura e Instalao
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;
Arquitetura e Instalao - 41
42 Arquitetura e Instalao
Arquitetura e Instalao - 43
44 Arquitetura e Instalao
Arquitetura e Instalao - 45
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
48 Arquitetura e Instalao
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
Arquitetura e Instalao - 49
Patch
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
ADVPL
50 Arquitetura e Instalao
Atualizao de BUILD
Arquitetura e Instalao - 51
52 Arquitetura e Instalao
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
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\;
54 Arquitetura e Instalao
Arquitetura e Instalao - 55
5 . Posicione com o cursor sobre o mesmo, confirme e Aplicao da Patch, ser iniciada.
56 Arquitetura e Instalao
Configurao do Protheus 11
Wizard - Assistente de Configurao
Ambientes;
Servidor de Licenas;
Mdulos Web;
Processos Comuns;
Conexo (Server/Remote);
ByYou DbAccess;
Servidor CTREE;
Balanceamento de Carga;
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
Arquitetura e Instalao - 57
58 Arquitetura e Instalao
Configuraes de Ambientes
Arquitetura e Instalao - 59
Descrio
\APOTST\
Repositrio Independente
\PROTHEUS_DATATST\
RootPath Independente
[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
62 Arquitetura e Instalao
Arquitetura e Instalao - 63
64 Arquitetura e Instalao
Arquitetura e Instalao - 65
Teste de Balanceamento
66 Arquitetura e Instalao
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
70 Arquitetura e Instalao
Onde:
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
O Protheus 11 Monitor utilizado para monitorar as Conexes ao ByYou Application
Server.
Atravs dele pode-se:
Isto ser til quando precisarmos realizar alguma manuteno e precisarmos evitar que
outros usurios se conectem;
Desconectar Usurios:
Usurio:
Computador:
Conexo:
Tempo de uso:
Indicar o tempo em horas, minutos e segundos, desde que 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:
Arquivos Abertos:
Arquitetura e Instalao - 73
74 Arquitetura e Instalao
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
Arquitetura e Instalao - 77
78 Arquitetura e Instalao
Arquitetura e Instalao - 79
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
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.
Arquitetura e Instalao - 81
82 Arquitetura e Instalao
2 . Ser apresentada uma Tela de Acesso, na qual dever ser digitado o Nome do
Usurio, sua respectiva Senha e Empresa/Filial, que ser utilizada para trabalho;
3 . Confirme clicando na opo Ok;
4 . Pronto, todas as opes de relatrios, que existem no Protheus 11, esto disiponveis
atravs do Browser.
Arquitetura e Instalao - 83
Viso Tcnica
Customizaes
Parmetros;
Dicionrio de Dados;
Tabelas Genricas;
Tabelas (Arquivos);
Frmulas;
Relatrios;
Pastas Cadastrais;
Consultas Padres;
Perguntas e Respostas;
Sequncia de Documentos;
Schedule de Processos;
Pontos de Entradas;
84 Arquitetura e Instalao
Parmetros (Sx6)
Arquitetura e Instalao - 85
Tabelas (SX5)
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)
86 Arquitetura e Instalao
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
Arquitetura e Instalao - 87
Pontos de Entradas
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
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)
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)
Arquitetura e Instalao - 89
90 Arquitetura e Instalao