DocumentaçãoAEM 6.4Guia do Forms

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

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • User
CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Aproveite, integre e trabalhe com serviços Microsoft Dynamics online e local por meio de um modelo de dados de formulário.

integração de dados

O Microsoft Dynamics é um software de CRM (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. Integração de dados do AEM Forms O fornece uma configuração de serviço de nuvem OData para integrar o 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 servidor do Microsoft Dynamics para ativar 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.

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

Pré-requisitos prerequisites

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

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

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

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

  1. Vá para a conta do Microsoft Azure Ative Diretory e adicione o 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

    azure_diretory

  2. Salve a configuração.

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

O Microsoft Dynamics usa a 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 com acesso à Internet (IFD) e definir as configurações de solicitação.

NOTE
Use esse procedimento apenas durante a integração do AEM Forms com o 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 definir as configurações de afirmação no Microsoft Dynamics habilitado para IFD:

    code language-none 
    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 no computador AD FS configure-oauth-client-on-ad-fs-machine

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:

NOTE
Use esse procedimento apenas durante a integração do 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:

      code language-none 
      http://[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 Forms, instale o certificado do site Microsoft Dynamics para o 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 configure-cloud-service-for-your-microsoft-dynamics-service

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

  1. Navegar para Ferramentas > Cloud Services > Fontes de dados e toque no global pasta de configuração.

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

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

    1. Insira o valor da variável Raiz do serviço campo. Vá para a instância do Dynamics e navegue até Recursos do desenvolvedor para exibir o valor do campo Service Root . Por exemplo, https://<tenant-name>/api/data/v9.1/
    2. Substitua os valores padrão no ID do cliente (também designado por ID do aplicativo), Segredo do cliente, URL de OAuth, Atualizar URL do token, 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 no 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 o processo de autorização no Microsoft Dynamics.

    dynamics_authentication_settings

  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 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 create-form-data-model

Ao instalar o pacote AEM Forms, um modelo de dados de formulário,Microsoft Dynamics FDM, é 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 (Serviço OData) como fonte de dados.

Ao abrir o modelo de dados de formulário pela primeira vez, ele se conecta ao serviço Microsoft Dynamics configurado 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, acesse Forms > Integrações de dados. Selecionar 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 fluxos de trabalho, consulte Integração de dados.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da