Managing System Features

Search for system feature

• By adding filters
  1. Click the search box in the feature list and select one or more filters to search for system features.
  2. To clear all filters and display all data, click on the right of the search bar.
• By using a saved view
  1. Click the search box in the system feature list and select one or more filters.
  2. Click on the rightmost of the search bar, and enter a view name.
  3. Click Confirm. The created view is displayed next to the SF button.
  4. Select the created view to query the system features that meet the search criteria.

     Views can be shared with others, modified, and deleted.

Import work items

Use the provided template to import system features.

1. In the system feature list, click on the right of the search bar, and select Import SF.
2. In the displayed dialog box, click Download Template.

   The import template file is displayed in the lower part of the page. Save the file to the local PC and fill in data. The template file should be named in the following format: Project name + "-" + Module name (for example, Feature) + Template.

3. Set the fields in the SF - List sheet of the template.

   For details about how to set parameters, see the SF - Import Rules sheet in the template file.

4. Drag or click to select a file to be imported.
5. Click Import. The import progress dialog box is displayed.
   • After the import is successful, you can view the imported requirement information in the system feature list.
   • If the import fails, a message is displayed in the upper right corner of the page. Click View Failure Details in the message to view the failure details. You can modify the requirement information based on the details and import the template again.
     NOTE:

     For details about operations on import records, see Viewing Work Item Import/Export Records.

Export work items

Export system features in batches to an Excel file.

1. Export some or all system features.
   • Export all: On the Feature Tree page, click on the right of the search bar and choose Export All. The Select Fields to Export dialog box is displayed.
   • Export some: In the feature list, select one or more system features to be exported and click Export Selected at the bottom of the page. The Select Fields to Export dialog box is displayed.
2. Select the fields to be exported.
3. Click Export. A dialog box is displayed, indicating the export progress.
   • After the system features are exported, click Download. The feature file will be downloaded to the local PC. The file format is .xlsx.
     NOTE:

     For details about operations on export records, see Viewing Work Item Import/Export Records.

Configure fields to display

Clone SFs across projects

Constraints

• Only SFs can be cloned. The workload, associated work item, tag, and release sprint fields will be cleared.
• You must have permission to create and clone SFs for the target project.
• SFs can be cloned only to projects of the same type.
• You can clone up to 50 SFs at a time.

Procedure

1. Select the SFs to clone in the feature list and click Cross-Project Copy in the lower part of the page. The Cross-Project Copy window is displayed.
2. Select a target project from the drop-down list. You can select only a project to which you have joined and must have permission to create and clone tasks for the target project.
3. Click Next. The window for setting mandatory fields is displayed. Select the target owner from the drop-down list (the current operator is selected by default). Mandatory fields are those on the SF creation page of the target project.
4. Click OK. The SFs are cloned to the target project.
5. Go to the target project to view the cloned SFs.

Transition statuses in batches

Constraints

• The types of the selected work items must be the same.

• The selected SFs must be in the same status.
• You must have permission to set statuses for SFs.
• Mandatory fields of the selected SFs have been set.

Procedure

1. Select the target SFs in the SF list and click Batch Transfer in the lower part of the page. The Batch Transfer window is displayed.
2. Select the target status from the drop-down list.
3. Click Next.
4. Set mandatory fields. The mandatory fields are set on the In-transition GUI Config tab page of the project's SF status flow configuration page.
5. Click OK.

Perform batch operations

You can select multiple SFs to perform batch operations: baseline/unbaseline, change, baseline review, edit, suspend/unsuspend, export, delete, cross-project clone, and transition.

Group system features

You can group work items by any supported field type.

Constraints

• A maximum of 1,000 work items can be displayed during grouping.
• The supported field types include single-choice list, multi-choice list, single-choice user, multi-choice user, hierarchy, and date.
• For projects in a program (after sub-project aggregation is enabled), grouping by release, sprint, module, feature set, or tag is unavailable.

Procedure

1. In the system feature list, click Group.
2. On the displayed page, select the fields used to group work items.
   NOTE:

   • You can sort work items in ascending or descending order.
   • You can enter a keyword to search for fields.
   • When work items are grouped by multi-select list or multi-select user, the same work item may appear in multiple groups.
   • You can click No grouping to ungroup work items.

Edit work item

On the system feature details page, click the value box of the field to be modified, and enter a target value in the text box or select one from the drop-down list. The modification is saved automatically.

You must have permission to edit features.

Change work item status

Go to the work item details page, click the Status field, and transition the work item to the target status. For details about status transition, see Table 1.

You must have permission to set statuses for features.

Baseline feature

1. Go to the work item details page, and choose > Baseline. The Baseline dialog box is displayed.
2. Click OK.

   The baseline icon is displayed on the left of the system feature title. You can unbaseline system features that have been baselined.

You must have permission to baseline features.

Initiate baseline review (BR)

