AMBIENTE LINHA RM E BACKOFFICE PROTHEUS

Processo : Ambiente

Subprocesso Montagem de Ambiente com Linha RM e BackOffice Protheus.

Data da publicação : 10/12/2012

Este documento irá abordar a montagem de um ambiente do BackOffice Protheus e da Linha RM cuja

integração utilize Mensagem Única.

É um documento geral que não aborda a parte de configuração da integração em si. Após a montagem do

ambiente, devem ser realizadas as configurações referentes a integração que se encontram na especificação

da mesma.

Conteúdo 1. Pré Requisitos .................................................................................................................................................................... 3

1.1 Obtendo Arquivos ............................................................................................................................................................... 3

1.2 Atualizações Protheus ......................................................................................................................................................... 3

2. Instalação .......................................................................................................................................................................... 5

2.1 RM ....................................................................................................................................................................................... 6

2.2 Protheus .............................................................................................................................................................................. 6

2.3 DBAcces ............................................................................................................................................................................... 9

3. Configuração.................................................................................................................................................................... 12

3.1 Protheus – Banco de dados ............................................................................................................................................... 12

3.1.1 Configurando Banco SQL .............................................................................................................................................. 15

3.1.2 Configurando Banco Oracle .......................................................................................................................................... 18

3.1.3 Configurando Conexões no DBAcces ............................................................................................................................ 24

3.2 Protheus – AppServer ........................................................................................................................................................ 29

3.3 Protheus –WS Protheus ..................................................................................................................................................... 29

3.4 TOTVS Business Connect ................................................................................................................................................... 42

3.5 Painel de Controle ............................................................................................................................................................. 43

3.6 Internet Information Services (IIS) .................................................................................................................................... 44

3.7 Web.config ........................................................................................................................................................................ 50

4. Configuração específicas da Integração .......................................................................................................................... 53

4.1 Configurações iniciais ........................................................................................................................................................ 53

4.2 Adapters ............................................................................................................................................................................ 60

4.3 Schedules .......................................................................................................................................................................... 66

4.4 De-para .............................................................................................................................................................................. 70

2

4.5 Observações importantes ................................................................................................................................................. 79

4.6 Configurações iniciais ........................................................................................................................................................ 80

4.7 Parametros da integração ................................................................................................................................................. 85

4.8 Problemas frequêntes ....................................................................................................................................................... 86

3

Desenvolvimento/Procedimento

1. Pré Requisitos

Para montar o ambiente é necessário instalar:

Protheus versão 11

RM versão 11.80

Oracle 10G | Microsoft SQL Server 2008

Nota: instale o Oracle 10G e o MSSQL caso deseje montar um ambiente com os dois tipos de banco.

Caso contrario escolha somente♣ um.

DBAcces

IIS

SqlDbx, Developer, SQL Tools, etc.

Nota: Qualquer ferramenta para comunicar com o Banco de dados Oracle.

SOAP UI

Nota: para auxiliar na validação referente à mensagem única caso a integração utilize a mesma.

1.1 Obtendo Arquivos

Oracle: \\fileserver\Softwares\Livres\Banco de Dados\Oracle

MSSQL: \\fileserver\Softwares\Livres\Banco de Dados\SQL Server

RM: \\tecnologiabh\Instalar\CorporeRM\Versoes\11.8x

Protheus: http://www.totvs.com/suporte/central-de-download/seu-segmento/produto/microsiga

Nota: Selecionar a opção TOTVS Application Server.(A página só funcionou no IE)

1.2 Atualizações Protheus

As versões mais recentes dos arquivos do Protheus podem ser encontradas nos seguintes caminhos:

Espelho do Portal: \\172.16.103.229\espelho-portal

É um diretório interno onde se encontram os arquivos disponibilizados no portal do cliente. Entre eles

podemos destacar as seguintes pastas:

AppServer/SmartClient: Protheus11\binario referencia 700120420ª

Nota: abrir o arquivo .rar e copiar o conteúdo da pasta AppServer para a pasta bin\appserver

do seu computador. Fazer o mesmo para a pasta SmartClient.

RPO: Protheus11\1-apo-BRA-CHI-EUA-PAR-URU\topconnect

Nota: arquivo liberado para cliente. Para homologação o ideal é utilizar o do caminho D-1.

4

Updates: Protheus11\2-update-BRA-CHI-EUA-PAR-URU\topconnect

Nota: arquivo liberado para cliente. Para homologação o ideal é utilizar o do caminho D-1.

Dicionários/Help Campos/Menus: Protheus11\Systemload

Nota: arquivo liberado para cliente. Para homologação o ideal é utilizar o do caminho ATUSX.

DBAccess: Protheus11\TOTVS DBAccess

D-1: \\172.16.103.229\d-1

É um diretório onde são armazenadas as compilações diárias do Protheus. Semelhante a CM do RM.

Esta pasta e atualizada automaticamente com os últimos fontes liberados no TFS. Selecione a pasta

P11.

A nomenclatura do RPO é XX-X-X-000; onde:

tt - TOTVS;

a, c, d, t - ads, codebase, ctree, topconnect

e, p, s - english, portuguese, spanish

110 - Versão do Protheus

ATUSX: \\172.16.93.23\temp

É um diretório onde são disponibilizados diariamente as ultimas versões dos dicionários, dos menus e

dos arquivos de help cadastrados no ATUSX.

ATUSX: Gerenciador de base de dados, helps e CHs. O ATUSX é a ferramenta utilizada na criação e

manutenção de:

Dicionários:

• Índices (SIX)

