Вы находитесь на странице: 1из 35

Guia de Instalao do SARA Portal Web TOTVS

18/12/2013

TOTVS - SARA Portal Web

Sumrio

Sumrio ...................................................................................................................................................................................... 2
1.

Instalao do Portal Web SARA ......................................................................................................................................... 3

2.

Instalao do Protheus ...................................................................................................................................................... 4

3.

Atualizao do Binrio do Protheus................................................................................................................................... 5

4.

Instalao do DBAccess ..................................................................................................................................................... 6

5.

Atualizao do RPO ........................................................................................................................................................... 8

6.

Configurao do Banco de Dados ...................................................................................................................................... 9

7.

Acessando o Protheus ..................................................................................................................................................... 14

8.

Aplicao de Pacote do SARA .......................................................................................................................................... 17

9.

Instalando o SmartClient HTML ....................................................................................................................................... 23

10.

Configurao do SARA ................................................................................................................................................ 25

11.

Certificao Digital e-CPF ............................................................................................................................................ 29

12.

Cadastro de Usurios .................................................................................................................................................. 30

13.

Autorizao de Empresas ............................................................................................................................................ 32

14.

Utilizao do Portal SARA ........................................................................................................................................... 33

15.

Mais Informaes ....................................................................................................................................................... 34

Verso 1.0

TOTVS - SARA Portal Web

1. Instalao do Portal Web SARA

Pr-requisitos:
a. Banco de dados SQLServer 2008 R2;
b. SARA Delphi Instalado;
c. JAVA 6 ou superior;
d. Servidor de banco de dados e de aplicao na mesma rede de dados;
e. Servidor de licenas configurado com HardLock;
f. Licenas Protheus WMS ou TOTVS full disponveis para o portal;
g. Liberao de porta 8080, 7070, 80, 7443, 8443 443 no firewall do servidor onde ser instalado o portal;
h. Liberao da porta do servidor de licenas para o servidor onde ser instalado o Portal (padro 5555);
i. Arquivo sigamat.emp j configurado para a empresa e grupo de acesso;
j. Servidor com acesso a internet;
k. Liberao de administrador para a instalao;
l. Browser de internet:
i. Microsoft Internet Explorer 8;
ii. Mozila Firefox 3.6.x;
iii. Google Chrome 12.x ou
iv. Apple Safari 5.
m. Sero obrigatrios os itens abaixo se for utilizar o e-CPF:
i. AAWC JAVA Lib de autenticao do e-CPF da CertiSign;
ii. Certificado de site seguro SSL para o site ou servidor que ser disponibilizado o portal;
iii. Certificado de site seguro instalado no servidor de aplicao do portal.

Verso 1.0

TOTVS - SARA Portal Web

2. Instalao do Protheus

Para realizar a instalao do Protheus, o cliente precisa acessar o endereo abaixo e seguir o seguinte procedimento:
http://www.totvs.com/suporte/central-de-download/seu-segmento/produto/microsiga
Selecionar TOTVS Application Server;
Clicar em Install.
Depois do procedimento de cpia dos arquivos, dever selecionar:
Database:
RPO Language:
Available countries:

SQL
Portuguese
Brazil

Em uma das etapas de trmino da instalao padro do Protheus, deve-se selecionar o local onde est instalado o
servidor de licenas do produto.

Quando aparecer a opo de abrir o assistente, pode-se escolher a opo de no.


Ao exibir a mensagem questionando a execuo do assistente de configurao do servidor de aplicao, pode-se
selecionar a resposta No.

Depois de informar que no dever executar configurador, deve-se selecionar o cone para o atalho do servidor de
aplicao e o cone para o Smart Client (aplicativo principal).

Verso 1.0

TOTVS - SARA Portal Web

Est concluda a instalao padro do Protheus.

3. Atualizao do Binrio do Protheus

Para efetuar a atualizao do Protheus deve-se seguir os seguintes passos:


Acessar a rea de downloads da TOTVS para baixar o pacote de atualizao do binrio, conforme abaixo:
https://suporte.totvs.com/download
Filtros:
Linha:
Verso:
Plataforma:
Idioma:
Categoria:
Ambiente DB:
Pas:

Verso 1.0

Protheus
Microsiga Protheus 11
Windows
Portugus Brasil
TOTVS Binrio
TOP Connect
Brasil

