Configurazione di Microsoft Dynamics OData microsoft-dynamics-odata-configuration

Versione
Collegamento articolo
AEM as a Cloud Service
Fai clic qui
AEM 6.5
Questo articolo

integrazione dei dati

Microsoft Dynamics è un software CRM (Customer Relationship Management) e ERP (Enterprise Resource Planning) che fornisce soluzioni aziendali per la creazione e la gestione di account cliente, contatti, lead, opportunità e casi. Integrazione dei dati di AEM Forms fornisce una configurazione del servizio cloud OData per integrare Forms con il server Microsoft Dynamics online e on-premise. Consente di creare un modello di dati modulo basato su entità, attributi e servizi definiti nel servizio Microsoft Dynamics. Il modello per dati modulo può essere utilizzato per creare moduli adattivi che interagiscono con il server Microsoft Dynamics per abilitare i flussi di lavoro aziendali. Ad esempio:

  • Eseguire query sul server Microsoft Dynamics per dati e precompilare moduli adattivi
  • Scrivere dati in Microsoft Dynamics all’invio di moduli adattivi
  • Scrivere dati in Microsoft Dynamics tramite entità personalizzate definite nel modello di dati del modulo e viceversa

Il pacchetto del componente aggiuntivo AEM Forms include anche la configurazione OData di riferimento che è possibile utilizzare per integrare rapidamente Microsoft Dynamics con AEM Forms.

Quando il pacchetto viene installato, nell’istanza AEM Forms sono disponibili le seguenti entità e servizi:

  • CLOUD SERVICE OData MS Dynamics (servizio OData)
  • Modello dati modulo con entità e servizi Microsoft Dynamics preconfigurati.

Le entità e i servizi Microsoft Dynamics preconfigurati in un modello dati modulo sono disponibili nell’istanza AEM Forms solo se la modalità di esecuzione per l’istanza AEM è impostata su samplecontent (impostazione predefinita). Il Cloud Service OData di MS Dynamics (servizio OData) è disponibile anche con altre modalità di esecuzione. Per ulteriori informazioni sulla configurazione delle modalità di esecuzione per un’istanza AEM, consulta Modalità di esecuzione.

Prerequisiti prerequisites

Prima di iniziare a configurare Microsoft Dynamics, assicurati di disporre dei seguenti elementi:

Imposta URL di risposta per l'applicazione Microsoft Dynamics registrata set-reply-url-for-registered-microsoft-dynamics-application

Per impostare l'URL di risposta per l'applicazione Microsoft Dynamics registrata, eseguire le operazioni seguenti:

NOTE
Utilizzare questa procedura solo durante l'integrazione di AEM Forms con il server Microsoft Dynamics online.
  1. Passare all'account Microsoft Azure Active Directory e aggiungere l'URL di configurazione del servizio cloud seguente in URL di risposta impostazioni per l'applicazione registrata:

    https://'[server]:[port]'/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html

    Directory di Azure

  2. Salva la configurazione.

Configurare Microsoft Dynamics per IFD configure-microsoft-dynamics-for-ifd

Microsoft Dynamics utilizza l'autenticazione basata su attestazioni per fornire l'accesso ai dati nel server Microsoft Dynamics CRM agli utenti esterni. Per abilitare questa funzionalità, eseguire le operazioni seguenti per configurare Microsoft Dynamics per la distribuzione con connessione Internet (IFD) e le impostazioni delle attestazioni.

NOTE
Utilizzare questa procedura solo durante l'integrazione di AEM Forms con il server Microsoft Dynamics locale.
  1. Configurare l’istanza on-premise di Microsoft Dynamics per IFD come descritto in Configurare IFD per Microsoft Dynamics.

  2. Eseguire i comandi seguenti utilizzando Windows PowerShell per configurare le impostazioni delle attestazioni in Microsoft Dynamics abilitato per IFD:

    code language-shell
    Add-PSSnapin Microsoft.Crm.PowerShell
     $ClaimsSettings = Get-CrmSetting -SettingType OAuthClaimsSettings
     $ClaimsSettings.Enabled = $true
     Set-CrmSetting -Setting $ClaimsSettings
    

    Consulta Registrazione app per CRM on-premise (IFD) per i dettagli.

Configurare il client OAuth nel computer AD FS configure-oauth-client-on-ad-fs-machine

Per registrare un client OAuth nel computer Active Directory Federation Services (ADFS) e concedere l'accesso al computer ADFS, eseguire le operazioni seguenti:

