Box Connector für Jitterbit Integration Studio

Zusammenfassung

Der Box Connector stellt den Zugriff auf Box her.

Der Box-Connector bietet eine Schnittstelle zum Erstellen einer Box-Verbindung, der Grundlage zum Generieren von Instanzen von Box-Aktivitäten. Sobald diese Aktivitäten konfiguriert sind, interagieren sie über die Verbindung mit Box.

Der Zugriff auf den Box-Konnektor erfolgt über die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).

Connector-Übersicht

Dieser Connector wird verwendet, um zunächst eine Box-Verbindung zu konfigurieren. Mit dieser Verbindung verknüpfte Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zum Bereitstellen von Daten in einem Operation) oder Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden sollen.

Eine bestimmte Box-Verbindung und ihre Aktivitäten werden zusammen als Box Endpoint bezeichnet:

Diese Aktivitäten können mit jeder Box API verwendet werden Objekt:

• Suchen: Sucht nach übereinstimmenden Inhalten in Box und soll als Quelle in einer Operation verwendet werden.

• Abfrage: Fragt Objektdaten aus Box ab und ist zur Verwendung als Quelle in einer Operation vorgesehen.

• Erstellen: Erstellt Objektdaten in Box und ist zur Verwendung als Ziel in einer Operation vorgesehen.

• Löschen: Löscht Objektdaten aus der Box und ist zur Verwendung als Ziel in einer Operation vorgesehen.

• Kopieren: Kopiert eine Datei oder einen Ordner in Box und ist als Ziel in einem Operation vorgesehen.

• Aktualisieren: Aktualisiert Objektdaten in Box und soll als Ziel in einer Operation verwendet werden.

Diese Aktivitäten können nur mit Dateiobjekten verwendet werden:

• Datei herunterladen: Lädt eine Datei von Box herunter und soll als Quelle in einem Operation verwendet werden.

• Datei hochladen: Lädt eine Datei in Box hoch und soll als Ziel in einer Operation verwendet werden.

• Datei aktualisieren: Aktualisiert eine Datei in Box und soll als Ziel in einer Operation verwendet werden.

• Datei löschen: Löscht eine Datei aus Box und soll als Ziel in einer Operation verwendet werden.

Voraussetzungen und unterstützte API Versionen

Der Box Connector erfordert die Verwendung eines Agenten der Version 10.1 oder höher. Diese Agentversionen laden bei Bedarf automatisch die neueste Version des Connectors herunter.

Der Box Connector verwendet das Box Java SDK v2.28.1 und Box API. Informationen zu den Schema und -feldern finden Sie in der Dokumentation.

Um den Box Connector zu verwenden, benötigen Sie Folgendes, wie unter Box-Voraussetzungen beschrieben:

• Eine autorisierte benutzerdefinierte Box-App mit JWT-Authentifizierung.
• Der clientID, clientSecret, publicKeyID, privateKey, Und passphrase aus der JSON-Datei, die bei der App-Erstellung automatisch heruntergeladen wird.
• Die mit der App verknüpfte Benutzer-ID.

Fehlerbehebung

Wenn Sie Probleme mit dem Box-Connector haben, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

1. Klicken Sie in der Verbindungskonfiguration auf die Schaltfläche Test, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren).

2. Überprüfen Sie die Operation für alle Informationen, die während der Ausführung der Operation geschrieben werden.

3. Aktivieren Sie die debuggen für Operation (für Cloud-Agenten oder für private Vertreter), um zusätzliche Protokolldateien und Daten zu generieren.

4. Wenn Sie private Agenten verwenden, können Sie Connector Verbose Logging aktivieren für diesen Connector unter Verwendung dieses spezifischen Konfigurationseintrags mit Loggername und -ebene:

   <logger name="org.jitterbit.connector.verbose.logging.box" level="DEBUG"/>
   

5. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle überprüfen für weitere Informationen.

6. Weitere Hinweise zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Vorgängen.