Jitterbit App Builder-Connector in Jitterbit Studio

Zusammenfassung

Der Jitterbit App Builder-Connector stellt Zugriff auf eine Jitterbit App Builder-Anwendung bereit, die als REST-API veröffentlicht wurde.

Der Jitterbit App Builder-Connector bietet eine Schnittstelle zum Erstellen einer Jitterbit App Builder-Verbindung, die Grundlage für die Generierung von Instanzen von Jitterbit App Builder-Aktivitäten. Diese Aktivitäten interagieren nach der Konfiguration über die Verbindung mit der Jitterbit App Builder-Anwendung.

Auf den Jitterbit App Builder-Connector greift man über die Registerkarte Projektendpunkte und Connectors in der Palette des Designkomponenten zu (siehe Designkomponentenpalette).

Connector-Übersicht

Mit diesem Connector wird zunächst eine Jitterbit App Builder-Verbindung konfiguriert. Die Aktivitätstypen, die dieser Verbindung zugeordnet sind, werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) gedacht sind.

Eine bestimmte Jitterbit App Builder-Verbindung und ihre Aktivitäten zusammen werden als Jitterbit App Builder-Endpunkt bezeichnet:

• Lesen: Ruft ein oder mehrere Elemente von einem Objekt in der Jitterbit App Builder-Anwendung ab und ist als Quelle in einem Vorgang gedacht.

• Erstellen: Erstellt ein neues Element für ein Objekt in der Jitterbit App Builder-Anwendung und ist als Ziel in einem Vorgang gedacht.

• Aktualisieren: Aktualisiert ein vorhandenes Element für ein Objekt in der Jitterbit App Builder-Anwendung und ist als Ziel in einem Vorgang gedacht.

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

Mit diesem Connector erstellte Endpunkte sind von der Endpunkt-Nutzungsberichterstellung und von deinem Lizenzbeitrag ausgeschlossen.

Voraussetzungen und unterstützte API-Versionen

Die folgenden Voraussetzungen gelten für den Jitterbit App Builder-Connector:

• Veröffentliche die App in deiner Jitterbit App Builder-Anwendung als REST-API-Endpunkt und veröffentliche ein OpenAPI (Swagger)-Dokument für diese REST-API. Der Jitterbit App Builder-Connector nutzt dieses Dokument, um die verfügbaren Objekte und Vorgänge der Anwendung zu ermitteln.

  Hinweis

  Ein Objekt oder Vorgang, das bzw. der von der veröffentlichten Dokumentation ausgeschlossen ist, wird nicht in den Auswahlzellen des Connectors für Objekte und Vorgänge angezeigt.

• Konfiguriere die Authentifizierung auf der REST-API der Jitterbit App Builder-Anwendung so, dass sie der Option Authentifizierung der Verbindung entspricht, und sammle die erforderlichen Anmeldedaten. Konfiguriere beispielsweise für die Option API-Schlüssel die API-Schlüssel-Authentifizierung und generiere einen API-Schlüssel. Weitere Informationen findest du unter Jitterbit App Builder-Verbindung.

• Wenn die Datenquelle der Anwendung rollenbasierte Autorisierung nutzt, muss der App Builder-Benutzer, als der die Verbindung authentifiziert wird, einer Gruppe mit einer Rolle angehören, die die Berechtigung vergibt, die jede Aktivität für die Objekte benötigt, die sie nutzt. Der Benutzer ist der Eigentümer der Anmeldedaten in den Authentifizierungseinstellungen der Verbindung:

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können diese Updates mit der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren organization policy ausgesetzt werden.

Fehlerbehebung

Falls bei der Verwendung des Jitterbit App Builder Connectors Probleme auftreten, werden folgende Schritte zur Fehlerbehebung empfohlen:

1. Klicke auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (außer bei Verwendung der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren organization policy). Siehe den Hinweis unter Test in Jitterbit App Builder-Verbindung für einen Fall, in dem ein fehlgeschlagener Test nicht unbedingt bedeutet, dass die Anmeldedaten falsch sind.

2. Falls eine Aktivität für ein Objekt fehlschlägt, das die Verbindung anderweitig erreichen kann, stelle sicher, dass der App Builder-Benutzer, als der sich die Verbindung authentifiziert, die Rollenberechtigung hat, die die Aktivität für dieses Objekt erfordert.

3. Überprüfe die Vorgangsprotokolle auf alle Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

4. Aktiviere das Debug-Protokollieren von Vorgängen (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

5. Bei Verwendung privater Agenten kannst du das ausführliche Protokollieren von Connectors für diesen Connector aktivieren, indem du diesen Logger-Konfigurationseintrag zur Datei logback.xml deines privaten Agenten hinzufügst:

   <logger name="org.jitterbit.connector.appbuilder" level="DEBUG"/>
   

   Weitere Informationen zum ausführlichen Protokollieren von Connectors findest du unter Ausführliches Protokollieren für Connectors mit privaten Jitterbit-Agenten.

6. Bei Verwendung privater Agenten kannst du die Agent-Protokolle überprüfen, um weitere Informationen zu erhalten.

7. Weitere Überlegungen zur Fehlerbehebung findest du unter Fehlerbehebung für Vorgänge.