Dropbox
In einem Adobe Workfront Fusion-Szenario können Sie Workflows automatisieren, die Dropbox oder Dropbox Business verwenden, und diese mit mehreren Anwendungen und Services von Drittanbietern verbinden. Auf diese Weise können Sie Aktivitäten wie das Überwachen, Suchen, Abrufen, Auflisten, Erstellen und Bearbeiten von Dateien und Ordnern in Ihrer Dropbox automatisieren.
Anweisungen zum Erstellen eines Szenarios finden Sie in den Artikeln unter Szenarios erstellen: Artikelindex.
Informationen zu Modulen finden Sie in den Artikeln unter Module: Artikelindex.
Zugriffsanforderungen
Sie müssen über folgenden Zugriff verfügen, um die Funktion in diesem Artikel verwenden zu können:
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront-Paket | Beliebig |
| Adobe Workfront-Lizenz |
Neu: Standard Oder Aktuell: Arbeit oder höher |
| Lizenz für Adobe Workfront Fusion** |
Aktuell: Keine Workfront Fusion-Lizenzanforderung Oder Legacy: Workfront Fusion für Arbeitsautomatisierung und -integration |
| Produkt |
Neu:
Oder Aktuell: Ihr Unternehmen muss Adobe Workfront Fusion erwerben. |
Weitere Informationen zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation.
Informationen zu Adobe Workfront Fusion-Lizenzen finden Sie unter Adobe Workfront Fusion-Lizenzen.
Voraussetzungen
- Um Dropbox-Module verwenden zu können, müssen Sie über ein Dropbox-Konto verfügen.
- Um den Dropbox-Connector verwenden zu können, müssen Sie zunächst ein Programm in Dropbox erstellen.
> Weitere Informationen finden Sie unter „Erstellen einer Anwendung“ im Dropbox-Entwicklerhandbuch. - Verwenden Sie beim Erstellen des Programms den folgenden Umleitungs-URI:
https://app.workfrontfusion.com/oauth/cb/dropbox - Dropbox muss Programme mit mehr als 50 Benutzern genehmigen.
> Weitere Informationen finden Sie unter „Produktionsgenehmigung“ im Dropbox-Entwicklerhandbuch.
Dropbox-API-Informationen
Der Dropbox-Connector verwendet Folgendes:
Erstellen einer Verbindung zu Dropbox
So erstellen Sie eine Verbindung für Ihre Dropbox:
-
Klicken Sie in einem beliebigen Modul Hinzufügen neben dem Feld Verbindung .
-
Füllen Sie die folgenden Felder aus:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header Verbindungsname Geben Sie einen Namen für diese Verbindung ein. Umgebung Wählen Sie aus, ob diese Verbindung für eine Produktions- oder Nicht-Produktionsumgebung vorgesehen ist. Typ Wählen Sie aus, ob Sie eine Verbindung zu einem Service-Konto oder einem persönlichen Konto herstellen möchten. Client-ID Geben Sie Ihre Dropbox Client-ID ein. Client-Geheimnis Geben Sie Ihren Dropbox Client Secret ein. Kontotyp Wählen Sie aus, ob Sie eine Verbindung zu einem persönlichen Dropbox-Konto oder einem Geschäftskonto (Dropbox Business) herstellen möchten. exclude dropbox-api-path-root header Aktivieren Sie diese Option, um die Kopfzeile „dropbox-api-path-root“ für Dropbox-Apps mit Zugriff auf den Programmordner auszuschließen -
Klicken Sie Fortfahren, um die Verbindung zu speichern und zum Modul zurückzukehren.## Dropbox Module und ihre Felder
Dropbox Module und ihre Felder
Beim Konfigurieren von Dropbox zeigt Workfront Fusion die unten aufgeführten Felder an. Darüber hinaus können abhängig von Faktoren wie Ihrer Zugriffsebene in der App oder dem Service weitere Dropbox angezeigt werden. Ein fett gedruckter Titel in einem Modul gibt ein erforderliches Feld an.
Wenn die Zuordnungsschaltfläche über einem Feld oder einer Funktion angezeigt wird, können Sie damit Variablen und Funktionen für dieses Feld festlegen. Weitere Informationen finden Sie unter Zuordnen von Informationen von einem Modul zu einem anderen.
Trigger-Module
Dateien ansehen
Dieses Ordnertypmodul gibt Dateidetails zurück, wenn die Trigger in einem angegebenen Ordner geändert wird.
Module zum Abrufen Dropbox Dateien und Ordner
Datei herunterladen
Dieses Aktionsmodul lädt eine Datei aus einem Ordner herunter.
Sie geben die Datei und ihren Speicherort an.
Das Modul gibt die ID der Datei und aller zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Abrufen von Ordnermetadaten
Dieses Aktionsmodul ruft Details zum freigegebenen Ordner ab.
Sie geben die ID des Ordners an.
Das Modul gibt die ID des Ordners und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Listet alle Dateien/Unterordner in einem Ordner auf
Dieses Aktionsmodul listet Dateien oder Ordner in einem bestimmten Ordner auf.
Sie geben die ID des Ordners an.
Das Modul gibt die IDs der Dateien oder Ordner und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Dateiversionen auflisten
Dieses Aktionsmodul ruft alle Dateirevisionen (einen Versionsverlauf) einer bestimmten Datei ab.
Sie geben die ID der Datei an.
Das Modul gibt alle Standardfelder zurück, die mit dem Datensatz verknüpft sind, sowie alle benutzerdefinierten Felder und Werte, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Dateien/Ordner suchen
Dieses Suchmodul sucht in einem -Objekt nach Datensätzen, Dropbox mit der angegebenen Suchanfrage übereinstimmen.
Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Module zum Erstellen und Bearbeiten von Dropbox Dateien und Ordnern
Erstellen eines Ordners
Dieses Aktionsmodul erstellt einen neuen Ordner.
Sie geben den Pfad und einen Namen für den Ordner an.
Das Modul gibt die ID des Ordners und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Erstellen/Überschreiben einer Textdatei
Dieses Aktionsmodul erstellt eine DOC-Datei oder überschreibt den Inhalt einer vorhandenen.
Sie geben die Quelldatei und den Ordner an.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Erstellen/Aktualisieren eines Freigabe-Links
Dieses Aktionsmodul erstellt einen öffentlichen Link zu einer Datei.
Sie geben die Datei und Informationen zum Link an.
Das Modul gibt die ID des Links und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Löschen einer Datei/eines Ordners
Dieses Aktionsmodul löscht eine Datei oder einen Ordner.
Sie geben die Datei oder den Ordner an.
Das Modul gibt die ID des Datensatzes und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Verschieben einer Datei/eines Ordners
Dieses Aktionsmodul verschiebt eine Datei oder einen Ordner an einen anderen Speicherort.
Sie legen die Datei oder den Ordner sowie die Art und Weise und den Ort des Verschiebens fest.
Das Modul gibt die ID der Datei oder des Ordners und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Datei/Ordner umbenennen
Dieses Aktionsmodul benennt eine Datei oder einen Ordner um.
Geben Sie die Datei bzw. den Ordner und den neuen Namen an.
Das Modul gibt die ID der Datei oder des Ordners und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Datei wiederherstellen
Dieses Aktionsmodul stellt eine frühere Version einer Datei wieder her.
Sie geben die Datei und die Nummer der Revision an, die Sie benötigen.
Das Modul gibt die ID der Version und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Datei hochladen
Dieses Aktionsmodul lädt eine Datei in einen Ordner hoch.
Sie geben Informationen wie den Speicherort für die Datei, die Datei, die Sie hochladen möchten, und einen optionalen neuen Namen für die Datei an.
Das Modul gibt die ID der Datei und aller zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Andere Module
Erstellen eines API-Aufrufs
Mit diesem Aktionsmodul können Sie einen benutzerdefinierten authentifizierten Aufruf an die Dropbox-API durchführen. Auf diese Weise können Sie eine Datenflussautomatisierung erstellen, die von den anderen Dropbox nicht durchgeführt werden kann.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
https://api.dropboxapi.com einzugeben. Beispiel: /2/files/list_folderFügen Sie den Hauptteil des Inhalts für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.
Hinweis:
Wenn Sie bedingte Anweisungen wie if in Ihrer JSON-Datei verwenden, setzen Sie die Anführungszeichen außerhalb der bedingten Anweisung.
Beispiel:
Der folgende API-Aufruf gibt die ersten 10 Dateien aus dem /Text files Ordner in Ihrem Dropbox-Konto zurück:
URL: /2/files/list_folder
Textkörper:
{
"path": "/Text files",
"limit": 10,
"recursive": false,
"include_deleted": false
}
Treffer der Suche finden Sie in der Modulausgabe unter Bundle > Body > Einträge.
In unserem Beispiel wurden 10 Tickets zurückgegeben.
Häufige Probleme
Datei kann nicht hochgeladen oder aktualisiert werden
Das Hochladen oder Aktualisieren einer Datei kann aus folgenden Gründen fehlschlagen:
- Die hochgeladene Datei ist zu groß und überschreitet die für Ihren Dropbox maximal zulässige Dateigröße. Andernfalls haben Sie das Speicherkontingent Ihres Dropbox-Kontos vollständig ausgeschöpft. Sie müssen vorhandene Dateien aus Ihrem Dropbox löschen oder Ihren Plan aktualisieren.
- Der zuvor ausgewählte Ordner, in den die Datei hochgeladen wird, existiert nicht mehr. Das Szenario stoppt und Sie müssen den Zielordner erneut auswählen.
Über einen freigegebenen Link referenziertes Bild wird nicht gerendert
Die von Dropbox >Freigegebenen Link erstellen zurückgegebene URL verweist nicht direkt auf ein Bild, sondern auf eine Dropbox. Um das Herunterladen des Bildes zu erzwingen, ersetzen Sie die nachfolgende ?dl=0 durch ?dl=1. Um das Rendern des Bildes zu erzwingen (z. B. in einem Webbrowser oder in Facebook Messenger), hängen Sie &raw=1 an die URL an.
Wenn Sie den direkten oder unformatierten Link Ihres Bildes für Ihre Website oder für andere Workfront Fusion-Module abrufen müssen, müssen Sie die anfängliche freigegebene URL wie folgt ändern:
Ursprüngliche URL:
https://www.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png?dl=0
wwwdurchdlersetzen.?dl=0entfernen.
Endgültige URL:
https://dl.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png
Um die URL automatisch zu ändern, können Sie die Funktion replace() zweimal verwenden:
-
Ersetzen Sie www durch dl
-
Und ?dl=0 entfernen
Um dies in einem Schritt zu tun, kombinieren Sie diese Funktionen:
Sie können sie auch kopieren und in das Feld einfügen. Ersetzen Sie 1.url durch die URL .
{{replace(replace(1.url; "?dl=0"; ""); "www"; "dl")}}