Este documento irá abordar a montagem de um ambiente do BackOffice Protheus e da Linha RM cuja integração utilize Mensagem Única.

Transcrição

1 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 Obtendo Arquivos Atualizações Protheus Instalação RM Protheus DBAcces Configuração Protheus Banco de dados Configurando Banco SQL Configurando Banco Oracle Configurando Conexões no DBAcces Protheus AppServer Protheus WS Protheus TOTVS Business Connect Painel de Controle Internet Information Services (IIS) Web.config Configuração específicas da Integração Configurações iniciais Adapters Schedules De-para... 70

2 4.5 Observações importantes Configurações iniciais Parametros da integração Problemas frequêntes

3 Desenvolvimento/Procedimento 1. Pré Requisitos Para montar o ambiente é necessário instalar: Protheus versão 11 RM versão 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: 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: \\ \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 ª 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. 3

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: \\ \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 Versão do Protheus ATUSX: \\ \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) Arquivos.CH Menus do sistema Tabelas Padrão Help de campos e mensagens Gatilhos (SX7) Relacionamentos (SX9) Pastas (SXA) Consultas Padrão (SXB) Grupo de campos (SXG) 4

5 2. Instalação 2.1 RM Utilizar a versão (ou superior) A versão 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). 5

6 2.2 Protheus O setup da instalação pode ser baixado através do seguinte link: escolhendo opção TOTVS Application Server. Este setup fará o download do Protheus. 6

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. 7

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 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. 8

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. 9

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 é: 10

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. 11

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: \\ \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. 12

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: \\ \temp\ \rel\txt\bra Nota: Sendo que é a data (AAAAMMDD). Selecione a pasta com a data mais atual. 13

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. 14

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. 15

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. 16

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. 17

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: 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. 18

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. 19

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. 20

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) 21

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. 22

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. 23

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. 24

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. 25

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! 26

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. 27

28 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 29

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: 30

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 ( ) ConsoleFile=arquivo de log Segmento=cYdTm3WWERZF=1hu Serie===AV Realizada as alterações, a seção ficará assim: 31

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 32

33 [Drivers] Active=TCP [GENTCPIP] Enable=0 Notas: o o Caso não existam no arquivo as seções devem ser incluídas. 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: 33

34 Segue descritivo da Configuração do INI para o WebService. (EXEMPLO) Primeira 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= ALIAS=DADOSP10 PROTHEUSONLY=0 [Drivers] Active=TCP [TCP] TYPE=TCPIP Port=3333 [General] InstallPath=E:\Protheus11 [LICENSESERVER] enable=0 port=5555 ShowStatus=1 Segunda Página: [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 [ :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= WEBSERVICELocation= URLLocation= [LICENSECLIENT] server= port=5556 [TDS] allowapplypatch=* [SERVICE] NAME=Protheus11Service-ws DISPLAYNAME=TOTVS - ServerWS 34

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 35

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. 36

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: 37

38 Testando o WS 38

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

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 40

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. 41

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 42

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\v 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. 43

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

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 45

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. 46

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. 47

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 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. 48

49 As configurações do RM.Host.Service.exe.config, RM.exe.config e Web.config devem estar corretamente alinhados, como na figura abaixo: 49

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. 50

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. 51

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

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 o PROTHEUS11\BIN\APPSERVER_WS (Diretório do serviço de WS) 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. 53

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: 54

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) 55

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). 56

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). 57

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: 58

59 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. 60

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 61

62 Adapter FINA010 FINANCIALNATURE Adapter FINA055 FINANCING Adapter FINA070 ACCOUNTRECEIVABLEDOCUMENTDISCHARGE 62

63 Adapter FINA070 REVERSALOFACCOUNTRECEIVABLEDOCUMENTDISCHARGE Adapter FINA080 ACCOUNTPAYABLEDOCUMENTDISCHARGE 63

64 Adapter FINA080 REVERSALOFACCOUNTPAYABLEDOCUMENTDISCHARGE Adapter FINA070A UPDATECONTRACTPARCEL Adapter MATA020 CUSTOMERVENDOR 64

65 Adapter MATA030 CUSTOMERVENDOR Adapter MATA070 BANK Adapter MATA120 ORDER 65

66 4.3 Schedules Configuração de Schedules Abrindo o módulo configurador, deve-se abrir o Menu Ambiente Schedule Schedule Schedules configurados 66

67 Configuração do Agent 67

68 Monitor do Agent Agendamentos 68

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

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) 70

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 Empresa = D e M Unidade de negócio = MG, RJ, SP e PR Filial = 01 e 02 COLIGADA COLIGADA Já como parametro Business Unity marcado seria: 71

72 Grupo de empresa = T1 Empresa = D e M Unidade de negócio = MG, RJ, SP e PR Filial = 01 e 02 COLIGADA COLIGADA COLIGADA 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. 72

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. 73

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 74

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 (código da condição) 75

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 76

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 77

78 Módulo SIGACOM no Protheus Atualizações > Cadastros > Produtos Insira produto com o tipo mão de obra (MO) 78

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. 79

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 80

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. 81

82 Marque a opção TOTVS Incorporação x BackOffice Protheus Clique em Executar. 82

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

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. 84

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 o o o o o CENTRODECUSTOAUTOINC: quando true, faz todos os cadastros de centro de custo virem pro RM de forma sequencial. CLIFORAUTOINC: quando true, faz todos cadastros de Cliente/Fornecedor virem pro RM de forma sequencial. CODMEIOPAGAMENTO = a integração necessita de um Meio de Pagamento cadastrado. O código deste cadastro deve ser definido neste parâmetro. CONTACAIXAAUTOINC: quando true, faz todos cadastros de conta caixa virem pro RM de forma sequencial. NATUREZAFISCAOAUTOINC: quando true, faz todos os cadastros de natureza Financeira virem pro RM de forma sequencial. GERARTITULONF: quando true, todos os títulos dos lançamentos serão gerados como NF para o Protheus. 85

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. 86

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. 87

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. mensagem única com erro mensagem única correta Como está no XML (Natureza IdLan) <Financialcode> 11852<Financialcode> <Financialcode> <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'. 88

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 SE :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. 89

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: 90