• Perguntas (SX1)

• Arquivos (SX2)

• Campos (SX3)

• Tabelas genéricas (SX5)

• Parâmetros (SX6)

• Gatilhos (SX7)

• Relacionamentos (SX9)

• Pastas (SXA)

• Consultas Padrão (SXB)

• Grupo de campos (SXG)

Arquivos “.CH”

Menus do sistema

Tabelas Padrão

Help de campos e mensagens

5

2. Instalação

2.1 RM

Utilizar a versão 11.82.26.108 (ou superior)

A versão 11.80 da linha RM utiliza internamente o “novo modelo” de estoque/compras e financeiro.

A TOTVS disponibiliza um backup da base de dados RM “vazia” que pode ser utilizada para novos clientes. Para clientes que já possuem

versão anterior utilizar o Conversor RM para atualizar o banco de dados.

O TIN já está 100% migrado para a plataforma .net, por isto os clientes podem usar a nova MDI (RM.exe) para todas as suas

funcionalidades, não sendo mais necessário instalar o RMSGI.exe (instalador TOTVSIncorporacao*.msi).

http://interno.totvs.com/suporte/central-de-download/seu-segmento/produto/rm

6

2.2 Protheus

O setup da instalação pode ser baixado através do seguinte link: http://www.totvs.com/suporte/central-de-

download/seu-segmento/produto/microsiga escolhendo opção TOTVS Application Server.

Este setup fará o download do Protheus.

7

Após a instalação, os seguintes ícones serão gerados:

]

Clicando em Server Configuration Assistent, abrirá uma tela de configuração do Protheus.

8

Caso utilize o instalador acima, clique em TOTVS | Application Server.

Obs: Este modelo de instalação não é o obtido através do site http://www.totvs.com.

Concluída a instalação, acesse o diretório onde esta o Protheus e localize a pasta bin\appserver. Crie um atalho na

área de trabalho para o appserver.exe. Localize a pasta bin\smartclient e faça o mesmo para smartclient.exe.

Selecione o atalho do appserver na área de trabalho e abra as propriedades do mesmo. No campo Destino insira no

final do caminho: -console.

9

Selecione também o atalho do smartclient e abra as propriedades do mesmo. No campo Destino insira no final do

caminho: -m. Isso irá permitir abrir mais de uma instância do smartclient.

2.3 DBAcces

Execute novamente o instalador do Protheus e selecione a opção TOTVS | DBAcces. A instalação é bem intuitiva.

10

Após abra o local onde foi instalado o DBAcces.exe, e no caminho do diretório, insira no final –install.

O DBAcces será instalado como serviço.

Observação:

Outra maneira de configurar o DBAcces sem instalar como serviço é:

11

Abra a pasta onde o DBAcces foi instalado e crie um atalho do DBAcces.exe e do DBMonitor.exe na área de

trabalho. Selecione o atalho do DBAcces e abra as propriedades do mesmo. No campo Destino, no final do

caminho insira: -console.

Após basta iniciar o DBAcces:

Importante!! Quando o DBAcces é iniciado dessa forma, sempre que for fechar é necessário digitar CTRL + C,

e YES para confirmar. Após é necessário aguardar o aplicativo fechar sozinho. Este procedimento deve ser

realizado para não dar inconsistências na base.

12

3. Configuração

3.1 Protheus – Banco de dados

Para criar um ambiente com dois tipos de bancos, acesse o diretório do Protheus, pasta apo: C:\TOTVS

11\Microsiga\Protheus\apo

Crie duas pastas: MSSQL e ORACLE.

Copie o arquivo RPO para dentro de cada uma das pastas.

O arquivo é obtido no caminho D-1: \\172.16.103.229\d-1 pasta P11. Selecione o arquivo tttp110.

Nota: Escolha o arquivo que corresponda ao ambiente que deseja criar. Neste caso, o arquivo refere-se ao topconnect,

linguagem portuguesa, versão 110. A nomenclatura dos arquivos RPO está detalhada no início do documento, na parte

de Atualizações Protheus.

13

Observação:

Caso esteja montando ambiente apenas para um tipo de banco, basta não criar as pastas ORACLE e MSSQL,

e copiar o arquivo RPO direto para a pasta Protheus\apo

Copie os arquivos de dicionário para a pasta: C:\TOTVS 11\Microsiga\Protheus_Data\system. Selecione apenas os

arquivos .xnu que são os arquivos de menu.

Os arquivos são encontrados em: \\172.16.93.23\temp\20121128\rel\txt\bra

Nota: Sendo que 20122128 é a data (AAAAMMDD). Selecione a pasta com a data mais atual.

14

Copie os outros dois arquivos - sx2.unq e sxsbra.txt - que são arquivos de dicionário, para a pasta: C:\TOTVS

11\Microsiga\Protheus_Data\systemload

Para um ambiente com os dois tipos de banco, faça uma cópia da pasta Protheus_Data e renomeie uma pasta para

Protheus_oracle e a outra Protheus_mssql.

15

3.1.1 Configurando Banco SQL

São necessárias duas bases, uma para o RM e outra para o Protheus.

Para o RM, restaure e configure a base desejada normalmente. Para o Protheus não é necessário restaurar uma base.

O Protheus cria as tabelas necessárias para o seu funcionamento de forma automática, sendo necessária apenas a

configuração apontando para uma database vazia.

Para criar uma nova database no SQL Server conecte-se no mesmo, clique com o botão direito em cima de “Databases”

e selecione “New Database”.

Informe o nome da base no campo “Database name” e clique em ok.

