Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Select Connections > Add connection.

  2. Select Dropbox for Business as the platform on the Add connection modal.

  3. Enter the connection information. Reference the table below for details about each field.

  4. Select Sign in with Dropbox for Business.

  5. On the Dropbox API Request Authorization modal, enter the Email and Password required to log in to the account and select Sign In. Only an Administrator account can be used for Dropbox for Business. Standard accounts will return an error from the Dropbox for Business platform.

  6. Select Allow when prompted to authorize the connection.

  7. You will see a "Connection test succeeded" message on the Add connection modal. (If you don't see this message, repeat the sign-in process and authorization steps above.)

  8. Select Done to finish creating the connection. 

Add Connection Modal - Dropbox for Business

...

Field

Description

Required

Display as

Enter the display name for the connection. If you will be creating multiple connections, ensure the name readily identifies the connection. The name displays in the application, and you can use it to search for the connection and filter lists.

If you do not add a display name, the connection will automatically be named, "Dropbox for Business." DryvIQ recommends that you edit the name to more readily identify the connection. 

Optional

Platform API client credentials

Required

Use the system default client credentials

Select this option to use the default DryvIQ client application.

Use custom client credentials

Select this option to use custom client credentials provided by your administrator. When selected, two additional fields will be available to enter the credentials.

Client ID

This field displays only when you select Use custom client credentials. This value will be provided by your administrator.

Required when using custom credentials

Client Secret

This field displays only when you select Use custom client credentials. This value will be provided by your administrator.

Required when using custom credentials

Include unmounted folders

Indicate if you want to DryvIQ to show unmounted folders owned by the user.

The default option is No, so unmounted folders do not display.

If you select Yes, DryvIQ will display unmounted folders owned by the user. Only folders will display; the contents for the folders will not display.

Info

DryvIQ will not migrate the unmounted folders if used in a job.

Note

The DryvIQ will be slow to return folders when you include unmounted folders due to the response times of the Dropbox API required to obtain this information.

Optional

Dropbox API Request Authorization modal

...

Allow Access to Dropbox 

...

Connection Test Succeeded

...

Features and Limitations 

...

Files and Folders

Below is a list of Dropbox's supported and unsupported features as well as additional file/folder restrictions. 

Supported (tick)

Unsupported (error)

Other Features/Limitations (warning)

Version preservation

(See Versioning below.)

File lock propagation

Invalid characters

< > \\ / : ? * \ | ~

Emoji characters in file and folder names will be replaced with an underscore.

Timestamp preservation

Mirror lock ownership

File size maximum: 50 GB or smaller
All file uploads must be smaller than the account storage space.

Author/Owner preservation

Restricted types

Path length maximum: n/a
(See Path Lengths below.)

Account map

Tags map

Segment path length: 255
(See Path Lengths below.)

Group map

Maximum number of files per folder: 10,000

Permission preservation

No trailing spaces after file extensions

User impersonation

Metadata map

...

DryvIQ does not support Dropbox paper. Dropbox Paper is a separate work space workspace that stores Paper documents in your account on http://paper.dropbox.com. DryvIQ doesn't support have having access to these documents as part of your Dropbox connection. 

...

Dropbox does not impose restrictions for on the total path length.

Segment path lengths are limited to 255 charactercharacters. Segments are delimited by a forward slash (/). For example, <max 255 characters>/<max 255 characters>.

...

While Dropbox allows you to store unlimited versions, the platform restricts version downloads to 100. This means only the most recent 100 versions for of a given file will be transferred to the destination. Refer to the Dropbox API Documentation for more information.  You can also find additional information in the Dropbox Forum.

Info

If you want to transfer just teams' folders, you can use the Dropbox for Business Teams Folders connector to create a connection that will transfer only teams' folders. 

...

Create Connection | REST API

...

Info

The following are known issues when creating a job for a Dropbox for Business account using an Administrator account connection.

  • Connection-based Impersonation should be used due to a caching issue which may incorrect shared folder detection

  • Connection-based Impersonation is shown in the user - interface as "Run As...." option on the Locations step when creating a new job

  • Path-based impersonation should not be used, first 'folder' is a user name such as "path": "/user@company.com/"

...