Microsoft Dynamics OData-Konfiguration

Letzte Aktualisierung: 2023-11-07
  • Erstellt für:
  • User
Version Artikel-Link
AEM as a Cloud Service Hier klicken
AEM 6.5 Dieser Artikel

data-integeration

Microsoft Dynamics ist eine Software für Customer Relationship Management (CRM) und Enterprise Resource Planning (ERP), die Unternehmenslösungen für die Erstellung und Verwaltung von Kundenkonten, Kontakten, Leads, Chancen und Fällen bietet. AEM Forms-Datenintegration bietet eine OData-Cloud-Service-Konfiguration zur Integration von Forms in den Online- und lokalen Microsoft Dynamics-Server. Damit können Sie ein Formulardatenmodell erstellen, das auf den im Microsoft Dynamics-Dienst definierten Entitäten, Attributen und Diensten basiert. Das Formulardatenmodell kann verwendet werden, um adaptive Formulare zu erstellen, die mit Microsoft Dynamics Server interagieren, um Geschäfts-Workflows zu ermöglichen. Beispiel:

  • Abfragen des Microsoft Dynamics-Servers nach Daten und Vorausfüllen der adaptiven Formulare
  • Schreiben von Daten in Microsoft Dynamics bei der Sendung von adaptiven Formularen
  • Schreiben von Daten in Microsoft Dynamics durch benutzerdefinierte Entitäten, die im Formulardatenmodell definiert sind, und umgekehrt

Das AEM Forms Add-On-Paket enthält auch eine Referenz-OData-Konfiguration, die Sie verwenden können, um Microsoft Dynamics schnell in AEM Forms zu integrieren.

Wenn das Paket installiert ist, sind die folgenden Entitäten und Dienste in Ihrer AEM Forms-Instanz verfügbar:

  • MS Dynamics OData-Cloud Service (OData-Dienst)
  • Formulardatenmodell mit vorkonfigurierten Microsoft Dynamics-Entitäten und -Services.

Vorkonfigurierte Microsoft Dynamics-Entitäten und -Services in einem Formulardatenmodell sind nur dann in Ihrer AEM Forms-Instanz verfügbar, wenn der Ausführungsmodus für die AEM-Instanz auf samplecontent (Standard) festgelegt ist. MS Dynamics OData Cloud Service (OData Service) ist auch für andere Ausführungsmodi verfügbar. Weitere Informationen zum Konfigurieren von Ausführungsmodi für eine AEM-Instanz finden Sie unter Ausführungsmodi.

Voraussetzungen

Bevor Sie mit der Einrichtung und Konfiguration von Microsoft Dynamics beginnen, stellen Sie Folgendes sicher:

Festlegen der Antwort-URL für die registrierte Microsoft Dynamics-Anwendung

Führen Sie die folgenden Schritte aus, um die Antwort-URL für die registrierte Microsoft Dynamics-Anwendung festzulegen:

HINWEIS

Verwenden Sie dieses Verfahren nur bei der Integration von AEM Forms mit dem Online-Microsoft Dynamics-Server.

  1. Wechseln Sie zu einem Microsoft Azure Active Directory-Konto 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.

Microsoft Dynamics für IFD konfigurieren

Microsoft Dynamics verwendet eine auf Ansprüchen basierende Authentifizierung, um externen Benutzern Zugriff auf Daten auf dem Microsoft Dynamics CRM-Server zu gewähren. Um dies zu aktivieren, führen Sie die folgenden Schritte aus, um Microsoft Dynamics für eine Internet-orientierte Bereitstellung (IFD) zu konfigurieren und Schadenseinstellungen zu konfigurieren.

HINWEIS

Verwenden Sie dieses Verfahren nur bei der Integration von AEM Forms mit dem lokalen Microsoft Dynamics-Server.

  1. Konfigurieren Sie die lokale Microsoft Dynamics-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 AEM Forms mit dem lokalen 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 ist die URL zum Microsoft Dynamics OData Cloud-Dienst auf AEM Forms. Der mit dem AEM Forms-Paket 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 ist die Microsoft Dynamics-Organisations-URL.
  3. Microsoft Dynamics verwendet das HTTPS-Protokoll. Um AD FS-Endpunkte über den Forms-Server aufzurufen, installieren Sie das Microsoft Dynamics-Websitezertifikat mithilfe des Befehls keytool auf dem Computer, auf dem AEM Forms ausgeführt wird, im Java-Zertifikatspeicher.

