Zum Inhalt springen

Microsoft Dynamics CRM-Verbindungsanleitung für Jitterbit App Builder

Übersicht

Diese Anleitung beschreibt die Systemanforderungen und Anweisungen zur Verbindung von App Builder mit Microsoft Dynamics CRM.

Systemanforderungen

Aktives Konto

  • Microsoft Dynamics CRM

Client-Webbrowser

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

Verbindungsanweisungen

Voraussetzungen

Bevor Sie eine Verbindung von App Builder zu Microsoft Dynamics CRM einrichten, sollten Sie die folgenden Schritte ausführen:

  • Überprüfen Sie, ob Sie ein aktives Dynamics CRM-Konto haben

  • Überprüfen Sie, ob Sie sich in ein aktives Azure-Konto mit Berechtigung zur Konfiguration von Verbindungen einloggen können

Eine App in Microsoft Azure registrieren

Die Methode, die verwendet wird, um sich von App Builder bei Dynamics CRM zu authentifizieren, ist OAuth 2.0. Wir werden den OAuth-Fluss mit Microsoft Azure konfigurieren.

  1. Navigieren Sie zum Microsoft Entra ID-Admincenter-Portal

  2. Wählen Sie unter Verwalten App-Registrierungen > Neue Registrierung

  3. Geben Sie einen Namen ein. Zum Beispiel: App Builder Dynamics CRM

  4. Wählen Sie aus, wer die Anwendung nutzen kann

  5. Klicken Sie auf Registrieren

Wenn die Registrierung abgeschlossen ist, zeigt das Azure-Portal die App-Registrierung auf dem Übersichtsbildschirm an. Notieren Sie den Wert in Anwendungs- (Client-) ID als OAuthClientID und die Verzeichnis- (Mandanten-) ID als AzureTenantID.

Eine Umleitungs-URI hinzufügen

Die Umleitungs-URL stellt den Ort dar, an den Microsoft den Client des Benutzers umleitet und die Sicherheitstoken nach der Authentifizierung übergibt.

  1. Navigieren Sie zur registrierten App in Microsoft Entra ID

  2. Klicken Sie auf Eine Umleitungs-URI hinzufügen, um den Wert einzugeben. Zum Beispiel: http://localhost/auth-response

Ein Client-Geheimnis hinzufügen

Client-Geheimnisse werden auch als Anwendungskennwort bezeichnet. Die registrierte App in Microsoft Azure erfordert, dass für jede App Builder-Umgebung, in der die Verbindung verwendet wird, ein Client-Geheimnisdatensatz erstellt wird. Wenn Ihre App Builder-Konfiguration eine Entwicklungs-, QA- und Produktionsumgebung hat, benötigen Sie 3 entsprechende Client-Geheimnisdatensätze.

Client-Geheimnisse haben ein zugehöriges Ablaufdatum, und die maximale Dauer, für die sie festgelegt werden können, beträgt 2 Jahre.

Das Generieren eines Client-Geheimnisdatensatzes liefert Ihnen einen Client-Geheimnis Wert und eine Geheimnis-ID. Der Wert ist kodiert und kann nur einmal kopiert und verwendet werden (ansonsten müsste ein neues Token generiert werden, um einen neuen Wert zu erfassen).

  1. Navigieren Sie zur registrierten App in Microsoft Entra ID

  2. Wählen Sie unter Verwalten Zertifikate & Geheimnisse

  3. Klicken Sie auf Neues Client-Geheimnis

  4. Geben Sie eine Beschreibung ein. Zum Beispiel: App Builder Produktion

  5. Wählen Sie einen Ablauf-Wert. Zum Beispiel: 730 Tage (24 Monate)

  6. Klicken Sie auf Hinzufügen

  7. Notieren Sie den Wert, da er kodiert wird. Sie benötigen ihn als OAuthClientSecret

API-Berechtigungen zuweisen

