Azure Boards Airdrop

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

Setting up the Azure Boards connection

To configure the Azure Boards connection, ensure the Azure Boards token includes the following access scopes:

• Member Entitlement Management - Read
• Project and Team - Read
• Work Items - Read

Supported objects

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

Import from Azure Boards

Follow the steps below to import from Azure Boards:

1. Go to Marketplace and search for Azure Boards in the Airdrop category and install.
2. In the snap-in config modal, click Install then go to the Airdrop section in your settings left nav.
3. Click +Import and select the Azure Boards logo, click +Import.
4. Create a new connection to your Azure Boards account, or use an existing connection if you already have one.
5. Once the connection is established, select the Azure Boards account you want to import and specify the DevRev part that should be used for any imported work (future releases make use of this). This initiates a bulk import of the selected site.
6. DevRev makes an effort to automatically map the fields from Azure Boards to the corresponding fields in DevRev. However, you may be prompted to manually map certain fields if needed.

The duration of the import depends on the size of the Azure Boards account and the data being imported. It can take seconds for an account with only a few dozen work items to a few hours for an account with tens of thousands of items with many attachments. DevRev honors the Azure Boards API rate limits and back-off and resumes automatically.

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 Azure Boards with the corresponding items previously imported into DevRev. It also creates new items in DevRev for any new work items in Azure Boards 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 items that were imported from Azure Boards 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 an Azure Boards account, you can choose to sync the imported data with DevRev. This feature airdrops any new work items and users, and any changes made to previously imported items from Azure Boards.

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

1. Go to Settings > Integrations > Airdrops.
2. Locate the previously imported project.
3. Select the ⇆ > ⇾ From Azure Boards to DevRev option.

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

Sync from DevRev to Azure Boards

After a successful import of a Azure Boards project, you have the sync from DevRev to Azure Boards option. This feature writes back any changes made in DevRev to previously imported issues from Azure Boards. Additionally, any new DevRev work marked for sync to this project is created in Azure Boards. To perform a one-time sync to Azure Boards, go to Settings > Integrations > Airdrops, find the previously imported project, and select the ⇆ > ← From DevRev to Azure Boards option.

This overrides the workitem's fields, even if they were changed in Azure Board.

Mark a DevRev work item for syncing

Using the Sync from DevRev to Azure Boards feature, it's possible to sync DevRev work items to Azure Boards projects that have been imported to DevRev. In order to sync a DevRev work item to Azure Boards, it must be marked for syncing. Marking a DevRev work item for syncing can be done during the creation of a work item. During work creation, open the dropdown Select Subtype, set it to the Azure Boards project, and type the work item that should be synced. The display format is as follows: {Azure Boards project name} / {type}. For example, if you want to sync to a Bug to a Azure Boards project called Maple, this would show as Maple / Bug.