Histórico da Página
As mensagens TOTVS possuem um segmento chamado MessageInformation que possui as principais informações utilizadas para identificação e roteamento da mensagem.
Exemplo
<MessageInformation version="11.0.0">
<UUID>BranchUp-sert-Even-t000-000000000000</UUID>
<Type>BusinessMessage</Type>
<Transaction>Branch</Transaction>
<StandardVersion>1.0</StandardVersion>
<SourceApplication>SourceApplication</SourceApplication>
<CompanyId>CompanyId</CompanyId>
<Product name="Any" version="Any"/>
<GeneratedOn>2001-12-31T12:00:00</GeneratedOn>
<MessageInformation>
- MessageInformation/Version: Identifica qual a versão da mensagem de negócio, que pode sofrer alterações no decorrer do tempo afetando essas informações.
- UUID: Identificador único da mensagem que não pode ser igual ao UUID de qualquer outra mensagem em qualquer um dos aplicativos da integração.
- Type: Identifica o tipo de mensagem (BusinessMessage, ReceiptMessage ou ResponseMessage).
- Transaction: Identifica o tipo de transação da mensagem. Esta informação é utilizada pelos aplicativos para definir como os dados são processados no recebimento.
- StandardVersion: Identifica a versão do padrão TOTVS, ou seja, do formato utilizado nas áreas genéricas da mensagem. Caso o padrão seja alterado, este valor é alterado.
- SourceApplication: Identifica a instancia dos aplicativos que gerou a mensagem. Se duas instancias do mesmo aplicativo estão na mesma integração, cada um é identificado de forma única.
- CompanyId: Identificador da empresa que gerou a mensagem.
- Product: Identifica o produro e versão que originou a mensagem, o valor pode ser igual, mesmo em instancias diferentes do mesmo aplicativo.
- GeneratedOn: Identifica o timestamp de geração da mensagem.
Roteamento EAI Protheus
A Mensagem Única TOTVS agora pode enviar mensagens à múltiplos destinos e também pode responder para um receptor diferente do especificado no parâmetro MV_EAIURL2.
Uma mensagem Única somente poderá possuir mais de um destinatário se o seu tipo de envio for igual a 1 - assíncrono.
Cada rota de envio é definida pelo produto utilizado e pela aplicação de origem, ou seja, para um mesmo adapter, não existirá produto e aplicação com origens iguais. As mensagens que possuem adapters distintos devem possuir a mesma configuração de roteamento.
Caso o adapter, não possua roteamento cadastrado ou possua apenas rotas com o campo Envia=2 (não) a mensagem é gerada para o conteúdo do parâmetro MV_EAIURL2.
Procedimento
1. | No módulo Configurador (SIGACFG) acesse Ambiente / Schedule / Adapter E.A.I. (CFGA020) |
2. | Clique em Incluir |
3. | Insira um novo adapter EAI |
4. | No campo Mensagem Única escolha a opção 1 - Sim |
5. | No campo Rotina digite o nome do adapter a ser utilizado |
6. | No campo Mensagem digite o nome da Mensagem Única TOTVS relacionada ao adapter utilizado |
7. | Insira uma descrição para este adapter no campo Descrição |
8. | Selecione se este adapter está habilitado ou não para envio no campo Envia e se está habilitado ou não para recebimento no campo Recebe |
9. | Selecione no campo Método, a forma que deseja enviar. Lembrando que para rotas com mais de um envio somente é possível selecionar a opção 2 - Assíncrono |
10. | Selecione e operação para este adapter, no campo Operação; |
11. | Selecione no campo Canal de Envio a opção 2 – EAI; |
12. | EM Roteamento de Mensagens, altere os seguintes campos |
• | Produto: Informe o produto no qual o Protheus está integrado |
• | Aplicação Ori: informe a aplicação na qual o Protheus está integrado |
• | Envia: Determina se aquela é uma rota de envio e recebimento (envia=sim) ou somente recebimento (envia=não). Quando a mensagem é disparada, o EAI Protheus busca cada linha de roteamento com envia=sim e faz o disparo da mensagem para aquele endereço, ignorando os valores dos parâmetros MV_EAIURL2, MV_EAIMETH, MV_EAIWS, MV_EAIPASS e MV_EAIUSER. Caso não haja roteamento de envio cadastrado, são utilizados os valores dos parâmetros indicados. Já na chegada de uma Mensagem Única TOTVS assíncrona a ResponseMessage (a mensagem de resposta para o outro ERP) e gerada baseada neste cadastro. Desta maneira, o Protheus busca se existe roteamento para o Produto e Aplicação da mensagem. Caso seja encontrado, a ResponseMessage é devolvida para esta rota cadastrada. Caso não seja encontrada rota, a mensagem é devolvida utilizando os valores dos parâmetros MV_EAIURL2, MV_EAIMETH, MV_EAIWS, MV_EAIPASS e MV_EAIUSER |
• | URL: Indica o endereço de EAI do roteamento |
• | Client WS: Indica o cliente de Webservices deste roteamento |
• | Método: Indica o método a ser consumido para este roteamento |
• | Usuário WS: Indica o nome do usuário para sistemas que possuam camada de autenticação de Webservices |
• | Senha WS: Indica a senha do usuário para sistemas que possuam camada de autenticação de Webservices |
...