# 工作项类型组件

URL: https://docs.ones.cn/on-premises/7.33/product-manual/ones-project/projects/issue-type-components

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

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

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

## 2.工作项组件列表

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

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

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

[缺陷组件](https://docs.ones.cn/on-premises/7.33/product-manual/ones-project/projects/issue-type-components/bug-component/)

[工单组件](https://docs.ones.cn/on-premises/7.33/product-manual/ones-project/projects/issue-type-components/ticket-component/)

[发布组件](https://docs.ones.cn/on-premises/7.33/product-manual/ones-project/projects/issue-type-components/release-component/)

[史诗组件](https://docs.ones.cn/on-premises/7.33/product-manual/ones-project/projects/issue-type-components/epic-component/)

## 3.功能特性

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

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

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

![工作项类型组件](https://docs.ones.cn/assets/images/55a38cbea289a14de58c-3b41462204030db5c8d5c008931636e5.png)

### 3.2 工作项视图

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

![工作项类型组件](https://docs.ones.cn/assets/images/4481f6b9f7273050200b-8f60a86543eba893c7162289c474bfef.png)

#### 3.2.1 视图新建

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

![工作项类型组件](https://docs.ones.cn/assets/images/ea174bb449f9713e2551-3c223b9024df6311c6bd626a94076ba2.png)

###### 3.2.1.1 视图类型

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

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

###### 3.2.1.2 视图操作

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

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

#### 3.2.2 视图编辑

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

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

### 3.3 布局

工作项列表有五种布局方式：窄详情、宽详情、表格、卡片、文档。

##### 3.3.1 窄详情

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

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

##### 3.3.2 宽详情

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

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

##### 3.3.3 表格

表格布局支持自定义表头，按需展示工作项属性；支持切换不同行高、冻结列、排序以及筛选，清晰高效。

###### 3.3.3.1 表头设置

在表格布局下，点击表头行右侧的「表头设置」按钮，可在弹窗中选择表头显示的属性内容。

![工作项类型组件](https://docs.ones.cn/assets/images/702b5c994ec744bf8e6c-3c248eb2c15eacecbf7dc164f107b865.png)

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

###### 3.3.3.2 **冻结列**

在表格布局下，当表头展示的属性较多时，可点击表头快捷操作中的「冻结至此列」，即可将当前可见列中从第一列到该列的内容固定在左侧。横向滚动表格时，冻结列保持可见。需要调整冻结范围时，在新的目标列表头快捷操作中重新选择「冻结至此列」即可。

在表头属性设置中，也可以通过拖拽来调整右侧已选属性在冻结区和非冻结区的位置。当窗口宽度不足时，系统会提示无法继续冻结。

![工作项类型组件](https://docs.ones.cn/assets/images/15fb5525a4aefd6ab0ae-a6a54e3698585d1a30d8c3f82a5b5a9b.png)

###### 3.3.3.3 调整行高

在表格布局下提供「行高」配置项，点击后可在四档行高中切换。需要集中浏览更多工作项时，可选择较紧凑的行高；需要在表格中查看更完整的属性值内容时，可选择较高的行高，让单元格展示更多内容。

![工作项类型组件](https://docs.ones.cn/assets/images/078185f6920853982044-3d8306c3aaf7c946138349a86b8ef9f5.png)

###### 3.3.3.4 单元格操作

点击表格中的单元格并完成属性值的编辑后，单元格保持选中状态，在选中态下，可以通过键盘进行更快捷连续的操作：

- 使用 键盘方向键 移动到相邻单元格
- 按下 `Enter` 后继续编辑选中单元格的属性值
- 按下 `Delete` 清空当前选中单元格的属性值
- 在编辑态下，按下 `esc` 退出编辑态，回到选中态

##### 3.3.4 卡片

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

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

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

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

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

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

##### 3.3.5 文档

1. 文档布局可同时呈现工作项列表、标题和描述，便于连续阅读工作项内容。
![工作项类型组件](https://docs.ones.cn/assets/images/30a3d08389586d92ca03-50904f57315b024bb612921c4f85d81b.png)

### 3.4 层级

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

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

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

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

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

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

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

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

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

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

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

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

![工作项类型组件](https://docs.ones.cn/assets/images/91f52559f1dd902a94c2-4504f81836119e63e4605f775fea2f81.png)

![工作项类型组件](https://docs.ones.cn/assets/images/2faddf8dc48c03cdbb3e-74f1e868840a8606ad40fecf1e9ee343.png)

### 3.5 排序

工作项列表支持「条件排序」和「手动排序」。可在列表顶部工具栏的「排序」中按需切换，同一时刻仅支持一种排序方式生效。表格、卡片、窄详情、宽详情和文档布局均支持两种排序方式。

**当排序方式为「条件排序」：**

- 在条件排序下，可以按照工作项属性进行正序或倒序排序。
![工作项类型组件](https://docs.ones.cn/assets/images/11ff0308ae6054c11ddb-369ef05e4ad51117af9ba7e68d2ca7e5.png)

**当排序方式为「手动排序」：**

- 切换到手动排序后，鼠标悬浮至列表最左侧时会出现可拖拽标识，按下后即可拖拽调整工作项顺序。
- 启用「层级」后进行手动排序：仅支持在所选工作项的同一层级下调整顺序，即树状结构中的子工作项只能在同一父工作项下调整顺序；若同一子工作项属于多个父工作项，在其中一个父工作项下调整顺序，不会改变它在其他父工作项下的位置。顶层工作项的手动顺序在团队内相关视图和布局中共用。
- 按属性分组后进行手动排序：仅支持在所选工作项的同一分组下调整顺序。
- 表格、卡片、窄详情、宽详情和文档布局均支持拖拽单条工作项；表格布局还支持先勾选多个工作项，再批量拖拽，单次最多拖拽 100 条。
![工作项类型组件](https://docs.ones.cn/assets/images/e5e2128cfeaacdd4707e-f2a149254b157c8f8f1b1f9e59a4af88.png)

![工作项类型组件](https://docs.ones.cn/assets/images/aee1318fb2cb658c2a56-3b63e27a48523641b31c089e7c6dc997.png)

### 3.6 分组

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

![工作项类型组件](https://docs.ones.cn/assets/images/3a46f570ea448ae68c02-cdc36732aa1f482cb6cafe888431b9e4.png)

### 3.7 筛选和搜索

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

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

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

![工作项类型组件](https://docs.ones.cn/assets/images/5a85d15e9a1982985b99-3a0869e68ea84c0e566dccc84094e29a.png)

*筛选条件*

### 3.8 工作项操作

###### 3.8.1 复制工作项

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

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

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

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

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

###### 3.8.2 移动工作项

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

###### 3.8.3 删除工作项

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

###### 3.8.4 批量选择与操作

- 在任一布局下，都支持批量复制/移动/删除工作项，减少重复性操作。可通过工作项列表右上方的「更多」菜单中，进入对应的批量操作入口。
![工作项类型组件](https://docs.ones.cn/assets/images/fbfff263cc1a3374a588-f2af8a13ab866b997f2f513c79ece252.png)

- 在表格布局下，工作项左侧显示勾选框。可逐条勾选工作项，也可按住 `Shift` 连续选择。
- 点击表头勾选框，可选择当前筛选结果中的工作项。勾选父工作项不会自动选中子工作项，同一工作项在层级结构中出现多次时，其勾选状态保持一致，并且只计入一次选择数量。
- 选中工作项后，列表底部出现悬浮操作栏，展示已选择数量以及快捷批量操作：「修改属性」和「删除」。
- 点击「修改属性」后，需选择要修改的属性，再点击修改后的属性值，确认后即可将同一新值应用于所选工作项；若属性在全部所选工作项类型中均为"非必填"，则支持清空属性值。
![工作项类型组件](https://docs.ones.cn/assets/images/c110dcd2891c2da80246-06606e972c76f60a86e53f74c4001607.png)

点击「删除」后，在二次确认弹窗中确认后执行删除。

![工作项类型组件](https://docs.ones.cn/assets/images/b859a183b9e8ed45a32e-864e78f1c24e17c92ffcc26e70645c88.png)

###### 3.8.5 快速新建工作项

在表格/文档布局下，将鼠标移至工作项标题后，点击出现的「···」入口，支持快速新建同级工作项。

- 若此时列表在「手动排序」下，可选择「在上方插入工作项」或「在下方插入工作项」快速新建同级工作项，回车创建成功后可以连续创建下一条。
- 若此时列表在「条件排序」下，在上/下方插入菜单项则显示为禁用状态，悬停时会显示原因提示。
![工作项类型组件](https://docs.ones.cn/assets/images/a77881a4b54ed6f9c2a9-731b258f78bc3355931e27795f0d998a.png)

![工作项类型组件](https://docs.ones.cn/assets/images/7e458c59143ee050e017-533e2fef92e10f7d79eb56668191704d.png)

![工作项类型组件](https://docs.ones.cn/assets/images/b1c679a028730997f596-d3270001418691895a76ac392f5f531d.png)

![工作项类型组件](https://docs.ones.cn/assets/images/00e55ea5a0f235f9fc7a-5e53df27b4aaeb5110415437bfcd4900.png)

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

#### 3.9.1 工作项导入

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

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

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

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

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

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

###### 3.9.1.2 导入 .docx

- 支持导入 .docx 格式的文件为工作项。导入 docx 流程主要分为三步：

1. 选择文件上传；
2. 配置导入规则，根据导入规则匹配结果选择要导入的内容；
3. 对即将导入的内容补充工作项属性
![工作项类型组件](https://docs.ones.cn/assets/images/7e265d1279b0668c-05061c82371ec6689903a136b01b6f75.png)

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

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

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

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

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

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

#### 3.9.2 工作项导出

###### 3.9.2.1 导出 .csv 文件

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

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

###### 3.9.2.2 导出 .docx 文件

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

### 3.10 变更工作项类型

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

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