TOTVS - SARA Portal Web

Depois de efetuar o download do pacote, deve-se aplicar atualizao extraindo e sobrescrevendo os fontes no
diretrio de instalao, conforme abaixo:
C:\TOTVS 11\Microsiga\Protheus\bin

4. Instalao do DBAccess

O DBAccess o componente responsvel por fazer a ligao do Protheus com o ODBC. O SARA atualmente trabalha
com o banco de dados SQLServer, e para isto, precisa-se instalar este componente.
Acessar a rea de downloads da TOTVS e baixar o DBAccess conforme filtros abaixo:
https://suporte.totvs.com/download
Filtros:
Linha:
Verso:
Plataforma:
Idioma:
Categoria:
Ambiente DB:
Pas:

Protheus
Microsiga Protheus 11
Windows
Portugus Brasil
TOTVS DBAccess
TOP Connect
Brasil

Verso 1.0

TOTVS - SARA Portal Web

Depois de baixar o arquivo, na verso condizente ao sistema operacional, precisa-se realizar a instalao:
Para Windows 32bits:
o Executar o setup de instalao
o Instalar o componente dentro da estrutura de instalao do Protheus:
C:\TOTVS 11\DBAccess
o Depois da instalao, verificar se foi instalado o DBAccess no servios do Windows

Caso o servio no tenha sido instalado, deve-se executar o comando abaixo no prompt de comando
do Windows:

Para Windows 64bits:


o Extrair o arquivo .ZIP dentro do diretrio:
C:\TOTVS 11\DBAccess
o Depois de extrair o arquivo, deve-se instalar o componente no servio do Windows

Depois de instalar o DBAccess, se faz necessrio iniciar o servio:


Acessar o services do Windows:

Verso 1.0

TOTVS - SARA Portal Web

5. Atualizao do RPO

Para que todos os programas do Consulta RFB do SARA estejam no Protheus, se faz necessrio fazer a
atualizao do RPO. A atualizao deve seguir os passos abaixo:
Acessar a rea de downloads da TOTVS e baixar o RPO conforme o filtro abaixo:
https://suporte.totvs.com/download
Filtros:
Linha:
Verso:
Plataforma:
Idioma:
Categoria:
Ambiente DB:
Pas:

Protheus
Microsiga Protheus 11
Windows
Portugus Brasil
Repositrio de objetos
TOP Connect
Brasil

Depois de baixar o pacote do RPO, copiar o arquivo para o diretrio abaixo:


C:\TOTVS 11\Microsiga\Protheus\apo
Depois de copiar o arquivo, apagar o RPO antigo que est com o nome TTTP110.RPO.
Depois de apagar o RPO antigo, renomear o RPO copiado, para o nome tttp110.rpo

Verso 1.0

TOTVS - SARA Portal Web

6. Configurao do Banco de Dados

Depois da instalao do produto, precisa-se configurar o banco de dados para receber as tabelas do Protheus. Criar
um banco de dados denominado protheus_sara
Importante: Este banco deve estar no mesmo Server e Instancia que o banco do SARA_DB.

O banco de dados criado dever ter compatibilidade com o SQL2000. Para mais informaes acessar o link:
http://tdn.totvs.com/display/mp/MSSQL

Verso 1.0

TOTVS - SARA Portal Web

Depois da criao do banco de dados do Protheus, deve-se criar uma conexo ODBC, no servidor onde foi instalado o
Protheus, apontando para esta base criada.
Para criar uma conexo ODBC deve-se acessar o servio ODBCAD32 no Windows:

Na tela de ODBC, deve-se selecionar Fonte de dados de sistema e depois disto, acionar o boto de adicionar.
Concludo este processo, ser necessrio selecionar qual o Driver de Conexo, no caso desta instalao, selecionar
SQL Server.

10

Verso 1.0

TOTVS - SARA Portal Web

Efetuar a configurao da conexo conforme abaixo:

Verso 1.0

TOTVS - SARA Portal Web

