DocumentazioneAEM 6.5Guida utente

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

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Amministratore
  • Utente
  • Sviluppatore
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. AEM Forms Data Integration 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, vedere 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 il seguente URL di configurazione del servizio cloud nelle impostazioni URL di risposta 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 locale 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

    Per informazioni dettagliate, consulta Registrazione app per CRM locale (IFD).

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 di 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 il comando keytool nel computer che esegue AEM Forms.

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

La configurazione del Cloud Service OData MS Dynamics (servizio OData) include la configurazione OData predefinita. Per configurarlo per la connessione al servizio Microsoft Dynamics, eseguire le operazioni seguenti.

  1. Passare a Strumenti > Cloud Service > Origini dati e selezionare la cartella di configurazione global.

  2. Selezionare la configurazione Cloud Service OData (servizio OData) di MS Dynamics e selezionare Proprietà. Viene visualizzata la finestra di dialogo della proprietà di configurazione del servizio cloud.

    Nella scheda Impostazioni autenticazione:

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

    2. Sostituisci i valori predefiniti nei campi ID client(indicato anche come ID applicazione), Segreto client, URL OAuth, URL token di aggiornamento, URL token di accesso e Risorsa con i valori della configurazione del servizio Microsoft Dynamics. È obbligatorio specificare l'URL dell'istanza di dinamica nel campo 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. Specificare openid nel campo Ambito autorizzazione per il processo di autorizzazione in Microsoft Dynamics.

    Impostazioni autenticazione

  3. Fai clic su 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, nell'istanza AEM viene distribuito un modello di dati modulo,Microsoft Dynamics FDM. 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, vedere Integrazione dati.

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