All Products
Search
Document Center

:Automatic parent-child linkage

Last Updated:Jun 24, 2026

This topic explains how to use the parent-child relationship model to automatically link work items in project collaboration, helping teams respond quickly to changing requirements and keep projects on track.

Background information

In requirement collaboration, teams often break down requirements and delivery units using a parent-child relationship model. Apsara DevOps Projex supports automatic linkage between parent and child work items to reduce management overhead.

Apsara DevOps Projex enables automatic parent-child linkage as follows:

  • If all child work items are complete, the parent work item automatically changes to Complete.

  • If the iteration of a parent work item changes, its child work items update accordingly.

Configuration method

Go to your target project Settings (or Template settings) > Automation rules > Parent-child linkage and use the built-in template to configure Add automation rule.

Examples

Example 1: When all child work items reach the Complete status, the parent work item automatically changes to Complete.

In the Add automation rule dialog box, select the work item type as Product requirement, set the trigger condition to All child work items change to Complete, choose the action to Change parent work item status to Complete, and click Add to rule list.

Example 2: When a parent work item transitions to Complete, all its child work items automatically change to Complete.

In the Add automation rule dialog box, set the trigger condition to Product requirement status changing from Any status to Complete, choose the action to Change Child work item type status to Complete, and click Add to rule list.

Example 3: When the iteration of a parent work item changes, its child work items automatically update to match the parent’s iteration.

In the Add automation rule dialog box, select the category Parent-child linkage, choose the work item type Product requirement, set the trigger condition to a change in the Iteration field of the Product requirement, choose the action to Set Child work item Iteration to match the parent work item, set Execution account to Automation rule, and click Add to rule list.