Updated on 2024-10-31 GMT+08:00

Configuring Common Work Item Fields

Customize common fields that can be used by any type of work items in your project.

Prerequisites

A Scrum project is available, and you have permission to customize work items for the project.

Procedure

  1. Access the CodeArts Req homepage.
  2. Go to a Scrum project and choose Settings > Work.
  3. In the navigation pane, choose Common Fields.

    Click Add Field, and set the field information, including the name (for example, CommonField1), type, and description.
    • The added field is displayed in the field list, including the name, type, option, description, and usage.
    • Click Clone Field to copy existing common fields of other projects to the current project.
    • Common fields can be modified or deleted.

  4. Add an existing common field (for example, CommonField1) to the work item template.

    The following uses the story work item template as an example:

    1. In the navigation pane of the project settings page, choose Stories > Fields and Templates.
    2. Click Edit Template in the upper right corner to enter the editing state of the story work item template.

      Click Add Existing Field, select CommonField1 from the Field Name drop-down list, click Add, and save the template.

      Figure 1 Adding an existing field to the work item template
    3. Check this CommonField01 field when creating a story on the Work > Req > Work Items page.
      • Customized common fields can be configured and used for all types of work items of the current project.
      • The story work item template is used as an example. You can add common fields to other work item templates in the same way, and only need to do this once for each of them.
      • A maximum of 25 common fields can be customized.

  • After the configuration is complete, click Save as Template in the upper right corner of the page. In the Save as Template dialog box, enter a template name and description, and click OK.
  • This template can be used to create Scrum projects.
    Figure 2 Creating a Scrum project