As bases foram criadas.

Para a base Protheus é necessário criar um ODBC com o programa odbcad32. Abra o programa, selecione a aba “Fonte

de Dados de Sistema”, e clique em “Adicionar”.

16

Selecione a fonte de dados SQL Server e clique em “Concluir”.

Informe o nome da base de dados protheus criada anteriormente e o servidor. Clique em “Avançar”.

17

Clique em “Avançar”.

Selecione “Alterar o banco de dados padrão para”, escolha a base de dados protheus e clique em “Avançar”.

Caso deseje, altere o idioma. Após clique em “Concluir”.

18

Uma janela contendo o resumo da nova fonte de dados é exibida. Clique no botão “Testar fonte de dados...” para

validar a conexão.

Caso tudo tenha sido configurado corretamente o teste será realizado com sucesso, como mostra a imagem abaixo:

3.1.2 Configurando Banco Oracle

Da mesma forma que no SQL, são necessárias duas instâncias, uma para o RM e outra para o Protheus.

Para o RM, restaure e configure uma base de dados normalmente. Para o Protheus, iremos configurar um novo

schema no Oracle. Para isso temos que criar um usuário que será utilizado pelo Protheus. Utilize uma ferramenta para

acessar a instância oracle criada para o RM. O comando que será executado deve ser rodado com o usuário sys ou

system.

19

No exemplo abaixo foi utilizado a ferramenta SqlDbx.

O comando para criar um novo usuário é:

-- USER SQL

CREATE USER usuárioProtheus IDENTIFIED BY senhaProtheus

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP;

-- ROLES

GRANT "RESOURCE" TO usuárioProtheus WITH ADMIN OPTION;

GRANT "DBA" TO usuárioProtheus WITH ADMIN OPTION;

GRANT "CONNECT" TO usuárioProtheus WITH ADMIN OPTION;

ALTER USER usuárioProtheus DEFAULT ROLE "RESOURCE","DBA","CONNECT";

-- QUOTAS

ALTER USER usuárioProtheus QUOTA UNLIMITED ON SYSTEM;

Nota: Altere usuárioProtheus para o nome do usuário que deseja criar, e senhaProtheus para a senha do usuário.

Nota: Altere usuárioProtheus para o nome do usuário que deseja criar, e senhaProtheus para a senha do usuário.

Para validar se o usuário foi criado, basta logar na mesma instância informando o usuário e senha.

20

Após a criação do usuário do protheus devemos configurar uma nova nomeação de serviço na ferramenta Oracle Net

Manager.

Selecione a pasta “Nomeação de Serviço” no Net Manager e clique em + para criar uma nova nomeação.

21

Informe um nome para o serviço de rede e clique em “Próximo”.

Selecione o protocolo TCP/IP e clique em “Próximo”.

Informe o nome do host e a porta (default 1521) e clique em “Próximo”. (Insira o nome da sua máquina ou

simplesmente localhost)

22

Informe o nome do SID informado na instalação do Oracle. Clique em “Próximo”.

Nota: O SID é o nome da instância RM do Oracle

Clique em “Testar” para validar se as configurações realizadas estão corretas.

23

Clique no botão “Alterar Login” e informe o nome do usuário e senha criados com o script anteriormente. Clique no

botão “Ok”.

Após clique em “Testar”. Caso a configuração tenha sido executada corretamente o teste de conexão será bem

sucedido.

Clique em “Fechar” para fechar a tela de testes e depois clique em “Finalizar” para concluir a instalação.

Importante!

Antes de encerrar a aplicação selecione o menu Arquivo | Salvar Configuração de Rede para salvar a

configuração realizada.

24

3.1.3 Configurando Conexões no DBAcces

Após a criação e configuração do database/schema temos que configurar as conexões no TOTVS DBAccess. Ele é a

ferramenta utilizada pelo Protheus para fazer a comunicação entre o appserver e o SGBD.

Inicialize o DBAcces.

Observação

Se o DBAcces foi instalado como serviço verifique se o mesmo esta ativo.

Caso tenha sido configurado da outra forma, execute o DBAcces através do atalho.

Após iniciar o DBAcces, inicie o DBMonitor.

25

Para configurarmos a conexão com o SQL Server utilizaremos a aba “Configurações” e depois a aba “Microsoft SQL”.

Clique no botão “Novo”, e informe a base protheus referente ao banco SQL, nome do usuário e senha.

26

Para configurarmos a conexão Oracle utilizaremos a aba “Configurações” e depois a aba “Oracle”. Clique no botão

“Novo” e informe a base protheus, o nome do usuário e a senha.

Marque o checkbox “Usar BLOB para campo MEMO”.

Importante!

27

O DBAccess precisa que o caminho para a biblioteca do Oracle seja informada para o seu correto

funcionamento.

Fazemos isto através do arquivo DBAccess.ini no diretório onde foi instalado o DBAcces. Edite o arquivo e

acrescente a propriedade clientlibrary abaixo da chave [Oracle].

Exemplo:

[ORACLE]

environments=protheus,P11

Nota: a propriedade clientlibrary deve ser igual ao caminho onde esta instalada a dll oci.dll. Podendo variar

conforme escolha do diretório de instalação do DBAcces.

Após finalizarmos a configuração das conexões podemos realizar o teste das mesmas através da aba “Assistentes”.

Clique no botão “Validação de Conexão”.

Clique em “Avançar”. Selecione o SGBD e clique em “Avançar”. Informe o nome da conexão criada e clique em

“Finalizar”.

28

29

Se a conexão foi configurada corretamente será mostrada a janela a seguir.

