Configuração OData de Microsoft Dynamics microsoft-dynamics-odata-configuration

Versão
Link do artigo
AEM 6.5
Clique aqui
AEM as a Cloud Service
Este artigo

integração de dados

O Microsoft Dynamics é um software de CRM (relacionamento com o cliente) e ERP (planejamento de recursos corporativos) que fornece soluções corporativas para criar e gerenciar contas, contatos, clientes potenciais, oportunidades e casos de clientes. Experience Manager Forms A Integração de Dados fornece uma configuração do serviço de nuvem OData para integrar o Forms ao servidor Microsoft Dynamics local e online. Ela permite criar o Modelo de Dados de Formulário (FDM) com base nas entidades, atributos e serviços definidos no serviço Microsoft Dynamics. O Modelo de Dados de Formulário (FDM) pode ser usado para criar o Forms Adaptável que interage com o servidor Microsoft Dynamics para habilitar fluxos de trabalho de negócios. Por exemplo:

  • Consultar o servidor Microsoft Dynamics para obter dados e pré-popular o Adaptive Forms
  • Gravar dados em Microsoft Dynamics no envio do Formulário Adaptável
  • Gravar dados em Microsoft Dynamics por meio de entidades personalizadas definidas no Modelo de Dados de Formulário (FDM) e vice-versa

O Cloud Service OData (serviço OData) do MS Dynamics está disponível com todos os modos de execução. Para obter mais informações sobre como configurar os modos de execução para uma instância Experience Manager, consulte Modos de Execução.

O AEM as a Cloud Service oferece várias ações de envio prontas para uso para manipular envios de formulários. Você pode saber mais sobre essas opções no artigo Ação de envio do formulário adaptável.

Pré-requisitos prerequisites

Antes de começar a instalar e configurar o Microsoft Dynamics, verifique se você tem:

Definir URL de Resposta para o aplicativo Microsoft Dynamics registrado set-reply-url-for-registered-microsoft-dynamics-application

Faça o seguinte para definir a URL de resposta para o aplicativo Microsoft Dynamics registrado:

NOTE
Use este procedimento somente durante a integração do Experience Manager Forms com o servidor Microsoft Dynamics online.
  1. Vá para a conta do Ative Diretory Microsoft Azure e adicione a seguinte URL de configuração do serviço de nuvem nas configurações de URLs de resposta para o aplicativo registrado:

    https://[server]:[port]/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html

    Diretório do Azure

  2. Salve a configuração.

Configurar Microsoft Dynamics para IFD configure-microsoft-dynamics-for-ifd

Microsoft Dynamics usa autenticação baseada em declarações para fornecer acesso aos dados no servidor do CRM Microsoft Dynamics para usuários externos. Para habilitar isso, faça o seguinte para configurar o Microsoft Dynamics para IFD e definir as configurações de declaração.

NOTE
Use este procedimento somente durante a integração do Experience Manager Forms com o servidor Microsoft Dynamics local.
  1. Configure a instância local Microsoft Dynamics para o IFD conforme descrito em Configurar o IFD para Microsoft Dynamics.

  2. Execute os seguintes comandos usando o Windows PowerShell para definir as configurações de declaração no Microsoft Dynamics habilitado para IFD:

    code language-shell
    Add-PSSnapin Microsoft.Crm.PowerShell
     $ClaimsSettings = Get-CrmSetting -SettingType OAuthClaimsSettings
     $ClaimsSettings.Enabled = $true
     Set-CrmSetting -Setting $ClaimsSettings
    

    Consulte Registro de aplicativo para CRM local (IFD) para obter detalhes.

Configurar o cliente OAuth no computador do AD FS configure-oauth-client-on-ad-fs-machine

Faça o seguinte para registrar um cliente OAuth em um computador do Ative Diretory Federation Services (AD FS) e conceder acesso a esse computador:

NOTE
Use este procedimento somente durante a integração do Experience Manager Forms com o servidor Microsoft Dynamics local.
  1. Execute o seguinte comando:

    Add-AdfsClient -ClientId “<Client-ID>” -Name "<name>" -RedirectUri "<redirect-uri>" -GenerateClientSecret

    Em que:

    • Client-ID é uma ID de cliente que você pode gerar usando qualquer gerador de GUID.

    • redirect-uri é a URL para o serviço de nuvem OData Microsoft Dynamics em Experience Manager Forms. O serviço de nuvem padrão instalado com o Experience Manager Forms é implantado na seguinte URL:

      https://'[server]:[port]'/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html

  2. Execute o seguinte comando para conceder acesso à máquina do AD FS:

    Grant-AdfsApplicationPermission -ClientRoleIdentifier “<Client-ID>” -ServerRoleIdentifier <resource> -ScopeNames openid

    Em que:

    • resource é a URL da organização Microsoft Dynamics.
  3. Microsoft Dynamics usa o protocolo HTTPS. Para invocar pontos de extremidade do AD FS do servidor Forms, instale o certificado do site Microsoft Dynamics no armazenamento de certificados Java usando o comando keytool no computador que executa o Experience Manager Forms.

