Usage differences for the "upload" action

The "upload" action has usage differences between FileStore (NS3) and ObjectStore (NS4).

Upload modes supported

  • FileStore: Binary and Form
  • ObjectStore: Binary, only

Uploaded files and directories with the same name

  • FileStore: Not Supported — An uploaded file and a directory that exist within the same parent can not have the same name.
  • ObjectStore: All path names are treated independently of all other path names. Therefore, uploaded files and directories within the same parent can use the same name.

Trailing slashes (“/”) in symlink names

  • FileStore: Not Supported. “/” can only exist as path separators.
  • ObjectStore: Since a traditional file system is not in place, any number of trailing slashes can be included at the end of a file name.

Non-existent directories in a specified path

  • FileStore: When a path is specified for a n upload, if any sub-directory along that path does not currently exist, FileStore will create it as a physical directory, and house the uploaded file in the last directory named in the path.
  • ObjectStore: The final value noted in the path will be seen as the name for the uploaded file. Any non-existent directory within that path will be set up as Implicit, and will be associated as such with the uploaded file.
Note: The same rules that apply to the mkdir action for ObjectStore, in regards to trailing slashes (“/”), and periods (“.”) in a directory name also apply to any directories established in a path for the upload action.