Dropbox modules

In een Adobe Workfront Fusion-scenario kunt u workflows automatiseren die Dropbox of Dropbox Business gebruiken, en deze koppelen aan meerdere toepassingen en services van derden. Hierdoor kunt u activiteiten zoals het controleren, zoeken, ophalen, weergeven, maken en bewerken van bestanden en mappen in uw Dropbox automatiseren.

Voor instructies bij het creëren van een scenario, zie de artikelen onder scenario's creëren: artikelindex.

Voor informatie over modules, zie de artikelen onder Modules: artikelindex.

Toegangsvereisten

Breid uit om de toegangseisen voor de functionaliteit in dit artikel weer te geven.

U moet de volgende toegang hebben om de functionaliteit in dit artikel te kunnen gebruiken:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront-pakket Alle
Adobe Workfront-licentie

Nieuw: Standaard

of

Huidig: Werk of hoger

Adobe Workfront Fusion-licentie**

Huidig: Geen Workfront Fusion-licentievereisten

of

Verouderd: Workfront Fusion for Work Automation and Integration

Product

Nieuw:

  • Select- of Prime Workfront-pakket: uw organisatie moet Adobe Workfront Fusion aanschaffen.
  • Ultimate Workfront-pakket: Workfront Fusion is inbegrepen.

of

Huidig: Uw organisatie moet Adobe Workfront Fusion aanschaffen.

Voor meer detail over de informatie in deze lijst, zie vereisten van de Toegang in documentatie.

Voor informatie over de vergunningen van de Fusie van Adobe Workfront, zie de Fusie van Adobe Workfront vergunningen.

Vereisten

  • Als u Dropbox -modules wilt gebruiken, moet u een Dropbox -account hebben.
IMPORTANT
  • Als u de Dropbox-aansluiting wilt gebruiken, moet u eerst een toepassing in Dropbox maken.
    ​> Zoek naar "Een toepassing maken" in de handleiding voor ontwikkelaars van Dropbox voor meer informatie.
  • Wanneer u de toepassing maakt, gebruikt u de volgende URI voor omleiding: https://app.workfrontfusion.com/oauth/cb/dropbox
  • Dropbox moet toepassingen met meer dan 50 gebruikers goedkeuren.
    ​> Zoek naar "Productietoestemming" in de Dropbox-handleiding voor ontwikkelaars voor meer informatie.

Dropbox API-informatie

De Dropbox-connector gebruikt het volgende:

Basis-URL
https://api.dropboxapi.com/2
API-versie
2
API-tag
  • Dropbox

    v5.3.9

  • Dropbox Business

    v1.0.12

Verbinding maken met Dropbox

Verbinding maken voor uw Dropbox -modules:

  1. Klik in een willekeurige module op Add naast het vak Verbinding.

  2. Vul de volgende velden in:

    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 Voer een naam in voor deze verbinding.
    Environment Selecteer of deze verbinding voor een productie of een non-productie milieu is.
    Type Selecteer of u verbinding maakt met een serviceaccount of een persoonlijke account.
    Client ID Voer uw Dropbox Client ID in.
    Client Secret Voer uw Dropbox Client Secret in.
    Account Type Selecteer of u verbinding maakt met een persoonlijke Dropbox-account of een zakelijke account (Dropbox Business).
    Exclude dropbox-api-path-root header Schakel deze optie in om de header dropbox-api-path-root uit te sluiten voor Dropbox Apps met toegang tot App Folder
  3. Klik op Continue om de verbinding op te slaan en terug te keren naar de module.## Dropbox modules en hun velden

Dropbox modules en hun velden

Wanneer u Dropbox modules configureert, geeft Workfront Fusion de onderstaande velden weer. Daarnaast kunnen aanvullende Dropbox -velden worden weergegeven, afhankelijk van factoren zoals uw toegangsniveau in de app of service. Een bolde titel in een module wijst op een vereist gebied.

Als u de kaartknoop boven een gebied of een functie ziet, kunt u het gebruiken om variabelen en functies voor dat gebied te plaatsen. Voor meer informatie, zie informatie van de Kaart van één module aan een andere.

