Add a rule to a work item type (Inheritance process)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Custom rules provide support for a number of business use cases, allowing you to go beyond setting a default value for a field or make it required. Rules allow you to clear the value of a field, copy a value into a field, and apply values based on dependencies between different fields' values.

With a custom rule, you can define a number of actions based on specific conditions. For example, you can apply a rule to support these types of scenarios:

• When a value is defined for Priority, then make Risk a required field
• When a change is made to the value of Release, then clear the value of "Milestone"
• When a change was made to the value of Remaining Work, then make Completed Work a required field
• When the value of Approved is True, then make Approved By a required field
• When a user story is created, make the following fields required: Priority, Risk, and Effort
• When current user is a member of "Project Administrators", then make Priority required
• When current user is not a member of "Project Administrators", then hide the Priority field

Piezīme

You make a field required and specify a field default through the Options tab for the field.

Prior to defining a custom rule, review Rules and rule evaluation, Inherited process rule composition. For examples that illustrate common scenarios for applying rules, see Sample rule scenarios.

Prerequisites

For guidance on tailoring Azure Boards to align with your specific business requirements, see About configuring and customizing Azure Boards.

Category	Requirements
Permissions	- To create, delete, or edit a process: Member of the Project Collection Administrators group or specific collection-level permissions Create process, Delete process, Edit process, or Delete a field from organization set to Allow. For more information, see Set permissions and access for work tracking, Customize an inherited process. - To update boards: Team Administrator or a member of the Project Administrators group.
Access	- Even if you have Basic or lower access, you can still change a process if someone gives you permissions to do so. - To update and change the type of your existing work items: Member of the project.
Project process model	- Have the Inheritance process model for the project collection containing the project. - If migrating data to Azure DevOps Services, use the Team Foundation Server Database Import Service.
Knowledge	Familiarity with the customization and process models.

Open organization process settings

1. Sign in to your organization (https://dev.azure.com/{yourorganization}).

2. Select Organization settings.

   

3. Select Process.

   

Piezīme

When you customize an inherited process, any projects using that process automatically reflect the customizations. To ensure a smooth transition, we recommend creating a test process and project, which allows you to test your customizations before you implement them organization-wide. For more information, see Create and manage inherited processes.

Add a custom rule

You add fields to a selected work item type.

1. Select the WIT to which you want to add a rule, choose Rules, and then choose New rule.

   

   If you can't fill out the New work item rule dialog, you don't have the necessary permissions to edit the process. See Set permissions and access for work tracking, Customize an inherited process.

2. Name the rule and select the condition(s) and action(s) from the dropdown menus.

   Padoms

   Specify a name that builds off the field(s) you're acting on, or the conditions you're setting.

   Here we define that the Acceptance Criteria field is required when the State changes to Active and it is currently empty.

   

   The sequence of actions you specify doesn't impact the behavior of the rule itself or its behavior with respect to other rules defined for the same WIT.

3. Once you've added a custom rule, open a work item and verify that the rule works as you intended.

Delete or disable a rule

You can temporarily disable a rule or delete it altogether.

You delete or disable the rule from the actions menu of the rule.

Related articles

Piezīme

Review changes made to an inherited process through the audit log. For more information, see Access, export, and filter audit logs.

• Apply rules to workflow states
• Sample rule scenarios
• Rules and rule evaluation
• Customize the web layout
• Customize a project using an inherited process
• Work item form caching