Configurar o serviço de nuvem para o serviço Microsoft Dynamics configure-cloud-service-for-your-microsoft-dynamics-service

Um serviço OData é identificado por sua URL raiz de serviço. Para configurar um serviço OData em Experience Manager as a Cloud Service, verifique se você tem uma URL raiz de serviço para o serviço e faça o seguinte:

NOTE
Para obter o guia passo a passo para configurar o Microsoft Dynamics 365, online ou no local, consulte Microsoft Dynamics Configuração OData.
  1. Acesse Ferramentas > Cloud Service > Fontes de dados. Selecione para selecionar a pasta na qual deseja criar uma configuração de nuvem.

    Consulte Configurar pasta para configurações do serviço de nuvem para obter informações sobre como criar e configurar uma pasta para configurações do serviço de nuvem.

  2. Selecione Criar para abrir o Assistente de Criação de Configuração de Source de Dados. Especifique um nome e, opcionalmente, um título para a configuração, selecione Serviço OData na lista suspensa Tipo de Serviço, opcionalmente, procure e selecione uma imagem em miniatura para a configuração e selecione Próximo.
    Na guia Configurações de autenticação:

    1. Insira o valor para o campo Raiz de Serviço. Vá para a instância do Dynamics e navegue até Recursos do Desenvolvedor para exibir o valor do campo Raiz do Serviço. Por exemplo, https://<tenant-name>/api/data/v9.1/

    2. Selecione OAuth 2.0 como o tipo de autenticação.

    3. Substitua os valores padrão nos campos ID do Cliente (também conhecido como ID do Aplicativo), Segredo do Cliente, URL do OAuth, URL do Token de Atualização, URL do Token de Acesso e URL por valores da configuração do serviço Microsoft Dynamics. É obrigatório especificar a URL da instância do Dynamics no campo Recurso para configurar Microsoft Dynamics com um modelo de dados de formulário (FDM). Use o URL raiz do serviço para derivar o URL da instância dinâmica. Por exemplo, https://org.crm.dynamics.com.

    4. Especifique openid no campo Escopo de Autorização para o processo de autorização em Microsoft Dynamics.

      Configurações de autenticação
      Modelo de dados de formulário (FDM)

  3. Clique em Conectar ao OAuth. Você é redirecionado à página de logon Microsoft Dynamics.

  4. Faça logon com suas credenciais do Microsoft Dynamics e aceite para permitir que a configuração do serviço de nuvem se conecte ao serviço Microsoft Dynamics. É uma tarefa única estabelecer o Modelo de dados de formulário (FDM) entre o serviço em nuvem e o serviço.

    Você é a página Modelo de dados de formulário Configuração do serviço de nuvem, que exibe uma mensagem de que a configuração OData foi salva com êxito.

O serviço de nuvem OData Cloud Service (OData Service) do MS Dynamics está configurado e conectado com seu serviço Dynamics. Modelo de dados de formulário (FDM)

Criar modelo de dados de formulário (FDM) create-form-data-model

Após configurar o serviço de nuvem MS Dynamics OData, você pode usá-lo ao criar o modelo de dados de formulário (FDM). Para obter mais informações, consulte Criar modelo de dados de formulário (FDM).

Em seguida, você pode criar um Modelo de dados de formulário (FDM) baseado no Formulário adaptável e usá-lo em vários casos de uso do Formulário adaptável, como:

  • Preencha previamente o formulário adaptável consultando informações de Microsoft Dynamics entidades e serviços
  • Invocar operações do servidor Microsoft Dynamics definidas em um Modelo de Dados de Formulário (FDM) usando regras de Formulário Adaptável
  • Gravar dados de formulário enviados em Microsoft Dynamics entidades

Você pode configurar a Ação de Envio do Modelo de Dados de Formulário para um Formulário Adaptável para enviar dados para o Microsoft Dynamics OData.

Para obter mais informações sobre como criar e usar o Form Data Model (FDM) nos fluxos de trabalho de negócios, consulte Integração de Dados.

Artigos relacionados

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab