> For the complete documentation index, see [llms.txt](https://guides-ones.gitbook.io/guides/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides-ones.gitbook.io/guides/usage-guide/ones-project/pei-zhi-xiang-mu-zu-jian/xu-qiu-zu-jian.md).

# 工作项类型组件

## 1. 什么是“工作项类型组件“

**“工作项“**是 ONES 系统定义各类项目事务的基本工作单位，是对于具备相同数据结构（常见的如状态、属性、工作流）的业务类型的抽象定义，有着相似的业务场景，都是围绕“完成这件事情“来流转。

**“工作项类型组件“**基于这类事务的处理逻辑，做了一些产品能力的封装，增强可复用性的同时，也支持基于不同工作项类型的个性化的配置。

## 2. 工作项组件列表

典型的工作项类型组件包括：

* **用户故事**：详细的用户故事列表，可以对用户故事进行排序、筛选、规划
* **需求**：详细的需求列表，包含需求规划、拆分、关联工作项等针对性功能
* **缺陷**：详细的缺陷列表，包含关联需求、关联测试计划等针对性功能
* **任务**：详细的任务列表，包含关联工作项等针对性功能

另外，还有一类特殊的工作项类型组件，针对其业务特性，组件能力上比需求、任务等典型的工作项类型组件，做了特化处理：

* **工单**：详细的工单列表，包含工单收集，指派工单处理人，自定义工单状态流转
* **发布：**包含发布列表，可以进行发布的计划与管理

## 3. 功能特性

### 3.1 工作项新建、编辑

选择 **工作项类型组件**（如需求），点击左上方“**`提需求`**“或右上方按钮  ，在表单中输入基础信息（标题、工作项类型、负责人、优先级）后完成新建。

可以通过详细描述和更多自定义属性，补充工作项详细信息。系统支持批量新建以及批量导入，减少重复性操作。

![新建工作项及批量新建入口图示](/files/-MUD3z2AmcSuwaTdEcym)

![](/files/-MWvNiizyNQ5fpIYDytO)

### 3.2 工作项视图

「视图」是呈现工作项列表的界面载体，根据不同的业务场景和个人习惯，使用视图可以聚焦特定的数据和内容，简化筛选的操作；同时合并分离的数据和内容，创建分区视图，便于在不同场景下使用。‌

工作项类型组件，默认有「全部工作项」「未开始」「进行中」「已完成」四个公共视图。

![](/files/-MWtJVMiNi1H8ylaTrCA)

#### 3.2.1 公共视图和私人视图

![](/files/-MWtKEcRp2aVmeWApD1u)

为了满足项目管理各角色需求，**可分为「公共视图」和「私人视图」两类**。

**「公共视图」**仅项目管理员可以创建，方便项目成员查看共同关注的工作项列表，可被具有该组件查看权限的成员查看；**「私人视图」**仅创建者可查看和管理。两类视图的使用方式与功能点一致，仅因场景差异提供了不同的权限。

#### 3.2.2 视图新建

 **`视图管理>新建视图>输入视图名称>选择私人/公共视图`**创建视图，然后通过筛选条件、页面布局、列表结构、排序方式等自定义设置，使新增的视图能够高效准确的呈现你所关注的工作项内容。

![视图管理入口图示](/files/-MU7pI6BJ7sr25Q13GVn)

#### 3.2.3 视图编辑

视图新建完成后，仍然可以对视图名称、筛选条件、页面布局、排序方式等自定义设置进行编辑调整。当上述条件发生修改变化后，可以选择：

* 保存：对原视图保存修改内容
* 另存为：不改变原视图配置，另存为一个新视图
* 还原：不改变原视图配置，清除修改项，还原至原视图

![](/files/-MWtGE2_i1v8EmfRfvYK)

#### 3.2.4 视图管理

视图管理界面可以查看所有公共视图和自己创建的私人视图，并进行系列操作和管理：

* 视图显隐开关
* 复制视图
* 重命名视图
* 删除视图

![视图显隐开关图示](/files/-MU7q_igzBep9ZtycGov)

### 3.3 列表布局

工作项列表有四种布局方式：窄详情、宽详情、表格、看板。

#### 3.3.1 窄详情

窄详情便于查看列表全貌，在列表中快速切换，查看单条工作项详情信息。

![窄详情图示](/files/-MSfk9x-IbfOi4NjbcDQ)

#### 3.3.2 宽详情

宽详情便于查看单条工作项的细节，在列表中切换，查看需求详情信息，包括需求全部动态，如评论、文件、关联、变更记录等具体内容。

![宽详情图示](/files/-MSflLnfo6aFvWd-pXD7)

#### 3.3.3 表格

表格视图支持自定义设置表头、按需展示，以及快速的排序和筛选，清晰高效。

![表格图示](/files/-MSflVsOOwuuCQDoCxMX)

#### 3.3.4 看板

看板布局关注工作项状态分布以及流转，可以新增、删除、重命名看板栏，并且管理每个栏下面的工作项状态。

比如工作项有「未开始」、「实现中」、「已实现」三种状态，但是你想通过「未完成」和「已完成」来查看，在「未完成」的看板栏中就需要添加「未开始」、「实现中」两种工作项状态，「已完成」看板栏中添加「已实现」的工作项状态。

![看板图示](/files/-MSflcpaHmBpYvXd3bkt)

![看板栏设置入口图示](/files/-MU7vOOd3I_dcmPTdS8U)

![看板栏设置图示](/files/-MU7vabwdEAd_rP-7ag5)

### 3.4 列表结构

工作项列表支持平铺和树状两种列表结构。

#### 3.4.1 平铺

平铺结构下，支持显示或隐藏子工作项。

![平铺结构下工作项列表图示](/files/-MSfm3u4_OHJG9iSSiJ_)

#### 3.4.2 树状

树状结构下，可以选择结构化展开或折叠（即隐藏父子工作项）。支持设置子工作项透视。

子工作项透视即为完整的展示工作拆分结构，包括处于重要节点的但被筛选掉的工作项（置灰显示）。

![树状展开工作项列表图示](/files/-MSfmApzmUxBi5Zoc0N4)

### 3.5 工作项排序和分组

工作项列表可以按照某个工作项属性进行正序或倒序排序。

![工作项排序图示](/files/-MU7yLg5t8FBE7ITu2ei)

工作项列表可以按照某一工作项属性进行分组查看。

![工作项列表分组图示](/files/-MU7yhihGFqFcQNSyF01)

### 3.6 工作项筛选和搜索

工作项列表可以按照工作项基础信息、属性、状态、优先级等维度进行多重筛选。支持按照且、或，设置多个条件组进行筛选。

对要寻找的工作项内容十分明确时可以通过系统导航栏搜索框进行查找。

![筛选条件图示](/files/-MU7z5knwBqBT8_aEIet)

### 3.7 工作项复制、移动、删除

#### 3.7.1 工作项复制

工作项支持复制到当前项目或其他有权限的项目中，提升相同业务场景下工作项的复用能力与操作便捷性。在宽/窄详情布局下，在工作项详情**`更多`**操作中，点击**`复制`**，选择目标项目、目标工作项等，点击确定即可。

支持用户选择是否复制子工作项，以及配置父、子工作项除基础属性外的保留内容。保留内容包含周期与进度、关联工作项、测试情况、关联 Wiki 页面、文件、关注者，以及工时信息。

{% hint style="info" %}
复制工作项时，目标工作项类型中共有的基础属性将被自动保留，增加的属性属性值将为空，多余的属性将被去除。保留内容同时对父、子工作项生效。
{% endhint %}

当勾选工时信息后，用户可选择「复制所有的工时信息」或「只复制我的工时信息」。「复制所有的工时信息」会将工作项中所有成员的工时信息都复制到目标工作项中，「只复制我的工时信息」则只会复制用户自己的工时信息。

{% hint style="info" %}
勾选后，系统会根据目标工作项类型的工时管理权限复制工时信息，无权限则不复制。工时信息包含预估工时、已登记工时、剩余工时、工时进度及预估偏差。
{% endhint %}

#### 3.7.2 工作项移动

在宽/窄详情布局下，在工作项详情**`更多`**操作中，点击**`移动`**，选择项目和工作项类型 - 更新工作项状态 - 确认变更，即可移动工作项。

#### 3.7.3 删除工作项

工作项支持删除操作，在宽/窄详情布局下，在工作项详情「更多」操作中，点击「删除」即可，删除操作不可撤销。

系统支持批量复制/移动/删除工作项，减少重复性操作。

### 3.8 工作项导入/导出

#### 3.8.1 工作项导入

支持通过 excel 表直接批量导入工作项，将团队工作快速迁移到 ONES 中。您可以直接**选择下载模板**，或者**使用自己的excel表，需要把对应的字段对应上，【选择文件】上传。**

选择不同的工作项类型会生成不同的模板。如果您希望模板内容可以匹配您的 Excel 已有字段，可以前往项目设置-工作项类型-工作项属性，把工作项属性值设置成与 Excel 表头一致，以便完整对应。

上传之后将Excel表头字段与系统中工作项类型字段匹配上，然后点击【开始导入】。

通过拖拽“待匹配 Excel 表头字段”的内容至“Excel 表头字段”中来匹配对应的工作项属性。必填的工作项属性必须有对应的表头字段，否则该文件将不予导入。

导入完毕后、点击进度管理器的“查看详情”按钮，查看导入情况；如果导入失败，需要【下载失败的工作项】查看原因。

#### 3.8.2 工作项导出

支持将工作项以 .CSV 文件格式进行导出，在工作项详情的「更多」操作中，选择「导出工作项」，选择需要导出的工作项属性，并对要导出的属性进行排序，点击确定后即可。

![](/files/-McvmEWSK5wn0MKJG1Es)

{% hint style="info" %}
在「我的工作台」的全局筛选器中，导出跨项目的工作项时，支持导出工作所属项目的项目属性和工作项登记工时的工作内容。
{% endhint %}

### 3.9 变更工作项类型

当想把一个缺陷变更为需求时，可以使用变更工作项类型的功能。在宽/窄详情布局下，在工作项详情**`更多`**操作中，点击**`变更工作项类型`**，选择目标工作项类型及其工作项状态，并补充目标工作项类型中的所有必填属性，最后点击确认变更即可。

![](/files/-Mcvn_j93U4vfe_-XXtW)

{% hint style="info" %}
变更前后共有的工作项属性将自动保留，多余的属性将被去除。
{% endhint %}

### 3.10 子工作项

当一个工作项过于庞大和复杂时，可以利用子工作项进行细化和拆解。

#### 3.10.1 新建子工作项

在宽/窄详情下，在工作项详情右上角，点击**`添加子工作项`**图标，即可为选中的工作项创建一个子工作项。

#### 3.10.2 批量新建子工作项

当一个工作项需要创建多个子工作项时，可以在宽/窄详情下，点击工作项详情的「更多」操作下的批量新建子工作项，可根据需要创建的子工作项类型和数量多次点击”子任务“、”子需求“的按钮，添加新子工作项的行，填入相关信息并确认创建。

![](/files/-Mcvpmp7uLRuFeIo0Ir9)

#### 3.10.3 转为子工作项

支持将某一条工作项转为某个目标工作项的子工作项，选中工作项后，在详情的「更多」操作下，点击**`转为子工作项`**按照步骤选择目标子工作项类型、指定父工作项，更新工作项状态并补充工作项必填属性即可。

##