Kaart knevel

Triggermodules

Watch Files

Deze triggertypemodule retourneert bestandsgegevens wanneer het bestand in een opgegeven map wordt gewijzigd.

Connection
Zie Dropbox Verbinding maken met in dit artikel voor instructies over het verbinden van uw Dropbox -account met Workfront Fusion.
Folder
Selecteer de map die u wilt controleren op wijzigingen.
Watch also subfolders
Schakel deze optie in om ook de submappen in de geselecteerde map te controleren op gewijzigde bestanden.
Limit
Ga of kaart het maximumaantal verslagen in u de module tijdens elke cyclus van de scenariouitvoering wilt terugkeren.

Modules voor het ophalen van Dropbox bestanden en mappen

Download a File

Deze actiemodule downloadt een bestand uit een map.

U geeft het bestand en de locatie op.

De module retourneert de id van het bestand en de bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

NOTE
Deze module is nuttig om dossiers aan verdere modules te verstrekken.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Dropbox Verbinding maken met in dit artikel voor instructies over het verbinden van uw Dropbox -account met Workfront Fusion.
Wijze waarop bestanden worden geselecteerd
Selecteer of u het bestandspad wilt toewijzen of het bestand handmatig wilt selecteren.
Bestandspad / Bestand

Bestandspad

Typ of wijs het doelpad naar het bestand toe.

Bestand

Selecteer het bestand in het menu.

Get a Folder Metadata

In deze actiemodule worden de gegevens van de gedeelde map opgehaald.

U geeft de id van de map op.

De module retourneert de id van de map en alle bijbehorende velden, samen met eventuele aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Dropbox Verbinding maken met in dit artikel voor instructies over het verbinden van uw Dropbox -account met Workfront Fusion.
Gedeelde map-id
Voer de id in van de map waarover u gegevens wilt ophalen of wijs deze toe.

List All Files/Subfolders in a Folder

In deze actiemodule worden bestanden of mappen in een bepaalde map weergegeven.

U geeft de id van de map op.

De module retourneert de id's van de bestanden of mappen en alle bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Dropbox Verbinding maken met in dit artikel voor instructies over het verbinden van uw Dropbox -account met Workfront Fusion.
Lijst
Selecteer of u bestanden of mappen wilt ophalen.
Alleen downloadbare bestanden tonen
Schakel deze optie in als u alleen downloadbare bestanden wilt retourneren. Sommige bestandstypen, zoals Google Docs, kunnen niet worden gedownload.
Map
Voer de map in waarvan u bestanden of mappen wilt ophalen of wijs de map toe.
Limiet
Ga of kaart het maximumaantal verslagen in u de module tijdens elke cyclus van de scenariouitvoering wilt een lijst maken.

List File Revisions

Deze actiemodule haalt alle bestandsrevisies (een versiegeschiedenis) van een bepaald bestand op.
U geeft de id van het bestand op.

De module retourneert alle standaardvelden die aan de record zijn gekoppeld, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Dropbox Verbinding maken met in dit artikel voor instructies over het verbinden van uw Dropbox -account met Workfront Fusion.
Wijze waarop bestanden worden geselecteerd
Selecteer of u het bestandspad wilt toewijzen of het bestand handmatig wilt selecteren.
Bestandspad / Bestand

Bestandspad

Typ of wijs het doelpad naar het bestand toe.

Bestand

Selecteer het bestand in het menu.

Limiet
Ga of kaart het maximumaantal verslagen in u de module tijdens elke cyclus van de scenariouitvoering wilt een lijst maken.

Search Files/Folders

Deze zoekmodule zoekt naar records in een object in Dropbox dat overeenkomt met de zoekquery die u opgeeft.

