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 |
---|
|
Card |
---|
id | 1 |
---|
label | WARESHOUSE |
---|
effectType | fade |
---|
| - 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 |
---|
id | 2 |
---|
label | FAMILY |
---|
effectType | fade |
---|
| - 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 |
---|
id | 3 |
---|
label | ITEM |
---|
effectType | fade |
---|
| - 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 |
---|
id | 4 |
---|
label | STOCKTURNOVER |
---|
effectType | fade |
---|
| - 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 |
---|
id | 5 |
---|
label | ITEMCOSTING |
---|
effectType | fade |
---|
| - 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 |
---|
id | 6 |
---|
label | REQUEST |
---|
effectType | fade |
---|
| - 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 |
---|
id | 7 |
---|
label | SCHEDULE/AGENT |
---|
effectType | fade |
---|
| 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.
- Inicia o processamento das mensagens recebidas na fila do EAI Protheus.
- 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.
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 |
---|
|
Card |
---|
id | 1 |
---|
label | O que é ENVIADO pelo ESTOQUE |
---|
effectType | fade |
---|
| UNIDADE DE MEDIDA | GRUPO DE PRODUTO | PRODUTO | ARMAZEM | CENTRO DE CUSTO | CUSTO MÉDIO | TRANSFERENCIAS |
|
Card |
---|
id | 1 |
---|
label | O que é RECEBIDO para o ESTOQUE |
---|
effectType | fade |
---|
| |
|