13

Boletim Tcnico

Configurao do Protheus
Produto

TOTVS Incorporao x BackOffice Protheus

Processo

Configurao

Subprocesso
Data da
publicao

Configurao do Protheus

22/11/2012

Este boletim apresenta um exemplo do processo de cadastro de centro de custo da integrao TIN x Protheus.

DESENVOLVIMENTO/PROCEDIMENTO
Configurao do appserver.ini

O arquivo appserver.ini guarda informaes de configurao do Protheus.( C:\Protheus11\bin\appserver)

Abaixo temos a descrio das principais linhas a serem configuradas neste arquivo:

[P11_INTEGRA_TIN] < Nome do environment (ENVIRONMENT= AMBIENTE)

Informe o nome do Produto e a GDP

14

Boletim Tcnico

SOURCEPATH=D:\Protheus11\apo\P11_INTEGRA_TIN (caminho do *.rpo)

ROOTPATH=D:\Protheus11\Data_P11_INTEGRA_TIN < Caminho do diretrio data)(caminho
do root do protheus onde ficaro as pastas system, systemload, etc.
STARTPATH=\system\ < Caminho da pasta system do protheus
RPODB=TOP < Define se a conexo topconect ou codebase)
RPOLANGUAGE=Portuguese < Define a linguagem da aplicao, e no a localizao
RPOVERSION=110
LOCALFILES=ADS
LOCALDBEXTENSION=.dbf < Define se os arquivos de dicionario estaram em dbf, ctree, etc.
PICTFORMAT=DEFAULT
REGIONALLANGUAGE=BRA < Define a linguagem regional. Podemos ter um rpo portugus,
mas com regionalllanguage ANG [angola] por exemplo.
TOPDATABASE=MSSQL < define qual o banco de dados: MSSQL ,ORACLE DB2, MSSQL,
Oracle, Informix,Sysbase, PostGres, MySql.
TOPALIAS=P11_INTEGRA_TIN (alias no ODBC)
TOPSERVER=LOCALHOST
TOPPORT=7890 < esta porta ser usada na configurao do DBAccess - isto pode ser
omitido. Nas verses mais novas do top no e necessrio informar o endereo da porta.
SpecialKey=P11_ INTEGRA_TIN < Caso na criao de alguma tabela o Server caia, caia
a luz, desligado indevidamente, etc, o protheus no vai permitir a voc recriar o
banco, pois ele entende que outra pessoa estava fazendo isto. Com esta chave, ele
consegue reconhecer que voc que estava criando e permite a criao novamente. O nome da
chave pode ser qualquer um, mas deixe um diferente por ambiente.
[SERVICE] (para rodar o protheus como servio. Este pode ser omitido, dessa forma o
server Protheus deve ser iniciado toda vez.
Name=P11_INTEGRA_TIN
DisplayName=P11_INTEGRA_TIN
[Drivers]
Active=TCP
[TCP]
TYPE=TCPIP
Port=1243 <Porta na qual o SmartClient vai se conectar
[GENTCPIP]
Enable=0
[LICENSECLIENT]
SERVER=172.16.90.170 < Servidor de licenas do protheus. Caso use a empresa 99,
no necessrio
PORT=8009
[LICENSESERVER]
ENABLE=0
PORT=0
SHOWSTATUS=0
[HTTP](esta parte diz pro protheus o que ele vai abrir no HTTP)
ENABLE=1
PORT=86
PATH=\web\EAI
ENVIRONMENT=P11_INTEGRA_TIN
RESPONSEJOB=JOB_EAI_010101001
definir 3 blocos idnticos, um pelo localhost, outro pelo nome da maquina, outro
pelo ip da mquina. Um bloco com o IP da maquina j o suficiente.
[localhost:86] ENABLE=1
PATH=D:\P11_INTEGRA_TIN\web\EAI
ENVIRONMENT=P11_INTEGRA_TIN
INSTANCENAME=EAI
RESPONSEJOB=JOB_EAI_010101001
DEFAULTPAGE=wsindex.apw
[BHD0005396:86]
ENABLE=1
PATH=C:\Protheus11\Data_P11_INTEGRA_TIN\web\eai
ENVIRONMENT=P11_INTEGRA_TIN
INSTANCENAME=EAI
RESPONSEJOB=JOB_EAI_010101001
Informe o nome do Produto e a GDP

13

Boletim Tcnico

DEFAULTPAGE=wsindex.apw
[10.31.8.37:86] < Este o endereo da maquina e deve ser jogado no browser para o
WebService ser configurado
ENABLE=1
PATH=C:\Protheus11\Data_P11_INTEGRA_TIN\web\eai
ENVIRONMENT=P11_INTEGRA_TIN
INSTANCENAME=EAI
RESPONSEJOB=JOB_EAI_010101001
DEFAULTPAGE=wsindex.apw
[JOB_EAI_010101001]
TYPE=WEBEX
ENVIRONMENT=P11_INTEGRA_TIN
INSTANCES=1,1
SIGAWEB=WS
INSTANCENAME=EAI
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=01,0101001 < Aqui colocado empresa, filial. O protheus ir subir o
ambiente colocado aqui , nesta empresa e filial, para montar o WebService
[ONSTART]
JOBS=JOB_EAI_010101001,FWSCHDMANAG,FWSCHDQUEUE < Aqui indicado quais jobs ele
ir carregar na inicializao
RefreshRate=6000
[GENERAL]
InstallPath=C:\Protheus11
console=1
BuildKillUsers=1
LogEnable=1
ConsoleLog=1
consolemaxsize=10000000
Segmento=cYdTm3WWERZF=1hu
Serie===AV
ConsoleFile=C:\Protheus11\logs\Protheus11.log
[FWSCHDMANAG]
Main=FWSCHDMANAG
Environment=P11_INTEGRA_TIN
[FWSCHDQUEUE]
Main=FWSCHDQUEUE < Agents de schedule. Estes so criados quando se configurado o EAI
Environment=P11_INTEGRA_TIN
Configurao do DBAccess

Instale o DBAcess, localize o diretrio onde ele foi instalado, localize o dbaccess.ini, adicione a seguinte linha neste arquivo
clientlibrary=C:\app\<nomeDoUsuario>\product\11.1.0\db_1\BIN\oci.dll

Informe o nome do Produto e a GDP

14

Boletim Tcnico

Obs: interessante instalar o DBAcess como servio para no ter a necessidade de inicia-lo toda vez. Mas opcional. Para fazer isso basta inserir
install no endereo do atalho

No exemplo acima temos o arquivo configurado e a linha adicionada.

Informe o nome do Produto e a GDP

13

Boletim Tcnico

Crie um atalho do DBAccess.exe, clique com o boto direito > propriedades e adicione console no endereo, conforme a figura acima. (-install para
rodar como servio)

Clique duas vezes no atalho do DBAccess e rodar em modo console.

Feito isso, clique no DBMonitor.exe, aparecer esta tela. Clique em OK.

Esta a tela monitor do DBAccess. Aqui necessrio configurar os dados usurio e senha do banco de dados. No exemplo acima ultilizado um banco
Oracle com usurio e senha P11. O boto novo adiciona novas configuraes. Aps qualquer modificao necessrio clicar no boto Salvar em baixo da tela.

Informe o nome do Produto e a GDP

14

Boletim Tcnico

Outra funcionalidade do DBAccess a possibilidade de testar a conexo com o BD. Faa isso seguindo o seguinte fluxo.
Guia Assistentes > Validao de conexo > Siga o Wizard > Selecione o BD > Insira o nome da base > Clique em finalizar.
Se a conexo for testada com sucesso, esta mensagem Conexo OK! ser exibida na tela.

Informe o nome do Produto e a GDP

13

Boletim Tcnico

SOMENTE aps a o appserver.ini estiver configurado, crie um atalho para o appserver.exe. (C:\Protheus11\bin\appserver\appserver.exe)
V nas propriedades do atalho e adicione console, como no exemplo do DBACESS.

Informe o nome do Produto e a GDP

14

Boletim Tcnico

Clique no atalho do appserver.exe, ento ser aberto esta tela rodando o appserver no modo console.

Nesta etapa j podemos abrir o smartclient, para isso clique em smartclient.exe em C:\Protheus11\bin\smartclient
OBS: O CONSOLE DO DBACESS E O CONSOLE DO APPSERVER DEVEM ESTAR RODANDO.

Esta a tela que aparecer ao abrir o smartclient. nela que ser definido o modulo do protheus que ir entrar e nome do ambiente configurado no
appserver.ini. Entre no modulo sigacfg para configurao da integrao no Protheus.

Informe o nome do Produto e a GDP

13

Boletim Tcnico

Faa o login e clique em Acessar Protheus

Novamente lembrando que o Protheus ultiliza uma base VAZIA. Nesta etapa o prprio Protheus alimentar o banco com as tabelas.

Informe o nome do Produto e a GDP

14

Boletim Tcnico

Clique em Confirmar
Configurar Adapter EAI para Integrao no Protheus

Interface De/Para
No Protheus, navegue nas abas na direta da tela:. Ambiente > Schedule > Adapter EAI

Informe o nome do Produto e a GDP

13

Boletim Tcnico

Nesta tela sero listados os registros configurados. No canto inferior direito, h a opo de Alterar e Incluir registros.

Esta a tela de incluso/alterao dos registros EAI. A incluso/alterao feita de forma separada para cada registro, para confirmar basta clicar
em Confirmar. Esto em destaque os campos que DEVEM ser preenchidos de acordo com o quadro abaixo. OBS o campo descrio obrigatrio mas serve
somente para IDENTIFICAO do registro. Por exemplo, a descrio do registro BANK seria Banco, COSTCENTER seria centro de custo.

Msg
. nica

Rotin
a

Mensage
m

E
nvia

R
eceb

M
todo

Op
erao

e
Sim

MATA
020

CUSTOME
RVENDOR

S
im

Condio

Envio
S

im

C
anal

S
ncrono

Tod
as

EA
I

Informe o nome do Produto e a GDP

14

Boletim Tcnico

Sim

MATA
030

Sim

RVENDOR

CTBA
030

Sim

CUSTOME
im

COSTCEN
TER

MATA

Sim

BANK

FINA0

FINANCIAL
NATURE

FINA0
70

ACCOUNT
RECEIVABLEDOC

as

Tod

Tod

EA
I

Tod
as

S
incrono

EA
I

as

ncrono

EA
I

as

ncrono

im

im

Tod

ncrono

im

im

S
ncrono

im

im

10

S
im

im

070
Sim

EA
I

Atu
alizao

EA
I

SE1>E1_ORIGEM==

UMENTDISCHAR

FINI055

GE
Sim

FINA0
70

REVERSAL
OFACCOUNTREC

S
im

N
o

S
ncrono

Ex
cluso

EA
I

SE1>E1_ORIGEM==

EIVABLEDOCUME

FINI055

NTDISCHARGE
Sim

FINA0
80

ACCOUNT
PAYABLEDOCUME

S
im

N
o

S
ncrono

Atu
alizao

EA
I

>E2_ORIGEM==

NTDISCHARGE
Sim

FINA0
80

FINI055

REVERSAL
OFACCOUNTPAYA

S
im

N
o

S
ncrono

Ex
cluso

EA
I

FINI055

SCHARGE
FINA0
55
Sim

FINANCIN
G

MATA

ORDER

S
im

S
im

FINI0
70A

S
im

120
Sim

UPDATEC
ONTRACTPARCEL

S
im

S
im

Tod
as

S
ncrono

S
im

S
ncrono

Tod
as

S
ncrono

EA
I
EA
I

Tod
as

EA
I

Acima temos a tabela que com as informaes que devem ser inseridas no cadastro dos registros.
Configurar o EAI para Integrao no Protheus

Informe o nome do Produto e a GDP

SE2>E2_ORIGEM==

BLEDOCUMENTDI
Sim

SE2-

13

Boletim Tcnico

No Protheus, navegue nas abas na direta da tela:. Ambiente > Schedule > Schedule.

Informe o nome do Produto e a GDP

14

Boletim Tcnico

Clique no boto + do lado do globo verde e em seguida em Cadastros. Note que as informaes sero preenchidas automaticamente. Verifique se os
dados esto corretos e, se necessrio, complete se estiver algo incompleto ou errado.
Cadastrar agendamento

Clique em Agendamentos > Cadastros e na parte inferior, abaixo de Detalhes, clicar no cone com um smbolo + amarelo.

Informe o nome do Produto e a GDP

13

Boletim Tcnico

Algumas informaes aparecero automaticamente, complete o preechimento apenas em Rotina com FWEAI e com a Empresa/Filial clicando na lupa
no canto direito da tela como mostra a imagem abaixo, aparecer uma tela listando as empresas, bastar marcar com o checkbox e clicar em OK. Aps isso
basta clicar no boto verde de confirmao;
Configurar parmetros de integrao

No Protheus navegue em Ambiente > Cadastros > Parametros

Informe o nome do Produto e a GDP

14

Boletim Tcnico

Esta tela mostra todos os parmetros configurados. Clique na lupa para BUSCAR algum parmetro e na cone com uma folha e um lpis para EDITAR um
parmetro.

No caso de busca (clicando na lupa) o parmetro buscado aparecer em primeiro na lista. No exemplo acima foi buscado o parmetro MV_EAIURL2,
faa esta busca pelos parmetros abaixo e preencha o de acordo com o que especificado.
MV_EAIURL2= Endereo WebService que Receber os Dados Enviados (Exemplo: http://10.31.8.90/TBC/wsEAIService.asmx?wsdl).
MV_EAIWS= Informe o nome do Client WebService do EAI para envio a outro EAI. (WSEAISERVICE).
MV_EAIUSER= <Nome de usurio> (Opcional em caso do Servidor precisar de Autenticao).
MV_EAIPASS= <Senha de usurio> (Opcional em caso do Servidor precisar de Autenticao).

Informe o nome do Produto e a GDP

13

Boletim Tcnico

MV_EAIMETH= Informe o metodo de envio do EAI para envio a outro EAI. (RECEIVEMESSAGE).

INFORMAES

ADICIONAIS

INFORMAES TCNICAS

Informe o nome do Produto e a GDP