Dropbox moduler

I ett Adobe Workfront Fusion-scenario kan du automatisera arbetsflöden som använder Dropbox eller Dropbox Business, samt ansluta det till flera tredjepartsprogram och -tjänster. På så sätt kan du automatisera aktiviteter som övervakning, sökning, hämtning, listning, skapande och redigering av filer och mappar i Dropbox .

Instruktioner om hur du skapar ett scenario finns i artiklarna under Skapa scenarier: artikelindex.

Mer information om moduler finns i artiklarna under Moduler: artikelindex.

Åtkomstkrav

Expandera om du vill visa åtkomstkrav för funktionerna i den här artikeln.

Du måste ha följande åtkomst för att kunna använda funktionerna i den här artikeln:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront package Alla
Adobe Workfront-licens

Nytt: Standard

eller

Aktuell: Arbete eller högre

Adobe Workfront Fusion-licens**

Aktuell: Inga Workfront Fusion-licenser krävs

eller

Äldre: Workfront Fusion for Work Automation and Integration

Produkt

Nytt:

  • Select or Prime Workfront package: Your organization must purchase Adobe Workfront Fusion.
  • Ultimate Workfront-paket: Workfront Fusion ingår.

eller

Aktuell: Din organisation måste köpa Adobe Workfront Fusion.

Mer information om informationen i den här tabellen finns i Åtkomstkrav i dokumentationen.

Mer information om Adobe Workfront Fusion-licenser finns i Adobe Workfront Fusion-licenser.

Förutsättningar

  • Du måste ha ett Dropbox-konto för att kunna använda Dropbox-moduler.
IMPORTANT
  • Om du vill använda Dropbox-anslutningen måste du först skapa ett program i Dropbox.
    ​> Om du vill ha mer information kan du söka efter"Skapa ett program" i utvecklarhandboken för Dropbox.
  • Använd följande omdirigerings-URI när du skapar programmet: https://app.workfrontfusion.com/oauth/cb/dropbox
  • Dropbox måste godkänna program med fler än 50 användare.
    ​> Mer information finns i"Produktionsgodkännande" i utvecklarhandboken för Dropbox.

Dropbox API-information

Dropbox Connector använder följande:

Bas-URL
https://api.dropboxapi.com/2
API-version
2
API-tagg
  • Dropbox

    v5.3.9

  • Dropbox Business

    v1.0.12

Skapa en anslutning till Dropbox

Så här skapar du en anslutning för dina Dropbox-moduler:

  1. Klicka på Add bredvid rutan Anslutning i någon av modulerna.

  2. Fyll i följande fält:

    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
    Connection name Ange ett namn för anslutningen.
    Environment Ange om den här anslutningen är avsedd för en produktionsmiljö eller icke-produktionsmiljö.
    Type Ange om du ansluter till ett tjänstkonto eller ett personligt konto.
    Client ID Ange din Dropbox Client ID.
    Client Secret Ange din Dropbox Client Secret.
    Account Type Ange om du ansluter till ett personligt Dropbox-konto eller ett företagskonto (Dropbox Business).
    Exclude dropbox-api-path-root header Aktivera det här alternativet om du vill exkludera dropbox-api-path-root header för Dropbox-appar med appmappåtkomst
  3. Klicka på Continue för att spara anslutningen och återgå till modulen.## Dropbox moduler och deras fält

Dropbox-moduler och deras fält

När du konfigurerar Dropbox-moduler visas fälten som listas nedan i Workfront Fusion. Dessutom kan ytterligare Dropbox fält visas, beroende på faktorer som din åtkomstnivå i appen eller tjänsten. En rubrik med fet stil i en modul visar ett obligatoriskt fält.

Om du ser kartknappen ovanför ett fält eller en funktion kan du använda den för att ange variabler och funktioner för det fältet. Mer information finns i Mappa information från en modul till en annan.

Växla karta

Utlösarmoduler

Watch Files

Den här modulen för utlösare returnerar filinformation när filen i en angiven mapp ändras.

Connection
Instruktioner om hur du ansluter ditt Dropbox-konto till Workfront Fusion finns i Skapa en anslutning till Dropbox i den här artikeln.
Folder
Markera mappen som du vill bevaka ändringar i.
Watch also subfolders
Aktivera det här alternativet om du även vill övervaka undermappar i den valda mappen för ändrade filer.
Limit
Ange eller mappa det maximala antal poster som du vill att modulen ska returnera under varje körningscykel för scenario.

Moduler för att hämta Dropbox filer och mappar

