Microsoft Dynamics CRM-Verbindung
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 Instanzen von Microsoft Dynamics CRM-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.
Hinweis
Eine Microsoft Dynamics CRM-Verbindung erfordert die Verwendung eines Harmony Windows-Privatagenten mit einem Jitterbit Microsoft Dynamics CRM REST-Connector. Diese beiden Softwarekomponenten müssen heruntergeladen, installiert und konfiguriert werden, bevor die Verwendung und Konfiguration dieses Studio Microsoft Dynamics CRM-Connectors erfolgen kann. Weitere Informationen finden Sie unter Microsoft Dynamics CRM-Agenten-Konfiguration.
Hinweis
Dieser Connector unterstützt die Re-Authentifizierung bei Änderung Organisationsrichtlinie. Wenn aktiviert, erfordert eine Änderung der Service-URL der Organisation oder Anmeldung in dieser Verbindung, dass die Benutzer das Passwort für die Verbindung erneut eingeben.
Erstellen oder Bearbeiten einer Microsoft Dynamics CRM-Verbindung
Eine neue Microsoft Dynamics CRM-Verbindung wird mit dem Microsoft Dynamics CRM-Connector aus einem dieser Standorte erstellt:
- Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
- Der Seite Globale Endpunkte (siehe Erstellen eines globalen Endpunkts in Globalen Endpunkten).
Eine vorhandene Microsoft Dynamics CRM-Verbindung kann von diesen Standorten bearbeitet werden:
- Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
- Der Registerkarte Komponenten im Projektbereich (siehe Menü für Komponentenaktionen in Projektbereich Komponenten-Registerkarte).
- Der Seite Globale Endpunkte (siehe Bearbeiten eines globalen Endpunkts in Globalen Endpunkten).
Konfigurieren einer Microsoft Dynamics CRM-Verbindung
Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Microsoft Dynamics CRM-Verbindung wird im Folgenden beschrieben.
Tipp
Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Variablen-Icon klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.
-
Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Microsoft Dynamics CRM-Verbindung eindeutig sein und darf keine Schrägstriche (
/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den Microsoft Dynamics CRM-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht. -
URL des Organisationsdienstes: Um die URL des Organisationsdienstes in einer Dynamics CRM-Cloudinstanz zu finden, melden Sie sich bei der Instanz an und klicken Sie auf die Dynamics 365 — benutzerdefiniert Karte. Verwenden Sie die vollständige Domain (ohne den Pfad), die in der Adressleiste Ihres Webbrowsers angezeigt wird, als Eingabe für dieses Feld.
Vorsicht
Verwenden Sie nicht die URL des Organisationsdienstes, die auf der Seite Entwicklerressourcen einer Dynamics CRM-Cloudinstanz oder die veraltete Regionale Entdeckungs-URL vorhanden ist.
-
Benutzername: 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.
-
Verbindungstyp: Wählen Sie den Verbindungstyp aus, der erforderlich ist, um die bei der Microsoft Dynamics CRM-Instanz registrierte Benutzer-ID aufzulösen. Wählen Sie einen der folgenden: Active Directory, Federation, Live ID, Online Federation oder None.
-
Anwendungs-ID: Geben Sie die Anwendungs-ID ein, die nur sichtbar ist, wenn Online Federation als Verbindungstyp ausgewählt ist. Weitere Informationen zum Abrufen der Anwendungs-ID finden Sie unter Abrufen einer Microsoft Dynamics CRM-Anwendungs-ID.
-
Organisationseinzigartiger Name: Geben Sie den einzigartigen Namen der Organisation ein. Der einzigartige Name der Organisation kann jede Zeichenfolge ohne Leerzeichen sein.
-
Domainname: Geben Sie die Domain ein, zu der die Benutzer-ID gehört. Geben Sie den vollständigen Domainnamen ein, wie er durch den ausgewählten Verbindungstyp bestimmt wird.
-
Test: Klicken Sie, 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 mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisation Richtlinie Automatische Connector-Aktualisierung deaktivieren.
-
Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.
-
Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
-
Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.
Häufige Verbindungsfehler
Dies sind häufige Verbindungsfehler und deren 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 Agents ist zu alt oder der falsche Jitterbit CRM REST Connector ist installiert. | Stellen Sie sicher, dass der installierte private Agent Version 10.42 oder höher ist und der richtige Jitterbit CRM REST Connector installiert ist. Siehe Microsoft Dynamics CRM-Agenten-Konfiguration für weitere Informationen. |
Error: Invalid Input: No input for organizationUniqueName |
Das Feld Organisationseinzigartiger Name ist leer. | Geben Sie eine beliebige Zeichenfolge ohne Leerzeichen ein. |
Error: Connection Timeout |
Das Netzwerk könnte ausgehenden Datenverkehr blockieren. | Überprüfen Sie mit den Netzwerkadministratoren, ob der ausgehende Datenverkehr zu dieser URL erlaubt ist. |
Connector Error: The fatal error : Not initialized. |
Dieser Fehler kann von einem Dynamics CRM 2011-Server zurückgegeben werden. Dies kann zurückgegeben werden, wenn die Organisation Service-URL falsch ist. | Überprüfen Sie, ob die Organisation Service-URL korrekt ist und keine Regionale Entdeckungs-URL verwendet wird. |
Connector Error: The fatal error : Value cannot be null. |
Dieser Fehler kann von einer Dynamics CRM On-Premises-Instanz zurückgegeben werden. Dies kann zurückgegeben werden, wenn die Organisation Service-URL falsch ist. | Überprüfen Sie, ob die Organisation Service-URL korrekt ist und keine Regionale Entdeckungs-URL verwendet wird. |
Connector Error: The fatal error : AUTHORIZATION ERROR: Test connection failed., reason:One or more errors occurred. |
Dieser Fehler kann von einer Dynamics CRM-Cloud-Instanz zurückgegeben werden. Dies kann zurückgegeben werden, wenn die Organisation Service-URL falsch ist. | Überprüfen Sie, ob die Organisation Service-URL korrekt ist und keine Regionale Entdeckungs-URL verwendet wird. |
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 läuft nicht. | Siehe Microsoft Dynamics CRM-Agenten-Konfiguration für Anweisungen zur Installation eines Jitterbit CRM REST Connectors. |
Fatal Error: Object reference not set to an instance of an object. |
Es gibt eine falsche Anwendungs-ID, einen falschen Benutzernamen oder ein falsches Passwort oder eine falsche Organisation Service-URL. | Stellen Sie sicher, dass Sie die entsprechenden Microsoft Dynamics CRM-Anmeldeinformationen verwenden. Informationen zum Abrufen der Anwendungs-ID finden Sie unter Erhalten einer Microsoft Dynamics CRM-Anwendungs-ID. |
Nächste Schritte
Nachdem eine Microsoft Dynamics CRM-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfskanvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.
Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Entwurfskomponentenpalette zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.
Diese Aktivitätstypen sind verfügbar:
-
Upsert: Aktualisiert einen vorhandenen Objekt-Datensatz oder erstellt einen neuen Objekt-Datensatz in Microsoft Dynamics CRM und ist als Ziel in einem Vorgang vorgesehen.
-
Create: Erstellt einen Objekt-Datensatz in Microsoft Dynamics CRM und ist als Ziel in einem Vorgang vorgesehen.
-
Update: Aktualisiert einen vorhandenen Objekt-Datensatz in Microsoft Dynamics CRM und ist als Ziel in einem Vorgang vorgesehen.
-
Delete: Löscht einen Objekt-Datensatz aus Microsoft Dynamics CRM und ist als Ziel in einem Vorgang vorgesehen.