Aproveite, integre e trabalhe com os serviços do Microsoft Dynamics online e local por meio de um modelo de dados de formulário.
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:
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:
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 AEM estiver definido como samplecontent
(padrão). Para obter mais informações sobre como configurar modos de execução para uma instância 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 de complementos Forms
Configurado o Microsoft Dynamics 365 on-line ou instalado uma instância de uma das seguintes versões do Microsoft Dynamics:
Registrado o aplicativo do serviço online Microsoft Dynamics com o Microsoft Azure Ative Diretory. Anote os valores para a ID do cliente (também chamada de ID da aplicação) e o segredo do cliente para o serviço registrado. Esses valores são usados ao configurar o serviço em nuvem para o serviço do Microsoft Dynamics.
Faça o seguinte para definir o URL de resposta para o aplicativo registrado do Microsoft Dynamics:
Use este procedimento somente ao integrar o AEM Forms ao servidor Microsoft Dynamics online.
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
Salve a configuração.
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.
Use este procedimento somente ao integrar o AEM Forms ao 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 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.
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 este procedimento somente ao integrar o AEM Forms ao 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 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:
http://[server]:[port]/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
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.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.
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:
Navegue até Ferramentas > Cloud Services > Fontes de dados e toque na pasta de configuração global
.
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:
Clique em Ligar a OAuth. Você é redirecionado para a página de logon do Microsoft Dynamics.
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.
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
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:
É 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.