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
Step 3. Under
Choose an API section, select
Step 4. Under
Choose the type of access you need, select
Step 5. Enter a name for your custom app.
Step 6. If you have a personal and a business account which are linked, you will be asked to select which account you want to own the app. Once you make a selection, you will be asked to sign in to that account.
Step 7. Click
Create app. You will be redirected to the control panel for your app.
Step 8. 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
Step 2. Select
Step 3. Enter Connection parameters.
Directory: the actual directory with files. This parameter is optional.
File: the actual file name or a wildcard file name, for example,
Access token: the access token generated in step 8.
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
uuidas 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
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
Filesis set to
oldestis selected, Etlworks Integrator will always select the oldest file in the folder which matches the wildcard
Override Wildcard File Name set for Connection: if
Wildcard File Namesare allowed,
Override Wildcard File Name set for Connectionis enabled, and the file name entered in the
FROMfield 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.
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.