Configuração OData de Microsoft Dynamics microsoft-dynamics-odata-configuration
O Microsoft Dynamics é um software de CRM (relacionamento com o cliente) e ERP (planejamento de recursos corporativos) que fornece soluções corporativas para criar e gerenciar contas, contatos, clientes potenciais, oportunidades e casos de clientes. Experience Manager Forms A Integração de Dados fornece uma configuração do serviço de nuvem OData para integrar o Forms ao servidor Microsoft Dynamics local e online. Ela permite criar o Modelo de Dados de Formulário (FDM) com base nas entidades, atributos e serviços definidos no serviço Microsoft Dynamics. O Modelo de Dados de Formulário (FDM) pode ser usado para criar o Forms Adaptável que interage com o servidor Microsoft Dynamics para habilitar fluxos de trabalho de negócios. Por exemplo:
- Consultar o servidor Microsoft Dynamics para obter dados e pré-popular o Adaptive Forms
- Gravar dados em Microsoft Dynamics no envio do Formulário Adaptável
- Gravar dados em Microsoft Dynamics por meio de entidades personalizadas definidas no Modelo de Dados de Formulário (FDM) e vice-versa
O Cloud Service OData (serviço OData) do MS Dynamics está disponível com todos os modos de execução. Para obter mais informações sobre como configurar os modos de execução para uma instância Experience Manager, consulte Modos de Execução.
O AEM as a Cloud Service oferece várias ações de envio prontas para uso para manipular envios de formulários. Você pode saber mais sobre essas opções no artigo Ação de envio do formulário adaptável.
Pré-requisitos prerequisites
Antes de começar a instalar e configurar o Microsoft Dynamics, verifique se você tem:
-
Microsoft Dynamics 365 online configurado ou instalado uma instância de uma das Microsoft Dynamics versões a seguir:
- Microsoft Dynamics 365 no local
- Microsoft Dynamics 2016 no local
-
Registrou o aplicativo para o Microsoft Dynamics serviço online Microsoft Azure Ative Diretory. Anote os valores da ID do cliente (também chamada de ID do aplicativo) e o segredo do cliente para o serviço registrado. Estes valores são usados ao configurar o serviço de nuvem para o seu Microsoft Dynamics serviço.
Definir URL de Resposta para o aplicativo Microsoft Dynamics registrado set-reply-url-for-registered-microsoft-dynamics-application
Faça o seguinte para definir a URL de resposta para o aplicativo Microsoft Dynamics registrado:
-
Vá para a conta do Ative Diretory Microsoft Azure e adicione a seguinte URL de configuração do serviço de nuvem nas configurações de URLs de resposta para o aplicativo registrado:
https://[server]:[port]/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
-
Salve a configuração.
Configurar Microsoft Dynamics para IFD configure-microsoft-dynamics-for-ifd
Microsoft Dynamics usa autenticação baseada em declarações para fornecer acesso aos dados no servidor do CRM Microsoft Dynamics para usuários externos. Para habilitar isso, faça o seguinte para configurar o Microsoft Dynamics para IFD e definir as configurações de declaração.
-
Configure a instância local Microsoft Dynamics para o IFD conforme descrito em Configurar o IFD para Microsoft Dynamics.
-
Execute os seguintes comandos usando o Windows PowerShell para definir as configurações de declaração no Microsoft Dynamics habilitado para IFD:
code language-shell Add-PSSnapin Microsoft.Crm.PowerShell $ClaimsSettings = Get-CrmSetting -SettingType OAuthClaimsSettings $ClaimsSettings.Enabled = $true Set-CrmSetting -Setting $ClaimsSettings
Consulte Registro de aplicativo para CRM local (IFD) para obter detalhes.
Configurar o cliente OAuth no computador do AD FS configure-oauth-client-on-ad-fs-machine
Faça o seguinte para registrar um cliente OAuth em um computador do Ative Diretory Federation Services (AD FS) e conceder acesso a esse computador:
-
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
é a URL para o serviço de nuvem OData Microsoft Dynamics em Experience Manager Forms. O serviço de nuvem padrão instalado com o Experience Manager Forms é implantado na seguinte URL:https://'[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
é a URL da organização Microsoft Dynamics.
-
Microsoft Dynamics usa o protocolo HTTPS. Para invocar pontos de extremidade do AD FS do servidor Forms, instale o certificado do site Microsoft Dynamics no armazenamento de certificados Java usando o comando
keytool
no computador que executa o Experience Manager Forms.
Configurar o serviço de nuvem para o serviço Microsoft Dynamics configure-cloud-service-for-your-microsoft-dynamics-service
Um serviço OData é identificado por sua URL raiz de serviço. Para configurar um serviço OData em Experience Manager as a Cloud Service, verifique se você tem uma URL raiz de serviço para o serviço e faça o seguinte:
-
Acesse Ferramentas > Cloud Service > Fontes de dados. Selecione para selecionar a pasta na qual deseja criar uma configuração de nuvem.
Consulte Configurar pasta para configurações do serviço de nuvem para obter informações sobre como criar e configurar uma pasta para configurações do serviço de nuvem.
-
Selecione Criar para abrir o Assistente de Criação de Configuração de Source de Dados. Especifique um nome e, opcionalmente, um título para a configuração, selecione Serviço OData na lista suspensa Tipo de Serviço, opcionalmente, procure e selecione uma imagem em miniatura para a configuração e selecione Próximo.
Na guia Configurações de autenticação:-
Insira o valor para o campo Raiz de Serviço. Vá para a instância do Dynamics e navegue até Recursos do Desenvolvedor para exibir o valor do campo Raiz do Serviço. Por exemplo, https://<tenant-name>/api/data/v9.1/
-
Selecione OAuth 2.0 como o tipo de autenticação.
-
Substitua os valores padrão nos campos ID do Cliente (também conhecido como ID do Aplicativo), Segredo do Cliente, URL do OAuth, URL do Token de Atualização, URL do Token de Acesso e URL por valores da configuração do serviço Microsoft Dynamics. É obrigatório especificar a URL da instância do Dynamics no campo Recurso para configurar Microsoft Dynamics com um modelo de dados de formulário (FDM). Use o URL raiz do serviço para derivar o URL da instância dinâmica. Por exemplo, https://org.crm.dynamics.com.
-
Especifique openid no campo Escopo de Autorização para o processo de autorização em Microsoft Dynamics.
Modelo de dados de formulário (FDM)
-
-
Clique em Conectar ao OAuth. Você é redirecionado à página de logon Microsoft Dynamics.
-
Faça logon com suas credenciais do Microsoft Dynamics e aceite para permitir que a configuração do serviço de nuvem se conecte ao serviço Microsoft Dynamics. É uma tarefa única estabelecer o Modelo de dados de formulário (FDM) entre o serviço em nuvem e o serviço.
Você é a página Modelo de dados de formulário Configuração do serviço de nuvem, que exibe uma mensagem de que a configuração OData foi salva com êxito.
O serviço de nuvem OData Cloud Service (OData Service) do MS Dynamics está configurado e conectado com seu serviço Dynamics. Modelo de dados de formulário (FDM)
Criar modelo de dados de formulário (FDM) create-form-data-model
Após configurar o serviço de nuvem MS Dynamics OData, você pode usá-lo ao criar o modelo de dados de formulário (FDM). Para obter mais informações, consulte Criar modelo de dados de formulário (FDM).
Em seguida, você pode criar um Modelo de dados de formulário (FDM) baseado no Formulário adaptável e usá-lo em vários casos de uso do Formulário adaptável, como:
- Preencha previamente o formulário adaptável consultando informações de Microsoft Dynamics entidades e serviços
- Invocar operações do servidor Microsoft Dynamics definidas em um Modelo de Dados de Formulário (FDM) usando regras de Formulário Adaptável
- Gravar dados de formulário enviados em Microsoft Dynamics entidades
Você pode configurar a Ação de Envio do Modelo de Dados de Formulário para um Formulário Adaptável para enviar dados para o Microsoft Dynamics OData.
Para obter mais informações sobre como criar e usar o Form Data Model (FDM) nos fluxos de trabalho de negócios, consulte Integração de Dados.
Artigos relacionados
- Enviar e-mail
- Enviar para o SharePoint
- Enviar usando modelo de dados do formulário
- Enviar para o Armazenamento de blob do Azure
- Enviar para endpoint REST
- Enviar para o OneDrive
- Chamar um fluxo de trabalho de AEM
- Enviar para o Power Automate
- Enviar para o Workfront Fusion
- Conectar o formulário adaptável ao aplicativo do Salesforce
- Conectar um formulário adaptável ao Microsoft
- Conectar um formulário adaptável ao Adobe Marketo Engage
- Criar ação de envio personalizada