DokumentationWorkfrontAnvändarhandbok om Workfront

Dropbox moduler

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Användare

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.

Om du behöver instruktioner om hur du skapar ett scenario kan du läsa Skapa ett scenario i Adobe Workfront Fusion.

Mer information om moduler finns i Moduler i Adobe Workfront Fusion.

Åtkomstkrav

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

Adobe Workfront plan*
Pro eller högre
Adobe Workfront licens*
Plan, Work
Adobe Workfront Fusion licens**

Aktuellt licenskrav: Inget Workfront Fusion-licenskrav.

eller

Gammalt licenskrav: Workfront Fusion för Automatisering och integrering av arbetet

Produkt

Aktuellt produktkrav: Om du har planen Select eller Prime Adobe Workfront måste din organisation köpa både Adobe Workfront Fusion och Adobe Workfront för att kunna använda de funktioner som beskrivs i den här artikeln. Workfront Fusion ingår i planen Ultimate Workfront.

eller

Äldre produktkrav: Din organisation måste köpa Adobe Workfront Fusion och Adobe Workfront för att kunna använda de funktioner som beskrivs i den här artikeln.

Kontakta Workfront-administratören om du vill ta reda på vilken plan, licenstyp eller åtkomst du har.

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
Dropbox måste godkänna program med fler än 50 användare.
Mer information finns i Utvecklarhandbok för Dropbox.

API-information för Dropbox

Kopplingen Dropbox 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.

  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 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 Dropbox-konto eller ett företagskonto (Dropbox Business).

  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 visar Workfront Fusion fälten som listas nedan. 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 i Adobe Workfront Fusion.

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

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 Dropbox om du inte väljer någon mapp.
Filstatus
Välj filstatus för att begränsa sökningen till vald filstatus.
Filkategorier
Välj de filkategorier som du vill begränsa sökningen till de valda kategorierna.
Filtillägg
Välj de filtillägg som du vill söka efter.
Gräns
Ange eller mappa det maximala antal poster som du vill att modulen ska returnera under varje körningscykel för scenario.

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.

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

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

Ange eller mappa filen som du vill lägga till i mappen Dropbox ovan.

File name

Ange eller mappa filnamnet, inklusive filtillägget.

File data

Ange eller mappa fildata (från tidigare modul som Google Drive >Get a File).

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.

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 klicka inte på Click here för att välja mappen för att 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.

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.
Select to
Välj om du vill skapa eller skriva över en DOC-fil.
Folder
Välj den målplats där du vill skapa en fil.
Source File

Ange eller mappa filen som du vill lägga till i mappen Dropbox.

Filnamn

Ange filnamnet för den nya DOC-filen (utan filtillägg).

Filinnehåll

Ange textinnehållet i DOC-filen.

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 målsökvägen till filen.

File

Välj filen på menyn.

Requested Visibility

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

Obs! Alternativen Team only och Access with password är bara tillgängliga för användare med version Dropbox Pro eller senare.

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 i Adobe Workfront Fusion.

Obs! Alternativen Team only och Access with password är bara tillgängliga för användare som har Dropbox Pro eller senare versioner.

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.

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

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.

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
Välj om du vill mappa eller ange filsökvägen eller markera filen manuellt.
File/Folder Path / File/Folder

File/Folder Path

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

File/Folder

Markera filen eller mappen på menyn.

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

Markera filen eller mappen på menyn.

Byt namn
Ange target name för filen, inklusive filtillägget.

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 Path / File

File Path

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

File

Välj filen på menyn.

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

Obs! En lista över tillgängliga slutpunkter finns i Dropbox API v2-dokumentationen.

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 i Adobe Workfront Fusion.
Headers
Ange önskade begäranderubriker. Workfront Fusion lägger till auktoriseringshuvuden automatiskt.
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.

INFO
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

Det finns flera situationer när 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 hämta den direkta eller råa länken till bilden för webbplatsen 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

  • Och ta bort ?dl=0

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

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")}}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43