tDropboxList - 6.1

Talend Components Reference Guide

Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for Data Quality
Talend Open Studio for ESB
Talend Open Studio for MDM
Talend Real-Time Big Data Platform
Talend Studio
Data Governance
Data Quality and Preparation
Design and Development

tDropboxList properties

Component family




This component reads the file(s) on Dropbox held in the directory you specify and lists the metadata and the contents of that file or those files.


The tDropboxList component lists the files stored in a specified directory on Dropbox.

Basic settings

Use existing connection

Select this check box and in the Component List click the relevant connection component to reuse the connection details you already defined.


Access token

Enter the access token required by the Dropbox account you need to connect to. This access token allows the Studio to make Dropbox API calls for that Dropbox account.

Note that a Dropbox App should have been created under that account before generating the access token. For further information about a Dropbox access token, see


Use HTTP proxy

If you are using a proxy, select this check box and enter the host and port information of that proxy in the corresponding fields that are displayed.



Enter the path pointing to the folder you need to list the files from, or enter the path pointing to the exact file you need to read.

Note that the path string should start with a slash (/). It is the root folder of the Dropbox App for which you are using the current access token.


List type

Select the type of data you need to list from the specified path.


Include subdirectories

Select this check box to list files from any existing sub-folders in addition to the files in the directory defined in the Path field.

Advanced settings

tStatCatcher Statistics

Select this check box to collect log data at the component level.

Global Variables

ERROR_MESSAGE: the error message generated by the component when an error occurs. This is an After variable and it returns a string. This variable functions only if the Die on error check box is cleared, if the component has this check box.

NAME: the name of the remote file being processed. This is a Flow variable and it returns a string.

PATH: the path pointing to the folder or the file being processed on Dropbox. This is a Flow variable and it returns a string.

LAST_MODIFIED: the timestamp of the last modification of the file being processed. This is a Flow variable and it returns a long.

SIZE: the volume of the file being processed. This is a Flow variable and it returns a long.

IS_FILE: the boolean result of the file listing. This is a Flow variable and it returns a boolean. The result Yes indicates that the listed data is of the type File; otherwise, the type is Folder.

A Flow variable functions during the execution of a component while an After variable functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl + Space to access the variable list and choose the variable to use from it.

For further information about variables, see Talend Studio User Guide.


This component is typically used standalone.



Related scenario

No scenario is available for this component yet.