Updated on 2025-07-22 GMT+08:00

Creating a Change Review for Requirements of a Baselined Release/Sprint

This section describes how to perform changes on requirements of a baselined release or sprint. The figure below shows the process.

Figure 1 Changing requirements of a baselined release/sprint
Table 1 Changing requirements of a baselined release/sprint

Process

Description

Step 1: Trigger the Change Review of Requirements of a Baselined Release or Sprint

  • Select R&D requirements of a baselined release or sprint, and click Change at the bottom of the list.
  • On the R&D requirement details page, edit the Release or Sprint field, and click the confirm button in the displayed dialog box.
  • Select R&D requirements and click Change at the bottom of the list.

Step 2: (Review Experts) Complete Review

Review experts complete the CR.

Step 3: (Approver) Complete Decision-making

The approver makes decisions on the CR.

Step 4: Requirement Field Values Changed Automatically upon Approval

After the change review is complete, R&D requirements are automatically moved into or out of the pipeline based on the change review conclusion.

This practice involves the following project roles, as shown in Table 2.

Table 2 Project roles

Member

Role

Responsibility

Sarah

Project creator (product owner)

Creates a project and sets up a team.

Chris

Product manager

Approves the CR.

Maggie

Developer

Initiates the CR.

Frank

System engineer

Serves as a review expert of the CR.

Billy

System engineer

Serves as a review expert of the CR.

Susan

System engineer

Serves as a review expert of the CR.

Step 1: Trigger the Change Review of Requirements of a Baselined Release or Sprint

After several rounds of clarification, the requirements for this phase have been finalized and organized in the delivery pipeline, and the pipeline has been baselined. Maggie, a project team member, needs to update the baseline pipeline by removing some requirements and adding new ones. Maggie adds these R&D requirements in a change review to make necessary adjustments. Maggie can also edit the Release or Sprint field of each requirement of a baselined release or baselined sprint to initiate a change.

  1. Go to the smart watch project, choose Work Item > Req > Plans, and click the baselined release or sprint that contains requirements to be removed from the pipeline.
  2. Select the requirements to be changed, click Change at the bottom of the list, and click the confirm button in the displayed dialog box.
  3. Go to the page for creating a CR. The R&D requirements selected in the previous step are automatically added to the Change Objects list in the review ticket.
  4. Enter the following information and click Submit. A change review is created.

    Table 3 CR information

    Parameter

    Description

    Example Value

    Title

    CR title.

    The value can contain letters, hyphens (-), underscores (_), commas (,), semicolons (;), colons (:), periods (.), slashes (/), parentheses, and spaces.

    The value can contain 1 to 256 characters.

    Retain the default value generated by the system in this document.

    Description

    CR description.

    The value can contain images, links, letters, digits, hyphens (-), underscores (_), commas (,), semicolons (;), colons (:), periods (.), slashes (/), parentheses, and spaces.

    The value can contain 1 to 50,000 characters.

    CR background: Requirements have been through multiple rounds of clarification, baselined, and entered the R&D pipeline. However, due to the project timeline, some requirements need to be replaced.

    CR value: Some R&D requirements need to be replaced. Remove requirements with a long development cycle and add requirements with a short development cycle.

    CR details: Refer to the associated files.

    If the change is triggered by editing the Release or Sprint field, the system automatically generates a change description.

    Require Decision-Making

    Whether this field is displayed in the review depends on whether Require Decision-Making is enabled on the Work Item Settings > Review page. If the switch is enabled, this field is displayed in the review form. If not, this field is not displayed.

    For details, see Configuring Reviews for IPD-System Device Projects.

    Yes

    Reviewer

    Approver, who makes decisions on the review object at the decision-making phase of the review.

    Single choice. This field is associated with the Require Decision-Making field. The options are the roles set in the review settings.

    For details, see Configuring Reviews for IPD-System Device Projects.

    Chris

    Review Expert

    Review expert, who reviews the review object in the review phase of the review.

    Select one or more project members. For details, see Configuring Reviews for IPD-System Device Projects.

    Billy, Frank, Susan

    Change Objects

    You can add multiple R&D requirements as change objects as required.

    Requirements needed to be moved into the pipeline in the R&D requirement list.

    Change

    For the Modify change type, the change content is the fields to be reviewed during the CR.

    • For requirements to be removed from the pipeline, change the Release or Sprint field to other release or sprint.
    • For requirements to be added to the pipeline, set the Release or Sprint field to the current release or sprint.

  5. Check the new CR on the review list page.

Step 2: (Review Experts) Complete Review

After the CR is submitted, review experts Billy, Frank, and Susan receive a to-do notification. Review experts access the review details page through the notification card and review the objects.

If the proportion of review experts whose review comments are Approve or Reject reaches the threshold set in Work Item Settings > Review > Review Methods, the review phase of this change object ends.

After the review phase of all change objects ends, all change objects under the CR are automatically transitioned to the decision-making phase.

If the review result of a change object is Rejected, the decision-making result will be automatically set to Rejected.

  1. Access the service homepage and click To-do Center in the upper right corner, or go to the smart watch project and choose Review > Change Review. On the Change Review page, select Pending review to check the CRs that need to be reviewed.
  2. Click a CR title to go to the details page. Click Expert Review in the Operation column of each change object, or select the change objects to be reviewed and click Expert Review in the upper right corner. The expert review dialog box is displayed.
  3. After filling in the information, click OK. The review is in the To be decided state.

    Table 4 Expert review parameters

    Parameter

    Description

    Example Value

    Result

    Select a value as required. When Transfer to others is selected, the Review Expert selection box is displayed and you must set this parameter.

    Approve

    Comments

    This parameter is mandatory when Result is set to Approve or Reject.

    Approve

    Expert Comments

    If multiple review experts participate in the review, their review comments will be displayed here.

    --

Step 3: (Approver) Complete Decision-making

After all review experts complete the review, Chris, the approver of the review, will be notified to proceed with the CR.

  1. Access the service homepage and click To-do Center in the upper right corner, or go to the smart watch project and choose Review > Change Review. On the Change Review page, select Pending decision-making to view the CRs that need to be approved.
  2. Click a CR title to go to the review details page. Click in the Operation column of each change object, or select the change objects to be decided by you and click Approver Decision in the upper right corner. The Approver Decision dialog box is displayed.
  3. After the parameters are set according to Table 5, click OK. The CR status is Completed.

    Table 5 Approver decision-making parameters

    Parameter

    Description

    Example Value

    Result

    Select a value as required. When Transfer to others is selected, the Reviewer selection box is displayed and you must set this parameter.

    Approve

    Comments

    This parameter is mandatory when Result is set to Approve or Reject.

    Approve

    Review Result

    This parameter indicates the final result of the review.

    Passed

    Expert Comments

    The review results and comments of review experts are displayed here.

    --

Step 4: Requirement Field Values Changed Automatically upon Approval

After the decision-making process of all change objects is complete, the CR status changes to Completed, indicating that the review is completed. Maggie, the review creator, goes to the project after receiving a notification.

  1. Access the service homepage and click Messages in the upper right corner, or go to the smart watch project and choose Review > Change Review. On the Change Review page, select I created to view the created CRs and their review result in the Status column.
  2. Click Plans. On the list of requirements of a baselined release or sprint, you can see that the requirements in the current pipeline have been replaced. The R&D requirement change process is complete.