Configurazione Microsoft Dynamics OData

Sfruttare, integrare e utilizzare i servizi Microsoft Dynamics online e in sede tramite il modello dati del modulo.

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 Integrationfornisce una configurazione del servizio cloud OData per integrare Forms con il server Microsoft Dynamics online e locale. 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. Esempio:

  • Query del server Microsoft Dynamics per dati e precompilazione di moduli adattivi
  • Inserimento di dati in Microsoft Dynamics per l'invio di moduli adattivi
  • Scrittura di dati in Microsoft Dynamics tramite entità personalizzate definite nel modello dati del modulo e viceversa

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

Quando il pacchetto è installato, le entità e i servizi seguenti sono disponibili nell'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 di dati del 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 su 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 Microsoft Dynamics, accertati di disporre di:

Imposta URL risposta per l'applicazione Microsoft Dynamics registrata

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

NOTA

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

  1. Accedete all'account Microsoft Azure Active Directory e aggiungete il seguente URL di configurazione del servizio cloud nelle impostazioni Rispondi URL per l'applicazione registrata:

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

    azure_directory

  2. Salva la configurazione.

Configurare Microsoft Dynamics per IFD

Microsoft Dynamics utilizza l'autenticazione basata sulle attestazioni per fornire l'accesso ai dati del server Microsoft Dynamics CRM agli utenti esterni. Per abilitare questa opzione, effettuate le seguenti operazioni per configurare Microsoft Dynamics per la distribuzione Internet (IFD) e configurare le impostazioni delle attestazioni.

NOTA

Utilizzare questa procedura solo durante l'integrazione 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. Eseguite i comandi seguenti 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, vedere Registrazione app per CRM locale (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, effettuare le seguenti operazioni:

NOTA

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

  1. Eseguite 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. 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 in cui è in esecuzione AEM Forms.

Configurare il servizio cloud per il servizio Microsoft Dynamics

La configurazione MS Dynamics OData Cloud Service (OData Service) viene fornita con la configurazione OData predefinita. Per configurarlo per la connessione al servizio Microsoft Dynamics, effettuare le seguenti operazioni.

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

  2. Selezionare MS Dynamics OData Cloud Service (OData Service) e toccare Properties. Viene visualizzata la finestra di dialogo delle proprietà di configurazione del servizio cloud.

    Nella scheda Impostazioni autenticazione:

    1. Immettere il valore per il campo Radice servizio. Andate all'istanza Dynamics e andate a Risorse per sviluppatori per visualizzare il valore del campo radice del servizio. Ad esempio, https://<nome-tenant>/api/data/v9.1/
    2. Sostituisci i valori predefiniti in ID client (altrimenti denominato ID applicazione), Segreto cliente, URL OAuth, Aggiorna URL token, URL token di accesso e i campi Resource con i valori della configurazione del servizio Microsoft Dynamics. È obbligatorio specificare l'URL dell'istanza dinamica nel campo Resource per configurare Microsoft Dynamics con un modello dati del modulo. Utilizzate l'URL di directory principale del servizio per derivare l'URL dell'istanza di dinamica. Ad esempio, https://org.crm.dynamics.com.
    3. Specificare openid nel campo Ambito di autorizzazione per il processo di autorizzazione in Microsoft Dynamics.

    dDynamics_authentication_settings

  3. Fare clic su Connetti a OAuth. Viene nuovamente visualizzata la pagina di accesso di Microsoft Dynamics.

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

    Viene quindi eseguito il reindirizzamento 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 MS Dynamics OData (servizio OData) è configurato e connesso con il servizio Dynamics.

Crea modello dati modulo

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

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

Per esaminare il modello dati del modulo, passare a Forms > Integrazioni dati. Selezionare Microsoft Dynamics FDM e fare 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

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

  • Precompila il modulo adattivo eseguendo query sulle informazioni di entità e servizi di Microsoft Dynamics
  • Richiamo delle operazioni del server Microsoft Dynamics definite in un modello dati modulo utilizzando le 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 al pacchetto non avranno la precedenza sul modello dati del modulo.

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

In questa pagina