DevRev Airdrop

The DevRev Airdrop simplifies migration of objects from one DevRev dev org into another one, supporting both one-time imports and ongoing syncs.

Supported objects

The following is a list of DevRev objects that the user might expect to be successfully imported from the target organization. Those marked as Supported are eligible for import.

Importing from DevRev

Follow the steps below to import from DevRev:

1. In the Marketplace, search for DevRev ADaaS under the Import category
   and install.
2. In the snap-in config modal, click on Install, then go to the Import section on your settings left nav
3. Click +Import to start an import, then select the DevRev ADaaS option.
4. Create a new connection to your external dev organization from which data is pulled, or use an existing connection if you already have one. A personal access token which has access to that particular org is required.
5. Once the connection is established, select the dev org you want to import and specify the DevRev part that should be used for any imported work. This initiates a bulk import of the selected site.
6. A pre-defined mapping is provided for all object types to ease on the user's required interaction and have them set beforehand. However, you may be prompted to manually map certain fields if needed.

The duration of the import depends on the size of the dev org and the data being imported. It can take seconds for an account with only a few dozen tickets to a few hours for an account with tens of thousands of items with many attachments.

Post import options

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

• View Report
  • This option allows you to access detailed information about the initial import and any subsequent syncs performed.
• Delete Import
  • If you wish to remove the import and all items that were imported from the external source, 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.

Historical Airdrops

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

1. Go to Settings > Integrations > Airdrops.
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 > Airdrops.
2. Locate the previously imported project.
3. Select the ⇆ > Set Periodic Sync option.

The Enable automations 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 disabled, updates will 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 and works.

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 > Airdrops, find the previously imported project, and select ⋮ > Delete Import.