Dropbox connector

When to use this connector

Use this Connector to create Flows that work with files in Dropbox.

Create a Dropbox app

Prior to creating your first Connection for the Dropbox, you will need to create a Dropbox app. This is a one-time process required for the specific Dropbox account. 

Step 1. Visit the Dropbox App Console. 

Step 2. Click Create app.

Step 3. Under Choose an API section, select Scoped access.

Step 4. Under Choose the type of access you need, select Full Dropbox.

Step 5. Enter a name for your custom app and click Create app.

Step 6. Switch to Permissions tab and enable the read/write permissions for files_metadata and files_content. Click Submit button to save changes. 

Step 7. Switch back to Settings tab and click Generate to generate the access token. Copy the generated access token. You will need it later when you will be creating a Dropbox Connection.

Create a Connection

Step 1. In the Connections window, click +, and type in dropbox.

Step 2. Select Dropbox.

Step 3. Enter Connection parameters.

Connection Parameters

• Directory: the actual directory with files. This parameter is optional.
• File: the actual file name or a wildcard file name, for example, *.csv.
• Access token: the access token generated in step 7.
• Add Suffix When Creating Files in Transformation: you can select one of the predefined suffixes for the files created using this Connection. For example, if you select uuid as a suffix and the original file name is dest.csv, Etlworks Integrator will create files with the name dest_uuid.csv, where uuid is a globally unique identifier such as 21EC2020-3AEA-4069-A2DD-08002B30309D.

This parameter works only when the file is created using source-to-destination-transformation. Read how to add a suffix to the files created when copying, moving, renaming, and zipping files.

• Enable Wildcard File Name: if there are multiple source files in a folder, you can specify an algorithm that will be used to select the next source file to process. For example, if Files is set to *.csv and oldest is selected, Etlworks Integrator will always select the oldest file in the folder which matches the wildcard *.csv.
• Override Wildcard File Name set for Connection: if Wildcard File Names are allowed, Override Wildcard File Name set for Connection is enabled, and the file name entered in the FROM field of the transformation is a wildcard file name, the system will override the file name entered at the Connection level. Otherwise, the default behavior is to use the wildcard file name entered when the Connection was configured.

Decryption

When Dropbox Connection is used as a source (FROM) in the source-to-destination transformation, it is possible to configure the automatic decryption of the encrypted source files using the PGP algorithm and private key uploaded to the secure key storage.

If the private key is available, all source files processed by the transformation will be automatically decrypted using the PGP algorithm and given key.  Note that the private key requires a password. 

Read how to generate a pair of public/private keys.