...
Deck of Cards |
---|
startHidden | false |
---|
history | false |
---|
id | ids |
---|
|
Card |
---|
default | true |
---|
id | id1 |
---|
label | 1. Parâmetro MV_RHNG |
---|
title | 1. Parâmetro MV_RHNG |
---|
| Acessar o módulo configurador e preencher o parâmetro MV_RHNG com .T. ![](/download/attachments/793200883/1%20-%20MV_RHNG%2001.png?version=1&modificationDate=1696187405753&api=v2) ![](/download/attachments/793200883/1%20-%20MV_RHNG%2002.png?version=1&modificationDate=1696187406080&api=v2)
* A partir desse momento, a cada inclusão ou alteração os dados serão gravados na tabela RJP e posteriormente serão integrados através de um JOB que será configurado nos próximos passos. |
Card |
---|
id | id2 |
---|
label | 2. Carga Inicial |
---|
title | 2. Carga Inicial |
---|
| A Carga Inicial deve ser utilizada para integrar, para a tabela RJP, informações criadas antes da ativação do parâmetro MV_RHNG. Acessar a rotina disponível em: SIGAGPE / Atualizações / Integrações / Integração Ng / Carga Inicial (GPEM925) Preencher as perguntas e clicar em OK: ![](/download/attachments/793200883/2%20-%20Carga%20Inicial%20GPEM925%2001.png?version=1&modificationDate=1696458303033&api=v2)
Parâmetros de entrada: Cloak |
---|
| Parâmetro | Valor de Exemplo | Obrigatório | Tipo | Parâmetro | Valor Default | Descrição | Filial De:? | D MG 01 | Não | String | query |
| Inicio da relação de filiais. | Filial Até:? | D MG 01 | Não | String | query |
| Final da relação de filiais. | Cadastro de Funcionários | Check | Não | Opção | query |
| Informa que será enviado na carga inicial a relação de funcionários. | Cadastro de Dependentes | Check | Não | Opção | query |
| Informa que será enviado na carga inicial a relação de funcionários. | Matrícula De:? | 000001 | Não | String | query |
| Início da relação de matrículas de funcionários ou dependentes. | Matrícula Até:? | 999999 | Não | String | query |
| Final da relação de matrículas de funcionários ou dependentes. | Cadastro de Pessoas | Check | Não | Opção | query |
| Informa que será enviado na carga inicial a relação de funcionários. | Participante De:? | 000001 | Não | String | query |
| Início da relação de códigos de participantes. | Participante Até:? | 999999 | Não | String | query |
| Final da relação de códigos de participantes. | Log de Processamento | Check | Não | Opção | query |
| Informa se deseja gerar um relatório com o LOG da carga de dados. |
|
Na primeira execução o processo pode ser um pouco demorado por isso será solicitada uma confirmação:
![](/download/attachments/793200883/2%20-%20Carga%20Inicial%20GPEM925%2002.png?version=1&modificationDate=1696458582607&api=v2) ![](/download/attachments/793200883/2%20-%20Carga%20Inicial%20GPEM925%2004.png?version=1&modificationDate=1696458714517&api=v2)
No final será possível visualizar o log dos registros gravados na tabela RJP: Image Added
Image Added
|
Card |
---|
id | id3 |
---|
label | 3. Habilitar o Job de Integração |
---|
title | 3. Habilitar o Job de Integração GPEM923 |
---|
| Habilitar JOB de Integração (GPEM923). Essa rotina que deve ser cadastrada no SCHEDULE será responsável por verificar as alterações pendentes na tabela RJP e fazer o envio para o Quírons. ![](/download/attachments/793200883/3%20-%20JOB%20GPEM923.png?version=1&modificationDate=1696188265190&api=v2)
Informações |
---|
| Caso as tabelas de funcionários, dependentes e pessoas tiverem compartilhamentos diferentes, será necessário realizar a carga de cada uma de forma separada. |
|
Card |
---|
id | id4 |
---|
label | 4. Parâmetros Específicos |
---|
title | 4. Parâmetros Específicos |
---|
|
|
Card |
---|
id | id5 |
---|
label | 5. Situações específicas |
---|
title | 5. Situações específicas |
---|
|
|
Card |
---|
id | id6 |
---|
label | 6. Documentações Relacionadas |
---|
title | 6. Documentações Relacionadas |
---|
|
|
|
05. ADAPTER
O cadastro de adapter são rotinas responsáveis por realizar o processamento das mensagens enviadas e recebidas, possibilitando a inclusão, alteração e exclusão.
Para realizar o cadastro/configuração do adapter, antes é necessário ter uma ROTA cadastrada (Item 03). Após ter realizado o cadastro da rota, navegar no menu em Ambiente > Schedule > Adapter EAI (CFGA020).
Exemplo:
Image Removed
Image Removed
Aviso |
---|
Obs.: Em todos adapters, no grid Roteamento de mensagens (para Mensagem Única com canal de envio EAI), selecionar a rota cadastrada conforme item 03 deste documento. |
Image Removed
...
Card |
---|
id | 1 |
---|
label | ITEM |
---|
effectType | fade |
---|
|
- Mensagem Única (XX4_UNMESS): 1-Sim
- Rotina (XX4_ROTINA): MATA010
- Mensagem (XX4_MODEL): ITEM
- Descrição (XX4_DESCRI): PRODUTO
- Envia (XX4_SENDER): Sim (Envia mensagem JSON para Quírons)
- Recebe (XX4_RECEIV): Sim (Recebe mensagem JSON do Quírons)
- Método (XX4_METHOD): Síncrono/Assíncrono
- Operação (XX4_TPOPER): 1-Todas
- Canal Envio (XX4_CHANEL): 3 - EAI - PAD.APP.
- Versão Envio (XX4_SNDVER): 4.005
- Formato (XX4_FORMAT): JSON
|
Card |
---|
id | 2 |
---|
label | UNITOFMEASURE |
---|
effectType | fade |
---|
|
- Mensagem Única (XX4_UNMESS): 1-Sim
- Rotina (XX4_ROTINA): QIEA030
- Mensagem (XX4_MODEL): UNITOFMEASURE
- Descrição (XX4_DESCRI): UNIDADE DE MEDIDA
- Envia (XX4_SENDER): Sim (Envia mensagem JSON para Quírons)
- Recebe (XX4_RECEIV): Sim (Recebe mensagem JSON do Quírons)
- Método (XX4_METHOD): Síncrono/Assíncrono
- Operação (XX4_TPOPER): 1-Todas
- Canal Envio (XX4_CHANEL): 3 - EAI - PAD.APP.
- Versão Envio (XX4_SNDVER): 2.002
- Formato (XX4_FORMAT): JSON
|
Card |
---|
id | 3 |
---|
label | WAREHOUSE |
---|
effectType | fade |
---|
|
- Mensagem Única (XX4_UNMESS): 1-Sim
- Rotina (XX4_ROTINA): AGRA045
- Mensagem (XX4_MODEL): WAREHOUSE
- Descrição (XX4_DESCRI): LOCAIS DE ESTOQUE
- Envia (XX4_SENDER): Sim (Envia mensagem JSON para Quírons)
- Recebe (XX4_RECEIV): Sim (Recebe mensagem JSON do Quírons)
- Método (XX4_METHOD): Síncrono/Assíncrono
- Operação (XX4_TPOPER): 1-Todas
- Canal Envio (XX4_CHANEL): 3 - EAI - PAD.APP.
- Versão Envio (XX4_SNDVER): 1.000
- Formato (XX4_FORMAT): JSON
|
Card |
---|
id | 4 |
---|
label | STOCKLEVEL |
---|
effectType | fade |
---|
|
- Mensagem Única (XX4_UNMESS): 1-Sim
- Rotina (XX4_ROTINA): MATA225
- Mensagem (XX4_MODEL): STOCKLEVEL
- Descrição (XX4_DESCRI): SALDOS EM ESTOQUE
- Envia (XX4_SENDER): Sim (Envia mensagem JSON para Quírons)
- Recebe (XX4_RECEIV): Não (Não recebe mensagem JSON do Quírons)
- Método (XX4_METHOD): Síncrono/Assíncrono
- Operação (XX4_TPOPER): 1-Todas
- Canal Envio (XX4_CHANEL): 3 - EAI - PAD.APP.
- Versão Envio (XX4_SNDVER): 3.004
- Formato (XX4_FORMAT): JSON
|
Card |
---|
id | 5 |
---|
label | REQUEST |
---|
effectType | fade |
---|
|
- Mensagem Única (XX4_UNMESS): 1-Sim
- Rotina (XX4_ROTINA): MATA105
- Mensagem (XX4_MODEL): REQUEST
- Descrição (XX4_DESCRI): SOLICITACAO AO ARMAZEM
- Envia (XX4_SENDER): Sim (Envia mensagem JSON para Quírons)
- Recebe (XX4_RECEIV): Sim (Recebe mensagem JSON do Quírons)
- Método (XX4_METHOD): Síncrono/Assíncrono
- Operação (XX4_TPOPER): 1-Todas
- Canal Envio (XX4_CHANEL): 3 - EAI - PAD.APP.
- Versão Envio (XX4_SNDVER): 1.009
- Formato (XX4_FORMAT): JSON
|
Card |
---|
id | 6 |
---|
label | STOCKTURNOVER |
---|
effectType | fade |
---|
|
- Mensagem Única (XX4_UNMESS): 1-Sim
- Rotina (XX4_ROTINA): MATA241
- Mensagem (XX4_MODEL): STOCKTURNOVER
- Descrição (XX4_DESCRI): MOVIMENTACOES INTERNAS MULT.
- Envia (XX4_SENDER): Sim (Envia mensagem JSON para Quírons)
- Recebe (XX4_RECEIV): Sim (Recebe mensagem JSON do Quírons)
- Método (XX4_METHOD): Síncrono/Assíncrono
- Operação (XX4_TPOPER): 1-Todas
- Canal Envio (XX4_CHANEL): 3 - EAI - PAD.APP.
- Versão Envio (XX4_SNDVER): 1.000
- Formato (XX4_FORMAT): JSON
|
...
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 Removed 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 Removedna barra de opções permite que você especifique a execução em intervalos regulares (diariamente, mensalmente, anual, a cada X horas…)
...
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;
...
O
06. DE/PARA EMPRESAS
Em uma integração entre sistemas é comum os sistemas terem códigos diferentes, neste caso é muito importante ter um 'De/Para" (XXD), para que seja mapeado e retornado o valor interno de um determinado registro da tabela informada no cadastro de De/Para.
...