Using an IPD-System Device Project to Review Baselines of a Smart Watch R&D Project

Overview

A product goes through a complex R&D process from planning to release. CodeArts Req helps to manage these processes by requirement baselines, change requests of controlled fields, change reviews, and change management. Baseline changes must reach specified gate thresholds before going to the next stage to keep teams on the right track.

A company plans to launch a smart watch, which requires collaboration across departments and teams. R&D requirements have been assigned to each production and research team after rounds of communication and clarification on requirements. To ensure that products are delivered on time and with high quality, all R&D and production teams need to devotedly carry out tasks based on specified requirements. Therefore, baseline control for requirements is necessary and baselined requirements cannot be modified randomly. This sector describes how to use an IPD-system device project to simulate the smart watch R&D project to perform a BR.

Procedure

The basic operation process of the simulation case is as follows.

Figure 1 Basic operation process

Preparations

Before performing a specific task, you need to complete the following preparations:

• The project owner has registered a Huawei Cloud account. For details, see Signing Up for a Huawei Cloud Account.
• The project owner has created IAM users for project members. For details, see Creating an IAM User.
• You can purchase either CodeArts or CodeArts Req.
  • Purchasing CodeArts

    To complete all operations in this practice, you need to purchase CodeArts Pro Edition.

    1. Go to the Buy CodeArts.
    2. Select CodeArts Pro, retain the default value for Users, set Required Duration to 1 month, agree to the statement, and click Next.
    3. Confirm the order and click Pay.
    4. Follow the prompts to complete the payment.
    5. Check the subscription record on the CodeArts page.

• Creating an IPD-System Device Project

  Before starting the BR, the product owner Sarah creates a project.

  1. Click Access Service on the CodeArts console.
  2. Choose Create > Create Project and select IPD-System Device from the example projects.
  3. Enter the project name Smart Watch and click OK. The project is created.
• Adding Project Members

  Sarah creates accounts for team members and adds them to the project. Project members can be added in batches. For details, see How Do I Create Accounts for Multiple Users to Use CodeArts Req?

  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.
  Maggie	Project manager	Approves the BR.
  Chris	Developer	Initiates the BR.
  Frank	Test manager	Serves as the review expert of the BR.
  Billy	Tester	Serves as the review expert of the BR.

Step 1: Select Requirements and Initiate a BR

Chris, a project member, hopes that the R&D requirements determined in rounds of clarification will not be easily changed. Therefore, Chris adds these R&D requirements to the BR so that they can be controlled by locking the baseline.

1. Go to the smart watch project and choose Work > Req > R&D Requirements.
2. View the R&D requirements of the current project. Select the R&D requirements to be baselined and click Baseline Review on the operation bar in the lower part of the page.
   Figure 2 R&D requirement list

   

3. Go to the page for creating a BR. The R&D requirements selected in the previous step are automatically added to the Baseline Object list.
   Figure 3 Creating a BR

   

4. Enter the following information and click Submit to initiate a BR.

   Table 3 BR description

   Parameter	Description	Example Value
   Title	BR 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	Description of a review. 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.	BR background: The requirement has been clarified for multiple rounds and has entered the R&D phase. BR value: The following R&D requirements must be baselined and cannot be modified randomly. BR details: For details, see the associated files.
   Decision-Maker	Decision-maker of the review, who makes decisions at the decision-making phase of the review. When Require Decision-Making is disabled, this parameter is not displayed. That is, if Decision-Maker is not set in the review ticket, the review process will skip the pending decision-making phase. When Require Decision-Making is enabled, Decision-Maker is mandatory. You can configure the options of Decision-Maker by choosing Settings > Work Item > Review > Basic Review Settings. The default options are Project admin and Project manager. You can select only one option. NOTE: To enable Require Decision-Making, go to Settings > Work Item > Review > Basic Review Settings.	Maggie
   Review Expert	Review expert of the review, who performs review at the review phase of the review. When Require Decision-Making is enabled, Review Expert is optional. If Review Expert is not selected, the review phase will be skipped. If Require Decision-Making is disabled, Review Expert is mandatory. If Decision-Maker is not set in the review ticket, the review process will skip the pending decision-making phase. You can configure the options of Review Experts by choosing Settings > Work Item > Review > Basic Review Settings. Multiple options can be selected.	Billy, Frank
   Baseline Object	Add the objects that need to be baselined. Only unbaselined objects are supported. The baseline objects include SF, IR, SR, AR, and task.	Requirements selected in the R&D requirement list.

Step 2: (Review Experts) Complete Review

After the BR is submitted successfully, the review experts Billy and Frank will receive a notification, access the review details page through the notification card, and review the requirements.

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 > Baseline Review. On the Baseline Review page, select To be reviewed by me to view the BRs that need to be reviewed.
   Figure 4 List of BRs to be reviewed

   

2. Click the title of the BR. On the review details page, click Expert Review in the upper right corner. The Expert Review dialog box is displayed.
   Figure 5 BR details

   

   Figure 6 Expert review

   

3. After setting the following parameters, click OK to complete the BR review.

   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.	OK
   Expert Comments	If multiple review experts participate in the review, their review comments will be displayed here.	--

Step 3: (Decision-Maker) Complete Decision-Making

When the percentage of review experts selecting Approve or Reject reaches the threshold set in the Review Methods area on the Work Configuration > Review page, the BR automatically moves from the review phase to the decision-making phase.

If the review result of the BR is Rejected, the decision-making result will automatically be Rejected and the BR will be in the End state.

After review experts complete the review, Maggie, 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 > Baseline Review. On the Baseline Review page, select Pending decision-making to view the BRs that need to be approved.
   Figure 7 To-do Center

   

2. Click the title of a BR to go to the BR details page. Click Decide by reviewer in the upper right corner of the details page. The Decide by reviewer dialog box is displayed.
   Figure 8 BR details

   

   Figure 9 Decision-making by the decision-maker

   

3. After setting the following parameters, click OK to complete decision-making on the BR.

   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, Reject, or Deny.	OK
   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: Baseline the Requirements

After the review is approved, the review transits to the End state, indicating that the review is completed. Chris, the creator of the review, will be notified to proceed with the CR.

1. Access the service homepage and click Messages in the upper right corner, or go to the smart watch project and choose Review > Baseline Review. On the Baseline Review page, select I created to view the created BRs and their review result in the Status column.
   Figure 10 Notices

   

   Figure 11 BR list page

   

2. Click the R&D Requirements tab. On the displayed page, all R&D requirements added to the BR are in the Baselined state. The baseline locking of R&D requirements is implemented.
   Figure 12 R&D requirement list

   

   The locked baseline fields of baselined R&D requirements cannot be changed randomly. Changes take effect only after review.

   Figure 13 Change notification