U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Connection
Zie Dropbox Verbinding maken met in dit artikel voor instructies over het verbinden van uw Dropbox -account met Workfront Fusion.
Search
Voer de zoekterm in.
Folder
Selecteer de map die u wilt doorzoeken. Deze module zoekt de volledige Dropbox rekening als u geen omslag selecteert.
Bestandsstatus
Selecteer de bestandsstatus die u in de zoekopdracht wilt opnemen.
Bestandscategorieën
Selecteer de bestandscategorieën die u in de zoekopdracht wilt opnemen.
Bestandsextensies
Voor elke dossieruitbreiding die u in het onderzoek wilt omvatten, klik toevoegen punt en ga of kaart de dossieruitbreiding in.
Limiet
Ga of kaart het maximumaantal verslagen in u de module tijdens elke cyclus van de scenariouitvoering wilt terugkeren.

Modules voor het maken en bewerken van Dropbox bestanden en mappen

Create a Folder

Deze actiemodule maakt een nieuwe map.

U geeft het pad en een naam voor de map op.

De module retourneert de id van de map en alle bijbehorende velden, samen met eventuele aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Dropbox Verbinding maken met in dit artikel voor instructies over het verbinden van uw Dropbox -account met Workfront Fusion.
Folder Name
Voer de naam voor de nieuwe map in.
Folder

Voer het pad in of wijs het toe op de plaats waar u een nieuwe map wilt maken.

Opmerking:

Als u een Dropbox Business rekening (met teamruimten) gebruikt, moet u de schuine streep / verwijderen, of klikt hier niet om omslag te kiezen om een teamomslag in de wortel tot stand te brengen.

Als de schuine streep niet wordt verwijderd, wordt een fout [409] path/malformed_path/.. geretourneerd.

Auto rename
Schakel deze optie in om de naam van de nieuwe map te wijzigen als er al een map met dezelfde naam bestaat op de doellocatie.

Create/Overwrite a Text File

Deze actiemodule maakt een DOC-bestand of overschrijft de inhoud van een bestaand bestand.

U geeft het bronbestand en de map op.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Dropbox Verbinding maken met in dit artikel voor instructies over het verbinden van uw Dropbox -account met Workfront Fusion.
Select to

Selecteer of u een DOC-bestand wilt maken of overschrijven.

  • Maken Selecteer de map waarin u een bestand wilt maken.

  • Overschrijven

    Selecteer hoe u het bestand wilt kiezen dat u wilt overschrijven, wijs vervolgens het bestandspad toe of selecteer het bestand.

Source File

Selecteer een bronbestand uit een vorige module of wijs de inhoud van het bronbestand toe.

Als u een dossier creeert, uitgezocht Leeg .

In deze actiemodule wordt een openbare koppeling naar een bestand gemaakt.

U geeft het bestand en de informatie over de koppeling op.

De module retourneert de id van de koppeling en alle bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Dropbox Verbinding maken met in dit artikel voor instructies over het verbinden van uw Dropbox -account met Workfront Fusion.
Way of selecting files
Selecteer of u het bestandspad wilt toewijzen of invoeren, of selecteer het bestand handmatig.
File Path / File

File Path

Typ of wijs het pad naar het doelbestand toe.

File

Selecteer het doelbestand.

Requested Visibility

Selecteer of de verbinding openbaar, voor team, of wachtwoord beperkt is.

Opmerking:

Team only is alleen beschikbaar voor Dropbox Business-accounts. Access with password is alleen beschikbaar voor Dropbox Pro - of Dropbox Business-accounts.

Link's Expiration Date
Voer de datum en tijd in waarop de koppeling verloopt en niet meer toegankelijk is. Als dit veld leeg blijft, verloopt de koppeling niet. Voor een lijst van gesteunde datum en tijdformaten, zie Druk van het Type.
Link's Access Level

Stel de machtigingen voor de ontvanger van de koppeling in.

  • Viewer

    Gebruikers die de koppeling gebruiken, kunnen de inhoud weergeven en opmerkingen plaatsen.

  • Editor

    Gebruikers die de koppeling gebruiken, kunnen de inhoud bewerken, weergeven en opmerkingen plaatsen. Dit toegangsniveau is alleen beschikbaar voor documenten in de cloud.

  • Max

    Gebruikers die de koppeling gebruiken, ontvangen het maximale toegangsniveau waarop u de koppeling kunt instellen.

