DropboxCaller
Using Dropbox’s file storage service, uploads, downloads, or deletes files/folders from a Dropbox account.
Input Ports
This transformer accepts any feature.
Output Ports
The output of this transformer will vary depending on the operation performed. After an Upload operation, a URL to the file will be saved to the Object URL Attribute. A Download operation can save to either a file or attribute. A Delete operation will save the number of files/folders deleted to the Delete Count Attribute. Finally, a List operation will output a new feature for each file/folder found in the path specified. Each of these new features will have attributes listing various pieces of information about the object.
Features that cause the operation to fail are output through this port. Additionally, a message stored in the attribute specified in Error Attribute will contain details about the failure.
Parameters
Request
Performing operations against a Dropbox account requires the use of OAuth2 authentication using a Web Connection. If you have not already added a Dropbox connection, select “Add Web Connection…” from the dropdown menu. Make sure to select the “Dropbox” option from the “Web Service” dropdown in the resulting window.
The type of operation to perform.
Specify the output attribute that will store any messages from errors during an operation.
Parameters
The parameters available here depend on the value of the Operation Type parameter. Parameters for each Operation Type are detailed below.
Upload
The source of the data to be uploaded.
- File: The specified file will be uploaded.
- Folder: The specified folder and its contents will be uploaded.
- Attribute: The contents of the specified attribute will be uploaded.
When working with large objects, File is a better choice than Attribute as the data will be streamed directly from disk and not require that the object be stored entirely in memory on a feature.
The path on Dropbox to upload the source file to. To upload to the root directory, enter “/”.
The file to be uploaded to Dropbox if Source Type is set to File.
The folder to be uploaded to Dropbox if Source Type is set to Folder.
Choose whether to upload subfolders of the Source Folder or not.
The data to be uploaded, supplied from an attribute.
The encoding type of Data to Upload.
The name of the file created from the data supplied in Data to Upload. The name must include a filename extension (e.g. .txt, .jpg, .doc).
Output
Specify the output attribute that will store a URL that links to the file on Dropbox.
Download
Select whether to store the downloaded data in a File or Attribute.
- File: The downloaded object will be stored in the specified file.
- Attribute: The downloaded object will be stored in the specified attribute.
The Dropbox path to the file to download.
Specify the path to the file that will store the downloaded file.
Specify the attribute that will store the contents of the downloaded file.
Delete
Path to a file/folder on Dropbox to delete.
Specify the attribute that will store a count of the number of files/folders that were deleted.
List
The path on Dropbox to list the contents of.
Output
Specify the attribute to hold the name of an object on Dropbox.
Specify the attribute to hold the full path of an object on Dropbox.
Specify the attribute to hold the size of an object on Dropbox.
Specify the attribute to hold the revision string of an object on Dropbox.
Specify the attribute to hold the last modified date of an object on Dropbox.
Specify the attribute to hold the type (file or folder) of an object on Dropbox.
Editing Transformer Parameters
Using a set of menu options, transformer parameters can be assigned by referencing other elements in the workspace. More advanced functions, such as an advanced editor and an arithmetic editor, are also available in some transformers. To access a menu of these options, click beside the applicable parameter. For more information, see Transformer Parameter Menu Options.
Transformer Categories
FME Licensing Level
FME Professional edition and above
Search FME Knowledge Center
Search for samples and information about this transformer on the FME Knowledge Center.