Configuração OData do Microsoft Dynamics

Última atualização em 2023-12-04
Versão Link do artigo
AEM as a Cloud Service Clique aqui
AEM 6.5 Este artigo

integração de dados

O Microsoft Dynamics é um software de CRM (Customer Relationship Management, gerenciamento de relacionamento com o cliente) e ERP (Enterprise Resource Planning, planejamento de recursos corporativos) que fornece soluções corporativas para criar e gerenciar contas, contatos, clientes potenciais, oportunidades e casos de clientes. Integração de dados do AEM Forms O fornece uma configuração do serviço de nuvem OData para integrar o Forms ao servidor do Microsoft Dynamics online e local. Ela permite criar um modelo de dados de formulário com base nas entidades, atributos e serviços definidos no serviço Microsoft Dynamics. O modelo de dados de formulário pode ser usado para criar formulários adaptáveis que interagem com o servidor do Microsoft Dynamics para habilitar fluxos de trabalho de negócios. Por exemplo:

  • Consultar o servidor do Microsoft Dynamics para obter dados e preencher formulários adaptáveis
  • Gravar dados no Microsoft Dynamics no envio de formulário adaptável
  • Gravar dados no Microsoft Dynamics por meio de entidades personalizadas definidas no modelo de dados de formulário e vice-versa

O pacote complementar do AEM Forms também inclui a configuração OData de referência que você pode usar para integrar rapidamente o Microsoft Dynamics com o AEM Forms.

Quando o pacote é instalado, as seguintes entidades e serviços estão disponíveis na instância do AEM Forms:

  • CLOUD SERVICE OData do MS Dynamics (Serviço OData)
  • Modelo de dados de formulário com entidades e serviços pré-configurados do Microsoft Dynamics.

As entidades e os serviços pré-configurados do Microsoft Dynamics em um modelo de dados de formulário estarão disponíveis na instância do AEM Forms somente se o modo de execução da instância do AEM estiver definido como samplecontent (padrão). O MS Dynamics OData Cloud Service (OData Service) também está disponível com outros modos de execução. Para obter mais informações sobre como configurar os modos de execução para uma instância do AEM, consulte Modos de execução.

Pré-requisitos

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

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

OBSERVAÇÃO

Use esse procedimento somente ao integrar o AEM Forms ao servidor online do Microsoft Dynamics.

  1. Vá para a conta do Ative Diretory do Microsoft Azure e adicione a seguinte URL de configuração do serviço de nuvem em URLs de resposta configurações para seu 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 o Microsoft Dynamics para IFD

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

OBSERVAÇÃO

Use esse procedimento somente ao integrar o AEM Forms com o servidor local do Microsoft Dynamics.

  1. Configure a instância local do Microsoft Dynamics para o IFD conforme descrito em Configurar o IFD para o Microsoft Dynamics.

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

    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

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:

OBSERVAÇÃO

Use esse procedimento somente ao integrar o AEM Forms com o servidor local do Microsoft Dynamics.

  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 do Microsoft Dynamics no AEM Forms. O serviço de nuvem padrão instalado com o pacote do AEM Forms é implantado no 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 é o URL da organização do Microsoft Dynamics.
  3. O Microsoft Dynamics usa o protocolo HTTPS. Para chamar pontos de extremidade do AD FS do servidor do Forms, instale o certificado de site do Microsoft Dynamics no armazenamento de certificados Java usando o keytool no computador que executa o AEM Forms.

Configurar o serviço em nuvem para o serviço Microsoft Dynamics

A variável CLOUD SERVICE OData do MS Dynamics (Serviço OData) A configuração do vem com a configuração OData padrão. Para configurá-lo para se conectar com o serviço Microsoft Dynamics, faça o seguinte.

  1. Navegue até Ferramentas > Cloud Service > Fontes de dados e selecione a variável global pasta de configuração.

  2. Selecionar CLOUD SERVICE OData do MS Dynamics (Serviço OData) e selecione Propriedades. A caixa de diálogo de propriedade de configuração do Cloud Service é aberta.

    No Configurações de autenticação guia:

    1. Insira o valor para o Raiz do serviço campo. Acesse 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. Substitua os valores padrão no ID do cliente(também referido como ID do aplicativo), Segredo do cliente, URL do OAuth, URL do token de atualização, URL do token de acesso, e Recurso campos com valores da configuração do serviço Microsoft Dynamics. É obrigatório especificar o URL da instância do dynamics na variável Recurso para configurar o Microsoft Dynamics com um modelo de dados de formulário. Use o URL raiz do serviço para derivar o URL da instância dinâmica. Por exemplo, https://org.crm.dynamics.com.

    3. Especificar openid no Escopo da autorização campo para processo de autorização no Microsoft Dynamics.

    Configurações de autenticação

  3. Clique em Conectar-se ao OAuth. Você é redirecionado para a página de logon do Microsoft Dynamics.

  4. Faça logon com as credenciais do Microsoft Dynamics e aceite para permitir que a configuração do serviço de nuvem se conecte ao serviço do Microsoft Dynamics. É uma tarefa única para estabelecer a conexão entre o serviço de nuvem e o serviço.

    Em seguida, você será redirecionado para a página de configuração do Cloud Service, que exibirá uma mensagem informando 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.

Criar modelo de dados de formulário

Ao instalar o pacote do AEM Forms, um modelo de dados de formulário,FDM do Microsoft Dynamics, é implantado na instância do AEM. Por padrão, o modelo de dados de formulário usa o serviço Microsoft Dynamics configurado no Cloud Service OData (OData Service) do MS Dynamics como a fonte de dados.

Ao abrir o modelo de dados de formulário pela primeira vez, ele se conecta ao serviço configurado do Microsoft Dynamics e busca entidades da sua instância do Microsoft Dynamics. As entidades "contato" e "cliente potencial" do Microsoft Dynamics já foram adicionadas no modelo de dados de formulário.

Para revisar o modelo de dados do formulário, acesse Forms > Integrações de dados. Selecionar FDM do Microsoft Dynamics e clique em Editar para abrir o modelo de dados de formulário no modo de edição. Como alternativa, você pode abrir o modelo de dados de formulário diretamente da seguinte URL:

https://'[server]:[port]'/aem/fdm/editor.html/content/dam/formsanddocuments-fdm/ms-dynamics-fdm

default-fdm-1

Em seguida, você pode criar um formulário adaptável com base no modelo de dados de formulário e usá-lo em vários casos de uso de formulário adaptável, como:

  • Preencha previamente o formulário adaptável consultando informações de entidades e serviços do Microsoft Dynamics
  • Invocar operações de servidor do Microsoft Dynamics definidas em um modelo de dados de formulário usando regras de formulário adaptáveis
  • Gravar dados de formulário enviado em entidades do Microsoft Dynamics

É recomendável criar uma cópia do modelo de dados de formulário fornecido com o pacote do AEM Forms e configurar modelos de dados e serviços para atender aos seus requisitos. Ele garantirá que qualquer atualização futura do pacote não substitua o modelo de dados de formulário.

Para obter mais informações sobre como criar e usar o modelo de dados de formulário em fluxos de trabalho de negócios, consulte Integração de dados.

Nesta página