Ir para o conteúdo

Guia de conexão do Microsoft Dynamics 365 para Jitterbit App Builder

Visão geral

Este guia descreve os requisitos do sistema e as instruções para conectar o App Builder a um servidor de banco de dados do Microsoft Dynamics 365 Business Central. O Microsoft Business Central é um sistema de contabilidade que configuraremos com OAuth 2.0 para autenticar a partir do App Builder. O Microsoft Azure será utilizado para configurar o fluxo de autenticação OAuth.

Este guia assume que você possui um sistema de contabilidade Microsoft Dynamics 365 Business Central existente que deseja conectar ao App Builder.

Para as etapas de configuração que ocorrem no Microsoft Azure e no Dynamics 365 Business Central, este guia fornecerá informações de alto nível.

Requisitos do sistema

Servidor de banco de dados

  • Dynamics 365 Business Central

  • Microsoft Entra ID

Navegador da web do cliente

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

Instruções de conexão

Registrar um aplicativo no Microsoft Azure

O método utilizado para autenticar do App Builder para o Microsoft Business Central e Dynamics 365 é OAuth 2.0. Vamos configurar o fluxo OAuth usando o Microsoft Azure.

  1. Navegue até o portal do Centro de administração do Azure Active Directory

  2. Em Gerenciar, selecione Registros de aplicativos > Novo registro

  3. Forneça um Nome. Este valor pode ser exibido em alguns momentos pelos usuários do aplicativo. Por exemplo: App Builder Business Central

  4. Selecione quem pode usar o aplicativo

  5. Clique em Registrar

Quando o registro estiver completo, o portal do Azure exibirá o registro do aplicativo na tela de Visão geral, juntamente com o ID do Aplicativo (ou cliente), que é um valor exclusivo que identifica o aplicativo.

Adicionar uma URI de redirecionamento

A URL de redirecionamento representa o local onde a Microsoft redirecionará o cliente do usuário e passará

os tokens de segurança após a autenticação.

  1. Navegue até o aplicativo registrado no Microsoft Entra ID

  2. Clique em Adicionar um URI de Redirecionamento para inserir o valor. Por exemplo: http://localhost/auth-response

Adicionar um segredo do cliente

Segredos do cliente também são chamados de senha de aplicativo. O aplicativo registrado no Microsoft Azure requer que um registro de segredo do cliente seja criado para cada ambiente do App Builder em que a conexão está sendo utilizada. Se sua configuração do App Builder tiver um ambiente de desenvolvimento, QA e Produção, você precisará de 3 registros de segredo do cliente correspondentes.

Segredos do cliente têm uma data de expiração associada, e o comprimento máximo que podem ser definidos é de 2 anos.

Gerar um registro de segredo do cliente fornece a você um Valor e um ID do Segredo. O Valor é codificado e só pode ser copiado e utilizado uma vez (caso contrário, um novo token precisaria ser gerado para capturar um novo Valor).

  1. Navegue até o aplicativo registrado no Microsoft Entra ID

  2. Em Gerenciar, selecione Certificados e segredos

  3. Clique em Novo segredo do cliente

  4. Forneça uma Descrição. Por exemplo: Produção do App Builder

  5. Selecione um valor de Expiração. Por exemplo: 730 dias (24 meses)

  6. Clique em Adicionar

  7. Anote o Valor, pois ele será codificado

Endpoints do aplicativo

Após um aplicativo ter sido registrado no Microsoft Azure, a tela de Endpoints fornece os valores de endpoint necessários para a autenticação OAuth 2.0. Ao configurar o Provedor de Segurança no App Builder, você precisará referenciar alguns desses valores de Endpoint.

  1. Navegue até o aplicativo registrado no Microsoft Entra ID

  2. Clique na aba Endpoints. Os seguintes valores são necessários no App Builder:

    1. Endpoint de autenticação OAuth 2.0 (v2)

    2. Endpoint de token OAuth 2.0 (v2)

Atribuir permissões de API

O aplicativo registrado no Microsoft Azure precisa de permissões atribuídas ao Business Central. Isso deve ser configurado com base em como você deseja integrá-lo ao App Builder. Um método para configurar permissões é um fluxo de tipo de usuário, onde você se autentica no Azure e suas permissões no Business Central ditam o mesmo conjunto de permissões definido no App Builder.

  1. Navegue até o aplicativo registrado no Microsoft Entra ID

  2. Em Gerenciar, selecione Permissões de API

  3. Clique em Adicionar uma permissão

  4. Clique em Dynamics 365 Business Central

  5. Selecione Permissões de aplicativo

  6. Clique em Adicionar uma permissão e defina as permissões de acordo com os requisitos do seu negócio

Para mais detalhes, veja Introdução Rápida: Registrar um aplicativo na plataforma de identidade da Microsoft

Para esta etapa de configuração, você deve ter o valor de ID do Aplicativo (cliente) do aplicativo registrado acima copiado em algum lugar acessível, como sua área de transferência. No Business Central, você também define permissões de aplicativo.

  1. Navegue até o Dynamics 365 Business Central

  2. Vá para Aplicativos do Microsoft Entra ID

  3. Clique em Novo

  4. Insira o valor de ID do Cliente do aplicativo registrado. Este é o valor de ID do Aplicativo (cliente) no Microsoft Azure.

  5. Insira a Descrição. Por exemplo: Integração do App Builder com o Business Central

  6. Selecione o valor de Estado para indicar se a conexão está Habilitada ou Desabilitada

  7. Defina quaisquer Conjuntos de Permissão que o aplicativo possui no Business Central