Die registrierte App in Microsoft Azure benötigt Berechtigungen, die Dynamics CRM zugewiesen sind. Dies sollte basierend darauf konfiguriert werden, wie Sie es mit App Builder integrieren möchten.

  1. Navigieren Sie zur registrierten App in Microsoft Entra ID

  2. Wählen Sie unter Verwalten API-Berechtigungen

  3. Klicken Sie auf Berechtigung hinzufügen

  4. Klicken Sie auf Dynamics ERP

  5. Wenn Sie planen, dass Ihre Anwendung ohne Benutzerkontext verbindet, wählen Sie Anwendungsberechtigungen (OAuthGrantType=Client). Andernfalls verwenden Sie Delegierte Berechtigungen (OAuthGrantType=Code)

  6. Klicken Sie auf Berechtigung hinzufügen und definieren Sie die Berechtigungen gemäß Ihren geschäftlichen Anforderungen

Für weitere Details siehe Schnellstart: Registrieren Sie eine Anwendung bei der Microsoft-Identitätsplattform

Für diesen Konfigurationsschritt sollten Sie den Anwendungs- (Client-) ID-Wert der oben registrierten App irgendwo griffbereit kopiert haben, z. B. in Ihrer Zwischenablage.

  1. Navigieren Sie zu Dynamics CRM

  2. Erstellen Sie einen Anwendungsbenutzer

  3. Geben Sie den Client-ID-Wert der registrierten App ein. Dies ist der Anwendungs- (Client-) ID-Wert in Microsoft Azure.

  4. Weisen Sie dem neuen Benutzer eine Rolle zu

Hinzufügen eines Servers

  1. Navigieren Sie zum App Builder IDE

  2. Klicken Sie im Menü "Connect" auf die Schaltfläche Data Servers

  3. Klicken Sie auf die Schaltfläche + Server im Data Servers-Bereich. Dadurch wird die Serverseite geöffnet. Geben Sie die folgenden Informationen ein:

    • Servername: Ein identifizierbarer und einzigartiger Servername. Zum Beispiel: Dynamics CRM

    • Typ: Wählen Sie Dynamics CRM aus dem Dropdown-Menü

    • Url: Geben Sie die Url zum Zugriff auf Dynamics CRM ein, die mit http:// oder https:// beginnen muss

  4. Klicken Sie auf die Schaltfläche Speichern

    attachment

  5. Klicken Sie auf die Schaltfläche Erweiterte Einstellungen.

  6. Geben Sie die folgenden Informationen und entsprechenden Werte im erweiterten Feld ein, wobei Sie jeden Wert mit einem Semikolon trennen:

    1. AzureTenant – Tenant-ID-Wert für den Azure-Dienst

    2. InitiateOAuth – Eigenschaft, um den Prozess zum Abrufen/Aktualisieren des OAuth-Zugriffstokens bei der Verbindung zu initiieren. Zum Beispiel: GETANDREFRESH

    3. OAuthClientID – ID-Wert, der zugewiesen wird, wenn die App beim OAuth-Server registriert wird

    4. OAuthClientSecret – Wert, der zugewiesen wird, wenn die App beim OAuth-Server registriert wird

    5. OAuthGrantType – Grant-Typ für den OAuth-Fluss. Zum Beispiel: CLIENT

    6. OAuthSettingsLocation – Speicherort der Einstellungsdatei, in der die OAuth-Werte gespeichert werden. Zum Beispiel: C:\inetpub\wwwroot\App Builder\App_Data\CData\DynamicsCRM;

Beispiel für erweiterte Einstellungen:

AzureTenant=<TenantID>;
InitiateOAuth=GETANDREFRESH;
OAuthClientId=<ClientID>;
OAuthClientSecret=<ClientSecret>;
OAuthGrantType=CLIENT;
OAuthSettingsLocation=C:\inetpub\wwwroot\App Builder\App_Data\CData\DynamicsCRM;

Fehlersuche

Wenn Sie Probleme mit Microsoft Dynamics CRM haben, werden die folgenden Schritte zur Fehlersuche empfohlen:

  1. Aktivieren Sie Datenprotokollierung, um Protokolldateien und Daten zu generieren, die Sie herunterladen und überprüfen können.

  2. Konsultieren Sie die CData ADO.NET Provider für Microsoft Dynamics CRM-Dokumentation für detaillierte Informationen.