Configuração do Microsoft Dynamics OData

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 empresariais) que fornece soluções corporativas para criar e gerenciar contas, contatos, clientes potenciais, oportunidades e casos de clientes. A integração de dados do AEM Forms fornece uma configuração de serviço de nuvem OData para integrar o Forms ao servidor do 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 servidor do Microsoft Dynamics para habilitar fluxos de trabalho de negócios. Por exemplo:

  • Consultar o servidor do Microsoft Dynamics para dados e pré-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 de referência de 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:

  • MS Dynamics OData Cloud Service (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 em sua instância do AEM Forms se o modo de execução da instância de 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 de AEM, consulte Executar modos.

Pré-requisitos

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

Definir URL de resposta para 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 apenas durante a integração do AEM Forms com o servidor online do Microsoft Dynamics.

  1. Vá para a conta do Microsoft Azure Ative Diretory e adicione o seguinte URL de configuração do serviço de nuvem nas configurações de URLs de resposta 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 afirmaçõ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 com acesso à Internet (IFD) e definir as configurações de solicitação.

OBSERVAÇÃO

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

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

  2. Execute os seguintes comandos usando o Windows PowerShell para definir as configuraçõ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 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 esse procedimento somente ao integrar o AEM 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 é o URL para o serviço de nuvem do Microsoft Dynamics OData no AEM Forms. O serviço em 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 na máquina 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 do site do Microsoft Dynamics no armazenamento 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 serviço do 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 a configuração MS Dynamics OData Cloud Service (Serviço OData) e toque em Propriedades. A caixa de diálogo da propriedade de configuração do serviço em nuvem é aberta.

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

    1. Insira o valor do campo Service Root. Vá para a instância Dynamics e navegue até Developer Resources para exibir o valor do campo Service Root. Por exemplo, https://<tenant-name>/api/data/v9.1/

    2. Substitua os valores padrão no Client Id (também conhecido como Application ID), Client Secret, OAuth URL, Atualizar URL do Token, Access Token URL<a Campos 11/> e Resource com valores da configuração do serviço Microsoft Dynamics. É obrigatório especificar o URL da instância dinâmica no campo Resource 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 Conectar-se a OAuth. Você é redirecionado para a página de logon do Microsoft Dynamics.

  4. Faça logon com as 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 estabelecer 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 de que a configuração de OData foi salva com êxito.

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

Criar modelo de dados de formulário

Ao instalar o pacote AEM Forms, um modelo de dados de formulário,Microsoft Dynamics FDM, é implantado em sua instância de AEM. Por padrão, o modelo de dados de formulário usa o serviço Microsoft Dynamics configurado no MS Dynamics OData Cloud Service (OData Service) como 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 instância do Microsoft Dynamics. As entidades "contato" e "lead" do Microsoft Dynamics já são 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 Microsoft Dynamics FDM 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 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 das entidades e serviços do Microsoft Dynamics
  • Chamar operações do 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 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 modelos e serviços de dados para atender aos seus requisitos. Ele garantirá que qualquer atualização futura no 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 workflows de negócios, consulte Data Integration.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now