Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

✕

Esta documentação é para a versão 4 e posterior do App Builder, o novo nome do Vinyl. Acesse a documentação do Vinyl aqui.

✕

Guia de conexão Infor M3 para Jitterbit App Builder

Visão geral

Este guia fornece uma visão geral do uso do App Builder para se conectar ao Infor M3 (ou M3). O Infor M3 é um sistema ERP baseado em nuvem que fornece muitas APIs específicas de fabricação e distribuição.

Especificamente, revisaremos os componentes usados para atualizar o Access Token para M3 periodicamente. Neste cenário, o Refresh Token deve ser atualizado a cada 2 horas para executar chamadas de API contra M3.

Requisitos do sistema

As seguintes DLLs precisam ser instaladas no servidor do App Builder para estabelecer a conexão do Infor M3:

  • Atualizar Token DLL

  • Invocar DLL de transação

Atualizar configuração do token

Tabela de parâmetros

Dentro do próprio aplicativo App Builder, você precisa criar uma tabela chamada Param (nome exato necessário) com as seguintes colunas definidas:

Nome Tipo de dados
ParamID UUID
URL NVarchar(2000)
RestTableId UUID
Token de acesso NVarchar(2000)
* NotificarEmail NVarchar(255)
* isTokenRefreshed Bit
* Ambiente NVarchar(10)

Observe que os nomes fornecidos devem ser exatos, pois a API os referencia por Nome.

*Colunas opcionais que podem ser definidas, mas não são necessárias para configuração.

Crie um evento de token de atualização

Este Evento personalizado deve ser criado no objeto de negócios Param (Source) chamado RefreshToken. Para aproveitar essa funcionalidade de dentro do aplicativo App Builder, você precisará dos arquivos DLL necessários colocados no ambiente, junto com os registros Plugin e Assembly adicionados ao banco de dados do App Builder.

  1. Navegue até Param (Fonte)

  2. Clique em Eventos

  3. Clique em + Evento de regra

  4. Atribua o Nome como RefreshToken

  5. Defina Refresh Scope como Row

  6. Clique em Salvar

  7. Em Ações, clique em Registrar existente

  8. Defina Tipo como Plugin

  9. Defina o Plugin para Token de atualização

  10. Clique em Salvar

    Interface gráfica do usuário, descrição do aplicativo gerada automaticamente

Crie um trabalho agendado para atualizar o token

  1. Navegue até o App Builder IDE

  2. Clique em Monitoramento no menu Tempo de execução

  3. Clique em Agendamentos

  4. Clique em + Agendar e crie:

    • Nome: Forneça um nome identificável. Exemplo: M3 API Token Refresh

    • Frequência: Execução Periódica do Cronograma

    • Aplicação: Nome do aplicativo que atribui a tarefa a

    • Recorre a cada: 90 minutos

  5. Clique em Salvar

    anexo

  6. Confirme se o Evento associado à Agenda tem um único Evento atribuído

Identifique as APIs do Infor M3 a serem usadas

Esta etapa pressupõe acesso de credencial de administrador ao Infor M3:

  1. Faça login e clique em Ferramentas de administração

  2. Clique em M3 Metadata Publisher

  3. Clique na aba M3 API Repository

  4. Selecione API de pesquisa

  5. Localize a API desejada

  6. Analise a API Nome do Programa para identificar a estrutura de transação necessária e a convenção de nomenclatura esperada a ser criada no aplicativo App Builder. Exemplo: PMS050MI

Crie tabelas e colunas do App Builder para mapear para API

Para usar qualquer uma das APIs do Infor M3, você precisa criar manualmente as Tabelas correspondentes no App Builder com os nomes esperados para Tabelas e Colunas. A convenção de nomenclatura que deve ser usada para qualquer Tabela é ProgramName_TransactionName. Por exemplo: PMS100MI_Get

Todas as tabelas devem conter colunas nomeadas exatamente como a definição da API do Infor M3. Por exemplo: FACI, NVarchar(3)

anexo

Adicionar uma ação de evento à tabela do App Builder

A partir da tabela criada no App Builder para mapear a API do M3, você precisará adicionar uma Ação de Evento:

  1. Clique em Eventos na visualização Tabela

  2. Selecione o evento Inserir

  3. Clique no ícone de edição lápis

  4. Em Ações, clique em Registrar existente

  5. Defina Tipo como Plugin

  6. Defina o Plugin para Invocar transação

  7. Defina o valor Quando como Antes

  8. Clique em Salvar

anexo

Crie uma regra CRUD para inserir na tabela

Com as etapas anteriores configuradas, agora você pode criar uma Regra CRUD para inserir nas tabelas no aplicativo App Builder. Os dados podem fluir do aplicativo App Builder para o M3 e o App Builder pode receber chamadas de volta, se necessário:

  1. Navegue até o Workbench > Rules

  2. Clique em + Regra

  3. Atribua o seguinte:

    • Nome: Forneça um Nome identificável. Exemplo: PMS050MI_RptReceipt (Inserir de MORoutePutaway)

    • Objetivo: CRUD

    • Ação: Inserir

    • Camada de destino: Camada lógica

    • Target: selecione a Tabela para inserir dados. Exemplo: PMS050MI_RptReceipt

    anexo

  4. Clique na aba Colunas para revisar as informações.

    • Target deve ser definido como o Nome da Coluna da tabela Target onde os dados serão inseridos

Recursos

Informações M3