Com a concluso da criao do banco de dados, e a configurao do ODBC, deve-se efetuar a conexo no DBAccess
para que o Protheus consiga acessar o ODBC criado e por sua vez o banco de dados.
No diretrio de instalao do DBAccess, executar o programa DBMonitor.exe.
Na guia Microsoft SQL, criar um novo ambiente, contendo o mesmo nome da conexo criada no ODBC, este caso
protheus_sara (informar o usurio e senha do banco de dados).
Para mais informaes do processo de configurao do DBAccess acessar o link:
http://tdn.totvs.com/pages/viewpage.action?pageId=6064466

12

Verso 1.0

TOTVS - SARA Portal Web

Depois da configurao, devemos efetuar a verificao da conexo, para isto faa o procedimento abaixo:

Verso 1.0

TOTVS - SARA Portal Web

Depois do banco de dados criado e configurado para a conexo, necessrio alterar o arquivo de configurao do
Protheus para utilizar a conexo criada.
Acessar o arquivo C:\TOTVS 11\Microsiga\Protheus\bin\appserver\appserver.ini
Alterar a sesso DBAccess conforme configurao criada anteriormente.
Onde:
o DATABASE = MSSQL
o SERVER = Servidor onde foi configurado o DBAccess
o ALIAS = Alias configurado no DBAccess para acessar o banco de dados

7. Acessando o Protheus

Com as configuraes de instalao efetuada, pode-se neste momento acessar o Protheus.


Para acessar verificar o procedimento abaixo:

No menu Iniciar, acessar TOTVS 11 > Microsiga Protheus > Application Server.

14

Verso 1.0

TOTVS - SARA Portal Web

Depois de iniciar o Server, pode-se verificar o Build se igual ou superior a 7.00.120420.


Com o servio iniciado, acessar novamente no Menu Iniciar TOTVS 11 > Microsiga Protheus > SmartClient
No Programa inicial, colocar SIGACFG.
Depois de iniciar ser necessrio selecionar o tema: Informar o tema Padro.

Verso 1.0

TOTVS - SARA Portal Web

Inseridas as informaes, aguarde a atualizao dos arquivos de help.


Ser necessrio informar o usurio e senha.
o Usurio: admin
o Senha: (em branco)
o Clique no boto Entrar
Usurio:
Senha:

admin
(em branco)

Acione o boto Entrar.


Ao entrar no sistema, ser solicitado o pas de origem, neste caso informar: Brasil.
Depois de informar o pas, ser necessrio informar o diretrio onde se encontra o diretrio com a primeira
carga de dados do Protheus.
Selecionar o diretrio: SERVIDOR\systemload\

Acionar o boto Abrir. Ser efetuada a criao de algumas tabelas no banco Protheus_sara. No final deste
procedimento aparecer a tela Moedas, clique em confirmar e/ou cancelar. Finalize a sesso do produto.
Depois de todos os procedimentos acima, concluiu-se a instalao e atualizao do Protheus. A partir deste ponto,
ser realizada a configurao e atualizao do SARA dentro do produto Protheus.

16

Verso 1.0

TOTVS - SARA Portal Web

8. Aplicao de Pacote do SARA

Efetuar o download do pacote com o menu do SARA.


Acessar a central de downloads da TOTVS no link https://suporte.totvs.com/download
Filtros:
Linha:
Verso:
Plataforma:
Idioma:
Categoria:
Ambiente DB:
Pas:

Protheus
Microsiga Protheus 11
Windows
Portugus Brasil
Menu de mdulo
TOP Connect
Brasil

Depois de baixar o arquivo de menu, o mesmo dever ser substitudo no diretrio.


o C:\TOTVS 11\Microsiga\Protheus_Data\system

Efetuar o download do pacote com os dicionrios do SARA conforme print abaixo:


Acessar a central de downloads da TOTVS no Link: https://suporte.totvs.com.br/download
Filtros:
Linha:
Verso:
Plataforma:
Idioma:
Categoria:
Ambiente DB:
Pas:

Protheus
Microsiga Protheus 11
Windows
Portugus Brasil
Dicionrio de dados
TOP Connect
Brasil

Depois de baixar o pacote, deve-se substituir e colocar os arquivos de dicionrio dentro do seguinte
diretrio:
C:\TOTVS 11\Microsiga\Protheus_Data\systemload

Verso 1.0

TOTVS - SARA Portal Web

o
o
o
o
o

o
o

Acessar Iniciar TOTVS 11 > Microsiga Protheus > SmartClient;


