---
title: "Set up Azure DevOps mapping"
slug: "set-up-azure-devops-mapping"
description: "Set up Azure DevOps mapping for RapidValue records, including work item types, field synchronization, and conditions for seamless integration."
tags: ["Task", "RapidValue", "RV"]
updated: 2026-03-20T13:42:21Z
published: 2026-03-20T17:46:36Z
canonical: "docs.staedean.com/set-up-azure-devops-mapping"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.staedean.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up Azure DevOps mapping

Before you can use the Azure DevOps integration, you must set up the DevOps mapping. This includes:

- Which RapidValue records map to which DevOps work item types.
- If you use work packages, to which DevOps work item types the work package groups and work packages are mapped.
- Which fields of these RapidValue records map to which fields of the DevOps work item.
- The synchronization direction of the mapping, which defines whether RapidValue (Out) or DevOps (In) owns the data.
- In case of an enum type field, which **RapidValue** field value maps to which **DevOps work item** field value.

### Steps

1. Click **Business process management**.
2. In the **Links section**, click **DevOps mapping**.
3. In the list, click the link of the desired mapping.
4. Click the **Mapping** tab.
5. Sub-task: Set up entity mapping.
  1. Set up which R**apidValue records map** to which work item types.

In the **Entity mapping** section, click **Add**.

> [!NOTE]
> Note
> 
> You can also copy an existing entity mapping to create a new entity mapping. To do so, select the entity mapping that you want to copy, and in the **Entity mapping** section, click **Copy**, fill in the fields as desired, and click **OK**
  2. In the **RapidValue table name** field, select an option.
  3. You can define a condition to only synchronize records with a specific field value. To do so, select a field in the RapidValue field name field and a value in the **RapidValue value** field.

In the **RapidValue field name** field, enter or select a value.
  4. In the **RapidValue value** field, enter or select a value.
  5. You can map a **RapidValue entity** to any **DevOps work item** type.

In the **Work item type** field, enter or select a value.
  6. If you want to use work packages to synchronize with DevOps, you must indicate this in the mapping.

To do so, for the business process mapping, select the **Parent work package** check box. As a result, on synchronize, in DevOps:

Select the **Parent work package** check box.
    - The business process work item gets the work package work item as the parent.
    - The work package work item gets the work package group work item as the parent.
    - This is only applied if on the business process the work package group and work package are assigned that are needed to create the hierarchy in DevOps.
  7. You can apply a task template on creation of a requirement in Azure DevOps.

A task template has a predefined set of tasks to be created for a requirement in DevOps. In DevOps, these tasks are added as work item with the requirement as parent work item.

In the **Task template** field, enter or select a value.

> [!NOTE]
> Note
> 
> Only apply a task template to a mapping record if the RapidValue table name is 'Requirement'.
6. Sub-task: Set default parent for mapped entity.
  1. In the **Entity mapping** section, click Set default parent.
  2. For the RapidValue entities which do not have a parent in the business process hierarchy, define a default parent work item. Otherwise no DevOps work item is available to which the created work item can be linked.

Use this, for example, to synchronize requirements only.

In the **Work item ID** field, type a value.

> [!NOTE]
> Note
> 
> Copy the work item ID in DevOps and paste it in this field.
  3. Before you can proceed, check the entered work item ID. If it is valid, the name and description are filled from the work item.

Click **Check**.
  4. Click **OK**.

> [!NOTE]
> Note
> 
> As a result, the Default parent for the selected entity mapping record is filled.
7. Sub-task: Define additional conditions.
  1. You can add additional conditions on top of the condition as defined in the RapidValue field name field and **RapidValue value** field in the **Entities** pane.

Use these conditions to only synchronize records with specific field values. To do so, in the **Conditions** pane, select a field in the **RapidValue** field name field and a value in the **RapidValue value** field.

In the **Entity mapping** section, in the **Conditions** pane, click **Add**.
  2. In the **RapidValue** field name field, enter or select a value.
  3. In the **RapidValue value** field, enter or select a value.
8. Sub-task: Set up entity field mapping.
  1. Set up which fields of the **RapidValue record map** to which fields of the DevOps work item. Also define the synchronization direction.

In the **Entity details** section, click **Add**.

> [!NOTE]
> Note
> 
> You can also copy an existing entity field mapping to create a new entity field mapping. To do so, select the entity field mapping that you want to copy, and in the **Entity details** section, click **Copy**, fill in the fields as desired, and click **OK**
  2. In the **Name** field, type a value.
  3. The direction of the field mapping defines whether RapidValue (Out) or DevOps (In) owns the data.

In the **Sync direction** field, select an option.
  4. In the **RV field name** field, enter or select a value.

> [!NOTE]
> Note
> 
> Fewer fields are allowed for the synchronization direction '**In**' than for the direction '**Out**'.
  5. In the '**DevOps field**' field, enter or select a value.
9. Sub-task: Set up entity field value mapping.
  1. If you set up a field mapping for an enum type field, define which RapidValue field value maps to which DevOps work item field value.

Example: You can use the field value mapping to link requirement statuses to work item statuses.

In the **Entity details** section, in the **Values** pane, click **Add**.
  2. In the **RapidValue value** field, enter or select a value.

> [!NOTE]
> Note
> 
> Do not define a field mapping for the **RapidValue** field that you defined in the entity mapping.
  3. In the **DevOps value** field, enter or select a value.
10. Close the page.
11. Close the page.

## Related

- [Set up Azure DevOps integration](/set-up-azure-devops-integration.md)