Zum Inhalt springen

Verwandeln Sie Ihre Kontakte in Urlaubsgeld mit unserem neuen Kundenempfehlungsprogramm! Erfahren Sie mehr

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, die die Grundlage für die Generierung von Instanzen von Box-Aktivitäten bildet. Nach der Konfiguration interagieren diese Aktivitäten ü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 Anschluss dient dazu, 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 einer Operation) oder Ziele (zum Verbrauchen von Daten in einer Operation) verwendet werden sollen.

Zusammen werden eine bestimmte Box-Verbindung und ihre Aktivitäten als Box Endpoint bezeichnet:

Box-Aktivitätstypen

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

  • Suchen: Sucht nach übereinstimmenden Inhalten in Box und ist für die Verwendung als Quelle in einer Operation vorgesehen.

  • Abfrage: Fragt Objektdaten von 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 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 einer Operation vorgesehen.

  • Aktualisieren: Aktualisiert Objektdaten in Box und ist zur Verwendung als Ziel in einer Operation vorgesehen.

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

  • Datei herunterladen: Lädt eine Datei von Box herunter und soll als Quelle in einer 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.

Hinweis

Dieser Konnektor ist ein Konnektor-SDK-basierter Konnektor, auf den Jitterbit bei der Kommunikation von Änderungen an mit dem Connector SDK erstellten Konnektoren verweisen kann.

Voraussetzungen und unterstützte API Versionen

Der Box Connector erfordert die Verwendung eines Agenten der Version 10.1 oder höher. Diese Agent-Versionen 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 in 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 Protokollierung für Operation (für Cloud-Agenten oder für private Vertreter), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Bei Verwendung privater Agenten können Sie die ausführliche Protokollierung des Connectors aktivieren für diesen Connector unter Verwendung des folgenden Konfigurationseintrags für 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 im Betrieb.