Upload to OneDrive

Updated a few days ago

3 min read

Overview

 

This action will upload files to OneDrive cloud storage.

 

Rules

 

  • The default location path is always uploader's OneDrive/Apps/Willow/[WorkflowName] folder
    • Characters : “ # % * : < > ? / \ | ~ & from workflow name will be replaced with “-”.
  • 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 “-”.
    • If a file/folder needs to be named after a Microsoft platform reserved name, Willow360 will rename it by adding a dash (-) to the end of the name
      • Reserved names: COM0, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT0, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, .LOCK, CON, PRN, AUX, NUL, DESKTOP.INI, FORMS, and also “_vti_” sequence anywhere in the name
      • For example, if a folder is to be named "lpt4", Willow will rename it to “lpt4-”
    • When the character “.” appears at the end of the subfolder name, it's 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 OneDrive credentials to upload files. Files will be uploaded to their OneDrive account.
    • On - User who ticks the checkbox while configuring workflow needs to provide their OneDrive credentials to upload files. Files will be uploaded to the default user's account. This helps organisations that want to automatically upload files to a default user's OneDrive account.
  • 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 OneDrive Sign In Screen
  • When the file is stuck in Unable to sign in to OneDrive status, there will be the Sign in to OneDrive action on File View and as a bulk action on To-do List. The action will lead to the OneDrive Sign In Screen.
  • After signing in, Willow stores the credentials for that user. Until OneDrive 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 OneDrive sign in, even files in another workflow.
  • Credentials can be cleared only in Personal Settings > Stored Credentials Panel
  • OneDrive action will create an entry in the File History. The entry will have the link to the chosen location on OneDrive.
  • The way OneDrive deals with the files with the same names is - it throws an error when you try to do so
  • Using the OneDrive 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 Upload to OneDrive action can use its data.
    • If you want more info on the actions where OneDrive location can be used in metadata inputs, please check the Metadata Concept chapter (under Export Location bullet).