Zum Inhalt springen

Jitterbit App Builder-Verbindung in Jitterbit Studio

Einführung

Eine Jitterbit App Builder-Verbindung wird mithilfe des Jitterbit App Builder-Connectors erstellt und stellt Zugriff auf eine Jitterbit App Builder-Anwendung bereit, die als REST-API veröffentlicht wird. Nach der Konfiguration einer Verbindung lassen sich Instanzen von Jitterbit App Builder-Aktivitäten erstellen, die dieser Verbindung zugeordnet sind. Diese Aktivitäten fungieren entweder als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder als Ziele (zur Nutzung von Daten in einem Vorgang).

Erstellen oder Bearbeiten einer Jitterbit App Builder-Verbindung

Eine neue Jitterbit App Builder-Verbindung wird mithilfe des Jitterbit App Builder-Connectors von einem dieser Orte erstellt:

Eine vorhandene Jitterbit App Builder-Verbindung lässt sich von diesen Orten aus bearbeiten:

Konfigurieren einer Jitterbit App Builder-Verbindung

Im Folgenden werden die einzelnen Elemente der Benutzeroberfläche des Konfigurationsbildschirms für die Jitterbit App Builder-Verbindung beschrieben.

Tipp

Felder mit einem -Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das -Variablensymbol, um ein Menü mit verfügbaren Variablen anzuzeigen.

  • Connection Name: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Jitterbit App Builder-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch zur Identifizierung des Jitterbit App Builder-Endpunkts verwendet, der sich auf eine bestimmte Verbindung und ihre Aktivitäten bezieht.

  • Hostname: Geben Sie den Hostnamen Ihres Jitterbit App Builder-Servers ohne das Protokoll ein. Wenn Ihre App Builder-Instanz von einem Pfad aus bereitgestellt wird, beziehen Sie den Pfad ein (z. B. ab.example.com oder ab.example.com/production).

  • Authentication: Wählen Sie die Authentifizierungsmethode aus, die der Connector für den Aufruf der REST-API der Anwendung verwendet. Folgende Optionen stehen zur Verfügung:

    • API Key: (Standard.) Authentifiziert mit einem API-Schlüssel. Diese Option zeigt das folgende Feld an:

      • API Key: Geben Sie den API-Schlüssel ein, der für die Jitterbit App Builder-Anwendung konfiguriert ist, mit der Sie sich verbinden möchten. Dieser Schlüssel wird bei jeder Anfrage als X-API-KEY-Header gesendet.

    • OAuth 2.0 Client Credentials: Authentifiziert als eine Client-Anwendung, die beim App Builder-Autorisierungsserver registriert ist. Der Connector fordert ein Zugriffstoken von https://<hostname>/connect/token an und sendet es bei jeder Anfrage als Bearer-Token. Diese Option zeigt die folgenden Felder an:

      • Client ID: Geben Sie die Client-ID der registrierten Client-Anwendung ein.
      • Client Secret: Geben Sie das Client-Secret der registrierten Client-Anwendung ein.
      • Scope: Geben Sie den angeforderten Umfang ein. Der Standard ist api, wodurch der Zugriff auf von App Builder gehostete REST-APIs autorisiert wird.

  • Standardauthentifizierung: Authentifiziert sich mit HTTP-Standardauthentifizierung unter Verwendung des Identifiers und Schlüssels eines API-Schlüssels eines Benutzers. Diese Option zeigt die folgenden Felder:

    • Identifier: Geben Sie den Identifier des API-Schlüssels ein.
    • Schlüssel: Geben Sie den Schlüssel ein.

  • Anonym: Sendet Anfragen ohne Anmeldedaten. Verwenden Sie diese Option für eine Anwendung, deren REST-API keine Authentifizierung erfordert.

  • Anwendungsendpunkt: Wählen Sie den REST-API-Endpunkt der Jitterbit App Builder-Anwendung aus, mit der Sie sich verbinden möchten. Die Dropdown-Liste ist leer, bis Sie sie laden: Geben Sie zunächst den Hostname ein, wählen Sie eine Authentifizierungsoption aus, füllen Sie die darunter angezeigten Felder aus und klicken Sie dann auf Aktualisieren oberhalb der Dropdown-Liste. Die Dropdown-Liste zeigt dann nach Namen jede Anwendung auf Ihrem App Builder-Server an, die ein veröffentlichtes OpenAPI-Dokument besitzt; eine Anwendung ohne veröffentlichtes Dokument wird nicht angezeigt. Wenn ein erforderlicher Wert fehlt oder die Liste nicht abgerufen werden kann, beschreibt ein Dialog Daten konnten nicht abgerufen werden das Problem.

  • Test: Klicken Sie hier, um die Verbindung mit der angegebenen Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agent(en) in der Agent-Gruppe heruntergeladen, die der aktuellen Umgebung zugeordnet ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

    Hinweis

    Ein fehlgeschlagener Test bedeutet nicht immer, dass die Anmeldedaten falsch sind. Test überprüft die Verbindung in zwei Schritten. Zunächst wird das OpenAPI-Dokument der Anwendung abgerufen, um den Hostname und den Anwendungsendpunkt zu bestätigen, und dann wird einer der Endpunkte der Anwendung aufgerufen, um die Authentifizierungsdaten zu bestätigen. Wenn jeder Endpunkt in der Anwendung einen Element-Identifier in seinem Pfad erfordert (beispielsweise /customers/{id}), kann der zweite Schritt fehlschlagen, auch wenn die Anmeldedaten korrekt sind.

  • Speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder vorhandenen Konfiguration vorgenommen haben, klicken Sie hier, um die Konfiguration zu schließen, ohne zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine vorhandene Verbindungskonfiguration geöffnet haben, klicken Sie hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nach der Erstellung einer Jitterbit App Builder-Verbindung platzieren Sie einen Aktivitätstyp auf der Entwurfsfläche, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einer Operation bereitzustellen) oder als Ziele (um Daten in einer Operation zu verbrauchen) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und der Komponentenpalette des Entwurfs zugänglich. Einzelheiten finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Lesen: Ruft ein oder mehrere Elemente aus einem Objekt in der Jitterbit App Builder-Anwendung ab und soll als Quelle in einer Operation verwendet werden.

  • Erstellen: Erstellt ein neues Element für ein Objekt in der Jitterbit App Builder-Anwendung und soll als Ziel in einer Operation verwendet werden.

  • Aktualisieren: Aktualisiert ein vorhandenes Element für ein Objekt in der Jitterbit App Builder-Anwendung und soll als Ziel in einer Operation verwendet werden.

  • Delete: Löscht ein vorhandenes Element für ein Objekt in der Jitterbit App Builder-Anwendung und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.