We're updating some of our product names. Nintex Workflow Cloud will soon be Automation Cloud. You may see both product names in our help pages while we make this change.

Dropbox Business - Get a file

The Dropbox Business - Get a file action A tool for building the processes, logic, and direction within workflows. retrieves a file from Dropbox Business and stores it to a variable to use later in the workflow.

You can use this variable in other actions throughout your workflow. For example, if you want to move or copy this file later in the workflow, the stored file variable can be used to specify the source.

Before you start

How do I handle files in my workflow?

You can start a workflow whenever a new or updated file is detected (example: Box - New file), upload files on start or at any point in the workflow, generate documents from tagged templates, send and receive files via email, and manipulate files. You can set up file handling in your workflow start event The connector and event for triggering the workflow to run, including required configuration. An example is Box - New file, which triggers the workflow to run when a new file is uploaded to the specified folder. and actions A tool for building the processes, logic, and direction within workflows..

Note: Your tenancy's default file storage location must be configured to hold files for later reference by the workflow. This location is used for uploaded files and for files stored as output from actions.

Handle files in your workflow actions

Generate documents from tagged templates using Generate document
Send and receive files via email; for example, see Assign a task
Manipulate files in services (see Connectors):
- Get, store, move, copy, or delete files using file share connector actions A workflow action that performs a basic operation through a connected system, such as Salesforce or Box., such as Box - Move a file
- Get and attach files in Salesforce
- Get and store files in SharePoint
- Get signatures: Get and store signed documents using DocuSign or Adobe Sign.
Store a file for use later in the workflow
For example, store any email attachments received by the task assignee.
1. On the Designer canvas, click the action you want to configure.
2. Find the output field for storing the file or set of files.
  
  For example, to store attachments received in task assignee email replies when they may attach multiple files, use the Assign a task Multiple file attachments option for the Store output field.
3. In the output field, select a variable or specify a file path:
  - Select a variable. For outputs storing multiple files, select a collection variable. For outputs storing a single file, select a file variable.
  - Specify a file path. You can use any combination of text and variables, beginning with the root folder. If available, use the folder browse icon on the right of the path field to navigate to the folder and any subfolders that you want, and then edit the path as desired to include variables and different text.
  The availability of variable or path options for storing files varies by action. For more information, see Connectors and Workflow actions.
Reference a stored file
For example, reference the new Box file that started the workflow to attach it to a task email notification or reference an image received by the task assignee to generate an invoice document.
1. On the Designer canvas, click the action you want to configure.
2. Find the field where you want to reference the stored file select a variable or specify a file path:
  - Select the file variable associated with the stored file. For example, select the variable for the new Box file that started the workflow or select the variable storing Multiple file attachments output from a task action.
  - Specify the file path where the file is stored. You can use any combination of text and variables, beginning with the root folder. If available, use the folder browse icon on the right of the path field to navigate to the folder and any subfolders that you want, and then edit the path as desired to include variables and different text.
    View example
    Both a file variable and a file path are used in the example image below for the Dropbox Business - Copy a file action. A file variable is selected for Source and a file path is specified for Destination.
    The variables "CountryVariable" and "Program" insert the values into the file path as determined by earlier workflow logic (in this case, fields in a submitted form). For example, if the person submitting the form selects Australia for country and specifies Inspire2017 for program, then the resulting file path is "/SpecialProgramNDAs/Australia/Inspire2017NDA.docx."

Configure the Dropbox Business - Get a file action

In the Designer page:

Click the Dropbox Business action A tool for building the processes, logic, and direction within workflows. group in the action toolbox.

or

Find actions by browsing action groups, or by typing an action name or function in the Search field at the top of the action toolbox.
Drag the Dropbox Business - Get a file action to the point in the workflow when you want to retrieve the file.
Click the Dropbox Business - Get a file action to open the configuration panel.
Select a Connection.
Don't have one yet? Follow these steps to create a Dropbox Business connection
Note: To create a Dropbox Business connection, you must be an administrator of your Dropbox account.
1. In the drop-down list for Connection, select Add new connection.
  
  The Configure a connection window is displayed, prompting you for a connection name.
  
  The entered name is validated for uniqueness. If credentials are not stored in the browser for the selected connector service, then you are prompted for credentials.
2. Enter credentials if prompted.
  
  Upon successful login, you are prompted to grant or deny access to Nintex Workflow Cloud.
3. Click the option to grant access.
  
  The Connection window closes. Your newly added connection now appears in the Connection field.
Select a Member ID.
Under Source, type the Path to the file you want to retrieve or click the browse icon () to browse the folder structure and select the file.

Note: A Connection and Member ID must be selected for the Path field to become configurable.

Select a file variable for Store output.

For more information on the fields and buttons, see Dropbox Business - Get a file action fields, buttons, and settings.

Dropbox Business - Get a file action fields, buttons, and settings

Caution: If a file/folder that's used in a workflow is moved, renamed, or deleted, any workflows that use that file/folder will not start or will fail. Make sure you keep the paths in your workflow configurations up to date.

Section	Field	Description	Variable types
(Unlabeled)	Connection Credentials and other settings required to pass data between the workflow and the indicated service, which could be a cloud service, business application, or content store.	The Dropbox Business connection to use for retrieving the file.	(n/a)
(Unlabeled)	Member ID	The ID of the Dropbox Business team member. All the active members in the Dropbox Business account will be listed in the drop down to select from.	Boolean, DateTime, Decimal, Collection, Integer, Text
Source	Path	The location in Dropbox Business where the workflow retrieves the file from. Accepts any combination of typed text, text added through navigation (), and inserted variables.	Boolean, DateTime, Decimal, Integer, Text
Output	Store output	The variable to store the retrieved file for use later in the workflow. Accepts an inserted variable.	File