# 工作项类型组件

URL: https://docs.ones.cn/ones-project/projects/issue-type-components

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

"工作项类型"是 ONES 系统的基本工作单位。每个工作项类型都会根据一个具体的业务场景（比如"需求"、"缺陷"）去定义自己的状态、属性、工作流。

"工作项类型组件"支持以表格、看板等不同的布局，列出某一个工作项类型下的具体数据，并提供排序、筛选、分组等功能。

## 2.工作项组件列表

系统预置的工作项类型组件包括：

- 需求 ：详细的需求列表，包含需求规划、拆分、关联工作项等针对性功能
- 缺陷 ：详细的缺陷列表，包含关联需求、关联测试计划等针对性功能
- 任务 ：详细的任务列表，包含关联工作项等针对性功能
另外，还有一类特殊的工作项类型组件，针对其业务特性，组件能力上比需求、任务等典型的工作项类型组件，做了特化处理：

- 工单 ：详细的工单列表，包含工单收集，指派工单处理人，自定义工单状态流转
- 发布： 包含发布列表，可以进行发布的计划与管理
针对缺陷组件、工单组件、发布组件在特定场景下的使用，详情可见：

> [缺陷组件](https://docs.ones.cn/wiki/#/team/6mRWUuNv/space/JrZtz5TS/page/97JiU4g9)

> [工单组件](https://docs.ones.cn/wiki/#/team/6mRWUuNv/space/JrZtz5TS/page/MTobGd8Z)

> [发布组件](https://docs.ones.cn/wiki/#/team/6mRWUuNv/space/JrZtz5TS/page/PovjSpUa)

> [史诗组件](https://docs.ones.cn/wiki/#/team/6mRWUuNv/space/JrZtz5TS/page/YYd2w5Jz)

## 3.功能特性

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

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

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

![工作项类型组件 配图 1](https://docs.ones.cn/assets/images/d571b2b774eb6f88-b79ef2e8dc07de3d35865c7daf543353.png)

### 3.2 工作项视图

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

![工作项类型组件 配图 2](https://docs.ones.cn/assets/images/fcac0c407d2682ff-c2bb429f2c6c5f6af2316dcdfdfdd2ad.png)

### 3.2.1 视图新建

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

![工作项类型组件 配图 3](https://docs.ones.cn/assets/images/562df2af2539cf47-004a911d211894f3aa3e152721dbdc0f.png)

##### 视图类型

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

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

##### 视图操作

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

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

### 3.2.2 视图编辑

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

- 保存：对原视图保存修改内容
- 另存为：不改变原视图配置，另存为一个新视图
- 还原：不改变原视图配置，清除修改项，还原至原视图
![工作项类型组件 配图 4](https://docs.ones.cn/assets/images/130b4b96970af1ed-37f8f06d49c29c1648bba6c8fc6f3de0.png)

### 3.3 布局

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

### 3.3.1 窄详情

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

![工作项类型组件 配图 5](https://docs.ones.cn/assets/images/26b0ee2ffa88ae7c-981849b86c7708a005af4b18fc55779f.png)

### 3.3.2 宽详情

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

![工作项类型组件 配图 6](https://docs.ones.cn/assets/images/0ac52b157100d875-19a96fd945dc7e858af07381300d7e50.png)

### 3.3.3 表格

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

![工作项类型组件 配图 7](https://docs.ones.cn/assets/images/257c0762304fdb88-e14f7fc3c93e8522682b0be55bf94aef.png)

### 3.3.4 看板

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

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

![工作项类型组件 配图 8](https://docs.ones.cn/assets/images/259c8d16cf2d2e19-58adc84ddc2432bbe8beffe4c1feb2e0.png)

点击栏设置，可设置看板栏

![工作项类型组件 配图 9](https://docs.ones.cn/assets/images/f1160f3b842ffc38-2d2732826b37f937bac5b84f36ae1249.png)

![工作项类型组件 配图 10](https://docs.ones.cn/assets/images/8901cee896d0092a-7fe21932e6703fe32c3c9c82fd2309ae.png)

### 3.3.5 文档

文档布局能够同时呈现工作项列表与工作项标题和描述，帮助大家快速阅读工作项列表中所有工作项的线描。

![工作项类型组件 配图 11](https://docs.ones.cn/assets/images/743082441fbbd590-a705312c8a3a5ba46ffa02530995916b.png)

### 3.4 层级

##### 3.4.1【层级】作用是让工作项列表，以树状展示符合父子关系的工作项

- 各布局支持的配置情况如下，并可作为保存视图时的记录项

| 布局 | 开启并设置【层级】 | 切换显示方式：树状/平铺 | 切换展开折叠：展开/折叠 | 开启子节点透视（原子工作项透视） |
| --- | --- | --- | --- | --- |
| 表格 | ✅ | ✅ | ✅ | ✅ |
| 窄详情 | ✅ | ✅ | ✅ | ✅ |
| 宽详情 | ✅ | ❌（仅平铺） | ❌ | ❌ |
| 卡片 | ❌ | ❌ | ❌ | ❌ |

##### 3.4.2【层级】支持的范围说明

- 项目的工作项类型组件
- 项目的筛选器组件
- 迭代的工作项类型tab
- 迭代的筛选器tab
- 迭代的未规划工作项/所有工作项tab
- 我的工作台的筛选器组件

##### 3.4.3 开启【层级】并点击层级设置，工作项列表以树状展示符合配置的工作项

![工作项类型组件 配图 12](https://docs.ones.cn/assets/images/c34b96e62b019489-a0c3ee2f6dddcf1fa4064c668041bab3.png)

先「选择层级结构」：可选择的层级结构与当前所在组件有关

- 若为特定工作项类型组件，则
- 如在设备需求组件，仅可选择【包含软件需求工作项类型的层级结构】
- 若为筛选器组件，则可选择团队中所有层级结构
- 如在项目的筛选器组件，可选择团队中所有层级结构
再「设置展示层级」：选择层级结构后，将基于当前所在组件向下加载出完整展示层级节点

- 若为特定工作项类型组件，则将基于该工作项类型向下加载出完整层级节点
- 如在设备需求组件，将从「设备需求」向下加载出完整层级节点（不会往上加载层级，即使层级结构中「设备需求」存在向上的节点）
- 若为筛选器组件，则将从根节点向下加载出完整层级节点
- 如在项目的筛选器组件，将从根节点「用户要求」向下加载出完整层级节点
- 不管是哪类组件，在加载出完整展示节点后，都可再进行裁剪，以选择希望查看的部分
最后「保存层级设置」：工作项列表将基于层级设置，展示符合配置的工作项

- 拆解关联的工作项可能为其他项目或其他类型的工作项，实际展示的工作项为：当前成员有查看权限的工作项
- 若一个工作项在层级结构中有多个父层级工作项，在工作项列表显示方式为「树状」时将重复出现，但为「平铺」时将去重
- 如多个设备需求拆解关联了同一个软件需求，在工作项列表显示方式为「树状」时，该软件需求将在多个设备需求下重复出现（此时列表计数也将重复计数，即为行数）；在工作项列表显示方式为「平铺」时，该软件需求将去重展示

#### 3.4.4 启用【层级】后，「表格」布局下，标题列可快捷：添加子层级工作项 或 新建子层级工作项

![工作项类型组件 配图 13](https://docs.ones.cn/assets/images/e28b465e8768006c-8e8b1eb781d83da2e6c906dc84595a2f.png)

### 3.5 排序和分组

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

![工作项类型组件 配图 14](https://docs.ones.cn/assets/images/e4ee77282e02c21c-c60c3eab8739685fe27697425f1b6962.png)

工作项排序

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

![工作项类型组件 配图 15](https://docs.ones.cn/assets/images/3cd64d2908018f7c-d4bb3ba7297a13505055be2c33aa7ed8.png)

工作项列表分组

### 3.6 筛选和搜索

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

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

同时，还支持「ONESQL」筛选方式，可根据业务场景，灵活编写表达式进行工作项查询，详见 [ONESQL筛选](https://docs.ones.cn/ones-project/issues/onesql-filter/)

![工作项类型组件 配图 16](https://docs.ones.cn/assets/images/c1ecf60fb8315414-fa0941890c4e17cf5c321c0a1ef629b5.png)

筛选条件

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

### 3.7.1 工作项复制

工作项支持复制到当前项目或其他有权限的项目中，提升相同业务场景下工作项的复用能力与操作便捷性。在宽/窄详情布局下，在工作项详情更多

操作中，点击复制，选择目标项目、目标工作项等，点击确定即可。

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

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

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

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

### 3.7.2 工作项移动

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

### 3.7.3 删除工作项

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

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

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

### 3.8.1 工作项导入

##### 3.8.1.1 导入 .xls/.xlsx/.csv

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

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

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

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

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

##### 3.8.1.2 导入 .docx

- 支持导入 .docx 格式的文件为工作项。导入 docx 流程主要分为三步：
- 选择文件上传；
- 配置导入规则，根据导入规则匹配结果选择要导入的内容；
- 对即将导入的内容补充工作项属性
![工作项类型组件 配图 17](https://docs.ones.cn/assets/images/7e265d1279b0668c-05061c82371ec6689903a136b01b6f75.png)

导入时，系统会根据文档中的标题切割内容，每个标题及其下的内容可被导入为一个工作项。上传文件之后进入到配置导入规则界面，在这里，界面上会展示文档中能够导入为工作项的所有内容。可以在右侧添加内容匹配规则，根据文档中的标题样式和标题中包含的文本匹配内容来导入为特定的工作项类型，例如将样式为标题一，且标题中包含需求的工作项导入为需求。

![工作项类型组件 配图 18](https://docs.ones.cn/assets/images/dbc7de06d614eced-0386c003062202d7a229107aef40fc67.png)

在导入时可以批量导入多种工作项类型，也可在导入时为导入的工作项创建父子层级关系。点击添加子层级规则即可导入子层级工作项，添加子层级规则后，需要先选择要引用的层级关系，选择之后就可选择要导入的子层级工作项了，子层级工作项的标题样式层级不能超过父层级的标题样式。

![工作项类型组件 配图 19](https://docs.ones.cn/assets/images/71c1ce08e66c8624-f619be34ccad3a26c2962c192dec8a42.png)

配置好导入规则后点击应用规则，即可查看当前规则会导入哪些内容以及会被导入为什么类型的工作项，此时可以再对匹配到的内容进行二次裁剪，可选择不导入匹配到的内容，选择好之后即可进入下一步，补充属性。选择好要导入的内容之后，可对选择的内容补充工作项属性，点击选择属性即可添加要补充的属性，补充完属性后即可导入工作项。

![工作项类型组件 配图 20](https://docs.ones.cn/assets/images/315b4b3396bbb64d-8f33e7634feb7db07cef92735870bb64.png)

### 3.8.2 工作项导出

##### 3.8.2.1 导出 .csv 文件

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

> 在「我的工作台」的全局筛选器中，导出跨项目的工作项时，支持导出工作所属项目的项目属性和工作项登记工时的工作内容。

##### 3.8.2.2 导出 .docx 文件

点击工作项列表右侧的更多操作菜单中的导出为docx，即可将当前工作项列表导出，其中工作项的标题将会被导出为标题样式，工作项的描述将会被导出为正文样式，如果列表中有父子层级工作项，则导出后会根据标题的层级样式来表示内容的层级关系，例如父层级工作项会导出为 H1 标题样式，子层级工作项会导出为 H2 标题样式，以此类推。

### 3.9 变更工作项类型

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

> 变更前后共有的工作项属性将自动保留，多余的属性将被去除。