Show Menu
ARGOMENTI×

Configurazione di Microsoft Dynamics OData

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. L'integrazione dei dati di AEM Forms fornisce 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
Il pacchetto del componente aggiuntivo AEM Forms include anche la configurazione di riferimento OData che puoi sfruttare per integrare rapidamente Microsoft Dynamics con AEM Forms.
Quando il pacchetto è installato, nell’istanza di AEM Forms sono disponibili le entità e i servizi seguenti:
  • Servizio cloud MS Dynamics OData (servizio OData)
  • Modello dati modulo con entità e servizi Microsoft Dynamics preconfigurati.
Il servizio OData Cloud e il modello di dati del modulo con entità e servizi Microsoft Dynamics preconfigurati sono disponibili nell'istanza di AEM Forms solo se la modalità di esecuzione dell'istanza di AEM è impostata come samplecontent (impostazione predefinita). Per ulteriori informazioni sulla configurazione delle modalità di esecuzione per un’istanza di AEM, consultate 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:
Utilizzare questa procedura solo durante l'integrazione di 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 URL risposta per l'applicazione registrata:
    https://'[server]:[port]'/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
  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.
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. 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 informazioni dettagliate, consultate 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:
Utilizzare questa procedura solo durante l'integrazione di 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:
      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 keytool comando disponibile 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 > Servizi cloud > Origini dati e tocca la cartella di global configurazione.
  2. Selezionare la configurazione del servizio MS Dynamics OData Cloud Service (OData Service) e toccare Proprietà . Viene visualizzata la finestra di dialogo delle proprietà di configurazione del servizio cloud.
    Nella scheda Impostazioni autenticazione:
    1. Immettete il valore per il campo radice del 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. Sostituite i valori predefiniti nei campi ID ​client (altrimenti denominati ID ​applicazione), Segreto ​client, URL ​OAuth, URL token di aggiornamento, URL token di accesso, URLtoken di accesso, e SegretoRisorsacon i 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 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. Specificate open nel campo Ambito ​autorizzazione per il processo di autorizzazione in Microsoft Dynamics.
  3. Fate 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 Cloud Service (OData Service) è configurato e connesso con il servizio Dynamics.

Create form data model

Quando installate il pacchetto AEM Forms, nell’istanza di 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 servizio MS Dynamics OData Cloud Service (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
È 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
È consigliabile creare una copia del modello dati del modulo fornito con il pacchetto AEM Forms e 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 Integrazione dei dati AEM Forms dei dati.