Configuração do Microsoft Dynamics OData

integração de dados

O Microsoft Dynamics é um software CRM (Customer Relationship Management) e ERP (Enterprise Resource Planning) que fornece soluções empresariais para criar e gerenciar contas, contatos, clientes potenciais, oportunidades e casos de clientes. A AEM Forms Data Integrationfornece uma configuração de serviço em nuvem OData para integrar a Forms ao servidor Microsoft Dynamics online e local. Ele 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 Microsoft Dynamics Server para habilitar workflows comerciais. Por exemplo:

  • Query do Microsoft Dynamics Server para dados e pré-preenchimento de 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 de complementos AEM Forms também inclui a configuração de referência OData que você pode aproveitar para integrar rapidamente o Microsoft Dynamics ao AEM Forms.

Quando o pacote é instalado, as seguintes entidades e serviços estão disponíveis na sua 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 só estarão disponíveis na sua instância do AEM Forms se o modo de execução da instância AEM estiver definido como samplecontent (padrão). O MS Dynamics OData Cloud Service (Serviço OData) também está disponível com outros modos de execução. Para obter mais informações sobre como configurar modos de execução para uma instância AEM, consulte Modos de execução.

Pré-requisitos

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

Definir URL de resposta para o aplicativo registrado do Microsoft Dynamics

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

OBSERVAÇÃO

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

  1. Vá para a conta do Ative Diretory do Microsoft Azure e adicione o seguinte URL de configuração de serviço em nuvem nas configurações 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 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 a usuários externos. Para habilitar isso, faça o seguinte para configurar o Microsoft Dynamics para a implantação com a Internet (IFD) e defina as configurações de declaração.

OBSERVAÇÃO

Use este procedimento somente ao integrar o AEM Forms ao servidor Microsoft Dynamics local.

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

  2. Execute os seguintes comandos usando o Windows PowerShell para configurar as definições de afirmaçã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 do aplicativo para CRM no local (IFD) para obter detalhes.

Configurar o cliente OAuth na máquina do AD FS

Faça o seguinte para registrar um cliente OAuth na máquina do Ative Diretory Federation Services (AD FS) e conceder acesso à máquina do AD FS:

OBSERVAÇÃO

Use este procedimento somente ao integrar o AEM Forms ao 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 é o URL do serviço de nuvem OData do Microsoft Dynamics no AEM Forms. O serviço de nuvem padrão instalado com o pacote 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 Forms, instale o certificado do site do Microsoft Dynamics no repositório de certificados Java usando o comando keytool no computador que executa o AEM Forms.

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

A configuração MS Dynamics OData Cloud Service (OData Service) vem com a configuração padrão de OData. Para configurá-lo para se conectar ao seu serviço Microsoft Dynamics, faça o seguinte:

  1. Navegue até Ferramentas > Cloud Services > Fontes de dados e toque na pasta de configuração global.

  2. Selecione Cloud Service do MS Dynamics OData (Serviço OData) a configuração e toque em Propriedades. A caixa de diálogo de propriedade de configuração do serviço de nuvem é aberta.

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

    1. Digite o valor para o campo Raiz do Serviço. Vá para a instância do Dynamics e navegue até Developer Resources para visualização do valor do campo Service Root. Por exemplo, https://<nome-locatário>/api/data/v9.1/

    2. Substitua os valores padrão no ID do cliente(também conhecido como ID da aplicação), Segredo do cliente, URL OAuth, Atualizar URL do token, URL do Token de acesso<a 11/> e os campos Resource com valores da configuração do serviço Microsoft Dynamics. É obrigatório especificar o URL da instância dinâmica no campo 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. Especifique openid no campo Escopo da Autorização para o processo de autorização no Microsoft Dynamics.

    Configurações da autenticação

  3. Clique em Ligar a OAuth. Você é redirecionado para a página de logon do Microsoft Dynamics.

  4. Faça logon com suas credenciais do Microsoft Dynamics e aceite 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ê é redirecionado para a página de configuração do serviço de nuvem, que exibe uma mensagem informando que a configuração OData foi salva com êxito.

O serviço em nuvem do MS Dynamics OData Cloud Service (Serviço OData) está configurado e conectado ao serviço do Dynamics.

Criar modelo de dados de formulário

Quando você instala o pacote 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 do MS Dynamics OData (OData Service) como sua 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 obtém entidades da 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 de formulário, vá para Forms > Integrações de dados. Selecione 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 do seguinte URL:

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

default-fdm-1

Em seguida, é possível criar um formulário adaptável com base no modelo de dados do formulário e usá-lo em vários casos de uso do formulário adaptável, como:

  • Preencha o formulário adaptável consultando informações de entidades e serviços do Microsoft Dynamics
  • Chamar operações do Microsoft Dynamics Server definidas em um modelo de dados de formulário usando regras de formulário adaptáveis
  • Gravar dados de formulário enviados para entidades do Microsoft Dynamics

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

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

Nesta página