Download a File

Den här åtgärdsmodulen hämtar en fil från en mapp.

Du anger filen och dess plats.

Modulen returnerar filens ID och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

NOTE
Den här modulen är användbar när du vill skicka filer till efterföljande moduler.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Dropbox-konto till Workfront Fusion finns i Skapa en anslutning till Dropbox i den här artikeln.
Olika sätt att välja filer
Välj om du vill mappa filsökvägen eller markera filen manuellt.
Filsökväg/fil

Filsökväg

Ange eller mappa målsökvägen till filen.

Fil

Välj filen på menyn.

Get a Folder Metadata

Den här åtgärdsmodulen hämtar information om delade mappar.

Du anger mappens ID.

Modulen returnerar ID:t för mappen och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Dropbox-konto till Workfront Fusion finns i Skapa en anslutning till Dropbox i den här artikeln.
ID för delad mapp
Ange eller mappa ID:t för mappen som du vill hämta information om.

List All Files/Subfolders in a Folder

Den här åtgärdsmodulen visar filer eller mappar i en viss mapp.

Du anger mappens ID.

Modulen returnerar ID:n för filerna eller mapparna och eventuella associerade fält, tillsammans med anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Dropbox-konto till Workfront Fusion finns i Skapa en anslutning till Dropbox i den här artikeln.
Lista
Välj om du vill hämta filer eller mappar.
Visa endast hämtningsbara filer
Aktivera det här alternativet om du bara vill returnera hämtningsbara filer. Det går inte att hämta vissa filtyper, till exempel Google Docs.
Mapp
Ange eller mappa mappen som du vill hämta filer eller mappar från.
Gräns
Ange eller mappa det maximala antal poster som du vill att modulen ska visa under varje körningscykel för scenario.

List File Revisions

Den här åtgärdsmodulen hämtar alla filversioner (en versionshistorik) av en viss fil.
Du anger filens ID.

Modulen returnerar alla standardfält som är associerade med posten, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Dropbox-konto till Workfront Fusion finns i Skapa en anslutning till Dropbox i den här artikeln.
Olika sätt att välja filer
Välj om du vill mappa filsökvägen eller markera filen manuellt.
Filsökväg/fil

Filsökväg

Ange eller mappa målsökvägen till filen.

Fil

Välj filen på menyn.

Gräns
Ange eller mappa det maximala antal poster som du vill att modulen ska visa under varje körningscykel för scenario.

Search Files/Folders

Den här sökmodulen söker efter poster i ett objekt i Dropbox som matchar den sökfråga du anger.

Du kan mappa den här informationen i efterföljande moduler i scenariot.

Connection
Instruktioner om hur du ansluter ditt Dropbox-konto till Workfront Fusion finns i Skapa en anslutning till Dropbox i den här artikeln.
Search
Ange söktermen.
Folder
Markera mappen som du vill söka i. Den här modulen söker igenom hela Dropboxkontot om du inte väljer någon mapp.
Filstatus
Välj den filstatus som du vill ta med i sökningen.
Filkategorier
Markera de filkategorier som du vill ta med i sökningen.
Filtillägg
För varje filtillägg som du vill inkludera i sökningen klickar du på Lägg till objekt och anger eller mappar filtillägget.
Gräns
Ange eller mappa det maximala antal poster som du vill att modulen ska returnera under varje körningscykel för scenario.

Moduler för att skapa och redigera Dropbox filer och mappar

Create a Folder

Den här åtgärdsmodulen skapar en ny mapp.

Du anger sökvägen och ett namn för mappen.

Modulen returnerar ID:t för mappen och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Dropbox-konto till Workfront Fusion finns i Skapa en anslutning till Dropbox i den här artikeln.
Folder Name
Ange namnet på den nya mappen.
Folder

Ange eller mappa sökvägen där du vill skapa en ny mapp.

Obs!

Om du använder ett Dropbox Business-konto (med grupputrymmen) måste du ta bort snedstrecket / eller inte klicka Klicka här om du vill välja mappen och skapa en gruppmapp i roten.

Om snedstrecket inte tas bort returneras felet [409] path/malformed_path/...

Auto rename
Aktivera det här alternativet om du vill byta namn på den nya mappen, om det redan finns en mapp med samma namn på målplatsen.

Create/Overwrite a Text File

Den här åtgärdsmodulen skapar en DOC-fil eller skriver över innehållet i en befintlig.

