Populate Azure DevOps identifier reference fields for a custom table

Enable Azure DevOps project identifier reference fields for an Agile Development 2.0 table that you added to the map configuration of a process type.

Before you begin

Role required: admin

About this task

You can display references of ID, key, Azure DevOps project, and the project URL on your custom table form by adding an External Identifier reference field to your custom table and then adding the table to the Populate External Identifier Reference business rule.

Procedure

1. Navigate to All > System Definitions > Tables and open your custom table (for example, rm_defect).

2. Add an External Identifier reference field to your custom table with the following values.

   • Type: Reference
   • Reference table: sn_int_common_external_identifiers
   • Column name: u_external_identifier
   • Column label: External Identifier
   • Navigate to All > System Definitions > Business Rules.

3. From the list of business rules, locate and open the Populate External Identifier Reference rule.

4. In the When to run section of the form, include your custom table map by adding it to the filter conditions.

   For example, if the custom table that you added is Defect, do the following:

   1. Click Add "OR" Clause.

   2. Set the new clause to Reference table is rm_defect.

5. Update the Advanced Script section of the rule to handle the new custom table reference and map the External Identifier field accordingly.

6. Click Update.

What to do next

Configure the form layout or personalize the list layout of your custom table to display any or all of the following fields.

• External ID
• External Key
• External Project
• External URL

Parent Topic:Customizing your map configuration for Microsoft Azure DevOps integration

Related topics

Personalise a v2 list

Configuring the form layout

Populate external identifier on custom tables for Azure DevOps