Acessar novamente o Protheus, porm agora No programa inicial, informar: UPDDISTR;
No wizard, informe o usurio Administrador e senha em branco.
Para habilitar o boto avanar, clique no campo Senha, clique na tecla tab para habilitar a
palavra Brasil.
Na tela configurao marcar as opes:
Corrigir todos os erros automaticamente
Eliminar arquivos de backup ao termino de cada tabela

Aguarde aparecer tela indicando que o processo foi finalizado com sucesso.
No mesmo pacote de dicionrio contm um arquivo .PDF contendo mais detalhes da atualizao.

18

Verso 1.0

TOTVS - SARA Portal Web

Efetuar o download do pacote com as stored procedures do SARA conforme abaixo:


Acessar a central de download da TOTVS no link: https://suporte.totvs.com/download
Filtros:
Linha:
Verso:
Plataforma:
Idioma:
Categoria:
Ambiente DB:
Pas:

Protheus
Microsiga Protheus 11
Windows
Portugus Brasil
Stored Procede
TOP Connect
Brasil

Depois de baixar o pacote com as procedures, se faz necessrio executar todas as procedures do pacote no
banco SARA_DB, utilizando o editor de SQL de preferncia do cliente.
Por ultimo, devem-se executar os scripts:
o Script_Create_tab_descricao_objeto.sql
o Sinonimos.sql
Importante: O Script Sinonimos.sql dever ser executado no banco PROTHEUS_SARA, pois
este script ir criar um espelho de todas as tabelas, procedures e views do SARA_DB dentro
do banco PROTHEUS_SARA.

Verso 1.0

TOTVS - SARA Portal Web

Efetuar o download do pacote com as cargas padres do SARA conforme abaixo:


Acessar a central de download da TOTVS no link: https://suporte.totvs.com/download
Filtros:
Linha:
Verso:
Plataforma:
Idioma:
Categoria:
Ambiente DB:
Pas:

Protheus
Microsiga Protheus 11
Windows
Portugus Brasil
Arquivos de configurao
TOP Connect
Brasil

Para aplicar a carga padro do SARA, deve-se efetuar os seguintes passos:


o Acessar o Protheus. No programa inicial, incluir SIGAWMS
o Acessar com o usurio admin e a senha em branco

20

Verso 1.0

TOTVS - SARA Portal Web

No menu do WMS, acessar Atualizaes > Consulta Rfb entre nas 3 opes (abrir e fechar a tela)
o Loc. Doc. Sistema
o Param. Cons. Din.
o SQL Dinmico

Depois de executar estas 3 rotinas ao acessar o banco do protheus (protheus_sara), ser possvel visualizar 3
novas tabelas (DBO, DBP e DBQ).

Verso 1.0

TOTVS - SARA Portal Web

Com as tabelas criadas, podem-se executar as rotinas de carga de dados no editor de SQL de preferncia do
cliente.
Executar os Scripts do pacote baixado no banco protheus_sara:

22

Verso 1.0

TOTVS - SARA Portal Web

9. Instalando o SmartClient HTML

O SmartClient HTML a tecnologia da TOTVS que permite a mesma visualizao de um programa realizado para
Desktop, na WEB
Todos os programas do consulta RFB, foram desenvolvidos com base no ADVPL e MVC do Protheus, para serem
executados no desktop.
Com este programa, automaticamente todas as rotinas podem ser visualizadas tambm a partir de um browser de
internet.
Para efetuar a instalao do SmartClient HTML, deve-se acessar a central de download da TOTVS e efetuar o
download conforme os filtros abaixo:
Acessar a central de download da TOTVS no link: https://suporte.totvs.com/download
Filtros:
Linha:
Verso:
Plataforma:
Idioma:
Categoria:
Ambiente DB:
Pas:

Verso 1.0

Protheus
Microsiga Protheus 11
Windows
Portugus Brasil
TOTVS Binrio
TOP Connect
Brasil

TOTVS - SARA Portal Web

Verso igual ou superior ao SmartClient HTML Server 2.1.7 AppServer: TOTVS - Build 7.00.121227P.

Depois de baixar o pacote do SC HTML, efetuar a instalao do produto, conforme pontos abaixo:
Alterar o caminho da instalao padro para:
o C:\TOTVS 11\SmartClientHTML