Du anger källfilen och mappen.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Dropbox-konto till Workfront Fusion finns i Skapa en anslutning till Dropbox i den här artikeln.
Select to

Välj om du vill skapa eller skriva över en DOC-fil.

  • Skapa Välj den mapp där du vill skapa en fil.

  • Skriv över

    Välj hur du vill välja vilken fil som ska skrivas över och mappa sedan filsökvägen eller markera filen.

Source File

Välj en källfil från en tidigare modul eller mappa källfilens innehåll.

Om du skapar en fil väljer du Tom.

Den här åtgärdsmodulen skapar en offentlig länk till en fil.

Du anger filen och information om länken.

Modulen returnerar länkens ID och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Dropbox-konto till Workfront Fusion finns i Skapa en anslutning till Dropbox i den här artikeln.
Way of selecting files
Välj om du vill mappa eller ange filsökvägen eller markera filen manuellt.
File Path / File

File Path

Ange eller mappa sökvägen till målfilen.

File

Markera målfilen.

Requested Visibility

Ange om länken är offentlig, för team eller om lösenordet är begränsat.

Obs!

Team only är bara tillgängligt för Dropbox Business-konton. Access with password är bara tillgängligt för Dropbox Pro- eller Dropbox Business-konton.

Link's Expiration Date
Ange det datum och den tidpunkt då länken upphör att gälla och inte längre är tillgänglig. Om fältet lämnas tomt upphör länken inte att gälla. En lista över vilka datum- och tidsformat som stöds finns i Typtvång.
Link's Access Level

Ange behörighet för länkmottagaren.

  • Viewer

    Användare som använder länken kan visa och kommentera innehållet.

  • Editor

    Användare som använder länken kan redigera, visa och kommentera innehållet. Den här åtkomstnivån är endast tillgänglig för molnbaserade dokument.

  • Max

    Användare som använder länken får den maximala åtkomstnivå som du kan ange länken till.

Delete a File/Folder

Den här åtgärdsmodulen tar bort en fil eller mapp.

Du anger filen eller mappen.

Modulen returnerar postens ID och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Dropbox-konto till Workfront Fusion finns i Skapa en anslutning till Dropbox i den här artikeln.
Way of selecting files
Välj om du vill mappa eller ange filsökvägen eller markera filen manuellt.
File or Folder Path / File or Folder

File/Folder Path

Ange eller mappa målsökvägen till filen eller mappen.

File/Folder

Markera filen eller mappen på menyn.

Move a File/Folder

Den här åtgärdsmodulen flyttar en fil eller mapp till en annan plats.

Du anger filen eller mappen och hur och var du vill flytta den.

Modulen returnerar ID:t för filen eller mappen och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Dropbox-konto till Workfront Fusion finns i Skapa en anslutning till Dropbox i den här artikeln.
Way of selecting files / folders
Välj om du vill mappa eller ange fil- eller mappsökvägen, eller markera filen eller mappen manuellt.
File / Folder Path /

File/Folder Path

Ange eller mappa målsökvägen till filen eller mappen.

File/Folder

Ange om du flyttar en fil eller mapp, sedan filen eller mappen.

To Folder
Ange eller mappa målplatsen för filen eller mappen.
New Name
Ange det nya namnet på filen eller mappen på den nya platsen.
Auto Rename
Aktivera det här alternativet om du vill försäkra dig om att om det finns en fil eller mapp med samma namn så byter modulen namn på den nya filen eller mappen genom att lägga till (NUMBER) efter fil- eller mappnamnet. Annars skrivs filen eller mappen på målplatsen över.
Allow ownership transfer
Aktivera det här alternativet om du vill tillåta flyttning efter ägare, även om det skulle leda till en ägaröverföring för innehållet som flyttas.

Rename a File/Folder

Den här åtgärdsmodulen byter namn på en fil eller mapp.

Du anger filen eller mappen och det nya namnet.

Modulen returnerar ID:t för filen eller mappen och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Dropbox-konto till Workfront Fusion finns i Skapa en anslutning till Dropbox i den här artikeln.
Olika sätt att välja filer
Välj om du vill mappa eller ange filsökvägen eller markera filen manuellt.
Fil-/mappsökväg / Fil/Mapp

Fil-/mappsökväg

Ange eller mappa målsökvägen till filen eller mappen.

Fil/mapp

Ange om du flyttar en fil eller mapp, sedan filen eller mappen.

Byt namn
Ange det nya namnet för filen, inklusive filtillägget.

Restore a File

Den här åtgärdsmodulen återställer en tidigare version av en fil.