Realize o mesmo teste para a base oracle.

3.2 Protheus – Appserver.ini

Nesta segunda parte da configuração do Protheus, iremos configurar o arquivo appserver.ini. Ele se encontra na pasta

appserver, no diretório onde foi instalado o Protheus: C:\TOTVS 11\Microsiga\Protheus\bin\appserver

30

Seção Environment

Deve possuir as propriedades:

[Environment]

SOURCEPATH=pasta onde se encontra o RPO

ROOTPATH=pasta protheus data

STARTPATH=nome da pasta system

RPODB=tipo de conexão (TOP)

RPOLANGUAGE=linguagem do RPO (Portuguese)

RPOVERSION=versão do RPO (110)

LOCALFILES=tipo dos arquivos locais (ADS)

LOCALDBEXTENSION=extensão das tabelas locais (.dbf)

PICTFORMAT=DEFAULT

REGIONALLANGUAGE=localização (BRA)

TOPSERVER=endereço do DBAccess

TOPPORT=porta do DBAccess (7890)

TOPDATABASE=banco de dados (MSSQL/ORACLE)

TOPALIAS=alias do banco Protheus

TOPALIASRM=alias do banco RM

Notas:

o Algumas propriedades podem se encontrar na sessão DBAcces. Neste caso, retire as mesmas dessa

sessão e transfira-as para a sessão Environment, inserindo TOP na frente. A sessão DBAcces deixa

de existir.

o Altere o nome Environment por um nome que represente a conexão que está sendo criada.

o Caso esteja montando dois ambientes – Oracle e MSSQL – basta criar outra seção Environment,

renomeando a mesma.

Realizada as alterações, a seção ficará assim:

31

Seção Geral

Deve possuir as propriedades:

[GENERAL]

InstallPath=pasta do Protheus

console=loga no console (0/1)

BuildKillUsers=desconecta todos os usuários quando compilar o RPO (0/1)

LogEnable=habilitar arquivo de log (0/1)

ConsoleLog=loga no console (0/1)

consolemaxsize=tamanho máximo do log (10000000)

ConsoleFile=arquivo de log

Segmento=cYdTm3WWERZF=1hu

Serie===AV

Realizada as alterações, a seção ficará assim:

32

Seção de Serviço

Deve possuir as propriedades:

[SERVICE]

Name=Protheus11

DisplayName=Protheus 11

Nota: Caso não exista no arquivo deve ser incluída.

Realizada as alterações, a seção ficará assim:

Seções [TCP], [Drivers] e [GENTCPIP]

Devem possuir as propriedades:

[TCP]

TYPE=TCPIP

Port=porta do appserver

33

[Drivers]

Active=TCP

[GENTCPIP]

Enable=0

Notas:

o Caso não existam no arquivo as seções devem ser incluídas.

o A porta informada na seção TCP deve ser informada também no arquivo smartclient.ini na seção.

Realizada as alterações, as seções ficarão assim:

Seção LICENSECLIENT

Deve possuir as propriedades:

[LICENSECLIENT]

server= servidor

port= porta

Realizada as alterações, a seção ficará assim:

34

Segue descritivo da Configuração do INI para o WebService. (EXEMPLO)

Primeira Página: Segunda Página:

[ws]

SourcePath=E:\Protheus11\APO_WS

RootPath=E:\Protheus11\Protheus_Data

StartPath=\system\

x2_path=

RpoDb=Top

RpoLanguage=portuguese

RpoVersion=110

LocalFiles=ads

Trace=0

localdbextension=.dbf

PictFormat=DEFAULT

DateFormat=DEFAULT

RegionalLanguage=BRA

THEME=STANDARD

helpserver=help.outsourcing.com.br/p11/

;IXBLOG=NORUN

[DBAccess]

DataBase=MSSQL

Server=192.168.1.3

ALIAS=DADOSP10

PROTHEUSONLY=0

[Drivers]

Active=TCP

[TCP]

TYPE=TCPIP

Port=3333

[General]

InstallPath=E:\Protheus11

[LICENSESERVER]

enable=0

port=5555

ShowStatus=1

[LICENSECLIENT]

server=192.168.1.3

port=5556

[TDS]

allowApplyPatch=*

[SERVICE]

NAME=Protheus11Service-ws

DISPLAYNAME=TOTVS - ServerWS

[HTTP]

ENABLE=1

PORT=84

RpcEnable=0

instances=1,10

SessionTimeout=30000

HyperHsEnv=1

Cache-control=no-store

PATH=E:\Protheus11\Protheus_Data

RESPONSEJOB=JOB_WSINTEGRACAO_T1_MSP11

[192.168.1.3:84]

ENABLE=1

environment=ws

PATH=E:\Protheus11\Protheus_Data

INSTANCENAME=JOB_WSINTEGRACAO_MSP11

DEFAULTPAGE=wsindex.apw

RESPONSEJOB=JOB_WSINTEGRACAO_MSP11

[JOB_WSINTEGRACAO_MSP11]

TYPE=WEBEX

INSTANCES=1,10

SIGAWEB=WS

INSTANCENAME=status

ONSTART=__WSSTART

ENVIRONMENT=ws

ONCONNECT=__WSCONNECT

;PREPAREIN=99,01

Trace=1

;COMANDO PARA MOSTRAR LOG E ERROS

XMLSAVEALL=1

NameSpace=http://www.totvs.com.br

WEBSERVICELocation=http://192.168.1.3:84

URLLocation=http://192.168.1.3:84

35

3.3 Protheus – WS Protheus

