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.
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:
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:
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.
Antes de começar a configurar e configurar o Microsoft Dynamics, verifique se você:
Instalado o AEM 6.4 Pacote do complemento Forms
Configurado o Microsoft Dynamics 365 online ou instalado uma instância de uma das seguintes versões do Microsoft Dynamics:
Registrado o aplicativo para o serviço online Microsoft Dynamics com o Microsoft Azure Ative Diretory. Anote os valores para a ID do cliente (também chamada de ID do aplicativo) e o segredo do cliente para o serviço registrado. Esses valores são usados enquanto configuração do serviço em nuvem para o serviço Microsoft Dynamics.
Faça o seguinte para definir o URL de resposta para o aplicativo Microsoft Dynamics registrado:
Use este procedimento somente ao integrar o AEM Forms com o servidor Microsoft Dynamics online.
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
Salve a configuração.
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.
Use esse procedimento apenas durante a integração do AEM Forms com o servidor Microsoft Dynamics local.
Configure a instância local do Microsoft Dynamics para IFD, conforme descrito em Configurar o IFD para o Microsoft Dynamics.
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.
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:
Use esse procedimento apenas durante a integração do AEM Forms com o servidor Microsoft Dynamics local.
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:
http://[server]:[port]/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
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.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.
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:
Navegar para Ferramentas > Cloud Services > Fontes de dados e toque no global
pasta de configuração.
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 :
Clique em Conectar-se ao OAuth. Você é redirecionado para a página de logon do Microsoft Dynamics.
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.
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
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:
É 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.