Dropbox is a file hosting service that offers cloud storage, file synchronization, personal cloud, and client software.
Please note that terms used in the Dropbox channel categories are Dropbox specific terminology.
On the My pipelines page, click Create a pipeline. Enter name, description, and tag fields and click the Create Pipelines button. The pipelines wizard displays:
- From the wizard you choose the connections for the first steps of your pipeline. When you choose a type, you'll add the channels and steps for your first steps. You can always add more steps later. A Triggered pipeline is started by a specific event in real-time. A Scheduled pipeline will start according to a schedule. A Manual pipeline only starts manually. Once you've completed the wizard, you'll be prompted for connection detail, if necessary. If you are an experienced builder, click the Start from scratch button and then from the right side of the page, choose the All to list all available channels.
- Expand Dropbox in the list of channels on the right side of the page and click Connect to Dropbox.
- In the pop-up window, click Connect to Dropbox.
- Sign in with your Dropbox credentials and click Sign in.
- You will be asked to allow Quickbase permission to access your Dropbox account, click Allow.
How to reconnect the Dropbox channel
You may need to reconnect your account to a channel. Reasons may be (but not limited to):
If you need to connect a different account.
Authorization updates, such as a changed password.
Editing the access rights that Pipelines has to the channel.
- Select a pipeline that already has Dropbox in it.
- Open a step containing Dropbox.
- Under account, select Connect (or reconnect) and follow the process above, How to connect.
The steps you can use with Dropbox fall into two categories: Folders and Files.
Creates a new child folder in the parent folder identified in the Parent Folder field. If the field is left empty, the root folder will be used.
The Name field used for naming your new folder, accepts the standard forward-slash ( / ) sub-folder(s) prefix . For example, Q1-reports/finance-jan, where finance-jan is a subfolder of Q1-reports.
Deletes a target folder identified in the Folder field. This field receives information that is either created or looked up by path/id in a previous step within the pipeline.
|Action||Copy a Folder|
Copies the target folder, identified in the Folder field, and all its contents to a new location. The Folder field receives information that is either created or looked up by path/id in a previous step within the pipeline. You may choose to provide a Destination Folder for the copied contents to be placed or if left blank, the default root folder is selected. *
|Action||Move a Folder|
Moves a particular folder and its contents from one place to another. It functions similarly to Copy a Folder by supplying the Folder field with information that is either created or looked up by path/id in a previous step. Specify a location to move your folder to, in the Destination Folder field, or leave blank to use the root folder as the parent.*
|Action||Share a Folder|
Share a particular folder and its contents.
|Query||Search Folders||Searches for folders and returns a list of potential matches based on the search criteria. The Recursive field is set to Yes by default.|
|Action||Look Up Folder|
Looks up a folder and returns a single record based on the search criteria.
Note: When using a path for your query, use everything after the /home section of the Dropbox URL.
Initiates the pipeline when any file is modified (i.e. uploaded, moved,or copied). The optional Folder field is used to select a particular folder to watch for any activity to any of the files, in order to trigger the pipeline.
Deletes a target file identified by information received from uploaded, moved, or copied files from previous steps, or looked up by path/id, in an earlier step.
|Action||Copy a File|
Copies a target file identified by information received from uploaded, moved, or copied files from previous steps, or looked up by path/id in an earlier step. The Destination Field is optional and is used to specify the location for your file(s).If nothing is entered, the root folder is the default location. *
|Action||Move a File|
Moves a particular file from one place to another. Similar to the Copy a File step above, the File field is populated with options from information that is either created or looked up by path/id in a previous step. Use the Destination Folder field to specify where to move the data or leave blank to default to the root folder.*
|Action||Upload a File||Uploads a file. Max allowed file size is 150 MB.|
Searches for files and returns a list of potential matches based on the search criteria.
The Recursive field, which will recursively search to all sub folders and return results, is set to Yes by default.
|Action||Look Up File||Looks for a file based on search criteria and returns a single record.|
At times, there have been issues with the Copy and the Move steps running correctly and cause them to fail, typically due to an external issue. The following example image shows a typical error window and the following list are the other types of errors you may see in the error window.
- cant_copy_shared_folder - shared folders can't be copied
- cant_nest_shared_folder - move action would result in nested shared folders. This is not allowed.
- cant_move_folder_into_itself - cannot move a folder into itself.
- too_many_files - the action would involve more than 10,000 files and folders, which is not allowed.
- duplicated_or_nested_paths - there are duplicated/nested paths among from_path and to_path.
- cant_transfer_ownership - move action would result in an ownership transfer.
- insufficient_quota - the current user/account does not have enough space to move or copy the files.
- cant_move_shared_folder - can't move the shared folder to the given destination.