Configurazione di Microsoft Dynamics OData

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

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

Il Cloud Service OData e il modello 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(impostazione predefinita). Per ulteriori informazioni sulla configurazione delle modalità di esecuzione per un'istanza AEM, vedere Modalità di esecuzione.

Prerequisiti

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

• Installato il pacchetto aggiuntivo Forms 6.4

• Microsoft Dynamics 365 configurato online o installato un’istanza di una delle seguenti versioni di Microsoft Dynamics:

  • Microsoft Dynamics 365 on-premise
  • Microsoft Dynamics 2016 on-premise

• È stata registrata l’applicazione per il servizio online Microsoft Dynamics con Microsoft Azure Active Directory. Prendi nota dei valori dell’ID client (noto anche come ID applicazione) e del segreto client per il servizio registrato. Questi valori vengono utilizzati durante la configurazione del servizio cloud per il servizio Microsoft Dynamics.

Imposta URL di risposta per l’applicazione registrata di Microsoft Dynamics

Per impostare l’URL di risposta per l’applicazione registrata di Microsoft Dynamics, procedi come segue:

1. Vai all'account Microsoft Azure Active Directory e aggiungi l'URL di configurazione del servizio cloud seguente nelle impostazioni URL di risposta per l'applicazione registrata:

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

   

2. Salva la configurazione.

Configurazione di Microsoft Dynamics per IFD

Microsoft Dynamics utilizza l’autenticazione basata su attestazioni per fornire l’accesso ai dati del 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.

1. Configura l’istanza locale di Microsoft Dynamics per IFD come descritto in Configura IFD per Microsoft Dynamics.

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

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

   Per ulteriori informazioni, consulta Registrazione app per CRM on-premise (IFD) .

Configurare il client OAuth sul computer AD FS

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

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:

     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, 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

La configurazione Cloud Service OData di MS Dynamics (OData Service) 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 la cartella di configurazione global.

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

   Nella scheda Impostazioni autenticazione :

   1. Immetti il valore per il campo Directory principale del servizio . Vai all’istanza di Dynamics e vai a Risorse 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 in ID client (noto anche come ID applicazione), Segreto client, URL OAuth, Aggiorna URL token, URL di accesso e i campi Resource con valori della configurazione del servizio Microsoft Dynamics. È obbligatorio specificare l’URL dell’istanza 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 dinamica. Ad esempio, https://org.crm.dynamics.com.
   3. Specifica openid nel campo Ambito autorizzazione per il processo di autorizzazione in Microsoft Dynamics.

   

3. Fai clic su Connetti a OAuth. Viene eseguito il reindirizzamento alla pagina di accesso di Microsoft Dynamics.

4. Accedi con le tue credenziali di Microsoft Dynamics e accetta per consentire la connessione della configurazione del servizio cloud 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

Quando si installa il pacchetto AEM Forms, un modello dati 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

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 adattivo
• 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 di dati modulo nei flussi di lavoro aziendali, vedere Integrazione dei dati.