Delete a File/Folder

Met deze actiemodule verwijdert u een bestand of map.

U geeft het bestand of de map op.

De module retourneert de id van de record en de bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Dropbox Verbinding maken met in dit artikel voor instructies over het verbinden van uw Dropbox -account met Workfront Fusion.
Way of selecting files
Selecteer of u het bestandspad wilt toewijzen of invoeren, of selecteer het bestand handmatig.
File or Folder Path / File or Folder

File/Folder Path

Voer het doelpad in of wijs dit toe aan het bestand of de map.

File/Folder

Selecteer het bestand of de map in het menu.

Move a File/Folder

Deze actiemodule verplaatst een bestand of map naar een andere locatie.

U geeft het bestand of de map op en bepaalt hoe en waar u het bestand of de map wilt verplaatsen.

De module retourneert de id van het bestand of de map en alle bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Dropbox Verbinding maken met in dit artikel voor instructies over het verbinden van uw Dropbox -account met Workfront Fusion.
Way of selecting files / folders
Selecteer of u het bestands- of mappad wilt toewijzen of invoeren, of selecteer het bestand of de map handmatig.
File / Folder Path /

File/Folder Path

Voer het doelpad in of wijs dit toe aan het bestand of de map.

File/Folder

Selecteer of u een bestand of map verplaatst, en vervolgens het bestand of de map.

To Folder
Voer de doellocatie voor het bestand of de map in of wijs deze toe.
New Name
Voer de nieuwe naam voor het bestand of de map op de nieuwe locatie in.
Auto Rename
Schakel deze optie in om ervoor te zorgen dat als er al een bestand of map met dezelfde naam bestaat, de module de naam van het nieuwe bestand of de nieuwe map wijzigt door (NUMBER) achter de bestands- of mapnaam toe te voegen. Anders wordt het bestand of de map op de doellocatie overschreven.
Allow ownership transfer
Schakel deze optie in om verplaatsing door de eigenaar toe te staan, zelfs als dit zou leiden tot een eigendomsoverdracht voor de inhoud die wordt verplaatst.

Rename a File/Folder

In deze actiemodule wordt de naam van een bestand of map gewijzigd.

U geeft het bestand of de map en de nieuwe naam op.

De module retourneert de id van het bestand of de map en alle bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Dropbox Verbinding maken met in dit artikel voor instructies over het verbinden van uw Dropbox -account met Workfront Fusion.
Wijze waarop bestanden worden geselecteerd
Selecteer of u het bestandspad wilt toewijzen of invoeren, of selecteer het bestand handmatig.
Pad naar bestand/map/bestand/map

Pad naar bestand/map

Voer het doelpad in of wijs dit toe aan het bestand of de map.

Bestand/map

Selecteer of u een bestand of map verplaatst, en vervolgens het bestand of de map.

Naam wijzigen
Voer de nieuwe naam voor het bestand in, inclusief de bestandsextensie.

Restore a File

In deze actiemodule wordt een vorige versie van een bestand hersteld.

U geeft het bestand en het nummer van de gewenste revisie op.

De module retourneert de id van de versie en alle bijbehorende velden, samen met eventuele aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Dropbox Verbinding maken met in dit artikel voor instructies over het verbinden van uw Dropbox -account met Workfront Fusion.
Way of selecting files
Selecteer of u het bestandspad wilt toewijzen of invoeren, of selecteer het bestand handmatig.
File Path / File

File Path

Typ of wijs het doelpad naar het bestand toe.

File

Selecteer het bestand in het menu.

Revision
Ga of kaart het revisieaantal van de revisie in u wilt herstellen.

Upload a File

Deze actiemodule uploadt een bestand naar een map.

U geeft informatie op zoals de locatie van het bestand, het bestand dat u wilt uploaden en een optionele nieuwe naam voor het bestand.

De module retourneert de id van het bestand en de bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Dropbox Verbinding maken met in dit artikel voor instructies over het verbinden van uw Dropbox -account met Workfront Fusion.
Folder
Selecteer de map van de Dropbox waarnaar u het bestand wilt uploaden.
Source File

