Zum Inhalt springen

Box-Connector in Jitterbit Studio

Zusammenfassung

Der Box-Connector stellt Zugriff auf Box bereit.

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

Man greift auf den Box-Connector über die Registerkarte Project endpoints and connectors (Projektendpunkte und Connectoren) der Palette der Designkomponenten zu (siehe Design component palette).

Connector-Übersicht

Dieser Connector dient zunächst zum Konfigurieren einer Box-Verbindung. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann verwendet, um Aktivitätsinstanzen zu erstellen, die als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder Ziele (zur Verarbeitung von Daten in einem Vorgang) verwendet werden sollen.

Zusammen werden eine bestimmte 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:

  • Search: Sucht nach übereinstimmenden Inhalten in Box und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

  • Query: Fragt Objektdaten aus Box ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

  • Create: Erstellt Objektdaten in Box und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Delete: Löscht Objektdaten aus Box und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Copy: Kopiert eine Datei oder einen Ordner in Box und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Update: Aktualisiert Objektdaten in Box und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

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

  • Download File: Lädt eine Datei aus Box herunter und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

  • Upload File: Lädt eine Datei in Box hoch und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Update File: Aktualisiert eine Datei in Box und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Delete File: Löscht eine Datei aus Box und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf Ihre Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

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 Sie diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update aussetzen.

Der Box-Connector verwendet die Box-API. Weitere Informationen zu den Schemaknoten und Feldern finden Sie in der Dokumentation.

Um den Box-Connector zu verwenden, benötigen Sie Folgendes, wie in 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 wird.
  • Die mit der App verknüpfte Benutzer-ID.

Fehlerbehebung

Wenn Probleme mit dem Box-Connector auftreten, werden diese Schritte zur Fehlerbehebung 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 Agent heruntergeladen wird (sofern die Organisationsrichtlinie Disable Auto Connector Update nicht verwendet wird).

  2. Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.

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

  4. Bei Verwendung von privaten Agenten können Sie das ausführliche Connector-Logging für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag zur logback.xml-Datei Ihres privaten Agenten hinzufügen:

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

    Weitere Informationen zum ausführlichen Connector-Logging finden Sie unter Ausführliches Logging für Connectors mit privaten Jitterbit-Agenten.

  5. Bei Verwendung von privaten Agenten können Sie die Agent-Protokolle überprüfen, um weitere Informationen zu erhalten.

  6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.