Microsoft Dynamics OData-Konfiguration

Microsoft Dynamics ist eine CRM (Customer Relationship Management)- und ERP (Enterprise Resource Planning)-Software, die Unternehmenslösungen für das Erstellen und Verwalten von Kundenkonten, Kontakten, Leads, Chancen und Fällen bereitstellt. Experience Manager Forms Datenintegration bietet eine OData-Cloud Service-Konfiguration für die Integration von Forms mit online und lokal installierten Microsoft Dynamics-Servern. Dies ermöglicht Ihnen das Erstellen von Formulardatenmodellen basierend auf den im Microsoft Dynamics-Service definierten Entitäten, Attributen und Services. Das Formulardatenmodell kann verwendet werden, um adaptive Formulare zu erstellen, die mit Microsoft Dynamics-Server interagieren, um Unternehmens-Workflows zu ermöglichen. Zum Beispiel:

• Abfragen eines Microsoft Dynamics-Servers nach Daten und Auffüllen adaptiver Formulare
• Schreiben von Daten in Microsoft Dynamics bei Übermittlung von adaptiven Formularen
• Daten schreiben in Microsoft Dynamics durch benutzerdefinierte Entitäten, die im Formulardatenmodell definiert sind, und umgekehrt

​ MS Dynamics OData Cloud Service (OData Service) ist für alle Ausführungsmodi verfügbar. Weitere Informationen zum Konfigurieren von Ausführungsmodi für eine Experience Manager -Instanz, siehe Ausführungsmodi.

Voraussetzungen

Bevor Sie mit dem Einrichten und Konfigurieren von Microsoft Dynamics beginnen, stellen Sie sicher, dass die folgenden Punkte erfüllt sind:

• Sie haben Microsoft Dynamics 365 online konfiguriert oder eine Instanz einer der folgenden Microsoft Dynamics-Versionen installiert:

  • Microsoft Dynamics 365 On-Premises
  • Microsoft Dynamics 2016 On-Premises

• Das Programm wurde für den Microsoft Dynamics -Online-Service mit Microsoft Azure Active Directory registriert. Notieren Sie sich die Werte für die Client-ID (die auch als Anwendungs-ID bezeichnet wird) und den geheimen Clientschlüssel für den registrierten Service. Diese Werte werden beim Konfigurieren des Cloud Service für Ihren Microsoft Dynamics -Service verwendet.

Festlegen einer Antwort-URL für ein registriertes Microsoft Dynamics-Programm

Gehen Sie folgendermaßen vor, um die Antwort-URL für eine registrierte Microsoft Dynamics-Anwendung festzulegen:

1. Wechseln Sie zum Active Directory-Konto von Microsoft Azure und fügen Sie in den Einstellungen für Antwort-URLs für Ihre registrierte Anwendung die folgende Cloud-Service-Konfigurations-URL hinzu:

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

   

2. Speichern Sie die Konfiguration.

Konfigurieren von Microsoft Dynamics für IFD

Microsoft Dynamics verwendet anspruchsbasierte Authentifizierung, um externen Benutzern Zugriff auf Daten auf dem Microsoft Dynamics-CRM-Server zu ermöglichen. Führen Sie die folgenden Schritte aus, um Microsoft Dynamics für Bereitstellung mit Internetzugriff (Internet-Facing Deployment, IFD) zu konfigurieren und um Anspruchseinstellungen zu konfigurieren.

1. Konfigurieren Sie die lokale Microsoft Dynamics-On-Premises-Instanz für IFD, wie in Konfigurieren von IFD für Microsoft Dynamics beschrieben.

2. Führen Sie die folgenden Befehle mit Windows PowerShell aus, um die Anspruchseinstellungen für IFD-aktiviertes Microsoft Dynamics zu konfigurieren:

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

   Weitere Informationen finden Sie unter App-Registrierung für CRM lokal (IFD).

Konfigurieren des OAuth-Clients auf einem AD FS-Computer

Führen Sie die folgenden Schritte aus, um einen OAuth-Client auf einem AD FS (Active Directory Federation Services)-Computer zu registrieren und Zugriff auf den AD FS-Computer zu erteilen:

1. Führen Sie den folgenden Befehl aus:

   Add-AdfsClient -ClientId “<Client-ID>” -Name "<name>" -RedirectUri "<redirect-uri>" -GenerateClientSecret

   Dabei ist:

   • Client-ID eine Client-ID, die Sie mit einem beliebigen GUID-Generator generieren können.

   • redirect-uri die URL zu dem Microsoft Dynamics-OData-Cloud Service auf Experience Manager Forms. Der mit Experience Manager Forms installierte standardmäßige Cloud Service wird unter der folgenden URL bereitgestellt:

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

2. Führen Sie den folgenden Befehl aus, um Zugriff auf den AD FS-Computer zu gewähren:

   Grant-AdfsApplicationPermission -ClientRoleIdentifier “<Client-ID>” -ServerRoleIdentifier <resource> -ScopeNames openid

   Dabei ist:

   • resource die Microsoft Dynamics-Unternehmens-URL.

