Árvore de páginas

Versões comparadas

Chave

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

01. VISÃO GERAL
02. MENSAGENS ENVOLVIDAS
03. ADAPTER

01.

...

VISÃO GERAL

O objetivo deste documento é explicar a integração do Protheus com o software PIMS através da troca de mensagens via EAI.


02. CONFIGURAÇÃO GERAL

Parâmetros Parâmetros 

O Sistema Microsiga Protheus utiliza de parâmetros.
Um parâmetro é uma variável que atua como elemento chave na execução de determinados processamentos. De acordo com seu conteúdo é possível obter diferentes resultados.
Todas as variáveis são iniciadas pelo prefixo MV_ e agem sobre diversas operações no Sistema.

...

  • MV_EAIURL2 - Endereço WebService que Receberá os Dados Enviados (Exemplo:http://10.31.6.68/TBC/wsEAIService.asm).
  • MV_I330FSM - Filtra produtos sem movimentação no período do recálculo Valor  .T. (importante para performance das movimentações)
  • MV_MSGPIMS - Nova integração via MGS Única Valor .F.
  • MV_EAIWS - Informe o nome do Client WebService do EAI para Valor – WSEAISERVICE
  • MV_EAIMETH - Informe o método de envio do EAI para envio a outro EAI Valor – receiveMessage
  • MV_PIMSINT - Habilita integração Protheus x PIMSGraos Valor .F. 


Adapter EAI.
O recurso Adapter EAI (Enterprise Application Integration) permite estabelecer integrações entre o Microsiga Protheus® e outro ERP. Utilizando esse recurso, o Administrador do Sistema passa a definir quais rotinas devem ser integradas, marcando condições de Envio e Recebimento de procedimentos e transações a serem efetuadas entre os dois Sistemas relacionados, e orientando os Métodos a serem aplicados.

...


O quadro abaixo demonstra algumas informações a serem preenchidas nas configurações do Adapter, relacionado ao modulo de ESTOQUE/CUSTOS

Descrição

Mensagem

Rotina

Condição Adapter

Tipo

Depósito

WAREHOUSE

AGRA045

(NNR->NNR_INTP) $ "1|2|4"

Sync

Grupo de Materiais

FAMILY

MATA035

-

Sync

Materiais

ITEM

MATA010

(SB1->B1_TIPO) $ "IA|MM"

Sync

Baixa de Estoque

STOCKTURNOVER

MATA241

!Empty(SD3->D3_NRBPIMS)

Sync

Valores de Estoque

ITEMCOSTING

MATA330

(SB1->B1_TIPO) $ "IA|MM"

Async

Solicitação de Materiais

REQUEST

MATA105

-

Sync

Fornecedores

CUSTOMERVENDOR

MATA020

-

Sync


02. ADAPTER CONFIGURAÇÃO RECOMENDADA

Deck of Cards
idADAPTER
Card
id1
labelWARESHOUSE
effectTypefade
  • Mensagem Única (XX4_UNMESS):
  • Rotina (XX4_ROTINA):
  • Mensagem (XX4_MODEL):
  • Descrição (XX4_DESCRI):
  • Envia (XX4_SENDER):
  • Recebe (XX4_RECEIV):
  • Método (XX4_METHOD):
  • Operação (XX4_TPOPER):
  • Canal Envio (XX4_CHANEL):
  • Versão Envio (XX4_SNDVER):
  • Formato (XX4_FORMAT):
Card
id2
labelFAMILY
effectTypefade
  • Mensagem Única (XX4_UNMESS):
  • Rotina (XX4_ROTINA):
  • Mensagem (XX4_MODEL):
  • Descrição (XX4_DESCRI):
  • Envia (XX4_SENDER):
  • Recebe (XX4_RECEIV):
  • Método (XX4_METHOD):
  • Operação (XX4_TPOPER):
  • Canal Envio (XX4_CHANEL):
  • Versão Envio (XX4_SNDVER):
  • Formato (XX4_FORMAT):
Card
id3
labelITEM
effectTypefade
  • Mensagem Única (XX4_UNMESS):
  • Rotina (XX4_ROTINA):
  • Mensagem (XX4_MODEL):
  • Descrição (XX4_DESCRI):
  • Envia (XX4_SENDER):
  • Recebe (XX4_RECEIV):
  • Método (XX4_METHOD):
  • Operação (XX4_TPOPER):
  • Canal Envio (XX4_CHANEL):
  • Versão Envio (XX4_SNDVER):
  • Formato (XX4_FORMAT):
Card
id4
labelSTOCKTURNOVER
effectTypefade
  • Mensagem Única (XX4_UNMESS):
  • Rotina (XX4_ROTINA):
  • Mensagem (XX4_MODEL):
  • Descrição (XX4_DESCRI):
  • Envia (XX4_SENDER):
  • Recebe (XX4_RECEIV):
  • Método (XX4_METHOD):
  • Operação (XX4_TPOPER):
  • Canal Envio (XX4_CHANEL):
  • Versão Envio (XX4_SNDVER):
  • Formato (XX4_FORMAT):
Card
id5
labelITEMCOSTING
effectTypefade
  • Mensagem Única (XX4_UNMESS):
  • Rotina (XX4_ROTINA):
  • Mensagem (XX4_MODEL):
  • Descrição (XX4_DESCRI):
  • Envia (XX4_SENDER):
  • Recebe (XX4_RECEIV):
  • Método (XX4_METHOD):
  • Operação (XX4_TPOPER):
  • Canal Envio (XX4_CHANEL):
  • Versão Envio (XX4_SNDVER):
  • Formato (XX4_FORMAT):
Card
id6
labelREQUEST
effectTypefade
  • Mensagem Única (XX4_UNMESS):
  • Rotina (XX4_ROTINA):
  • Mensagem (XX4_MODEL):
  • Descrição (XX4_DESCRI):
  • Envia (XX4_SENDER):
  • Recebe (XX4_RECEIV):
  • Método (XX4_METHOD):
  • Operação (XX4_TPOPER):
  • Canal Envio (XX4_CHANEL):
  • Versão Envio (XX4_SNDVER):
  • Formato (XX4_FORMAT):
Card
id7
labelSCHEDULE/AGENT
effectTypefade

Para que o envio das mensagens assíncronas seja realizado, é necessário efetuar o cadastro das rotinas FWEAISEND/FWEAI, no Schedule Protheus.

  • FWEAISEND: Esta rotina é exclusiva para o envio das mensagens da fila do EAI. O agendamento desta rotina é realizado por Empresa cadastrada no sistema. No envio da mensagem, um canal de comunicação é aberto com o webservice do produto integrado, e esta comunicação é encerrada após o recebimento  da mensagem de retorno (no caso das Mensagens Única TOTVS, após o recebimento da  ReceiptMessage, indicando que que o processo ocorreu corretamente) ou por timeout (mensagem com status de falha).
  • FWEAI: Esta rotina de envio e recebimento de mensagens do EAI Protheus. Quando agendada, esta rotina executa dois passos.
    1. Inicia o processamento das mensagens recebidas na fila do EAI Protheus.
    2. Inicia o envio das mensagens que estão na fila do EAI Protheus.

Antes de efetuar o cadastro das rotinas FWEAISEND/FWEAI, é necessário a inclusão dos Agent.

  • AGENT: Este é o componente que gerencia as execuções e distribui as tarefas para que as Executes configuradas que estão disponíveis no momento. Os Agents podem estar localizados em servidores diferentes, possibilitando o balanceamento da carga de execuções.
Informações

DMANMAT01-2132 DT Envio Ativo para Produtos com Estoque Alterado Desde o Último Envio

Inclusão das rotinas FWEAIRECE/FWEAISEND no agendamento

  • Navegar no menu em Ambiente > Schedule > Schedule (CFGA010).
  • Na barra lateral, acessar Schedule > Agendamentos > Cadastro
  • No grid Detalhes, clicar no primeiro ícone Image Added para inclusão.
    • Código: Valor sequencial que representa o identificador único desse agente no sistema. Ele é preenchido automaticamente;
    • Usuário: Usuário do Protheus que será utilizado para inicializar o processo;

    • Nome do usuário: Nome do usuário no sistema. É preenchido à partir do Usuário selecionado no campo anterior;

    • Rotina: FWEAI (Rotina envio e recebimento de mensagens do EAI Protheus) / FWEAISEND (Rotina recebimento de mensagens do EAI Protheus).

    • Data: Qual a data da execução do agendamento.

    • Hora: Qual a hora em que a função será executada.

Observe a opção “Recorrência” Image Addedna barra de opções permite que você especifique a execução em intervalos regulares (diariamente, mensalmente, anual, a cada X horas…)

    • Ambiente: Qual o ambiente que será inicializado na execução; 
    • Empresa/Filial: Qual empresa e filial será aberta no momento da execução. Novamente, repare que esses campos não invalidam funcionalidades que abram e utilizem um ambiente diferente;

    • Módulo: Qual o módulo do Protheus que será utilizado na execução do agendamento. Essa informação é importante pois interfere na forma como o Protheus irá consumir as licenças disponíveis para a execução do job;

    • Nome do Módulo: O nome do módulo selecionado no campo anterior e é preenchido automaticamente;

    • Habilitada: Flag que determina se a execução do agendamento está habilitada ou não; 

    • Descrição: Descrição livre sobre o agendamento;   

02. Transações/Entidades/Mensagens únicas

Abaixo são demostradas as transações/entidades que são trocadas e quem envia a informação para quem, entre ESTOQUE/CUSTOS e PIMS

Deck of Cards
idTransacoes
Card
id1
labelO que é ENVIADO pelo ESTOQUE
effectTypefade
UNIDADE DE MEDIDA
GRUPO DE PRODUTO
PRODUTO
ARMAZEM
CENTRO DE CUSTO
CUSTO MÉDIO
TRANSFERENCIAS
Card
id1
labelO que é RECEBIDO para o ESTOQUE
effectTypefade
MOVIMENTO DE ESTOQUE