Sfruttare, integrare e utilizzare i servizi Microsoft Dynamics online e in sede tramite il modello dati del modulo.
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:
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 :
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.
Prima di iniziare a configurare Microsoft Dynamics, accertati di disporre di:
Installato il AEM 6.4 Forms add-on package
Microsoft Dynamics 365 configurato online o installato un'istanza di una delle seguenti versioni di Microsoft Dynamics:
È stata registrata l'applicazione per il servizio online Microsoft Dynamics con Microsoft Azure Active Directory. Prendete nota dei valori per l'ID client (altrimenti denominato ID applicazione) e il segreto client per il servizio registrato. Questi valori vengono utilizzati durante la configurazione del servizio cloud per il servizio Microsoft Dynamics.
Per impostare l'URL di risposta per l'applicazione Microsoft Dynamics registrata, effettuate le seguenti operazioni:
Utilizzare questa procedura solo durante l'integrazione AEM Forms con il server Microsoft Dynamics online.
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
Salva la configurazione.
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 AEM Forms con il server Microsoft Dynamics locale.
Configurare l'istanza locale di Microsoft Dynamics per IFD come descritto in Configurare IFD per Microsoft Dynamics.
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).
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 AEM Forms con il server Microsoft Dynamics locale.
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
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.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.
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.
Passa a Strumenti > Cloud Services > Origini dati e tocca la cartella di configurazione global
.
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:
Fare clic su Connetti a OAuth. Viene nuovamente visualizzata la pagina di accesso di Microsoft Dynamics.
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.
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
È quindi possibile creare un modulo adattivo basato sul modello dati del modulo e utilizzarlo in vari casi di utilizzo di moduli adattivi, ad esempio:
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.