List of Transformers

You are here: Web ServicesDropboxConnector

DropboxConnector

Using Dropbox’s file storage service, uploads, downloads, or deletes files/folders from a Dropbox account.

Input Ports

ClosedInput

This transformer accepts any feature.

Output Ports

ClosedOutput

The output of this transformer will vary depending on the Dropbox Action performed.

  • After an Upload action, URLs to the file may be saved to the Sharable Link and Direct Download Link attributes.
  • A Download action can save to either a file or attribute.
  • A Delete action will save the number of files/folders deleted to the Deleted File Count attribute.
  • Finally, a List action 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.
Closed<Rejected>

Features that cause the operation to fail are output through this port. An fme_rejection_code attribute, having the value ERROR_DURING_PROCESSING, will be added, along with a more descriptive fme_rejection_message attribute which contains more specific details as to the reason for the failure.

Parameters

Request

ClosedDropbox Action

The type of operation to perform.

ClosedDropbox Account

Performing operations against a Dropbox account requires the use of OAuth2 authentication using a Web Connection. To create a Dropbox connection, click the 'Dropbox Account' drop-down box and select 'Add Web Connection...'. The connection can then be managed via Tools -> FME Options... -> Web Connections.

The remaining parameters available depend on the value of the Dropbox Action parameter. Parameters for each Dropbox Action are detailed below.

ClosedDelete

Dropbox Path

ClosedDelete File at Path

Path to a file/folder on Dropbox to delete.

Output Attributes

ClosedDeleted File Count

Specify the attribute that will store a count of the number of files/folders that were deleted.

ClosedDownload

Dropbox Source

ClosedDownload File at Path

The Dropbox path to the file to download.

Destination

ClosedDownload as

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.
ClosedDownload to File

Specify the path to the file that will store the downloaded file.

ClosedDownload to Attribute

Specify the attribute that will store the contents of the downloaded file.

ClosedList

Dropbox Path

ClosedList Contents at Path

The path on Dropbox to list the contents of.

Output Attributes

ClosedFile or Folder Name

Specify the attribute to hold the name of an object on Dropbox.

ClosedFull Path

Specify the attribute to hold the full path of an object on Dropbox.

ClosedFile Size

Specify the attribute to hold the size of an object on Dropbox.

ClosedRevision

Specify the attribute to hold the revision string of an object on Dropbox.

ClosedLast Modified

Specify the attribute to hold the last modified date of an object on Dropbox.

ClosedFile or Folder Flag

Specify the attribute to hold the type (file or folder) of an object on Dropbox.

ClosedUpload

Source

ClosedUpload from

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 Content: The contents of the specified attribute will be uploaded.

When working with large objects, File is a better choice than Attribute Content as the data will be streamed directly from disk and not require that the object be stored entirely in memory on a feature.

ClosedFile to Upload

The file to be uploaded to Dropbox if Upload from is set to File.

ClosedSource Folder

The folder to be uploaded to Dropbox if Upload from is set to Folder.

ClosedInclude Subfolders

Choose whether to upload subfolders of the Source Folder or not.

ClosedAttribute to Upload as File

The data to be uploaded, supplied from an attribute if Upload from is set to Attribute Content.

ClosedData Encoding

The encoding type of Attribute to Upload as File.

Dropbox Destination

ClosedUpload to Path

The path on Dropbox to upload the source file to. To upload to the root directory, enter “/”.

ClosedUpload with File Name

The name of the file created from the data supplied in Attribute to Upload as File. The name must include a filename extension (e.g. .txt, .jpg, .doc).

Output Attributes

ClosedShared Link

Specify the output attribute that will store a temporary publicly accessible URL that links to the file on Dropbox.

ClosedDirect Download Link

Specify the output attribute that will store a URL that links to the file on Dropbox. The URL can only be used by authenticated users.

Usage Notes

This transformer cannot be used to directly move or copy files between different Dropbox locations.

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

Web Services

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.