Ir para o conteúdo

Guia de Conexão do Microsoft Dynamics 365

Visão Geral

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

Este guia pressupõe que você tenha um sistema de contabilidade Microsoft Dynamics 365 Business Central existente ao qual deseja se conectar App Builder.

Para as etapas de configuração que acontecem 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

  • Active Directory do Azure

Navegador da Web do Cliente

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Borda: 84+

Instruções de Conexão

Registre um Aplicativo no Microsoft Azure

O método usado para autenticar de App Builder para o Microsoft Business Central e Dynamics 365 é OAuth 2.0. Configuraremos 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 às vezes pelos usuários do aplicativo. Por exemplo: App Builder central de negócios

  4. Selecione quem pode usar o aplicativo

  5. Clique em Registrar

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

Adicionar um URI de Redirecionamento

O * URL de redirecionamento* representa o local para 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 Azure Active Directory

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

Adicionar um Segredo do Cliente

Os segredos do cliente também são chamados de senha do aplicativo. O aplicativo registrado no Microsoft Azure requer que um registro de segredo do cliente seja criado para cada App Builder ambiente em que a conexão está sendo usada. Se o seu App Builder a configuração tem um ambiente de desenvolvimento, controle de qualidade e produção; você precisará de 3 registros secretos de cliente correspondentes.

Os segredos do cliente têm uma data de expiração associada e o período máximo que podem ser definidos é de 2 anos.

Gerar um registro de segredo de cliente fornece a você um Valor de segredo de cliente e um ID de segredo. O Valor é codificado e só está disponível para cópia e uso uma vez (caso contrário, um novo token precisaria ser gerado para capturar um novo Valor).

  1. Navegue até o aplicativo registrado no Azure Active Directory

  2. Em Gerenciar, selecione Certificados e segredos

  3. Clique em Novo segredo do cliente

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

  5. Selecione um valor Expira. Por exemplo: 730 dias (24 meses)

  6. Clique em Adicionar

  7. Observe o Valor, pois ele será codificado

Endpoints do Aplicativo

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

  1. Navegue até o aplicativo registrado no Azure Active Directory

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

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

    2. endpoint do 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 com App Builder. Um método para configurar permissões é um fluxo de tipo de usuário, onde você autentica no Azure e suas permissões no Business Central determinam as mesmas permissões definidas em App Builder.

  1. Navegue até o aplicativo registrado no Azure Active Directory

  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 do aplicativo

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

Para obter mais detalhes, consulte Início rápido: registrar um aplicativo na plataforma de identidade da Microsoft

Para esta etapa de configuração, você deve ter o valor ID do aplicativo (cliente) para o aplicativo registrado acima copiado em algum lugar prático para uso, 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 Azure Active Directory

  3. Clique em Novo

  4. Insira o valor Client ID do aplicativo registrado. Este é o valor Application (client) ID no Microsoft Azure.

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

  6. Selecione o valor Estado para indicar se a conexão está Ativada ou Desativada

  7. Defina quaisquer Conjuntos de permissões que o aplicativo tenha no Business Central

Para obter mais detalhes, consulte Registrar o Business Central On-Premises no Azure AD para integração com outros Serviços

Serviços Web do Business Central

No Business Central, você pode aproveitar os Web Services para expor dados adicionais se eles não estiverem disponíveis ou já estiverem expostos por padrão. Os Web Services permitem que você exponha uma página ou Query no Business Central como um Endpoint, semelhante em conceito a uma API. Quaisquer limitações e restrições em vigor no Business Central são transferidas para os dados recuperados dos Web Services. Os Web Services não podem executar retornos de chamada.

  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 de Serviço. Isso representa o Endpoint em que você o chamaria. Por exemplo: PaymentTerms

  7. Marque a caixa Publicado

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

Para mais detalhes, consulte Business Central Web Services.

Crie um Provedor de Segurança OAuth em App Builder

  1. Navegue até App Builder IDE

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

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

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

  5. Selecione Tipo como OAuth

  6. Confirme que Ativado está selecionado

  7. Defina Tipo de Autenticação como OAuth

  8. Defina Concessão de OAuth como Credenciais do Cliente

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

  10. Defina Autenticação do Recurso OAuth como Portador

  11. Defina Proprietário do Token como Cliente

  12. Clique em Salvar

    anexo

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

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

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

  14. Clique em + Credencial

    • Tipo = Cliente

    • Nome de usuário = ID do cliente do portal do Azure

    • Senha = Segredo do cliente do portal do 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

Crie uma Fonte de Dados em App Builder

  1. Navegue até App Builder IDE

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

  3. Clique em + Servidor

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

  5. Defina o Tipo como Dynamics 365 Business Central

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

    anexo

  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 se conectar, várias conexões do Data Server devem ser configuradas junto com a lógica de negócios desenvolvida para cada conexão exclusiva do Data Server

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

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

    • Clique em Salvar

    anexo

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

  10. Clique em Salvar

Teste a Conexão

Em Teste, clique no botão Testar conexão e certifique-se de que a configuração esteja 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 App Builder. Depois de importado, você pode expor, interagir e manipular os dados como faria normalmente em App Builder, todas as permissões do Business Central serão aplicadas.

  1. Navegue até App Builder IDE

  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 direito

  5. Clique no botão Importar

  6. Forneça o valor Endpoint de Web Services em Import Pattern que você deseja corresponder. Por exemplo: PaymentTerms

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