Dropbox modules
In an Adobe Workfront Fusion scenario, you can automate workflows that use Dropbox, as well as connect it to multiple third-party applications and services.This allows you to automate activities such as monitoring, searching, retrieving, listing, creating, and editing files and folders in your Dropbox.
If you need instructions on creating a scenario, see Create a scenario in Adobe Workfront Fusion.
For information about modules, see Modules in Adobe Workfront Fusion.
Access requirements
You must have the following access to use the functionality in this article:
To find out what plan, license type, or access you have, contact your Workfront administrator.
For information on Adobe Workfront Fusion licenses, see Adobe Workfront Fusion licenses.
Prerequisites
To use Dropbox modules, you must have a Dropbox account.
Dropbox modules and their fields
When you configure Dropbox modules, Workfront Fusion displays the fields listed below. Along with these, additional Dropbox fields might display, depending on factors such as your access level in the app or service. A bolded title in a module indicates a required field.
If you see the map button above a field or function, you can use it to set variables and functions for that field. For more information, see Map information from one module to another in Adobe Workfront Fusion.
Trigger modules
Watch Files
This Trigger type module returns file details when the file in a specified folder is modified.
Modules for getting Dropbox files and folders
Search Files/Folders
This search module looks for records in an object in Dropbox that match the search query you specify.
You can map this information in subsequent modules in the scenario.
Download a File
This action module downloads a file from a folder.
You specify the file and its location.
The module returns the ID of the file and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Get a Folder Metadata
This action module retrieves shared folder details.
You specify the ID of the folder.
The module returns the ID of the folder and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
List All Files/Subfolders in a Folder
This action module lists files or folders in a particular folder.
You specify the ID of the folder.
The module returns the IDs of the files or foldes and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
List File Revisions
This action module retrieves all file revisions (a version history) of a particular file.
You specify the ID of the file.
The module returns any standard fields associated with the record, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Modules for creating and editing Dropbox files and folders
Upload a File
This action module uploads a file to a folder.
You specify information such as the location for the file, the file you want to upload, and an optional new name for the file.
The module returns the ID of the file and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Create a Folder
This action module creates a new folder.
You specify the path and a name for the folder.
The module returns the ID of the folder and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Create/Overwrite a Text File
This action module creates a DOC file or overwrites the content of an existing one.
You specify the source file and the folder.
The module returns the ID of the folder and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Create/Update a Share Link
This action module creates a public link to a file.
You specify the file and information about the link.
The module returns the ID of the link and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Restore a File
This action module restores a previous version of a file.
You specify the file and the number of the revision you want.
The module returns the ID of the version and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Move a File/Folder
This action module moves a file or folder to a different location.
You specify the file or folder and how and where you ant to move it.
The module returns the ID of the file or folder and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Rename a File/Folder
This action module renames a file or folder.
You specify the file or folder and the new name.
The module returns the ID of the file or folder and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Delete a File/Folder
This action module deletes a file or folder.
You specify the file or folder.
The module returns the ID of the record and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Other modules
Make an API Call
This action module lets you make a custom authenticated call to the Dropbox API. This way, you can create a data flow automation that can’t be accomplished by the other Dropbox modules.
When you are configuring this module, the following fields display.
/2/files/list_folder
{
"path": "/Text files",
"limit": 10,
"recursive": false,
"include_deleted": false
}
Common problems
Unable to upload or update a file
There are several situations when uploading or updating a file fails:
- The uploaded file is too big and exceeds the maximum file size allowed for your Dropbox plan, or you have used all of your Dropbox account’s storage quota. You must delete existing files from your Dropbox account or upgrade your plan.
- The previously selected folder, to which the file is being uploaded to, no longer exists. The scenario stops and you must select the target folder again.
Image referenced via a shared link does not render
The URL returned by the Dropbox >Create a shared link does not link directly to an image, but to a Dropbox page. To force the image to download, replace the trailing ?dl=0
with ?dl=1
. To force the image to render (for example, in a Web browser or in Facebook Messenger), append &raw=1
to the URL.
If you need to get the direct or raw link of your image for your website or for other Workfront Fusion modules, you must modify the initial shared URL in the following way:
Original URL:
https://www.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png?dl=0
- Replace
www
withdl
. - Remove
?dl=0
.
Final URL:
https://dl.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png
To automatically modify the URL, you can use the replace()
function twice:
-
Replace www with dl
-
And to remove ?dl=0
To do it in one step, combine these functions:
You can also copy it and paste it into the field. Replace 1.url
with the URL.
{{replace(replace(1.url; "?dl=0"; ""); "www"; "dl")}}