Abra o SmartClient com SRVWIZARD

Em módulo web selecione WS Microsiga Protheus 11 Web Services Nome da instancia = EAI

O diretório raiz é preenchido automaticamente

Selecione o enviroment (Ambiente)

O parâmetro habilitar processos faz o WS subir automaticamente com o appserver e criará a tag ONSTART=__WSSTART

no .ini

36

Neste assistente, é necessário informar no host: Localost, o ip da máquina e o nome da máquina, como no exemplo abaixo

Ao adicionar cada host, é necessário em seguida selecionar a filial (não é necessário fazer o procedimento para todas as filiais)

E clicar em relacionar. O registro aparecerá na parte de baixo da janela.

Insira o número mínimo de usuários e o número máximo. Clique em avançar.

37

Sim

Clique em ok e reinicie o appserver.

O wizard cria como padrão na porta 80. Poderá acontecer conflito caso haja o IIS rodando na máquina, que

também roda na porta 80. Para alterar a porta, é necessário acessar o appserver.ini realizara a alteração como no exemplo:

38

Testando o WS

39

Caso não esteja modo console, poderá ser visualizado via log

http://localhost:8095/EAISERVICE.apw?WSDL

http://10.31.8.37:8095/EAISERVICE.apw?WSDL

http://bhd0005396:8095/EAISERVICE.apw?WSDL

40

Para configurar o EAI precisamos cadastrar o job que irá monitorar a fila de integração. Esta configuração é feita no

módulo SIGACFG do Protheus.

Inicie o appserver, e após o smartclient. Informe usuário e senha.

Nota: caso o protheus tenha sido instalado desde o zero, será necessário realizar algumas configurações antes de

acessar o módulo SigaCFG:

Escolha a localização.

Informe o diretório dos arquivos de dados (selecione a pasta data).

Informe o valor das Moedas

41

Acesse: Ambiente | Schedule | Schedule. Após: Schedule | Agent | Cadastro

Clique em Incluir para cadastrar o JOB. Insira as informações solicitadas e salve o cadastro.

42

Depois em Agendamento|Cadastro. Clique em incluir e informe a Rotina: FWEAI e Empresa/Filial: Informe a empresa.

3.4 TOTVS Business Connect

Para instalar os web services execute o instalador do TOTVS Business Connect.

O aplicativo esta disponível em: \\tecnologiabh\Instalar\CorporeRM\Versoes

43

Nota: Quando o IIS é instalado após o Visual é necessário rodar um comando para aplicar algumas configurações antes

instalar o web service:

Abra o prompt de comando e acesse o diretório: C:\Windows\Microsoft.NET\Framework\v4.0.30319

Após execute o comando aspnet_regiis -1.

Após executar o comando, rode o instalador TOTVS Business Connect para instalar o web service

3.5 Painel de Controle

Antes de abrir o IIS, abra o Painel de Controle e acesse a parte referente a Programas e Recursos. Clique em “Ativar

ou desativar recursos do Windows”.

Verifique se todas as opções referentes a “Serviços de Informações da Internet” estão selecionadas. Caso não esteja,

selecione e salve as alterações.

44

3.6 Internet Information Services (IIS)

Abra o IIS.

45

Selecione “Pools de Aplicativos” e verifique se todos os serviços estão iniciados.

Selecione: Sites | Default Web Site | TOTVBusinessConnect. Do lado direito selecione “Configurações Avançadas”.

Em Pool de Aplicativos deve estar Classic .NET AppPool.

Nota: Também pode estar preenchido com ASP.NET v4.0 Classic ou TOTVSBusinessConnect

46

Após realizar a configuração do Pool de Aplicativos selecione “TOTVBusinessConnect” e clique em “Autenticação”.

Apenas a “Autenticação Anônima” deve estar habilitada. Todas as outras devem estar desabilitadas.

47

Em seguida, selecione o servidor e clique em “Restrições ISAPI e CGI”.

Valide se a restrição do ASP.NET v4 está como Permitido. Caso não esteja altere para este status.

48

Nota: Os itens listados podem estar ou não com status permitido, mas é necessário que pelo menos o ASP.NET v4 esteja

com este status.

Para verificar se o WebService do RM está Funcionando utilize a chamada

http://Servidor/TOTVSBusinessConnect/wsEAIService.asmx?wsdl no browser, o usuário e senha que pedir será o mesmo que foi

configurado no Protheus em Parâmetros.

Para criação do De-Para das informações já existente na base de dados das tabelas: FCFO, FLAN, GCCUSTO, TTBORCAMENTO.

Deve-se rodar o script abaixo após ter executado a rotina de criação do De-Para no Protheus.

49

As configurações do “RM.Host.Service.exe.config”, “RM.exe.config” e “Web.config” devem estar corretamente alinhados,

como na figura abaixo:

50

3.7 Web.config

No diretório do RM, os web services foram instalados na pasta WS_TBC. Será necessário realizar alguma configurações

no arquivo web.config.

Abra o arquivo e localize a tag appSettings.

51

Altere as tags:

Host = informe a máquina

Port = porta do host

DBAlias = alias do banco de dados RM (no momento só aceita CORPORERM)

JobServer3Camadas = true (apenas se o acesso for de outra máquina)

Após alterar o arquivo irá ficar assim:

O smartclient.ini também deve ser verificado. Ele pode ser localizado na mesma pasta do smartclient.exe.

Para validar se as configurações realizadas estão corretas abra o browser e informe no endereço: localhost ou IP da

máquina /TOTVSBusinessConnect/wsEAIService.asmx