3. Microsoft Dynamics verwendet das HTTPS-Protokoll. Um AD FS-Endpunkte aus dem Forms-Server aufzurufen, installieren Sie das Microsoft Dynamics-Site-Zertifikat im Java-Zertifikatspeicher mit dem Befehl keytool auf dem Computer, auf dem Experience Manager Forms ausgeführt wird.

Konfigurieren des Cloud Service für Ihren Microsoft Dynamics-Service

Ein OData-Service wird anhand seiner Service-Stamm-URL identifiziert. Um einen OData-Service in Experience Manager as a Cloud Service zu konfigurieren, müssen Sie sicherstellen, dass Sie über die Service-Stamm-URL für den Service verfügen. Gehen Sie dann wie folgt vor:

1. Wechseln Sie zu Tools > Cloud Services > Data Sources. Tippen Sie, um den Ordner auszuwählen, in dem Sie eine Cloud-Konfiguration erstellen möchten.

   Weitere Informationen zum Erstellen und Konfigurieren eines Ordners für Cloud Service-Konfigurationen finden Sie unter Konfigurieren des Ordners für Cloud Service-Konfigurationen.

2. Tippen Sie auf Erstellen, um den Assistenten zum Erstellen der Datenquellkonfiguration zu öffnen. Geben Sie einen Namen und optional einen Titel für die Konfiguration ein, wählen Sie OData-Service aus der Dropdown-Liste „Service-Typ“ aus, suchen Sie optional nach einem Miniaturbild für die Konfiguration und tippen Sie auf Weiter.
   Auf der Registerkarte Authentifizierungseinstellungen:

   1. Geben Sie den Wert für das Feld Service-Stamm ein. Wechseln Sie zur Dynamics-Instanz und navigieren Sie zu Entwickler-Ressourcen, um den Wert für das Feld „Service-Stamm“ anzuzeigen. Beispiel: https://<tenant-name>/api/data/v9.1/

   2. Wählen Sie OAuth 2.0 als Authentifizierungstyp aus.

   3. Ersetzen Sie die Standardwerte in den Feldern Client-ID (die auch als Anwendungs-ID bezeichnet wird), Client-Geheimnis, OAuth-URL, URL für aktualisierten Token, Zugriffstoken-URL und Ressource mit Werten aus Ihrer Microsoft Dynamics-Service-Konfiguration. Sie müssen die Dynamics-Instanz-URL im Feld Ressource angeben, um Microsoft Dynamics mit einem Formulardatenmodell zu konfigurieren. Verwenden Sie die Service-Stamm-URL, um die URL der Dynamics-Instanz abzuleiten. Beispiel: https://org.crm.dynamics.com.

   4. Geben Sie die openid im Feld Autorisierungsumfang für den Autorisierungsprozess in Microsoft Dynamics an.

      
      Formulardatenmodell

3. Klicken Sie auf Mit OAuth verbinden. Sie werden zur Anmeldungsseite von Microsoft Dynamics umgeleitet.

4. Melden Sie sich mit Ihren Microsoft Dynamics-Anmeldeinformationen an und lassen Sie zu, dass die Cloud Service-Konfiguration eine Verbindung zum Microsoft Dynamics-Service herstellt. Es ist eine einmalige Aufgabe, das Formulardatenmodell zwischen dem Cloud Service und dem Service zu erstellen.

   Sie gelangen auf die Seite für das Formulardatenmodell und die Cloud Service-Konfiguration, auf der eine Meldung angezeigt wird, die besagt, dass die OData-Konfiguration erfolgreich gespeichert wurde.

Der MS Dynamics OData-Cloud Service (OData Service) ist konfiguriert und mit Ihrem Dynamics-Service verbunden. Formulardatenmodell Formulardatenmodell

Erstellen von Formulardatenmodellen

Nach der Konfiguration des MS Dynamics-OData-Cloud Service können Sie den Service beim Erstellen von Formulardatenmodellen verwenden. Weitere Informationen finden Sie unter Erstellen des Formulardatenmodells.

Anschließend können Sie ein adaptives Formular erstellen, das auf dem Datenmodell basiert, und es dann in verschiedenen Anwendungsfällen für adaptive Formulare verwenden, wie zum Beispiel:

• Befüllen eines adaptiven Formulars durch Abfragen von Informationen aus Microsoft Dynamics-Entitäten und -Services
• Aufrufen von Microsoft Dynamics-Servervorgängen, die in einem Formulardatenmodell definiert sind, mithilfe von adaptiven Formularregeln
• Schreiben übermittelter Formulardaten in Microsoft Dynamics-Entitäten

Weitere Informationen über die Erstellung und Verwendung des Formulardatenmodells in Unternehmens-Workflows finden Sie unter Datenintegration.