Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 1

changes.mady.by.user admin

Gravado em

comparado com

Nova versão 2

changes.mady.by.user Usuário desconhecido (wilian.arruda)

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


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

...