Este boletim técnico descreve os passos para configurar a integração entre o sistema TOTVS Incorporação x BackOffice Protheus. Inclui detalhes sobre como configurar o arquivo appserver.ini, o DBAccess, e o cadastro de adapters EAI no Protheus para habilitar a comunicação entre os sistemas.
Este boletim técnico descreve os passos para configurar a integração entre o sistema TOTVS Incorporação x BackOffice Protheus. Inclui detalhes sobre como configurar o arquivo appserver.ini, o DBAccess, e o cadastro de adapters EAI no Protheus para habilitar a comunicação entre os sistemas.
Este boletim técnico descreve os passos para configurar a integração entre o sistema TOTVS Incorporação x BackOffice Protheus. Inclui detalhes sobre como configurar o arquivo appserver.ini, o DBAccess, e o cadastro de adapters EAI no Protheus para habilitar a comunicação entre os sistemas.
Configurao do Protheus Produto : TOTVS Incorporao x BackOffice Protheus Processo : Configurao Subprocesso Configurao do Protheus Data da publicao : 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) SOURCEPATH=D:\Protheus11\apo\P11_INTEGRA_TIN (caminho do *.rpo) Boletim Tcnico
2 Informe o nome do Produto e a GDP 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 DEFAULTPAGE=wsindex.apw Boletim Tcnico 3 Informe o nome do Produto e a GDP [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 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 Boletim Tcnico
4 Informe o nome do Produto e a GDP
No exemplo acima temos o arquivo configurado e a linha adicionada.
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) Boletim Tcnico 5 Informe o nome do Produto e a GDP
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. Boletim Tcnico
6 Informe o nome do Produto e a GDP
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. Boletim Tcnico 7 Informe o nome do Produto e a GDP
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.
Boletim Tcnico
8 Informe o nome do Produto e a GDP 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. Boletim Tcnico 9 Informe o nome do Produto e a GDP
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.
Boletim Tcnico
10 Informe o nome do Produto e a GDP 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 Boletim Tcnico 11 Informe o nome do Produto e a GDP
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 Rotina Mensagem E nvia R ecebe M todo Op erao Ca nal Envio Condio Sim MATA0 20 CUSTOMERV ENDOR S im S im S ncrono Tod as EAI
Sim MATA0 CUSTOMERV S S S Tod EAI
Boletim Tcnico
12 Informe o nome do Produto e a GDP 30 ENDOR im im ncrono as Sim CTBA0 30 COSTCENTE R S im S im S ncrono Tod as EAI
Sim MATA0 70 BANK S im S im S ncrono Tod as EAI
Sim FINA01 0 FINANCIALN ATURE S im S im S ncrono Tod as EAI
Sim FINA07 0 ACCOUNTRE CEIVABLEDOCUMENT DISCHARGE S im N o S incrono Atu alizao EAI SE1- >E1_ORIGEM==FINI 055 Sim FINA07 0 REVERSALOF ACCOUNTRECEIVABL EDOCUMENTDISCHA RGE S im N o S ncrono Excl uso EAI SE1- >E1_ORIGEM==FINI 055 Sim FINA08 0 ACCOUNTPA YABLEDOCUMENTDIS CHARGE S im N o S ncrono Atu alizao EAI SE2- >E2_ORIGEM==FINI 055 Sim FINA08 0 REVERSALOF ACCOUNTPAYABLED OCUMENTDISCHARG E S im N o S ncrono Excl uso EAI SE2- >E2_ORIGEM==FINI 055 Sim FINA05 5 FINANCING S im S im S ncrono Tod as EAI
Sim MATA1 20 ORDER S im S im S ncrono Tod as EAI
Sim FINI07 0A UPDATECON TRACTPARCEL S im S im S ncrono Tod as EAI
Acima temos a tabela que com as informaes que devem ser inseridas no cadastro dos registros. Configurar o EAI para Integrao no Protheus Boletim Tcnico 13 Informe o nome do Produto e a GDP
No Protheus, navegue nas abas na direta da tela:. Ambiente > Schedule > Schedule. Boletim Tcnico
14 Informe o nome do Produto e a GDP
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. Boletim Tcnico 15 Informe o nome do Produto e a GDP 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 Boletim Tcnico
16 Informe o nome do Produto e a GDP
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). Boletim Tcnico 17 Informe o nome do Produto e a GDP MV_EAIMETH= Informe o metodo de envio do EAI para envio a outro EAI. (RECEIVEMESSAGE).