Du anger filen och numret på den revision du vill ha.

Modulen returnerar ID:t för versionen och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Dropbox-konto till Workfront Fusion finns i Skapa en anslutning till Dropbox i den här artikeln.
Way of selecting files
Välj om du vill mappa eller ange filsökvägen eller markera filen manuellt.
File Path / File

File Path

Ange eller mappa målsökvägen till filen.

File

Välj filen på menyn.

Revision
Ange eller mappa revisionsnumret för den revision som du vill återställa.

Upload a File

Den här åtgärdsmodulen överför en fil till en mapp.

Du kan ange information om till exempel filens plats, vilken fil du vill överföra och ett valfritt nytt namn för filen.

Modulen returnerar filens ID och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Dropbox-konto till Workfront Fusion finns i Skapa en anslutning till Dropbox i den här artikeln.
Folder
Markera mappen för den Dropbox som du vill överföra filen till.
Source File

Välj en källfil från en tidigare modul eller mappa källfilens namn och data.

Obs!

Den överförda filens största storlek är 150 MB.

Overwrite an existing file
Aktivera det här alternativet om du vill ersätta den befintliga filen med den nya filen. Om det här alternativet är inaktiverat byter den överförda filen namn.

Andra moduler

Make an API Call

Med den här åtgärdsmodulen kan du göra ett anpassat autentiserat anrop till API:t Dropbox. På så sätt kan du skapa en dataflödesautomatisering som inte kan utföras av de andra Dropbox-modulerna.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Dropbox-konto till Workfront Fusion finns i Skapa en anslutning till Dropbox i den här artikeln.
URL
Ange en relativ sökväg till Ange en relativ sökväg till https://api.dropboxapi.com. Exempel: /2/files/list_folder
Method
Välj den HTTP-förfrågningsmetod som du behöver för att konfigurera API-anropet. Mer information finns i Metoder för HTTP-begäran.
Headers
Ange önskade begäranderubriker. Workfront Fusion lägger automatiskt till auktoriseringsrubriker.
Query String
Ange frågesträngen för begäran.
Body

Lägg till brödinnehållet för API-anropet i form av ett standard-JSON-objekt.

Obs!

När du använder villkorssatser som if i JSON placerar du citattecknen utanför villkorssatsen.

recommendation-more-help

Exempel:

Följande API-anrop returnerar de första 10 filerna från mappen /Text files i ditt Dropbox-konto:

URL: /2/files/list_folder

Brödtext:

{
"path": "/Text files",
"limit": 10,
"recursive": false,
"include_deleted": false
}

Det går att hitta matchningar av sökningen i modulens utdata under Bundle > Body > poster.

I vårt exempel returnerades 10 biljetter.

Vanliga problem

Det går inte att överföra eller uppdatera en fil

Följande kan bero på att det inte går att överföra eller uppdatera en fil:

  • Den överförda filen är för stor och överskrider den största tillåtna filstorleken för din Dropbox-plan, eller så har du använt hela lagringskvoten för ditt Dropbox-konto. Du måste ta bort befintliga filer från ditt Dropbox-konto eller uppgradera din plan.
  • Den tidigare markerade mappen, som filen överförs till, finns inte längre. Scenariot stoppas och du måste välja målmappen igen.

Bild som refereras via en delad länk återges inte

Den URL som returneras av Dropbox >Create a shared link länkar inte direkt till en bild, utan till en Dropbox-sida. Ersätt efterföljande ?dl=0 med ?dl=1 om du vill tvinga bilden att hämtas. Om du vill tvinga bilden att återges (till exempel i en webbläsare eller i Facebook Messenger) lägger du till &raw=1 i URL:en.

Om du behöver få en direkt eller rå länk till bilden för din webbplats eller för andra Workfront Fusion-moduler måste du ändra den ursprungliga delade URL:en på följande sätt:

Ursprunglig URL:

https://www.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png?dl=0

  1. Ersätt www med dl.
  2. Ta bort ?dl=0.

Slutlig URL:

https://dl.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png

Om du vill ändra URL-adressen automatiskt kan du använda funktionen replace() två gånger:

  • Ersätt www med dl

    Ersätt www med dl

  • Och ta bort ?dl=0

    Ta bort DL

Om du vill göra det i ett enda steg kombinerar du dessa funktioner:

Ersätt båda

Du kan också kopiera den och klistra in den i fältet. Ersätt 1.url med URL:en.

{{replace(replace(1.url; "?dl=0"; ""); "www"; "dl")}}
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3