Konfigurieren Sie den Cloud-Dienst für Ihren Microsoft Dynamics-Dienst

Die Konfiguration MS Dynamics OData Cloud Service (OData Service) wird mit der Standard-OData-Konfiguration geliefert. Gehen Sie wie folgt vor, um ihn für die Verbindung mit Ihrem Microsoft Dynamics -Dienst zu konfigurieren.

  1. Navigieren Sie zu Tools > Cloud-Services > Datenquellen und tippen Sie auf den Konfigurationsordner global.

  2. Auswählen MS Dynamics OData-Cloud Service (OData-Dienst) Konfiguration und tippen Sie auf Eigenschaften. Das Dialogfeld "Cloud Service-Konfigurationseigenschaft"wird geöffnet.

    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. Ersetzen Sie die Standardwerte in der Client ID (auch als Application ID bezeichnet), die Felder Client Secret, OAuth URL, Refresh Token URL, Access Token URL und Resource mit Werten aus Ihrer Microsoft Dynamics-Dienstkonfiguration. 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.

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

    Authentifizierungseinstellungen

  3. Klicken Sie auf Verbindung zu OAuth herstellen. 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 herstellen kann. Es ist eine einmalige Aufgabe, eine Verbindung zwischen dem Cloud-Service und dem Dienst herzustellen.

    Anschließend werden Sie zur Cloud-Service-Konfigurationsseite weitergeleitet, auf der eine Meldung angezeigt wird, dass die OData-Konfiguration erfolgreich gespeichert wurde.

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

Erstellen des Formulardatenmodells

Wenn Sie das AEM Forms-Paket installieren, wird ein Formulardatenmodell, Microsoft Dynamics FDM, in Ihrer AEM-Instanz bereitgestellt. Standardmäßig verwendet das Formulardatenmodell den Microsoft Dynamics-Service, der im MS Dynamics ODaten-Cloud-Service (ODaten-Service) konfiguriert ist, als Datenquelle.

Beim erstmaligen Öffnen des Formulardatenmodells stellt es eine Verbindung zum konfigurierten Microsoft Dynamics-Dienst her und ruft Entitäten von Ihrer Microsoft Dynamics-Instanz ab. Die Entitäten "contact"und "lead"aus Microsoft Dynamics wurden bereits im Formulardatenmodell hinzugefügt.

Um das Formulardatenmodell zu überprüfen, navigieren Sie zu Formulare > Datenintegrationen. Auswählen Microsoft Dynamics FDM und klicken Bearbeiten , um das Formulardatenmodell im Bearbeitungsmodus zu öffnen. Alternativ können Sie das Formulardatenmodell direkt über die folgende URL öffnen:

https://'[server]:[port]'/aem/fdm/editor.html/content/dam/formsanddocuments-fdm/ms-dynamics-fdm

default-fdm-1

Anschließend können Sie ein adaptives Formular auf der Grundlage des Formulardatenmodells erstellen und es in verschiedenen Anwendungsfällen für adaptive Formulare verwenden, wie z. B.:

  • Adaptives Formulars durch Abfrage von Informationen aus Microsoft Dynamics-Entitäten und Dienste befüllen
  • Aufrufen von Microsoft Dynamics-Server-Prozessen, die in einem Formulardatenmodell definiert sind, unter Verwendung adaptiver Formularregeln
  • Gesendete Formulardaten in Microsoft Dynamics-Entitäten schreiben

Es wird empfohlen, eine Kopie des mit dem AEM Forms-Package bereitgestellten Formulardatenmodells zu erstellen und Datenmodelle und -dienste entsprechend Ihren Anforderungen zu konfigurieren. Dadurch wird sichergestellt, dass zukünftige Aktualisierungen des Pakets Ihr Formulardatenmodell nicht überschreiben.

Weitere Informationen zur Erstellung und Verwendung des Formulardatenmodells in Business Workflows finden Sie unter Datenintegration.

Auf dieser Seite