Box-Verbindung
Einführung
Eine Box-Verbindung, die mit dem Box-Connector erstellt wurde, ermöglicht den Zugriff auf Box. Sobald eine Verbindung konfiguriert ist, können Instanzen von Box-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.
Erstellen oder Bearbeiten einer Box-Verbindung
Eine neue Box-Verbindung wird mit dem Box-Connector von einem dieser Standorte aus erstellt:
- Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
- Der Seite Globale Endpunkte (siehe Einen globalen Endpunkt erstellen in Globale Endpunkte).
Eine vorhandene Box-Verbindung kann von diesen Standorten aus bearbeitet werden:
- Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
- Der Registerkarte Komponenten im Projektbereich (siehe Aktionsmenü für Komponenten in Projektbereich Komponenten-Registerkarte).
- Der Seite Globale Endpunkte (siehe Einen globalen Endpunkt bearbeiten in Globale Endpunkte).
Konfigurieren einer Box-Verbindung
Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Box-Verbindung wird im Folgenden beschrieben.
Tipp
Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Symbol für Variablen klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.
-
Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Box-Verbindung eindeutig sein und darf keine Schrägstriche
/oder Doppelpunkte:enthalten. Dieser Name wird auch verwendet, um den Box-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht. -
Benutzer-ID: Geben Sie die zuvor für Ihre Anwendung gespeicherte Box-Benutzer-ID ein, die in [Voraussetzungen][Box Prerequisites] beschrieben ist.
-
Client-ID: Geben Sie die zuvor in der heruntergeladenen JSON-Datei gespeicherte Box-Client-ID ein, die in [Voraussetzungen][Box Prerequisites] beschrieben ist.
-
Client-Geheimnis: Geben Sie das zuvor in der heruntergeladenen JSON-Datei gespeicherte Box-Client-Geheimnis ein, das in [Voraussetzungen][Box Prerequisites] beschrieben ist.
-
Öffentliche Schlüssel-ID: Geben Sie die zuvor in der heruntergeladenen JSON-Datei gespeicherte Box-öffentliche Schlüssel-ID ein, die in [Voraussetzungen][Box Prerequisites] beschrieben ist.
-
Privater Schlüssel: Geben Sie den zuvor in der heruntergeladenen JSON-Datei gespeicherten Box-privaten Schlüssel ein, der in [Voraussetzungen][Box Prerequisites] beschrieben ist.
-
Passphrase: Geben Sie die zuvor in der heruntergeladenen JSON-Datei gespeicherte Box-Passphrase ein, die in [Voraussetzungen][Box Prerequisites] beschrieben ist.
-
Keep-alive-Strategie aktivieren: Wählen Sie diese Option, um zu verhindern, dass die Verbindung zwischen den Signalen für die in dem Feld Geben Sie die Zeit in Sekunden zwischen den Signalen ein, um die Verbindung aktiv zu halten angegebene Anzahl von Sekunden geschlossen wird.
-
Geben Sie die Zeit in Sekunden zwischen den Signalen ein, um die Verbindung aktiv zu halten: Wenn das Feld Keep-alive-Strategie aktivieren ausgewählt ist, geben Sie die Zeit in Sekunden zwischen den Signalen ein, um die Verbindung aktiv zu halten. Nur numerische Zeichen sind erlaubt.
-
Proxy-Einstellungen verwenden (nur privater Agent): Bei Verwendung eines privaten Agents kann diese Einstellung ausgewählt werden, um die Proxy-Einstellungen des privaten Agents zu verwenden.
-
Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Deaktivieren Sie die automatische Connector-Aktualisierung [Organisationsrichtlinie].
-
Änderungen speichern: Klicken Sie, um die Konfigurationsänderungen zu speichern und die Verbindung zu schließen.
-
Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.
-
Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung wirklich löschen möchten.
Nächste Schritte
Nachdem eine Box-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.
Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Design-Komponentenpalette zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.
Diese Aktivitäten können mit jedem Box API Objekt verwendet werden:
-
Suchen: Sucht nach übereinstimmenden Inhalten in Box und ist als Quelle in einem Vorgang gedacht.
-
Abfragen: 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 einer Operation gedacht.
-
Datei hochladen: Lädt eine Datei in Box hoch und ist als Ziel in einer Operation gedacht.
-
Datei aktualisieren: Aktualisiert eine Datei in Box und ist als Ziel in einer Operation gedacht.
-
Datei löschen: Löscht eine Datei von Box und ist als Ziel in einer Operation gedacht.