Configurar o spoke do Microsoft Dynamics 365 for Finance and Operations

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 8 min. de leitura

    • Integre a instância ServiceNow e o Microsoft Dynamics 365 for Finance and Operations criando uma aplicação OAuth personalizada no Microsoft Azure para autenticar solicitações ServiceNow.

    Antes de Iniciar

    • Solicitar uma assinatura de Integration Hub.
    • Ative o spoke do Microsoft Dynamics 365 for Finance and Operations.
    • Função necessária: administrador
    Nota:
    Depois de configurar o alias de conexão e credencial, certifique-se de recuperar os metadados mais recentes da aplicação Microsoft Dynamics 365 Finance and Operations.

    Registrar o Microsoft Dynamics 365 for Finance and Operations como um provedor OAuth

    Registre o Microsoft Dynamics 365 for Finance and Operations como o provedor OAuth para que a instância ServiceNow possa solicitar tokens OAuth 2.0.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > OAuth de Sistema > Registro de aplicações.
    2. Aberto para o registro do OAuth do Microsoft D365 Fin and Ops Spoke.
    3. No formulário, preencha estes valores.
      Tabela 1. Formulário de registros de aplicações
      Campo Descrição
      Nome Nome para identificar exclusivamente o registro. Por exemplo, insira: OAuth do Microsoft Dynamics 365 for Finance and Operations
      ID de cliente ID de cliente criado durante o Microsoft Dynamics 365 for Finance and Operations configuração da aplicação.
      Segredo do cliente Segredo do cliente criado durante a configuração da aplicação Microsoft Dynamics 365 for Finance and Operations.
      URL de Autorização Endpoint do código de autorização do OAuth. Insira: https://login.microsoftonline.com/<AzureTenantID> /oauth2/v2.0/autorizar
      URL de Token Endpoint do token do servidor OAuth. Insira: https://login.microsoftonline.com/<AzureTenantID> /oauth2/v2.0/token
      URL de revogação do token Endpoint de revogação de token do servidor OAuth.
      URL de redirecionamento Endpoint de retorno de chamada OAuth neste formato: https://<instance>.service-now.com/oauth_redirect.do
      Script do API da OAuth Script para personalizar a solicitação e a resposta. Selecione .
      URL de logotipo URL que contém uma imagem a ser usada como logotipo da aplicação.
      Tipo de concessão padrão Tipo de concessão usado para estabelecer o token. Selecione Credenciais do Cliente.
      Tempo de vida do token de atualização Tempo, em segundos, em que o token de atualização é válido. O tempo padrão é 8.640.0000 segundos.
      PKCE necessário Opção para permitir que clientes públicos exijam o PKCE para uma autorização.
      Nota:
      Você pode usar somente o Código de autorização como o Tipo de concessão padrão quando o PKCE estiver habilitado.
      Aplicação Escopo da aplicação que contém este registro.
      Acessível de Escopo da aplicação a partir do qual este registro fica acessível.
      Ativo Opção para usar ativamente o registro da aplicação.
      Usar autenticação mútua Opção de usar autenticação mútua para solicitação e revogação de token. Esta opção exige que um perfil de autenticação mútua seja especificado.
    4. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.

    Criar um registro de conexão para o Microsoft Dynamics 365 for Finance and Operations

    Crie um registro de conexão para o Microsoft Dynamics 365 for Finance and Operations. Os aliases de conexão e credencial do spoke do Microsoft Dynamics 365 for Finance and Operations usam essas conexões para executar ações no Microsoft Dynamics 365 for Finance and Operations.

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Aliases de conexões e credenciais.
    2. Abra o registro de alias para MicrosoftD365FinAndOps.
    3. Na guia Conexões, clique em Novo.
    4. No formulário, preencha estes campos.
      Tabela 2. Formulário de conexão
      Campo Descrição
      Nome Nome para identificar exclusivamente o registro. Por exemplo, Conexão do Microsoft Dynamics 365 for Finance and Operations.
      Credenciais Registro de credencial criado para o Microsoft Dynamics 365 for Finance and Operations . Pesquise e selecione MicrosoftD365FinAndOps.Credential.
      Alias de conexão Registro de alias associado a esta conexão. Insira sn_ms_fin_ops_spk.MicrosoftD365FinAndOps
      URL de Conexão URL base para conexão com o Microsoft Dynamics 365 for Finance and Operations. Insira: https://<instance_ID> .cloudax.dynamics.com/
      Ativo Opção para usar ativamente o registro de conexão.
      Domínio Domínio no qual a ação é executada.
    5. Clique em Enviar.

    Recuperar metadados do Microsoft Dynamics 365 Finance and Operations

    Recupere os metadados do Microsoft Dynamics 365 Finance and Operations e armazene-os em sua instância da ServiceNow. As ações dinâmicas exigem os metadados mais recentes do Microsoft Dynamics 365 Finance and Operations.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Metadados de FinOps do Microsoft D365 > Conteúdo de metadados de FinOps do Microsoft D365.
    2. Clique em Obter/atualizar metadados.
    3. Selecione o alias para recuperar metadados atualizados da aplicação Microsoft Dynamics 365 Finance and Operation e clique em Ok.
      Nota:
      Certifique-se de recuperar os metadados mais recentes sempre que houver mudanças na aplicação Microsoft Dynamics 365 Finance and Operations.

    Configurar webhook bidirecional para o Spoke do Microsoft Dynamics 365 for Finance and Operations

    Configure o webhook para assinar o Spoke do Microsoft Dynamics 365 for Finance and Operations com um URL de retorno de chamada ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Spoke do Microsoft D365 FnO > Registros do webhook FnO.
    2. Clique em Nova.
    3. No formulário, preencha os campos.
      Campo Descrição
      Nome Nome exclusivo para o registro do webhook. Por exemplo, webhook do Microsoft Dynamics 365 for Finance and Operations.
      Descrição Descrição opcional do webhook.
      Gerar URL de retorno da chamada Opção para gerar uma URL de retorno de chamada que é usada para registrar o webhook no portal do Microsoft Dynamics 365 Finance and Operations.
      Gerar novo segredo Opção para gerar uma chave secreta para o webhook do Microsoft Dynamics 365 Finance and Operations.
      Nota:

      Ao gerar um novo segredo, certifique-se de gerar o URL de retorno de chamada também após gerar o segredo.

      Registre a URL de retorno de chamada para registrar o aplicativo no portal do Azure.

    Personalizar webhook bidirecional no spoke do Microsoft Dynamics 365 Finance and Operations

    Crie a política de roteamento do webhook e o subfluxo de acordo com seus requisitos no spoke do Microsoft Dynamics 365 Finance and Operations.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Flow Designer > Designer.
    2. Clique em Subfluxos.
    3. Crie uma cópia do subfluxo necessário.
    4. Personalize o subfluxo necessário de acordo com seus requisitos e publique-o.
    5. Navegar até Spoke do Microsoft D365 FnO > Políticas de roteamento do WebHook do FnO.
    6. Clique em Nova.
    7. No formulário, preencha os campos.
      Tabela 3. Formulário de decisão
      Campo Descrição
      Rótulo Rótulo exclusivo para identificar a política de roteamento.
      Resposta padrão Opção para especificar se esta é a resposta padrão. A resposta padrão é aplicável quando as condições não são atendidas.
      1. Clique no ícone de pesquisa.
      2. Selecione o subfluxo necessário na lista Documento:.
        Nota:
        Certifique-se de que o nome da tabela seja Fluxo [sys_hub_flow].
      Condição Condições a serem atendidas quando os eventos necessários ocorrerem no Microsoft Dynamics 365 Finance and Operations. Consulte Spoke do Microsoft Dynamics 365 for Finance and Operations para obter informações sobre os campos compatíveis.
      Resposta Subfluxo que precisa ser acionado quando as condições especificadas são atendidas.
    8. Clique em Enviar.
      Nota:
      Essas políticas de roteamento são salvas nas tabelas de decisão. Os usuários são alertados para não atualizar ou modificar diretamente os dados dessas tabelas.

    Resultado

    A política de roteamento e o subfluxo foram criados.

    Registrar um app no portal do Microsoft Azure para o spoke do Microsoft Dynamics 365 Finance and Operations

    Registre sua instância da ServiceNow no portal do Microsoft Azure para usar o spoke do Microsoft Dynamics 365 Finance and Operations.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Faça login no portal do Azure.
    2. Navegue até Registros de app e registre um app para o webhook.
    3. Crie um cofre de chaves usando o portal do Azure.
      Para obter mais informações, consulte Criação de um cofre de chaves usando o portal do Azure.
    4. Navegue até Políticas de acesso.
    5. Crie uma política de acesso.
    6. Selecione Obter em Permissões secretas e clique em Avançar.
    7. Na guia Principal, pesquise o nome do app registrado anteriormente e clique em Avançar.
    8. Na guia Aplicação (opcional), clique em Avançar.
    9. Na guia Revisar + criar, clique em Criar.
    10. Navegue até a seção Segredos.
    11. Clique em + Gerar/Importar.
    12. Em Criar uma página secreta, insira um nome e forneça o URL de retorno de chamada gerado a partir da sua instância da ServiceNow.
    13. Clique em Criar.
    14. Faça login no portal do Microsoft Dynamics 365 Finance and Operations.
    15. Navegar até Administração do sistema > Eventos de negócios > Catálogo de eventos de negócios.
    16. Navegue até a guia Endpoints e clique em Novo.
    17. Selecione o tipo de endpoint como HTTPS na exibição Padrão e clique em Avançar.
    18. No formulário, preencha os detalhes.
      Nome do endpoint Nome do endpoint.
      Tipo de endpoint Tipo de endpoint.
      Key Vault Cofre de chaves criado para a aplicação.
      ID da aplicação do Azure Active Directory ID do objeto da aplicação.
      Segredo da aplicação do Azure Segredo criado para a aplicação
      Nome DNS do cofre de chaves URI do Vault da aplicação.
      Nome do segredo do cofre de chaves Nome do segredo do cofre de chaves.
    19. Clique em OK.
      Nota:
      Certifique-se de que a política de acesso ao cofre de chaves seja criada para a aplicação. A política de acesso deve permitir que o registro da aplicação acesse segredos do cofre de chaves.
    20. Navegue até a guia Eventos de negócios e pesquise uma categoria.
      Por exemplo, Ordens de compra.
    21. Selecione a categoria necessária na lista e clique em Ativar.
    22. Na seção Configurar novo evento de negócios, selecione a entidade jurídica e o nome do endpoint.
    23. Clique em OK.
      Nota:
      Certifique-se de que essas permissões de API estejam habilitadas para a aplicação.
      • Acessar serviço personalizado do Dynamics AX
      • Acessar dados do Dynamics AX
      • Acessar o Dynamics AX on-line como usuários da organização

    Resultado

    O webhook está registrado e pronto para testes.