Microsoft Dynamics OData-Konfiguration

data-integeration

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
  • Speichern von Daten in Microsoft Dynamics durch benutzerdefinierte Entitäten, die im Formulardatenmodell definiert sind, und umgekehrt
MS Dynamics OData Cloud Service (OData Service) is available with all run modes. For more information on configuring run modes for an Experience Manager instance, see [Run Modes](/docs/experience-manager-cloud-service/implementing/deploying/overview.html?lang=de#runmodes).

Voraussetzungen

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

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:

HINWEIS

Verwenden Sie dieses Verfahren nur bei der Integration von Experience Manager Forms mit einem Microsoft Dynamics-Online-Server.

  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

    Azure-Verzeichnis

  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.

HINWEIS

Verwenden Sie dieses Verfahren nur bei der Integration von Experience Manager Forms mit einem lokal installierten Microsoft Dynamics-Server.

  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:

HINWEIS

Verwenden Sie dieses Verfahren nur bei der Integration von Experience Manager Forms mit einem lokal installierten Microsoft Dynamics-Server.

  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:

HINWEIS

Eine schrittweise Anleitung zum Konfigurieren von Microsoft Dynamics 365, online oder On-Premise, finden Sie unter Microsoft Dynamics OData-Konfiguration.

  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.

      Authentifizierungseinstellungen
      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.

Auf dieser Seite