Selecteer een bronbestand uit een vorige module of wijs de naam en gegevens van het bronbestand toe.

Opmerking:

De maximale grootte van het geüploade bestand is 150 MB.

Overwrite an existing file
Schakel deze optie in om het bestaande bestand te vervangen door het nieuwe bestand. Als deze optie niet is ingeschakeld, wordt de naam van het geüploade bestand gewijzigd.

Overige modules

Make an API Call

Met deze actiemodule kunt u een aangepaste, geverifieerde aanroep van de Dropbox API maken. Op deze manier kunt u een automatisering van de gegevensstroom maken die niet door de andere Dropbox -modules kan worden uitgevoerd.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Zie Dropbox Verbinding maken met in dit artikel voor instructies over het verbinden van uw Dropbox -account met Workfront Fusion.
URL
Voer een pad in dat relatief is ten opzichte van het invoeren van een pad dat relatief is ten opzichte van https://api.dropboxapi.com . Bijvoorbeeld: /2/files/list_folder
Method
Selecteer de HTTP- verzoekmethode u de API vraag moet vormen. Voor meer informatie, zie HTTP- verzoekmethodes.
Headers
Voer de gewenste aanvraagheaders in. Workfront Fusion voegt automatisch machtigingsheaders toe.
Query String
Voer de queryreeks voor de aanvraag in.
Body

Voeg de inhoud van de hoofdtekst voor de API-aanroep toe in de vorm van een standaard JSON-object.

Opmerking:

Wanneer u voorwaardelijke instructies gebruikt, zoals if in uw JSON, plaatst u de aanhalingstekens buiten de voorwaardelijke instructie.

recommendation-more-help

Voorbeeld:

De volgende API-aanroep retourneert de eerste 10 bestanden in de map /Text files in uw Dropbox -account:

URL: /2/files/list_folder

Lichaam:

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

Overeenkomsten met de zoekopdracht vindt u in de sectie Uitvoer van de module onder Bundle > Body > vermeldingen.

In ons voorbeeld werden 10 tickets teruggegeven.

Algemene problemen

Kan een bestand niet uploaden of bijwerken

Het uploaden of bijwerken van een bestand kan een van de volgende oorzaken hebben:

  • Het geüploade bestand is te groot en overschrijdt de maximaal toegestane bestandsgrootte voor uw Dropbox -abonnement. U hebt ook de volledige opslaglimiet van uw Dropbox -account gebruikt. U moet bestaande bestanden verwijderen van uw Dropbox -account of uw abonnement upgraden.
  • De eerder geselecteerde map waarnaar het bestand wordt geüpload, bestaat niet meer. Het scenario stopt en u moet de doelmap opnieuw selecteren.

Afbeeldingen waarnaar via een gedeelde koppeling wordt verwezen, worden niet gerenderd

De URL die wordt geretourneerd door Dropbox > Create a shared link , is niet rechtstreeks gekoppeld aan een afbeelding, maar aan een pagina Dropbox . Als u het downloaden van de afbeelding wilt forceren, vervangt u het navolgende ?dl=0 door ?dl=1 . Als u de afbeelding wilt renderen (bijvoorbeeld in een webbrowser of in de Facebook Messenger), voegt u &raw=1 toe aan de URL.

Als u de directe of ruwe verbinding van uw beeld voor uw website of voor andere modules van Workfront Fusion moet krijgen, moet u eerste gedeelde URL op de volgende manier wijzigen:

Oorspronkelijke URL:

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

  1. Vervang www door dl .
  2. Verwijderen ?dl=0 .

Uiteindelijke URL:

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

Als u de URL automatisch wilt wijzigen, kunt u de functie replace() twee keer gebruiken:

  • www door dl vervangen

    vervang www met dl

  • En om ?dl=0 te verwijderen

    verwijder DL

U kunt dit in één stap doen door de volgende functies te combineren:

vervang allebei

U kunt het ook kopiëren en in het veld plakken. Vervang 1.url door de URL.

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