DocumentazioneAEM 6.4Guida di Forms

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

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • User
CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

Utilizza, integra e lavora con i servizi Microsoft Dynamics online e on-premise tramite il modello dati del modulo.

integrazione dei dati

Microsoft Dynamics è un software di gestione delle relazioni con i clienti (CRM) e Enterprise Resource Planning (ERP) 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 dati modulo basato su entità, attributi e servizi definiti nel servizio Microsoft Dynamics. Il modello dati del modulo può essere utilizzato per creare moduli adattivi che interagiscono con il server Microsoft Dynamics per abilitare i flussi di lavoro aziendali. Ad esempio:

  • Query del server Microsoft Dynamics per dati e precompilazione dei moduli adattivi
  • Inserire dati in Microsoft Dynamics per l’invio di moduli adattivi
  • Scrivere dati in Microsoft Dynamics tramite entità personalizzate definite nel modello dati del modulo e viceversa

Il pacchetto aggiuntivo di AEM Forms include anche la configurazione di riferimento di OData che puoi sfruttare per integrare rapidamente Microsoft Dynamics con AEM Forms.

Quando il pacchetto è installato, le seguenti entità e servizi sono disponibili nella tua istanza AEM Forms:

  • Cloud Service MS Dynamics OData (servizio OData)
  • Modello dati per moduli con entità e servizi Microsoft Dynamics preconfigurati.

Il Cloud Service OData e il modello di dati modulo con entità e servizi Microsoft Dynamics preconfigurati sono disponibili nell’istanza AEM Forms solo se la modalità di esecuzione per l’istanza AEM è impostata come samplecontent(predefinito). Per ulteriori informazioni sulla configurazione delle modalità di esecuzione per un'istanza AEM, vedi Modalità di esecuzione.

Prerequisiti prerequisites

Prima di iniziare a configurare e configurare Microsoft Dynamics, assicurati di disporre di:

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, procedi come segue:

NOTE
Utilizzare questa procedura solo durante l’integrazione di AEM Forms con il server online Microsoft Dynamics.

  1. Vai all’account Microsoft Azure Active Directory e aggiungi 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

    azure_directory

  2. Salva la configurazione.

Configurazione di Microsoft Dynamics per IFD configure-microsoft-dynamics-for-ifd

Microsoft Dynamics utilizza l’autenticazione basata sulle attestazioni per fornire l’accesso ai dati sul server Microsoft Dynamics CRM a utenti esterni. Per abilitare questa opzione, procedi come segue per configurare Microsoft Dynamics per la distribuzione su Internet (IFD) e configurare le impostazioni di attestazione.

NOTE
Utilizzare questa procedura solo durante l’integrazione di AEM Forms con il server Microsoft Dynamics locale.

  1. Configura l’istanza on-premise di Microsoft Dynamics per IFD come descritto in Configurare IFD per Microsoft Dynamics.

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

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

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

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

Per registrare un client OAuth nel computer Active Directory Federation Services (AD FS) e concedere l'accesso al computer AD FS, procedere come segue:

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 è possibile generare 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:

      code language-none 
      http://[server]:[port]/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html

  2. Esegui il seguente comando 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 endpoint AD FS dal server Forms, installa 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

La Cloud Service MS Dynamics OData (servizio OData) la configurazione viene fornita con la configurazione OData predefinita. Per configurarlo per la connessione al servizio Microsoft Dynamics, procedi come segue.

  1. Passa a Strumenti > Cloud Services > Origini dati e tocca global cartella di configurazione.

  2. Seleziona Cloud Service MS Dynamics OData (servizio OData) configurazione e tocca Proprietà. Viene visualizzata la finestra di dialogo delle proprietà di configurazione del servizio cloud.

    In Impostazioni di autenticazione scheda:

    1. Immetti il valore per la Directory principale servizio campo . Vai all’istanza di Dynamics e passa a Riferimenti per sviluppatori per visualizzare il valore del campo Directory principale del servizio. Ad esempio, https://<tenant-name>/api/data/v9.1/
    2. Sostituisci i valori predefiniti nella ID client (di cui anche ID applicazione), Segreto client, URL OAuth, Aggiorna URL token, URL token di accesso e Risorsa campi con valori della configurazione del servizio Microsoft Dynamics. È obbligatorio specificare l’URL dell’istanza di dinamica nel Risorsa per configurare Microsoft Dynamics con un modello dati modulo. Utilizza l’URL principale del servizio per derivare l’URL dell’istanza dinamica. Ad esempio: https://org.crm.dynamics.com.
    3. Specifica openid in Ambito di autorizzazione campo per il processo di autorizzazione in Microsoft Dynamics.

    dynamics_authentication_settings

  3. Fai clic su Connettiti a OAuth. Verrai reindirizzato alla pagina di accesso di Microsoft Dynamics.

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

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

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

Crea modello dati modulo create-form-data-model

Quando si installa il pacchetto AEM Forms, un modello dati del modulo,Microsoft Dynamics FDM, viene distribuito sull’istanza AEM. Per impostazione predefinita, il modello dati del modulo utilizza il servizio Microsoft Dynamics configurato nel Cloud Service OData di MS Dynamics (OData Service) come origine dati.

All’apertura del 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" di Microsoft Dynamics sono già state aggiunte nel modello dati del modulo.

Per rivedere il modello dati del modulo, passare 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 modulo direttamente dal seguente URL:

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

default-fdm-1

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

  • Precompilare il modulo adattivo eseguendo query sulle informazioni provenienti da entità e servizi di Microsoft Dynamics
  • Richiamare le operazioni del server Microsoft Dynamics definite in un modello di dati modulo utilizzando regole del modulo adattive
  • Scrittura dei 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 di configurare modelli e servizi dati in base alle proprie esigenze. In questo modo gli eventuali aggiornamenti futuri del pacchetto non sovrascriveranno 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
a6ebf046-2b8b-4543-bd46-42a0d77792da