O servidor solicitado na instalao onde est instalado o Protheus, caso seja na mesma mquina, deixar
localhost, caso contrrio informar o IP do servidor instalado.
No campo porta, informar a porta de utilizada pelo Protheus. Nesta instalao deixou-se a padro.

Informar qual ser a porta de acesso ao portal e configurao de memria alocada.

24

Verso 1.0

TOTVS - SARA Portal Web

Para mais informaes:


o http://tdn.totvs.com/display/tec/Tutorial+--+108718

Depois da instalao, ser necessrio iniciar o servio no Windows:

Para acessar o Protheus no Browser, necessrio criar um atalho com a configurao abaixo:
http://[SERVIDOR]:[PORTA]/?auto&StartProg=SIGAWMS&Comm=TCP&Env=Environment
Onde:
o [SERVIDOR] = Onde foi instalado o SmartClientHTML
o [PORTA] = Porta da instalao efetuada
Efetue um teste de acesso com o usurio admin, senha em branco.

10. Configurao do SARA

Neste momento, ser necessrio configurar os parmetros do SARA para que as consultas dos Portais sejam
efetuadas com sucesso.
Para acessar a rea de parmetros do Protheus, acessar o Menu Iniciar TOTVS 11 > Microsiga Protheus >
SmartClient
Verso 1.0

TOTVS - SARA Portal Web

No Programa inicial, colocar SIGACFG


Usurio admin e a senha em branco

No menu do mdulo SIGACFG, acessar o item: Base de dados > Dicionrio > Base de dados.

Depois de acessar a tela de configuraes do banco de dados do Protheus, escolher a opo Parmetros.

Pesquisar o parmetro: MV_WMSPOWN


o Este parmetro indica qual o nome do banco de dados do Protheus, onde as procedures do SARA
enviaro os dados de retorno.
o Informar: protheus_sara..

26

Verso 1.0

TOTVS - SARA Portal Web

Pesquisar o parmetro: MV_WMSSPD


o Este parmetro indica a configurao de como o Protheus ir enviar os campos do tipo Date para
as procedures do SARA. Esta configurao pode mudar de acordo com a configurao do SQLServer
do cliente.
o Este parmetro no se trata de como o campo aparecer em tela, e sim como o banco recebe a
informao.

Verso 1.0

TOTVS - SARA Portal Web

Pesquisar o parmetro: MV_WMSSOWN


o Este parmetro indica qual o nome do banco do SARA, que utilizado internamente em algumas
procedures.
28

Verso 1.0

TOTVS - SARA Portal Web

o
o

Neste manual utilizamos sara_db..


Importante informar os dois pontos aps o nome do banco, para que os scripts consigam encontrar
as tabelas e views.

11. Certificao Digital e-CPF

O que ?
o Permitir o acesso ao portal atravs de um token ou carto magntico sem a necessidade de entrar
com usurio e senha no produto.
O cliente precisa adquirir uma biblioteca junto a CertiSign.
o Nome: AAWC JAVA
o E-Mail: atendimento.totvs@certisign.com.br
o Telefone: +55 11 3546-3702
o necessrio informar que para utilizao em um produto da TOTVS
Instalao:
o Toda a instalao e suporte do Certificado SSL e da lib AAWC feita pela CertiSign;
o A TOTVS no se envolve nesta instalao;
o O cliente precisa entrar em contato com a CertiSign para a compra, emisso e instalao da
biblioteca;
Configurao do e-CPF no SmartClient HTML:
o A configurao do e-CPF no SmartClient HTML assim como o download do pacote de atualizao,
deve-se verificar com a equipe de Framework de SP.

Verso 1.0

TOTVS - SARA Portal Web

12. Cadastro de Usurios

Para que os usurios tenham acesso ao portal do SARA, ser necessrio fazer o cadastro no portal.
Para acessar o cadastro de usurio deve-se acessar o mdulo SIGACFG do Protheus.
No menu do produto, navegar at a rotina: Configurador > Usurio > Senhas > Cadastro de usurios
Para cadastro de usurio que no far acesso via e-CPF, seguir o procedimento:
Criar um usurio e senha normal, com o nmero de CPF do usurio no login.

Depois de informar os dados principais, acessar a aba Ambientes e selecionar o mdulo SIGAWMS.

