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.

Als u instructies bij het creëren van een scenario nodig hebt, zie een scenario in Adobe Workfront Fusion creëren.

Voor informatie over modules, zie Modules in Adobe Workfront Fusion.

Toegangsvereisten

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

Adobe Workfront plan*
Pro of hoger
Adobe Workfront licentie*
Plan, Work
Adobe Workfront Fusion licentie**

Huidige licentievereiste: geen Workfront Fusion licentievereiste.

of

Vereiste voor oudere licenties: Workfront Fusion voor werkautomatisering en integratie

Product

Huidige productvereiste: als u het abonnement Select of Prime Adobe Workfront hebt, moet uw organisatie Adobe Workfront Fusion en Adobe Workfront aanschaffen om de in dit artikel beschreven functionaliteit te kunnen gebruiken. Workfront Fusion wordt opgenomen in het Ultimate Workfront -abonnement.

of

Vereiste verouderd product: uw organisatie moet Adobe Workfront Fusion en Adobe Workfront aanschaffen om de in dit artikel beschreven functionaliteit te kunnen gebruiken.

Neem contact op met de Workfront -beheerder als u wilt weten welk abonnement, licentietype of toegang u hebt.

Voor informatie over Adobe Workfront Fusion vergunningen, zie Adobe Workfront Fusion vergunningen.

Vereisten

  • Als u Dropbox -modules wilt gebruiken, moet u een Dropbox -account hebben.
IMPORTANT
Dropbox moet toepassingen met meer dan 50 gebruikers goedkeuren.
Voor meer informatie, zoek naar "Goedkeuring van de Productie"in de Dropbox ontwikkelaarsgids.

API-informatie voor Dropbox

De verbindingslijn van de Dropbox 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 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 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 met een persoonlijke rekening van de Dropbox of een bedrijfsrekening (de Zaken van de Dropbox) verbindt.
  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 in Adobe Workfront Fusion.

Triggermodules

Watch Files

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

Connection
Zie Verbinding maken met Dropbox 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

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 Verbinding maken met Dropbox 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 als u geen map selecteert.
Bestandsstatus
Selecteer de bestandsstatus om de zoekopdracht te beperken tot de geselecteerde bestandsstatus.
Bestandscategorieën
Selecteer de bestandscategorieën om de zoekopdracht te beperken tot de geselecteerde categorieën.
Bestandsextensies
Kies de bestandsextensies waarnaar u wilt zoeken.
Limiet
Ga of kaart het maximumaantal verslagen in u de module tijdens elke cyclus van de scenariouitvoering wilt terugkeren.

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 Verbinding maken met Dropbox 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 Verbinding maken met Dropbox 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 Verbinding maken met Dropbox 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 Verbinding maken met Dropbox 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.

Modules voor het maken en bewerken van Dropbox bestanden en mappen

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 Verbinding maken met Dropbox 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

Voer het bestand in of wijs het toe dat u aan de hierboven geselecteerde map Dropbox wilt toevoegen.

File name

Voer de bestandsnaam in of wijs deze toe, inclusief de bestandsextensie.

File data

Ga of kaart de dossiergegevens in (van vorige module zoals Google Drive > Get a File).

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.

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 Verbinding maken met Dropbox 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 account (met teamspaties) gebruikt, moet u de schuine streep / verwijderen of niet Click here klikken om map te kiezen om een teammap in de hoofdmap te maken.

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

In deze actiemodule wordt een DOC-bestand gemaakt of wordt de inhoud van een bestaand bestand overschreven.

U geeft het bronbestand en 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 Verbinding maken met Dropbox 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.
Folder
Selecteer de doellocatie waar u een bestand wilt maken.
Source File

Typ of wijs het bestand toe dat u aan de map Dropbox wilt toevoegen.

Bestandsnaam

Voer de bestandsnaam in voor het nieuwe DOC-bestand (zonder extensie).

Bestandsinhoud

Voer de tekstinhoud van het DOC-bestand in.

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 Verbinding maken met Dropbox 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.

Requested Visibility

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

Opmerking: Team only en Access with password -opties zijn alleen beschikbaar voor gebruikers met een Dropbox Pro -versie of hoger.

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

Opmerking: Team only en Access with password -opties zijn alleen beschikbaar voor gebruikers met Dropbox Pro of hogere versies.

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.

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

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 Verbinding maken met Dropbox 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.

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 Verbinding maken met Dropbox 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/Folder Path / File/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.

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 Verbinding maken met Dropbox 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 het bestand of de map in het menu.

Naam wijzigen
Voer de target name in voor het bestand, inclusief de bestandsextensie.

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 Verbinding maken met Dropbox 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.

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 Verbinding maken met Dropbox 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

Nota: Voor de lijst van beschikbare eindpunten, zie de Dropbox API v2 Documentatie.

Method
Selecteer de HTTP- verzoekmethode u de API vraag moet vormen. Zie HTTP-aanvraagmethoden in Adobe Workfront Fusion voor meer informatie.
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.

INFO
Voorbeeld: de volgende API vraag keert de eerste 10 dossiers van de /Text files omslag in uw Dropbox rekening terug:
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 geretourneerd:

Algemene problemen

Kan een bestand niet uploaden of bijwerken

Er zijn verschillende situaties wanneer het uploaden of bijwerken van een bestand mislukt:

  • 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 wilt dat de afbeelding wordt gerenderd (bijvoorbeeld in een webbrowser of in 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 Workfront Fusion modules 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

  • En om ?dl=0 te verwijderen

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

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