Será solicitado que informe usuário e senha para realizar a autenticação.

Nota: O usuário e senha são da base de dados que foi configurada no arquivo web.config.

52

Após informar os dados e realizar o login, a página do web.service será apresentada.

53

4. Configuração do TOTVS Incorporação

4.1 Configurações iniciais

O WebService é fundamental para integração das funcionalidades do TOTVS – Protheus com o RM TIN.

O WebService deve estar com o Serviço EAISERVICE - HABILITADO, como segue figura abaixo:

É importante ter um serviço e um RPO do Protheus separados para o WebService. Diante disso foi criado as seguintes pastas

para o WebService:

o PROTHEUS11\BIN\APPSERVER_WS (Diretório do serviço de WS) o PROTHEUS11\APO_WS (RPO do service de WS)

OBS: O Serviço de WebService é único, não havendo necessidade de ter um serviço por empresa.

54

Procedimento de Atualização de Parâmetros, Adapters e Schedules

Configuração de Parâmetros (Por empresa)

Parâmetro MV_EAIMETH – Informe o método de envio do EAI para envio a outro EAI - Conteúdo = receiveMessage.

Parâmetro MV_EAIURL2 – Conteúdo = Webservice RM (Ex: http://192.168.1.3/TOTVSBusinessConnect/wsEAIService.asmx?wsdl)

55

Parâmetro MV_EAIWS – Informe o nome do Client WebService do EAI para envio a outro EAI - Conteúdo = WSEAISERVICE

Parâmetro MV_EAIUSER - <Nome do usuário> (Opcional em caso do servidor precisar de autenticação)

56

Parâmetro MV_EAIPASS – <Senha do usuário> (Opcional em caso do servidor precisar de autenticação)

Parâmetro MV_MULNATR – Conteúdo = F (Esse parâmetro determina se vai haver rateio de Natureza Financeira no Contas a

Receber, deve ser configurado conforme regra de negócio da empresa).

57

Parâmetro MV_MULNATP – Conteúdo = F (Esse parâmetro determina se vai haver rateio de Natureza Financeira no Contas a Pagar,

deve ser configurado conforme regra de negócio da empresa).

Parâmetro MV_FINJRTP – Conteúdo = 3 - (Considerar na baixa do título em atraso: 1. Taxa de permanência(padrão) 2. Juros

3.Ambos).

58

Parâmetro MV_ITLBCPO – Conteúdo = .T. - (Libera campos multa, juros caso tenha integração TIN x PROTHEUS).

Menu SigaCfg Protheus:

É necessário que as seguintes opções existam no menu do configurador do Protheus, para que seja possível configurar os

cadastros necessários para a integração RM TIN x Protheus:

59

60

4.2 Adapters

Configuração de Adapters (Por Empresa)

Os Adapters são as rotinas que englobam o envio e recebimento das informações entre TOTVS – Protheus e RM TIN, de modo

on-line, através de mensagem única (arquivo XML).

É importante que os dados sejam preenchidos e criados exatamente como segue nas figuras e descrições.

Para realizar a inclusão ou alteração de um Adapter, é necessário ter permissão para acesso ao ambiente Configurador do

Protheus. SIGACFG.

Obs: O campo ALIAS no cadastro de adapter serve para a seguinte situação: Gestão de empresas e cadastros compartilhados

por nível de empresa. Quando informado o Alias referente a aquela mensagem, o sistema (Protheus) ira verificar o compartilhamento

do Alias informado, e dependendo do como estiver compartilhado o RM ira tratar se devera ou não replicar os informações enviadas.

Abrindo o módulo configurador, deve-se abrir o Menu Ambiente – Schedule – Adapter E.a.i.

61

Segue tela com todos os Adapters necessários para funcionamento da integração.

O adapter APCFG060 - WHOIS é padrão do sistema, mas deve estar configurado exatamente como segue abaixo.

Adapter CTBA030 – COSTCENTER – CENTRO DE CUSTO

62

Adapter FINA010 – FINANCIALNATURE

Adapter FINA055 – FINANCING

Adapter FINA070 – ACCOUNTRECEIVABLEDOCUMENTDISCHARGE

63

Adapter FINA070 – REVERSALOFACCOUNTRECEIVABLEDOCUMENTDISCHARGE

Adapter FINA080 – ACCOUNTPAYABLEDOCUMENTDISCHARGE

64

Adapter FINA080 – REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE

Adapter FINA070A – UPDATECONTRACTPARCEL

Adapter MATA020 – CUSTOMERVENDOR

65

Adapter MATA030 – CUSTOMERVENDOR

Adapter MATA070 – BANK

Adapter MATA120 – ORDER

66

4.3 Schedules

Configuração de Schedules

Abrindo o módulo configurador, deve-se abrir o Menu Ambiente – Schedule – Schedule

Schedules configurados

67

Configuração do Agent

68

Monitor do Agent

Agendamentos

69

Após cadastro do Agendamento, deve-se configurar a Recorrência, clicando no botão e configurando conforme tela

abaixo:

70

4.4 De-para

Entre no Protheus

Módulo SIGACFG

Abrindo o módulo configurador, deve-se abrir o Menu Ambiente – Schedule – Emp. Fil Msg. Única (Deve ser feito por

empresa)

71

Neste exemplo temos duas coligadas RM (Company 1 e 2) com 4 filiais cada uma

O company equivale à coligada no RM.

Branch equivale a filial no RM.

No Protheus temos as seguintes divisões:

Grupo de empresa = T1

Empresa = D e M

Unidade de negócio = MG, RJ, SP e PR

Filial = 01 e 02

Este entendimento é necessário para a correta parametrização do sistema, no configurador devemos dizer ao RM como o sistema

entedenderá o Company do Protheus

Seguindo o exemplo, com o parametro Company marcado seria:

Grupo de empresa = T1 COLIGADA

Empresa = D e M COLIGADA

Unidade de negócio = MG, RJ, SP e PR

Filial = 01 e 02

Já como parametro Business Unity marcado seria:

72

Grupo de empresa = T1 COLIGADA

Empresa = D e M COLIGADA

Unidade de negócio = MG, RJ, SP e PR COLIGADA

Filial = 01 e 02

Cadastros no RM Empresa Filial

Criar o De-Para por Coligada (GColigada) e Filial (GFilial). Na criação da coligada, considerar apenas a Coligada de acordo com o TIN para Chave do Protheus também.

Neste exemplo, temos 2 coligadas:

Na criação da filial, considerar para “Valor Chave Integração” a Empresa e Filial do Protheus.

73

Neste exemplo, temos 2 coligada com 4 filiais cada uma.

* Atenção: Sempre que cadastrar uma nova coligada no De/Para RM o código informado para “Valor da Chave Primária RM” e “Valor da Chave Integração”

o código da Coligada RM para os dois campos.

74

De para de moeda

O cadastro da moeda deve ser feito de forma MANUAL em ambos sistemas

Criar o De-Para por Moeda (GMoeda). A criação do de-para da moeda é feito Global que deve ser feito por FILIAL (uma única vez para cada moeda).

Seguindo o exemplo acima, segue o depara no Protheus

75

De para de Condição de Pagamento

Como exemplo, temos a condição 001

O de-para é ‘ 001 (8 espaços+codigo da condição)

Com base no exemplo, o valor da chave primária é composta pela coligada 2|001 (código da condição)

76

Protheus

Módulo SIGACOM

No módulo de Compras do Protheus (SIGACOM) entre em cond. De pagamento.

De para Protheus com base no exemplo. Temos o valor externo composto como CODCOLIGADA|CODCPG

77

De para de Produto

Cadastre Produto (Este cadastro somente é usado nas rotinas de Comissão de Venda)

O produto deverá ser serviço e o parâmetro último nível marcado

No de para, como no exemplo ao lado, temos duas coligadas.

O cadastro deve ser feito por coligada

78

Módulo SIGACOM no Protheus

Atualizações > Cadastros > Produtos

Insira produto com o tipo mão de obra (MO)

79

4.5 Observações importantes

Procedimento de Criação/Configuração de Campos Obrigatórios para Integração

PROTHEUS

Cadastro de Clientes – SA1 O campo SA1->A1_END (“Endereço”) - O campo endereço deve ser preenchido com o Endereço da Rua, Avenida, etc., após

a descrição uma vírgula “,” para indicar o número. Não deve existir o carácter vírgula “,” no campo da Descrição da Rua, Avenida,

etc.

Cadastro de Fornecedores – SA2 O campo SA2->A2_END (“Endereço”) - O campo endereço deve ser preenchido com o Endereço da Rua, Avenida, etc., após

a descrição uma vírgula “,” para indicar o número. Não deve existir o caractere vírgula “,” no campo da Descrição da Rua, Avenida,

etc.

Cadastro de Bancos – SA6 O campo SA6->A6_NUMBCO (“No. Banco”) – Esse campo deve ser preenchido obrigatoriamente.

RM

É necessário o cadastrar Meio de Pagamento (dinheiro) no RM. Obs: o parâmetro CODMEIOPAGAMENTO configurado com o valor do Meio de pagamento cadastrado.

A ação do valor de integração do componente desconto deve estar = DESCONTA

No componente de desconto, o tipo de componente deve estar como tipo 900.

Para o processo do aditivo de Antecipação de Parcela, o componente de 32 (Juros de Acordo M.Indexado) deve estar configurado.

Para Distratos, a situação da subunidade deve estar preenchida.

OBSERVAÇÔES GERAIS:

Nos cadastros e tabelas utilizadas pela integração, deve se ter atenção para os seguintes pontos:

Habilitar e desabilitar a obrigatoriedade dos campos; Criação de gatilhos; Pontos de entradas; Validações de usuários;

Pois isso pode afetar o correto funcionamento da integração.

80

4.6 Configurações iniciais

Navegue no menu e clique em Integração

Dentro de integração, clique em Ferramentas e em seguida configurar

81

Dê um nome para o processo e clique em Avançar

Insira usuário e senha do banco de dados, teste a conexão e clique em Avançar.

Obs: o Alias, driver e o nome do servidor e nome do banco já estão preenchidos.

82

Marque a opção TOTVS Incorporação x BackOffice Protheus

Clique em Executar.

83

Se o processo for executado com êxito, será exibido esta tela com um resumo do que foi feito.

84

Para saber se a integração está ligada, devemos verificar se a Integração existe, se o caminho do WebService do Protheus

está correto (Para verificar WebService Protheus, após iniciar o appserver.ini copie e cole o texto do campo “URL Webservice” no

browser).

Verificando versões para erro no momento de inclusão de alguma informação que seja integrada.

*a imagem acima mostra a última versão que a integração foi homologada.

As versões das mensagens mapeadas no RM devem estar alinhadas com as do adapter Protheus. Havendo

divergências, poderá ocasionar no mal funcionamento da integração pois ao receber a mensagem.

85

Adapters do Protheus e suas respectivas versões.

Em seguida, não deixe de verificar se a Integração está ativa.

4.7 Parâmetros da Integração

Temos alguns parâmetros da integração, são eles:

o CENTRODECUSTOAUTOINC: quando true, faz todos os cadastros de centro de custo virem pro RM de forma

sequencial.

o CLIFORAUTOINC: quando true, faz todos cadastros de Cliente/Fornecedor virem pro RM de forma sequencial.

o CODMEIOPAGAMENTO = a integração necessita de um Meio de Pagamento cadastrado. O código deste

cadastro deve ser definido neste parâmetro.

o CONTACAIXAAUTOINC: quando true, faz todos cadastros de conta caixa virem pro RM de forma sequencial.

o NATUREZAFISCAOAUTOINC: quando true, faz todos os cadastros de natureza Financeira virem pro RM de

forma sequencial.

o GERARTITULONF: quando true, todos os títulos dos lançamentos serão gerados como NF para o Protheus.

86

4.8 Problemas frequentes

Erro ao tentar acessar WebService instalado no IIS. Ocorre quando o Modo de pipeline está como “Integrado”, o mesmo funciona corretamente quando está como “Clássico”.

87

Erro no EAI. WS funcionando corretamente ao acessar pelo browser, mas quando tentamos executar algum processo que

utilize a integração do lado TIN não é registrado nenhuma mensagem na fila e no Protheus tenta encontrar o WS (TBC)

em para entregar a mensagem gerada, no entanto na fila do Protheus é apresentado a mensagem de erro que segue

abaixo.

Causa: dll’s da Lib desatualizadas no ambiente RM.Net.

Solução: Pegar ambiente RM.Net anterior a instalação do conversor de base e aplicar somente release de

atualização de ambiente do RM.Net.

88

Erro ao enviar “Natureza Orçamentária Financeira” para o financeiro do Protheus

Erro ao gerar o plano de financiamento, ocorreu porque não está enviando a natureza financeira corretamente

na TAG <Financialcode>, para que preencha corretamente preciso informar o Centro de custo no Empreendimento

independente, se o cliente utiliza ele em seus processos, como demonstra a figura abaixo.

Como está no XML (Natureza|IdLan)

mensagem única com erro <Financialcode>|11852<Financialcode>

mensagem única correta <Financialcode>0|11852<Financialcode>

Apresentação da mensagem de erro:

Falha ao tentar efetivar a venda [191919]:

Falha na Geração de Lançamentos para o RM Fluxus.

Erro na execução da Atividade: 'conTotvsMessageActivity1'

Erro: EAIService:receiveMessage : <Message type="ERROR" code="c2">Codigo da Natureza nao cadastrado

no Protheus------Item 1</Message>

Fórmula Visual: 'Mensagem Padrão - Lançamentos Financeiros'.

89

Erro ao gerar plano de financiamento.

Situação: Erro pode ocorrer devido a campos existentes no Backoffice Protheus que o cliente tenha criado e ou

customizado como obrigatório na geração de um título, também pode ocorrer devido a gatilhos dentro do Protheus

que venha a tentar inserir informações no título no momento de sua geração.

Solução: Desabilitar customizações e gatilhos criados pelo cliente no Protheus. Muitas das vezes após efetuar a

solução citada, se faz necessário reiniciar o appserver.ini do Protheus.

ERRO ao gerar Plano de Financiamento: Falha ao tentar efetivar a venda [191919]:

Falha na Geração de Lançamentos para o RM Fluxus.

Erro na execução da Atividade: 'conTotvsMessageActivity1'

Erro: EAIService:receiveMessage : <Message type="ERROR" code="c2">Tabela SE1 08 11 13 11:31:47

</Message><Message type="ERROR" code="c2">Filial E1_FILIAL := 01 </Message><Message type="ERROR"

code="c2">Prefixo E1_PREFIXO := 1

Fórmula Visual: 'Mensagem Padrão - Lançamentos Financeiros'.

Mensagem com versões divergentes.

"XML response structure is not well formatted". Está é a mensagem que pode ser apresentada.

Solução: Ir no Protheus e verificar se as versões se encontram iguais a do RM, não estando altere a versão do

Protheus para a mesma versão do RM.

90

Erro de cancelamento de baixa no Protheus.

Na tentativa de cancelar uma baixa de título no PROTHEUS ocorreu erro e não apresentava nada em tela, O

cancelamento não ocorria. Os parâmetros no ADAPTER da Mensagem de cancelamento no Protheus não foram

cadastrados corretamente.

Caso dê alguma mensagem de erro com relação ao número do dígito da parcela se difere, cheque nos parâmetros do SGI na parte de integração financeira, neste item:

91

Um problema no ambiente Serveng foi solucionado neste parâmetro do appserver.ini. Quando foram geradas

70 lançamentos, apareceu um erro. Caso isso ocorra, verifique este parâmetro.

Conexões SGBD (Sistema de Gerenciamento de Banco de Dados), realizadas através do TOTVS | DBAccess,

utilizem campo "M" Memo com até 1000000 de bytes.

Abrangência

ERP 10 e 11

Por compatibilidade com as versões anteriores do AdvPL, por padrão um campo "M" Memo suporta até 64 Kb do

texto. Com esta chave, especificada explicitamente no ambiente onde os programas serão executados, é possível

manipular até 1 milhão de bytes em um campo Memo.

Valor Descrição

0 (Padrão) Desabilita

1 Habilita

Caso esta parametrização não seja feita, o Protheus irá recusar mensagens de criação de lançamentos para vendas

com muitas parcelas.