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
91
Embed
NOVA_Montagem Ambiente TOTVS Incorporação x BackOffice Protheus
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
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
3.1 Protheus – Banco de dados ............................................................................................................................................... 12
3.4 TOTVS Business Connect ................................................................................................................................................... 42
3.5 Painel de Controle ............................................................................................................................................................. 43
3.6 Internet Information Services (IIS) .................................................................................................................................... 44
4.5 Observações importantes ................................................................................................................................................. 79
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
"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