Zum Inhalt springen

Box-Connector für Jitterbit Integration Studio

Zusammenfassung

Der Box-Connector ermöglicht den Zugriff auf Box.

Der Box-Connector bietet eine Schnittstelle zur Erstellung einer Box-Verbindung, die als Grundlage für die Generierung von Instanzen von Box-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Box.

Der Box-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine Box-Verbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einem Vorgang bereitzustellen) oder Ziele (um Daten in einem Vorgang zu konsumieren) gedacht sind.

Zusammen werden eine spezifische Box-Verbindung und ihre Aktivitäten als Box-Endpunkt bezeichnet:

Box-Aktivitätstypen

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

  • Suche: Sucht nach übereinstimmenden Inhalten in Box und ist als Quelle in einem Vorgang gedacht.

  • Abfrage: Abfragt Objektdaten aus Box und ist als Quelle in einem Vorgang gedacht.

  • Erstellen: Erstellt Objektdaten in Box und ist als Ziel in einem Vorgang gedacht.

  • Löschen: Löscht Objektdaten aus Box und ist als Ziel in einem Vorgang gedacht.

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

  • Aktualisieren: Aktualisiert Objektdaten in Box und ist als Ziel in einem Vorgang gedacht.

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

  • Datei herunterladen: Lädt eine Datei von Box herunter und ist als Quelle in einem Vorgang gedacht.

  • Datei hochladen: Lädt eine Datei in Box hoch und ist als Ziel in einer Operation vorgesehen.

  • Datei aktualisieren: Aktualisiert eine Datei in Box und ist als Ziel in einer Operation vorgesehen.

  • Datei löschen: Löscht eine Datei aus Box und ist als Ziel in einer Operation vorgesehen.

Hinweis

Dieser Connector ist ein Connector SDK-basierter Connector, auf den Jitterbit möglicherweise verweist, wenn Änderungen an mit dem Connector SDK erstellten Connectors kommuniziert werden.

Endpunkte, die mit diesem Connector erstellt wurden, sind in Endpunktnutzungsberichten enthalten und zählen zu Ihrer Lizenz.

Voraussetzungen und unterstützte API-Versionen

Der Box-Connector erfordert die Verwendung einer Agenten-Version 10.1 oder höher. Diese Agenten-Versionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

Der Box-Connector verwendet die Box API. Konsultieren Sie die Dokumentation für Informationen zu den Schema-Knoten und -Feldern.

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

  • Eine autorisierte Box-Custom-App mit JWT-Authentifizierung.
  • Die clientID, clientSecret, publicKeyID, privateKey und passphrase aus der JSON-Datei, die während der App-Erstellung automatisch heruntergeladen wurde.
  • Die Benutzer-ID, die mit der App verknüpft ist.

Fehlersuche

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

  1. Klicken Sie 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 (es sei denn, Sie verwenden die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren).

  2. Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

  3. Aktivieren Sie das Debug-Protokoll für den Vorgang (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Wenn Sie private Agenten verwenden, können Sie das ausführliche Protokoll für den Connector für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:

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

    Weitere Informationen zum ausführlichen Protokoll für Connectoren finden Sie unter Ausführliches Protokoll für Connectoren, die Jitterbit private Agenten verwenden.

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

  6. Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlerbehebung bei Vorgängen.