Dropbox Airdrop

The Dropbox Airdrop simplifies migration from Dropbox to DevRev, supporting both one-time imports and ongoing syncs.

Key features

• User profile sync for all team members within a Dropbox Business account.
• Complete file and folder hierarchy sync with directory structure preservation.
• Sync of private folders, team member folders, shared folders, and Dropbox Paper documents (.paper, .papert) for all team members.
• Group and group member data sync with membership details.
• Permission synchronization with granular access controls on files.

Supported objects

The following is a list of Dropbox objects and their corresponding DevRev equivalents. Those marked as Sync to DevRev are eligible for import from Dropbox to DevRev.

Supported document types

The Dropbox Airdrop supports importing the following document types as attachments to DevRev Articles:

• Google Workspace documents (.gdoc, .gsheet, .gslides, .gdraw, .gform)
• Microsoft Office documents (.doc, .docx, .ppt, .pptx, .xls, .xlsx)
• PDF documents (.pdf)
• Plain Text files (.txt)
• HTML and Web files (.html, .web)
• Development files (.css, .js, .json, .xml)
• Image formats (.jpg, .jpeg, .png, .gif, .svg)
• Video and Audio files (.mp4, .mov, .mp3)
• ZIP archives (.zip)
• Dropbox Paper documents (.paper, .papert)
• And other common document formats supported by Dropbox.

Dropbox Paper documents (.paper, .papert) are imported as HTML files to preserve formatting and structure.

Import from Dropbox

1. Go to the Marketplace and search for Dropbox in the Import category and install.
2. In the snap-in config modal, click Install.
3. Go to the Import section in your settings left nav.
4. Click +Import and select the Dropbox logo.
5. Create a new connection to your Dropbox account, or use an existing connection if you already have one.

You must use an admin connection. Non-admin connections are not supported at this time.

6. Once the connection is established, select the Dropbox team you want to import and specify the DevRev part to be used for any imported work. This initiates a bulk import of the selected team.
7. DevRev makes an effort to automatically map the fields from Dropbox to the corresponding fields in DevRev. However, you may be prompted to manually map certain fields if needed.

Post import options

After a successful import, you have the following options available for the imported account:

• Sync to DevRev

  This option allows you to synchronize any modifications made in Dropbox with the corresponding items previously imported into DevRev. It also creates new items in DevRev for any document in Dropbox after the last sync or import.

• View Report

  This option allows you to access detailed information about the initial import and any subsequent syncs performed.

• Delete Import

  If you want to remove the import and all data that were imported from Dropbox into DevRev, you can use this option.

• Edit Connection

  Use this option to change the connection used for any subsequent actions. It can be helpful if a connection becomes inactive or the user who established it is no longer available.

Sync to DevRev

After a successful import from Dropbox, you can choose to sync the imported data with DevRev. This feature imports any docs and users, and any changes made to previously imported items from Dropbox.

To perform a one-time sync to DevRev, follow these steps:

1. Go to Settings > Integrations > Imports.
2. Locate the previously imported project.
3. Select the ⋮ > Sync Dropbox to DevRev** option.

A one-time sync may overwrite fields in previously imported items, even if they were modified in DevRev.

Historical imports

To view currently running and previous imports from various sources, do the following:

1. Go to Settings > Integrations > Imports.
2. Select the import you want to view.
3. Click on the context menu (⋮) and select View Report.

Periodic sync

After successfully importing to DevRev, you have the option to enable a periodic sync. This allows for automatic synchronization with DevRev on a regular basis. By default, the sync occurs once an hour.

To configure periodic sync, follow these steps:

1. Go to Settings > Integrations > Imports.
2. Locate the previously imported project.
3. Select the ⋮ > Set Periodic Sync option.

The Enable automation for synced items setting is optional and can be activated during periodic sync configuration. When enabled, newly created or updated items trigger events, which can initiate webhooks, notifications, snap-ins, and other processes, as if the events originated directly in DevRev.

If this setting is turned off, updates do not trigger any event-driven processes. This behavior applies only to periodic syncs; no events are triggered during a first-time import or manual sync to or from DevRev.

Delete import

This deletes any content created by the import, including users, groups, members, and articles.

An import and all the content it creates can be deleted from DevRev. This can be useful when running POCs or to change the recipe used during the import. Once an import has been deleted, all the content it created gets deleted, even if they were modified in DevRev. It's possible to import the project again after its deletion.

To delete an import and all the content it created, go to Settings > Integrations > Imports, find the previously imported project, and select ⋮ > Delete Import.

Limitations

• Supports sync only with Dropbox Business accounts; personal accounts are not supported at this time.
• An admin connection is required for synchronization; non-admin connections are not currently supported.
• Periodic sync duration may equal or exceed initial import time.
• Folder permissions are not synchronized. Users can see all types of folders belonging to other team members but cannot access files within those folders without proper permissions.