Utilizando Engine de Regras com Integrações EAI

O Engine de Regras é composto pelos programas disponíveis no Foundation do EMS2 a partir do release 2.04.

Esse conjunto de programas permite que sejam montadas configurações onde o cliente possa trabalhar com variáveis e regras distintas de acordo com o tipo de operação. Essa configuração deve partir de empresa, estabelecimento e operação, e de acordo com esta operação deve ser possível parametrizar variáveis distintas conforme a utilização nos aplicativos.

Algumas transações de integração receberam pontos EPC para realizar tratamentos das regras oriundas do Engine de Regras, conforme abaixo:

• Conversão de códigos para os principais campos da transação.
  Exemplo: quando recebido determinado código, possibilitar sua conversão para o código interno cadastrado no produto recebedor.

• Envio de informações do XML contendo regras de validação ao Engine de Regras antes da criação na fila do EAI, a fim de evitar a sobrecarga de XML´s na fila ou nos diretórios de gravação dos arquivos.
  Exemplo: Executar ou não uma determinada transação mediante uma regra cadastrada pelo Engine de Regras.

Segue abaixo a lista de transações EAI disponíveis e respectivas variáveis para utilização com Engine de Regras.

 Quadro 1:

Observação:
A variável cTransaction serve para a configuração da ação da mensagem. O cliente pode assinar a transação e configurar condições para que uma determinada ação ocorra (add, upd, del).

Como ativar o Engine de Regras para utilização das variáveis disponíveis?

Deverá ser cadastrado um evento de nome EngineRegras para uma EPC já cadastrada para o adapter ou nova EPC. Não é necessário realizar nenhuma outra ação, visto que as variáveis já estão sendo carregadas pelos adapters. Vide variáveis disponíveis no quadro 1.

Observação:
Para os adapters Sender de Nota Fiscal de Saída, Pedido de Vendas e Documento Fiscal não é necessário cadastrar EPC.

As regras e variáveis deverão ser configuradas através do Engine de Regras.

Para mais informações no programa Cadastro do Configurador de Regras (CD0024).

Abaixo seguem algumas simulações a observar:

Simulação 1: Supondo que o cliente queira disparar a transação Sender Natureza da Operação apenas quando a ação da transação for de inclusão (add) ou de alteração (upd). A transação não será enviada quando ação for de exclusão (del).

Dada a seguinte configuração exemplo:

Transação: Sender Natureza da Operação

Empresa: 4 TOTVS S/A

Estabelecimento: 401 TOTVS S/A

Adapter: axsvd002

O tipo de operação sempre será o nome do adapter.

Cadastrar a Regra no Engine de Regras (cd0024):

Empresa: 4 TOTVS S/A

Estabelecimento: 401 TOTVS S/A

Tipo Operação: axsvd002

Regra: Valida envio do XML Natureza Operação

Variável: cTransAction (variável comumente utilizada para gravar a ação das transações).

Como a regra é somente para validar o envio, não sendo necessário retornar outro valor (como por exemplo em um de-para) a sugestão é retornar “yes” ou “no” para a execução do programa axsvd002. Vide folder “Retorno” (Tela 3.1).

Quando a validação for para tratar o disparo ou não da mensagem, o campo para retorno deverá sempre ser o nome do adapter. Neste exemplo será o adapter Sender Natureza de Operação (axspd002.p).

Simulação 2: Supondo que ao recebermos o XML de Pedido de Venda, seja necessário converter o código da Natureza da Operação (nat-operacao) para um determinado cliente (cod-emitente). Este poderá ser convertido através do Engine de Regras.

Dada a seguinte configuração exemplo:

Transação: Receiver Pedido de Venda

Empresa: 4 TOTVS S/A

Estabelecimento: 401 TOTVS S/A

Cliente: 886 DIMED S/A

Código Natureza Operação a receber: 6101ab

Adapter: axrvd003

O tipo de operação sempre será o nome do adapter.

Como será realizada a conversão de código, deverá ser cadastrado o campo e valor a receber a conversão. Vide folder “Retorno” (Tela 3.2).