Creating Work Items
After a project is created, you need to create a work item. In a Scrum project, work items are organized in the descending hierarchy: Epic > Feature > Story > Task or Bug.
Prerequisites
- You have created a Scrum project. For details, see Creating a CodeArts Project.
- An IAM user has been added to the project. For details about how to add members, see Adding Members to a CodeArts Project.
- You have permissions to create (clone) work items. For details about how to set permissions, see Managing Project Permissions.
Creating a Work Item in a Scrum Project
- Access the CodeArts Req homepage.
- Go to the project homepage and choose .
- Click Create Work Item and select a work item type. For example, Story.
- Set fields for the work item.
Work item fields can be customized. For details, see Configuring Work Item Fields and Templates. Table 1 describes default basic fields.
Table 1 Creating a work item Parameter
Description
Title
Work item name. The value can contain a maximum of 512 characters, including letters, digits, periods (.), and underscores (_).
Tag
Tag of a work item, for example, document update. Tags can be used only in a project that the work item belongs to.
Description
Enter a description based on the template. Enter a maximum of 50,000 characters.
Assigned To
Handler of a work item. The value range is all members of the project. If a handler has a nickname, their nickname is displayed by default. For details about how to assign a work item to multiple handlers, see How Can I Assign One Scrum Project Work Item to Multiple Members?
Module
Module that a work item belongs to. Modules can be customized. For details, see Adding Work Item Modules.
Sprint
Sprint of a work item. Set this parameter to an existing sprint. You can choose whether to use the start and end dates of the selected sprint for this work item. If no sprint is available, click
on the right to configure one. You can also configure a sprint by referring to Configuring a Sprint Plan.
Planned Start Date
Planned start time of a work item. Select a date from the time control.
Planned Delivery Date
Planned end time of a work item. Select a date from the time control.
Order
Order of a work item. Value range: 1–100
Priority
Priority of a work item. The options are as Low, Middle, and High.
Severity
Severity of a work item. The options are Critical, Major, Minor, and Trivial.
Notify
People who will receive messages about this work item.
Parentld
Parent work item to which a work item belongs. Only one parent work item can be selected.
- The parent work item of a bug or task is a story.
- The parent work item of a story is a feature.
- The parent work item of a feature is an epic.
- No parent work item can be set for an epic.
Domain
Domain that a work item belongs to. Domains can be customized. For details, see Adding Work Item Domains.
Release Version
Version of a release. Enter a value manually.
Developer
Person responsible for developing the work item. Each work item should be assigned to a fixed developer.
The handler of a work item changes as the work item develops. These two fields can be used together.
Expected
Estimated workloads required to complete a work item. Unit: person-hours or person-days.
Actual
Actual workloads required to complete a work item.
Find Release Version
Find Release Version is available only for work items of the bug type.
Product version where a bug is found.
Done Ratio
Progress of the work item. The value ranges from 0% to 100%. Done Ratio of a parent work item is updated automatically based on the completion rate of its child work items.
Story Point
Estimated workload of the story.
Attachment
Upload required files for the work item. The maximum size of attachments for a single work item is 50 MB.
Click
to associate files from Documentation of the project cloud, or upload local files.
- After setting the parameters, click OK.
The created work item is displayed in the work item list.
Figure 1 Work item list
Related Operations
Operation |
Description |
---|---|
Check work item details |
In the work item list, click the title or ID of a work item to view its details. |
Edit work item title |
In the work item list, click |
Fast create child work item |
|
Favorite work item |
In the work item list, click |
Clone work item |
|
Archive work item |
Click Archive under |
Edit work item |
|
Delete work item |
If you delete work items of a Scrum project, they are permanently deleted and cannot be restored.
|
Create story from bug |
This operation is available only for bugs. There is no limit on the number of times that this operation can be performed. In the work item list, click |
Perform batch operations |
Select multiple work items to clone, edit, archive, delete, and export them in batches. There are some restrictions on batch cloning, archiving, and deletion:
|
Helpful Links
- For details about how to create work items in a Scrum project, see Creating a Scrum Project and a Work Item.
- For details about how to create work items using APIs, see Creating a Work Item.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot