Upload to Dropbox

Overview

This action will upload files to Dropbox cloud storage.

Rules

• When configuring the action, the user will initially be prompted to pick Personal or Business Dropbox
• For Personal Dropbox, files will always be uploaded to the uploader's Personal Dropbox/Willow/[WorkflowName] folder
  • Characters : “ # % * : < > ? \ | ~ & ゛ဧ $ from workflow name will be replaced with “-”.
• For Business Dropbox, the user will have to pick a location
  • They will have to sign in to Dropbox first if they haven't entered their Dropbox credentials yet. Sign in screen will be opened in another tab.
    • Beware that the browser's pop-up blocker may block the tab from opening
  • After signing in, the list of folders will be presented so the user can pick the desired location
    • Please note that we only show the first 100 files in a folder. In case there are more, we write “Showing first 100 files only” at the bottom of the list.
    • User can't pick a location in the root of Dropbox Business's instance
  • Note that the access rights need to be configured on Dropbox too. For example, if you pick a location in Dropbox action, all the users that upload the files must be set as eligible to access that location in Dropbox. Otherwise, they will get a Dropbox error trying to upload files.
• Create new subfolder at the location lets the user specify the extension to the specified location path.
  • The path specified here may (and typically will) be dynamic, which means it will depend on the metadata variables of the file (e.g. when you want to categorise your files in Current year / Current month folders or create a CustomerID folder for each customer)
  • It will create a subfolder at the desired location or use the existing folder if it's already created and put the files in it.
  • Maximum number of characters for subfolder name is 200
  • Characters : “ # % * : < > ? \ | ~ & are forbidden when you try to put them directly in the text field for the subfolder path. If you use metadata value for the subfolder path, then the aforementioned characters will be replaced with “-”.
  • Enter character is replaced with space
  • Day and month metadata are padded with leading 0 if needed (like 08, 09, 10)
• Use Default User Credentials concept:
  • Off (default) - User who puts files into the workflow needs to provide their Dropbox credentials to upload files. Files will be uploaded in the name of the user who put files into the workflow.
  • On - User who ticks the checkbox while configuring workflow needs to provide their Dropbox credentials to upload files. Files will be uploaded in the name of that default user. This helps organisations that want to automatically upload files without other users ever supplying their Dropbox credentials.
• When files are put into the workflow, the user responsible for providing credentials will get a notification to do so (if the credentials weren't provided yet).
  • Note that that will be:
    • Whoever put the files into a workflow in case Use Default User Credentials isn't ticked
    • Default user, otherwise
• Notification leads directly to the Dropbox Sign In Screen
• When the file is stuck in Unable to sign in to Dropbox status, there will be the Sign in to Dropbox action on File View and as a bulk action on To-do List. The action will lead to the Dropbox Sign In Screen.
• After signing in, Willow stores the credentials for that user. Until Dropbox credentials expire, this upload action will be automatic. It will use the existing credentials to upload files and won't bother the user anymore.
• Furthermore, whenever the credentials are provided, it unblocks all the files waiting for Dropbox sign in, even files in another workflow.
• Credentials can be cleared only in Personal Settings > Stored Credentials Panel
• Dropbox action will create an entry in the File History. The entry will have the link to the chosen location on Dropbox.
• The way Dropbox deals with the files with the same names is - it overwrites the files, but it keeps the old versions in the Version History
• We store two separate credentials for Personal and Business Dropbox, so you may be logged in to a Personal Dropbox with one credentials and to Business with the other. Clearing credentials from the Personal Settings will clear both.
• Using the Dropbox location in other actions
  • Metadata inputs have the Export Location option, which is a URL to the file on the drive.
  • Only the actions after the Dropbox action can use its data.
  • If you want more info on the actions where Dropbox location can be used in metadata inputs, please check the Metadata Concept chapter (under Export Location bullet).