Microsoft Dynamics CRM Anbindung
Einführung
Eine Microsoft Dynamics CRM Verbindung, die mit dem Microsoft Dynamics CRM Connector erstellt wurde, ermöglicht den Zugriff auf Microsoft Dynamics CRM. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von Microsoft Dynamics CRM -Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.
Notiz
Eine Microsoft Dynamics CRM Verbindung erfordert die Verwendung eines Harmony privaten Windows Agenten mit einem Jitterbit Microsoft Dynamics CRM REST Connector. Diese beiden Softwareteile müssen vor der Verwendung und Konfiguration dieses Integration Studio Microsoft Dynamics CRM Connector. Weitere Informationen finden Sie unter Microsoft Dynamics CRM -Agentkonfiguration.
Hinweis
Dieser Connector unterstützt die Organisationsrichtlinie Erneute Authentifizierung bei Änderung aktivieren. Wenn diese Option aktiviert ist, müssen Benutzer bei einer Änderung der Organisationsdienst-URL oder des Logins in dieser Verbindung das Passwort für die Verbindung erneut eingeben.
Erstellen oder Bearbeiten einer Microsoft Dynamics CRM Verbindung
Eine neue Microsoft Dynamics CRM Verbindung wird mithilfe des Microsoft Dynamics CRM Connectors von einem dieser Standorte aus erstellt:
- Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
- Die Seite Globale Verbindungen (siehe Einen globalen Endpoint erstellen in Globale Verbindungen).
Eine vorhandene Microsoft Dynamics CRM Verbindung kann von diesen Orten aus bearbeitet werden:
- Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
- Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
- Die Seite Globale Verbindungen (siehe Einen globalen Endpoint bearbeiten in Globale Verbindungen).
Konfigurieren einer Microsoft Dynamics CRM Verbindung
Nachfolgend werden die einzelnen Benutzeroberflächenelemente des Microsoft Dynamics CRM Verbindungskonfigurationsbildschirms beschrieben.
Tipp
Felder mit variablem Symbol Unterstützung der Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [
in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.
-
Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede Microsoft Dynamics CRM Verbindung eindeutig sein und darf keine Schrägstriche enthalten (
/
) oder Doppelpunkte (:
) Dieser Name wird auch zur Identifizierung des Microsoft Dynamics CRM Endpoint verwendet, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht. -
Organisationsdienst-URL: Um die Organisationsdienst-URL in einer Dynamics CRM Cloudinstanz zu finden, melden Sie sich bei der Instanz an und klicken Sie auf die Karte Dynamics 365 - benutzerdefiniert. Verwenden Sie als Eingabe für dieses Feld die vollständige Domäne (ohne Pfad), die in der Adressleiste Ihres Webbrowsers vorhanden ist.
Vorsicht
Verwenden Sie nicht die Organisationsdienst-URL, die auf der Seite Entwicklerressourcen einer Dynamics CRM Cloudinstanz vorhanden ist, oder die veraltete Regional Discovery URL.
-
Anmeldung: Geben Sie die Benutzer-ID ein, die bei der Microsoft Dynamics CRM Instanz registriert ist.
-
Passwort: Geben Sie das Passwort für die Benutzer-ID ein, die bei der Microsoft Dynamics CRM Instanz registriert ist.
-
Konnektivitätstyp: Wählen Sie den Konnektivitätstyp aus, der zum Auflösen der bei der Microsoft Dynamics CRM Instanz registrierten Benutzer-ID erforderlich ist. Wählen Sie eine der folgenden Optionen aus:** Active Directory, *Federation *, Live ID , **Online Federation oder Keine.
-
Anwendungs-ID: Geben Sie die Anwendungs-ID ein. Diese ist nur sichtbar, wenn Online Federation als Konnektivitätstyp ausgewählt ist. Weitere Informationen zum Abrufen der Anwendungs-ID finden Sie unter Abrufen einer Microsoft Dynamics CRM Anwendungs-ID.
-
Eindeutiger Name der Organisation: Geben Sie den eindeutigen Namen der Organisation ein. Der eindeutige Name der Organisation kann eine beliebige Zeichenfolge ohne Leerzeichen sein.
-
Domänenname: Geben Sie die Domäne ein, zu der die Benutzer-ID gehört. Geben Sie den vollständigen Domänennamen ein, der durch den ausgewählten Verbindungstyp bestimmt wird.
-
Test: Klicken Sie hier, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.
-
Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.
-
Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
-
Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.
Häufige Verbindungsfehler
Dies sind häufige Verbindungsfehler und ihre Lösungen:
Fehler | Ursache | Lösung |
---|---|---|
Error: AUTHORIZATION ERROR: Test connection failed., reason:CData elements not valid at top level of an XML document. | Die Version des privaten Agenten ist zu alt oder der falsche Jitterbit CRM REST Connector ist installiert. | Stellen Sie sicher, dass der installierte private Agent die Version 10.42 oder höher ist und der richtige Jitterbit CRM REST Connector installiert ist. Siehe Microsoft Dynamics CRM Agentkonfiguration für weitere Informationen. |
Error: Invalid Input: No input for organizationUniqueName | Das Feld Eindeutiger Name der Organisation ist leer. | Geben Sie eine beliebige Zeichenfolge ohne Leerzeichen ein. |
Error: Connection Timeout | Das Netzwerk blockiert möglicherweise ausgehenden Datenverkehr. | Prüfen Sie bei den Netzwerkadministratoren, ob ausgehender Datenverkehr zu dieser URL zulässig ist. |
Connector Error: The fatal error : Not initialized. | Dieser Fehler kann von einem Dynamics CRM 2011-Server zurückgegeben werden. Er kann zurückgegeben werden, wenn die Organisationsdienst-URL falsch ist. | Überprüfen Sie, ob die Organisationsdienst-URL richtig ist und keine Regional Discovery-URL verwendet. |
Connector Error: The fatal error : Value cannot be null. | Dieser Fehler kann von einer lokalen Dynamics CRM -Instanz zurückgegeben werden. Er kann zurückgegeben werden, wenn die Organisationsdienst-URL falsch ist. | Überprüfen Sie, ob die Organisationsdienst-URL richtig ist und keine Regional Discovery-URL verwendet. |
Connector Error: The fatal error : AUTHORIZATION ERROR: Test connection failed., reason:One or more errors occurred. | Dieser Fehler kann von einer Dynamics CRM Cloudinstanz zurückgegeben werden. Er kann zurückgegeben werden, wenn die Organisationsdienst-URL falsch ist. | Überprüfen Sie, ob die Organisationsdienst-URL richtig ist und keine Regional Discovery-URL verwendet. |
Connector Error: The call to url http://127.0.0.1:8000/CRM/TestConnection failed. reason : Connect to 127.0.0.1:8000 [/127.0.0.1] failed: connection refused: connect | der Jitterbit CRM REST-Connector ist nicht installiert oder der Dienst wird nicht ausgeführt. | siehe Microsoft Dynamics CRM Agent-Konfiguration für Anweisungen zur Installation eines Jitterbit CRM REST-Connectors. |
Fatal Error: Object reference not set to an instance of an object. | Es ist eine falsche Anwendungs-ID, ein falscher Benutzername oder ein falsches Kennwort oder eine falsche Organisationsdienst-URL vorhanden. | Stellen Sie sicher, dass Sie die richtigen Microsoft Dynamics CRM Anmeldeinformationen verwenden. Informationen zum Abrufen der Anwendungs-ID finden Sie unter Abrufen einer Microsoft Dynamics CRM Anwendungs-ID. |
Nächste Schritte
Nachdem eine Microsoft Dynamics CRM Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verwenden von Daten in einem Operation) verwendet werden können.
Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.
Diese Aktivitätstypen sind verfügbar:
-
Upsert: Aktualisiert einen vorhandenen Objektdatensatz oder erstellt einen neuen Objektdatensatz in Microsoft Dynamics CRM und soll als Ziel in einem Operation verwendet werden.
-
Erstellen: Erstellt einen Objektdatensatz in Microsoft Dynamics CRM und soll als Ziel in einem Operation verwendet werden.
-
Aktualisieren: Aktualisiert einen vorhandenen Objektdatensatz in Microsoft Dynamics CRM und soll als Ziel in einem Operation verwendet werden.
-
Löschen: Löscht einen Objektdatensatz aus Microsoft Dynamics CRM und soll als Ziel in einem Operation verwendet werden.