NOTE
Utilizzare questa procedura solo durante l'integrazione di AEM Forms con il server Microsoft Dynamics locale.
  1. Esegui il comando seguente:

    Add-AdfsClient -ClientId "<Client-ID>" -Name "<name>" -RedirectUri "<redirect-uri>" -GenerateClientSecret

    Dove:

    • Client-ID è un ID client che può essere generato utilizzando qualsiasi generatore GUID.

    • redirect-uri è l’URL del servizio cloud Microsoft Dynamics OData su AEM Forms. Il servizio cloud predefinito installato con il pacchetto AEM Forms viene distribuito al seguente URL:

      https://'[server]:[port]'/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html

  2. Eseguire il comando seguente per concedere l'accesso al computer AD FS:

    Grant-AdfsApplicationPermission -ClientRoleIdentifier "<Client-ID>" -ServerRoleIdentifier <resource> -ScopeNames openid

    Dove:

    • resource è l’URL dell’organizzazione Microsoft Dynamics.
  3. Microsoft Dynamics utilizza il protocollo HTTPS. Per richiamare gli endpoint AD FS dal server Forms, installare il certificato del sito Microsoft Dynamics nell'archivio certificati Java utilizzando keytool sul computer che esegue AEM Forms.

Configurare il servizio cloud per il servizio Microsoft Dynamics configure-cloud-service-for-your-microsoft-dynamics-service

Il CLOUD SERVICE OData MS Dynamics (servizio OData) viene fornita con la configurazione OData predefinita. Per configurarlo per la connessione al servizio Microsoft Dynamics, eseguire le operazioni seguenti.

  1. Accedi a Strumenti > Cloud Service > Origini dati, e seleziona la global cartella di configurazione.

  2. Seleziona CLOUD SERVICE OData MS Dynamics (servizio OData) configurazione e selezione Proprietà. Viene visualizzata la finestra di dialogo della proprietà di configurazione del servizio cloud.

    In Impostazioni di autenticazione scheda:

    1. Immetti il valore per Directory principale servizio campo. Vai all’istanza Dynamics e passa a Risorse per sviluppatori per visualizzare il valore del campo Service Root. Ad esempio, https://<tenant-name>/api/data/v9.1/

    2. Sostituisci i valori predefiniti in ID client(denominati anche ID applicazione), Segreto client, URL OAuth, Aggiorna URL token, URL token di accesso, e Risorsa campi con i valori della configurazione del servizio Microsoft Dynamics. È obbligatorio specificare l’URL dell’istanza di Dynamics nel Risorsa per configurare Microsoft Dynamics con un modello dati modulo. Utilizza l’URL principale del servizio per derivare l’URL dell’istanza di Dynamics. Ad esempio: https://org.crm.dynamics.com.

    3. Specifica openid nel Ambito autorizzazione campo per il processo di autorizzazione in Microsoft Dynamics.

    Impostazioni di autenticazione

  3. Clic Connetti a OAuth. Viene visualizzata la pagina di accesso di Microsoft Dynamics.

  4. Accedi con le credenziali di Microsoft Dynamics e accetta per consentire alla configurazione del servizio cloud di connettersi al servizio Microsoft Dynamics. Stabilire la connessione tra il servizio cloud e il servizio è un’attività una tantum.

    Viene quindi reindirizzato alla pagina di configurazione del servizio cloud, in cui viene visualizzato un messaggio che informa che la configurazione OData è stata salvata correttamente.

Il servizio cloud Cloud Service OData (OData Service) di MS Dynamics è configurato e connesso al servizio Dynamics.

Crea modello dati modulo create-form-data-model

Quando installi il pacchetto AEM Forms, un modello di dati del modulo,Microsoft Dynamics FDM, è implementato nell’istanza AEM. Per impostazione predefinita, il modello dati del modulo utilizza il servizio Microsoft Dynamics configurato nel Cloud Service OData di MS Dynamics (servizio OData) come origine dati.

Quando apre il modello dati del modulo per la prima volta, si connette al servizio Microsoft Dynamics configurato e recupera le entità dall’istanza di Microsoft Dynamics. Le entità "contatto" e "lead" da Microsoft Dynamics sono già aggiunte nel modello dati del modulo.

Per rivedere il modello dati del modulo, vai a Forms > Integrazioni dati. Seleziona Microsoft Dynamics FDM e fai clic su Modifica per aprire il modello dati del modulo in modalità di modifica. In alternativa, è possibile aprire il modello dati del modulo direttamente dal seguente URL:

https://'[server]:[port]'/aem/fdm/editor.html/content/dam/formsanddocuments-fdm/ms-dynamics-fdm

default-fdm-1

Successivamente, puoi creare un modulo adattivo basato sul modello di dati del modulo e utilizzarlo in vari casi di utilizzo di moduli adattivi, ad esempio:

  • Precompilare un modulo adattivo eseguendo una query sulle informazioni provenienti da entità e servizi di Microsoft Dynamics
  • Richiama le operazioni del server Microsoft Dynamics definite in un modello di dati del modulo utilizzando le regole del modulo adattivo
  • Scrivere i dati del modulo inviati alle entità Microsoft Dynamics

Si consiglia di creare una copia del modello dati del modulo fornito con il pacchetto AEM Forms e configurare modelli dati e servizi in base alle tue esigenze. In questo modo, tutti gli aggiornamenti futuri al pacchetto non sostituiranno il modello dati del modulo.

Per ulteriori informazioni sulla creazione e l’utilizzo del modello dati modulo nei flussi di lavoro aziendali, consulta Integrazione dei dati.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2