1. Go to the work item details page, and choose > Baseline Review. The BR page is displayed.
2. Enter BR information.

   By default, the Baseline Object is the system feature for which the baseline review is initiated.

3. Click Submit. The Review page is displayed.

   Choose Review > Baseline Review to check the new baseline review.

4. Switch to the Feature Tree page. The icon of the system feature that is under baseline review is displayed as .

   Track the progress of the baseline review. The system feature can be baselined only when the baseline review status changes to Approved.

You must have permission to view features.

Initiate change review (CR)

The change process can be initiated only for baselined system features.

1. Go to the details page of a baselined work item, and choose > Change Review. The CR page is displayed.
2. Enter CR information.
   • Change Object: By default, it is the system feature to be changed.
   • Collaborative Parent Item Change: Only existing CRs can be added.
3. Click Submit. The Review page is displayed.

   Choose Review > Change Review to check the new CR in the change process. The CR state is Pending review by default.

   Track the progress of the CR. Only when the state is Approved, which means that the CR has been processed, will the changed content display in the corresponding system feature.

You must have permission to view features.

Upload attachment

Attachments can be pictures, workbooks, manuscripts, and text files. A maximum of 100 attachments can be added to each work item, and their total size cannot exceed 500 MB.

1. Go to the work item details page, and click the Attachment tab.
2. Click the box to select a local file or drag the file here to upload it as an attachment for the work item.

   Local files can be directly dragged to the text box. When the upload progress reaches 100%, the system displays a message indicating that the attachment is uploaded successfully.

   Move the cursor to the file that is successfully uploaded. The operations that can be performed are displayed.

   • Click to download the file.
   • Click to delete the uploaded file.

You must have permission to upload attachments for features.

Add and check related item

A work item can be associated with other types of work items in a project.

1. Go to the work item details page and click the Related Items tab.
2. Complete association.
   • Subrequirement: Child requirements of the current feature.

     Click Break Down to add child requirements.

     A maximum of 10 child requirements can be created at a time. One child requirement is displayed by default and cannot be deleted. Click to expand and configure more information.

     After the child requirements are created, you can check and edit them on the R&D Requirements tab.

     Click Associate to add existing requirements as child requirements.

     You can add multiple ones at a time.

   • Associate Work Item: associated work items of other types in the project.

     Tasks can be associated.

   • Test Case: test cases corresponding to the system feature. You can select system features associated with test cases in CodeArts TestPlan.

You must have permission to create/associate/dissociate child features, create/associate/dissociate child requirements, create/associate/dissociate work items, associate/dissociate files, and associate/dissociate wikis for features.

Check review record

You can check the review records related to system features only in the following situations:

• When a system feature is added to a baseline review, the baseline review process is triggered. Only then will you be able to view the review record on the Review tab of the system feature details page.
• When a locked field of a baselined system feature is modified, the change process is automatically triggered. Only then will you be able to view the review record on the Review tab of the system feature details page.
• When a system feature has a general review record, you can check the record on the Review tab of the system feature details page.

You must have permission to view features.

Add workload

1. Go to the work item details page and click the Workload tab.
2. Click Add Workload. The Add Workload dialog box is displayed.
3. Enter the workload information.
   • The end date cannot be earlier than the start date.
   • Decide whether to select Weekends included. If not, weekend workload records will not be generated.
   • You can select Total or Daily for Workload.
   • Work Type options include backend development, frontend development, UI design, replacement leave, debugging, and general. You can also customize the value by referring to Creating Work Types.
4. Click OK.

   The system automatically generates corresponding records based on the entered dates and days.

   The workload can be edited and deleted.

You must have permission to add person-hours for features.

Workloads can be edited and deleted by the creator. By default, the project administrator can edit and delete all workloads.

View operation history

History displays all operation logs of users, including creation, status transition, review initiation, work item association, and workload addition.

1. Go to the work item details page.
2. Click the History tab.
   • Click or to check historical records in the ascending or descending order of operation time.
   • You can set search criteria to query historical records that meet the search criteria.

You must have permission to view features.

Tag work item

1. Go to the work item details page. Click next to Tag at the top of the page, and select Create Tag.

   The added tag is displayed in the Tag area.

2. In the Create Tag dialog box, set Tag Name and select Tag Color.
3. Click OK.

   The new tag is displayed next to the requirement ID in the feature list.

4. (Optional) Hide a tag.
   • Click next to Tag. In the displayed dialog box, deselect √ to hide the tag.
   • Move the cursor to the tag name and click to hide the tag.

     

     NOTE:

     To add or remove tags for multiple system features, select the desired system features, click Batch Edit in the lower part of the page, and select Tag.

You must have permission to edit features.

Add comment

1. Go to the work item details page.
2. On the Details tab page, click the Comments text box.

   

3. Enter a comment.

   You can upload images, enter links, associate work items, and use @ to notify project members in comments.

4. Click Submit.

   Submitted comments can be replied, edited, pinned to the top, and deleted.

You must have permission to view features.