Zum Inhalt springen

Microsoft Dynamics 365 Verbindung

Einführung

Eine Microsoft Dynamics 365 Verbindung, die mit dem Microsoft Dynamics 365 Connector erstellt wurde, ermöglicht den Zugriff auf eines der folgenden Microsoft Dynamics 365 Produkte:

Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Microsoft Dynamics 365.

Erstellen oder Bearbeiten einer Microsoft Dynamics 365 Verbindung

Eine neue Microsoft Dynamics 365 Verbindung wird mit dem Microsoft Dynamics 365 Connector aus einem dieser Standorte erstellt:

Eine vorhandene Microsoft Dynamics 365 Verbindung kann von diesen Standorten aus bearbeitet werden:

Konfigurieren einer Microsoft Dynamics 365-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Microsoft Dynamics 365-Verbindung wird im Folgenden beschrieben.

Tipp

Felder mit einem Variablen-Symbol 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-Symbol klicken, um eine Liste der vorhandenen Variablen anzuzeigen, aus der Sie auswählen können.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Microsoft Dynamics 365-Verbindung eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den Microsoft Dynamics 365-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

  • Organisations-URL: Geben Sie die Organisations-URL ein.

  • Authentifizierungsschema: Wählen Sie das Authentifizierungsschema aus, eines von:

    • AzureAD

      • OAuth initiieren: Wählen Sie die OAuth-Einstellung aus, eine von:

        • AUS

          • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.

        • AKTUALISIEREN

          • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.

        • GETANDREFRESH

      • OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.

    • AzureMSI

    • AzureServicePrincipal

      • Azure-Mandant: Geben Sie den Azure-Mandanten ein.

      • OAuth initiieren: Wählen Sie die OAuth-Einstellung aus, eine von:

        • AUS

          • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.

        • AKTUALISIEREN

          • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.

        • GETANDREFRESH

      • OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.

      • OAuth-Client-Geheimnis: Geben Sie das OAuth-Client-Geheimnis ein.

      • OAuth Refresh Token: Geben Sie das OAuth-Refresh-Token ein.

    • AzureServicePrincipalCert

      • Azure Tenant: Geben Sie den Azure-Mandanten ein.

      • Initiate OAuth: Wählen Sie die OAuth-Einstellung, eine der folgenden:

        • OFF

          • OAuth Access Token: Geben Sie das OAuth-Zugangs-Token ein.

        • REFRESH

          • OAuth Access Token: Geben Sie das OAuth-Zugangs-Token ein.

        • GETANDREFRESH

      • OAuth Client Id: Geben Sie die OAuth-Client-ID ein.

      • OAuth Refresh Token: Geben Sie das OAuth-Refresh-Token ein.

      • OAuth JWT Cert: Geben Sie das OAuth-JWT-Zertifikat ein.

      • OAuth JWT Cert Type: Wählen Sie den Typ des OAuth-JWT-Zertifikats, eine der folgenden:

        • USER

        • MACHINE

        • PFXFILE

        • PFXBLOB

        • JKSFILE

        • JKSBLOB

        • PEMKEY_FILE

        • PEMKEY_BLOB

        • PUBLIC_KEY_FILE

        • PUBLIC_KEY_BLOB

        • SSHPUBLIC_KEY_FILE

        • SSHPUBLIC_KEY_BLOB

        • P7BFILE

        • PPKFILE

        • XMLFILE

        • XMLBLOB

        • BCFKSFILE

        • BCFKSBLOB

      • OAuth JWT Cert Password: Geben Sie das Passwort für das OAuth-JWT-Zertifikat ein.

      • OAuth JWT Cert Subject: Geben Sie das Subjekt des OAuth-JWT-Zertifikats ein.

  • Edition: Wählen Sie die Edition, eine der folgenden:

    • CustomerService

    • FieldService

    • FinOpsOnline

    • FinOpsOnPremise

      • ADFS Server: Geben Sie den ADFS-Server ein.

    • HumanResources

    • Marketing

    • ProjectOperations

    • Sales

    • Commerce

  • Use Proxy Settings: Wählen Sie, um die Proxy-Einstellungen für private Agenten zu verwenden.

  • Advanced Configurations: Wenn ausgewählt, wird die Tabelle Erweiterte Konfigurationsparameter angezeigt, die verwendet wird, um zusätzliche Konfigurationsparameter als Schlüssel-Wert-Paare hinzuzufügen.

    • Hinzufügen: Fügt eine Zeile zur Tabelle hinzu. Geben Sie ein Schlüssel-Wert-Paar für jede Eigenschaft ein.
    • Einreichen: Speichert das Schlüssel-Wert-Paar in der Tabelle. Sichtbar, wenn Sie mit der Maus über eine Zeile im Bearbeitungsmodus fahren.
    • Verwerfen: Verwirft eine neue Zeile oder alle Änderungen an einer bestehenden Zeile. Sichtbar, wenn Sie mit der Maus über eine Zeile im Bearbeitungsmodus fahren.
    • Bearbeiten: Ermöglicht das Bearbeiten eines bestehenden Schlüssel-Wert-Paares. Sichtbar, wenn Sie mit der Maus über eine bestehende Zeile fahren.
    • Löschen: Löscht die Zeile aus der Tabelle. Sichtbar, wenn Sie mit der Maus über eine bestehende Zeile fahren.
    • Alle löschen: Löscht alle Zeilen aus der Tabelle.

    Wichtig

    Felder in der Tabelle Erweiterte Konfigurationsparameter zeigen das Variablen-Icon nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 sein.

    Felder in der Tabelle Erweiterte Konfigurationsparameter unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird das Entkommen von {"success": "true"}; zu {\"success\": \"true\"};.

  • Test: Klicken Sie, um die Verbindung mit der angegebenen 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 fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

  • Löschen: Nachdem Sie eine vorhandene 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.

OAuth-Verbindungen konfigurieren

Dieser Connector unterstützt eine Verbindung über OAuth, indem spezifische Konfigurationseigenschaften verwendet werden. Nachdem Sie ein Authentifizierungsschema ausgewählt haben, das OAuth initiieren umfasst, können Sie die Konfiguration in den angezeigten Feldern angeben.

Hinweis

Zusätzliche IDs, Geheimnisse, Scopes und andere Authentifizierungstoken können erforderlich sein, um die OAuth-Authentifizierung erfolgreich abzuschließen. Überprüfen Sie die Dokumentation des Endpunkts für weitere Informationen zu deren Anforderungen.

Für diesen Connector werden zwei Szenarien unterstützt. In beiden Szenarien müssen Sie ein Drittanbieter-Tool (wie Postman oder ein ähnliches Tool) verwenden, um das erforderliche Zugriffstoken oder die Tokens vom beteiligten Endpunkt zu erhalten. Beide Szenarien funktionieren nur für Einzel-Agenten-Gruppen. Dies sind Agentengruppen, die aus einem einzelnen Agenten bestehen.

  • Szenario 1: Verwendung eines OAuth-Zugriffstokens, das nach einer festgelegten Zeitspanne abläuft.

    Mit dieser Konfiguration geben Sie ein OAuth-Zugriffstoken an, das für einen festgelegten Zeitraum gültig ist, wie vom jeweiligen Endpunkt bestimmt. Der Connector verwendet das Token, um die Verbindung herzustellen. Die Verbindung funktioniert jedoch nicht mehr, sobald das Zugriffstoken abläuft. Sie würden den Connector so konfigurieren, dass er das Token verwendet, indem Sie diese Eigenschaften festlegen:

    Konfigurationseigenschaft Wert
    OAuth initiieren AUS
    OAuth-Zugriffstoken Auf den Wert des vom Endpunkt erhaltenen OAuth-Zugriffstokens setzen

  • Szenario 2: Verwendung eines OAuth-Zugriffstokens in Kombination mit einem OAuth-Refresh-Token, um eine automatische Aktualisierung des Zugriffs zu ermöglichen.

    Mit dieser Konfiguration verwendet der Connector ein Refresh-Token, um ein neues Zugriffstoken zu erhalten, sobald das aktuelle Zugriffstoken abgelaufen ist. Dies ist im Allgemeinen die beste Methode zur Konfiguration von OAuth.

    Sie geben ein OAuth-Zugriffstoken und ein OAuth-Refresh-Token an, wie es der jeweilige Endpunkt bestimmt. Sie würden den Connector so konfigurieren, dass er diese Tokens verwendet, indem Sie diese Eigenschaften festlegen:

    Konfigurationseigenschaft Wert
    OAuth initiieren REFRESH
    OAuth-Zugriffstoken Auf den Wert des vom Endpunkt erhaltenen OAuth-Zugriffstokens setzen
    OAuth-Refresh-Token Auf den Wert des vom Endpunkt erhaltenen OAuth-Refresh-Tokens setzen

Hinweis

Wenn Sie mehrere OAuth-basierte Microsoft Dynamics 365-Verbindungen auf demselben privaten Agenten verwenden, setzen Sie die Konfigurationseigenschaft OAuthSettingsLocation auf einen eindeutigen beschreibbaren Agentenpfad für jede Verbindung. In der jitterbit.conf-Datei für den Agenten setzen Sie EnableLocalFileLocation=true. Wenn Sie diese beiden Schritte nicht ausführen, verwenden die mehreren Verbindungen denselben Standardpfad und überschreiben sich gegenseitig.

Nächste Schritte

Nachdem eine Verbindung zu einem Microsoft Dynamics 365-Connector hergestellt 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 Palette der Entwurfskomponenten zugänglich. Weitere Einzelheiten finden Sie in den Aktionsmenüs in den Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Abfrage: Ruft Datensätze aus einer Tabelle in Microsoft Dynamics 365 ab und ist als Quelle in einem Vorgang vorgesehen.

  • Erstellen: Fügt einen Datensatz in eine Tabelle in Microsoft Dynamics 365 ein und ist als Ziel in einem Vorgang vorgesehen.

  • Aktualisieren: Aktualisiert einen Datensatz in einer Tabelle in Microsoft Dynamics 365 und ist als Ziel in einem Vorgang vorgesehen.

  • Löschen: Löscht einen Datensatz aus einer Tabelle in Microsoft Dynamics 365 und ist als Ziel in einem Vorgang vorgesehen.

  • Ausführen: Führt ein Verfahren in Microsoft Dynamics 365 aus und ist als Ziel in einem Vorgang vorgesehen.