Caso seja de interesse, para restringir o acesso do usurio a alguns menus, deve-se acessar o menu aes
relacionadas e marcar quais as rotinas o usurio ter acesso ou no.

30

Verso 1.0

TOTVS - SARA Portal Web

Verso 1.0

TOTVS - SARA Portal Web

Para cadastro de usurio que faro acesso via e-CPF, seguir o procedimento:
Efetuar o mesmo procedimento de um usurio que no utilizar o e-CPF, com ateno aos seguintes itens:
O login do usurio dever ser obrigatoriamente ECPF + nmero do CPF do usurio.
o Ex.: ECPF00011122233
A senha dever ser uma senha padro de sistema, respeitando os caracteres maisculo e minsculo.
o Senha padro: ASDf921k#@avzzd

Informaes importantes:
Caso um usurio queira acessar o Protheus das duas forma, via e-CPF e via usurio e senha, deve-se
cadastrar 2 usurios no Protheus.
O cadastro de usurios do Protheus/portal no unificado com o cadastro do SARA, desta forma
necessrio criar um usurio no Protheus e outro no SARA.
O usurio do Protheus no o mesmo do banco de dados.
Os usurios criados no Protheus so somente de aplicao.
A configurao do ODBC do Protheus deve ser realizada com o usurio SA.

13. Autorizao de Empresas

Este manual de instalao contempla a utilizao do sistema utilizando a empresa 99 e filial 01, no entanto, ela
possui algumas caractersticas:
Neste modelo, apenas um usurio poder acessar o portal por vez. Restringindo tambm para apenas uma
tela por vez;
Este modelo poder ser utilizado para teste e tambm para uso interno;
No consome licenas;
Fica registrado no login que se trata de uma empresa de teste.

32

Verso 1.0

TOTVS - SARA Portal Web

Para cadastrar outras empresas e autoriz-las, o cliente precisa efetuar o procedimento conforme TDN:
o http://tdn.totvs.com/pages/viewpage.action?pageId=41353591
o Em caso de dvidas verificar com equipe de atendimento do Framework Protheus

14. Utilizao do Portal SARA

Para utilizar o portal do SARA, ser necessrio acessar o SmartClient HTML, conforme instruo do captulo
Configurao SARA.
Depois de acessar o SmartClient no mdulo SIGAWMS, no menu lateral da esquerda ter todas as rotinas
disponveis para o usurio.

Verso 1.0

TOTVS - SARA Portal Web

15. Mais Informaes

Instalao Protheus: http://tdn.totvs.com/pages/viewpage.action?pageId=4810815


Configurao MSSQL Protheus: http://tdn.totvs.com/display/mp/MSSQL
Instalao DBAccess: http://tdn.totvs.com/pages/viewpage.action?pageId=6064466
Instalao e TOTVS License: http://tdn.totvs.com/pages/viewpage.action?pageId=4810815 e
http://tdn.totvs.com/pages/viewpage.action?pageId=6065891
Configurao de usurios: http://tdn.totvs.com/pages/viewpage.action?pageId=6814686
Instalao SmartClient HTML: http://tdn.totvs.com/display/tec/Tutorial+--+108718
Autorizao de empresas: http://tdn.totvs.com/pages/viewpage.action?pageId=41353591
Para verificar o log de execuo das procedures no Protheus, basta ativar o parmetro: MV_WMSSMD.
o No arquivo C:\TOTVS 11\Microsiga\Protheus\bin\appserver\appserver.ini, incluir as chaves:

34

Verso 1.0

TOTVS - SARA Portal Web

Acompanhar as execues em: C:\TOTVS 11\Microsiga\Protheus\bin\appserver\console.log.

No est trazendo nenhum dado na tela?


o Ativa o parmetro de log de procedure;
o Executar a mesma instruo em um editor de SQL e verificar a mensagem de erro;
o Caso seja problema com:
Data: Verificar o parmetro MV_WMSSPD e MV_WMSSPDT
Tabela no encontrada: Verificar o parmetro MV_WMSPOWN e MV_WMSSOWN

Protheus est muito lento?


o Verificar se o servidor de licenas est ativo;
o Um dos motivos de lentido o Protheus ficar tentando procurar o servidor de licenas e no
encontrar.

Verso 1.0

Вам также может понравиться