Para mais detalhes, veja Registrar o Business Central Local no Microsoft Entra ID para Integração com Outros Serviços

Serviços da web do Business Central

Dentro do Business Central, você pode aproveitar os Serviços da Web para expor dados adicionais se não estiverem disponíveis ou já expostos por padrão. Serviços da Web permitem que você exponha uma página ou Consulta no Business Central como um Endpoint, semelhante em conceito a uma API. Quaisquer limitações e restrições em vigor no Business Central se aplicam aos dados recuperados dos Serviços da Web. Os Serviços da Web não podem realizar callbacks.

  1. Navegue até o Dynamics 365 Business Central

  2. Vá para Serviços da Web

  3. Clique em Novo

  4. Selecione o Tipo de Objeto desejado. Por exemplo: Página

  5. Selecione o ID do Objeto desejado

  6. Atribua um Nome do Serviço. Isso representa o Endpoint que você chamaria. Por exemplo: PaymentTerms

  7. Marque a opção Publicado

  8. O correspondente URI OData V4 pode ser usado para acessar esses dados, uma vez que a configuração adequada esteja em vigor

Para mais detalhes, veja Serviços da Web do Business Central.

Criar um provedor de segurança OAuth no App Builder

  1. Navegue até o IDE do App Builder

  2. No menu Conectar, clique no botão Provedores de Segurança

  3. Clique em + Autenticação de Usuário

  4. Forneça um Nome. Por exemplo: Business Central OAuth

  5. Selecione Tipo como OAuth

  6. Confirme que Habilitado está selecionado

  7. Defina o Tipo de Autenticação como OAuth

  8. Defina o OAuth Grant como Credenciais do Cliente

  9. Defina a Autenticação do Cliente OAuth como Parâmetro

  10. Defina a Autenticação do Recurso OAuth como Bearer

  11. Defina o Proprietário do Token como Cliente

  12. Clique em Salvar

    attachment

  13. Em seguida, configure 2 Endpoints clicando em + Endpoint:

    • Tipo = Endpoint de Autorização, URL = valor do portal Azure Endpoints

    • Tipo = Endpoint de Token, URL = valor do portal Azure Endpoints

  14. Clique em + Credencial

    • Tipo = Cliente

    • Nome de Usuário = ID do Cliente do portal Azure

    • Senha = segredo do Cliente do portal Azure

    • Clique em Salvar

  15. Clique em + Propriedade

    • Parâmetro = Escopos, Valor = valor padrão do Business Central. Por exemplo: https://api.businesscentral.dynamics.com/.default

Criar uma fonte de dados no App Builder

  1. Navegue até o IDE do App Builder

  2. No menu Conectar, clique no botão Servidores de Dados

  3. Clique em + Servidor

  4. Atribua um Nome do Servidor. Por exemplo: Dynamics 365 Business Central

  5. Defina o Tipo como Dynamics 365 Business Central

  6. Forneça a Url como a Url base para acessar o Dynamics 365 no Business Central (inclui o ID do locatário na string). Por exemplo: https://api.businesscentral.dynamics.com/v1.0/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/ODataV4

    attachment

  7. Forneça o Nome da Instância para conectar. Isso representa a empresa no Business Central.

    • O Business Central limita as conexões a uma empresa por vez

    • Se várias empresas precisarem ser conectadas, várias conexões de Servidor de Dados devem ser configuradas juntamente com a lógica de negócios desenvolvida para cada conexão de Servidor de Dados única

  8. Clique no botão Configurações Avançadas

    • Se necessário, forneça qualquer informação adicional de conexão no campo Avançado

    • Clique em Salvar

    attachment

  9. Em Configurações de Segurança, defina o Provedor de Segurança para o provedor do Business Central configurado

  10. Clique em Salvar

Testar a conexão

Na seção Teste, clique no botão Testar Conexão e verifique se a configuração está funcionando conforme o esperado.

Importar os dados do endpoint

Após a configuração ser estabelecida, você pode importar quaisquer dados de Endpoint desejados do Business Central para o App Builder. Depois de importados, você pode expor, interagir e manipular os dados como normalmente faria no App Builder; quaisquer permissões do Business Central se aplicarão.

  1. Navegue até o IDE do App Builder

  2. No menu Conectar, clique no botão Servidores de Dados

  3. Localize a conexão do servidor de dados do Dynamics 365 Business Central criada e selecione-a

  4. Clique no botão Detalhes na entrada do servidor de dados do Dynamics 365 Business Central no painel à direita

  5. Clique no botão Importar

  6. Forneça o valor do Endpoint dos Serviços Web em Importar Padrão que você deseja corresponder. Por exemplo: PaymentTerms

  7. Clique no botão Importar. O App Builder importará o esquema.

Solução de Problemas

Se você encontrar problemas com o servidor Microsoft Dynamics 365 Business Central, recomenda-se seguir estas etapas de solução de problemas:

  1. Ative o registro de dados para gerar arquivos de log e dados, que você pode baixar e inspecionar.

  2. Consulte a documentação do CData ADO.NET Provider para Microsoft Dynamics 365 Business Central para informações detalhadas.