# 工作项属性

URL: https://docs.ones.cn/release-notes/20260218/ones-project-updates/issue-fields

| 更新时间 | 20260218 |
| --- | --- |
| 更新内容 | **ONES Project：**<br>【工作项属性】<br>- 原关联内容，包含"关联工作项"、"关联 Wiki 页面"、"文件"升级为属性<br>- 新增自定义属性类型，包含"级联属性"、"富文本"、"公式计算"、"标签"等<br>- 所有富文本属性编辑器能力升级为"Wiki 编辑器"，包含描述、富文本、评论属性<br>- 属性支持自定义属性说明，对属性的含义/用法进行解释<br>- 属性字符数上限扩展<br>**完整更新内容见： [20260218 - 更新说明](https://docs.ones.cn/release-notes/20260218/)** |

## 一、新增属性类型清单

| 分类 | 属性类型 | 介绍 |
| --- | --- | --- |
| 文本 | 富文本 | 提供丰富的文本编辑功能，支持字体样式、颜色、链接、图片等格式设置。适合需要格式化显示的内容，如详细描述、需求文档等<br>支持协同编辑能力 |
| 选择 | 单选引用菜单 | 引用系统内其他菜单选项值 |
| 多选引用菜单 | 引用系统内其他菜单选项值 |
| 单选引用外部数据 | 连接外部系统数据源作为菜单选项值，适合与第三方系统集成的场景 |
| 多选引用外部数据 | 连接外部系统数据源作为菜单选项值，适合与第三方系统集成的场景 |
| 标签 | 灵活的标记方式，支持普通成员直接在填写属性时新建标签 |
| 单选级联 | 层级式单选菜单，如地区选择（省份→城市→区县）；上级选项决定下级可选范围 |
| 多选级联 | 层级式多选菜单，如地区选择（省份→城市→区县）；上级选项决定下级可选范围 |
| 多选迭代 | 引用系统内迭代数据源的多选菜单 |
| 单选项目 | 引用系统内项目数据源的单选菜单 |
| 关联 Wiki 页面 | 关联到 Wiki 知识库页面，支持菜单、列表两种样式 |
| 计算 | 公式计算 | 基于其他字段自动计算数值 |
| 成员 | 单选用户组 | 选择特定用户组，如开发组、测试组等 |
| 多选用户组 | 选择多个用户组，适合跨组协作场景 |
| 单选部门 | 选择特定部门，关联到组织架构 |
| 工作项 | 单选关联工作项 | 建立与其他工作项的关联，如缺陷转需求；支持菜单、列表两种样式 |
| 多选关联工作项 | 建立与其他工作项的关联，如关联反馈单；支持菜单、列表两种样式 |
| 层级属性 | 支持配置工作项的层级结构，如所属史诗、关联发布等 |
| 其他 | 文件 | 上传和管理文件，支持多种文件格式，便于保存设计稿、文档等相关资料；支持菜单、列表两种样式 |
| 链接 | 展示可以快速跳转访问的链接，如原型链接、参考文档等 |

## 二、属性类型的介绍

### 1 关联工作项属性

工作项关联关系指的是两个"工作项"之间的关系。「关联工作项属性」依赖「工作项关联关系」配置，一条关联关系，会关联 1 个或 2 个"工作项属性"。

![工作项属性 配图 1](https://docs.ones.cn/assets/images/1a4feb8328ad512b-38f9aa15ccf488a2814d9b57311f50d8.png)

配置是否需要"拆分属性"来描述工作项之间的关联

- 拆分属性：区分"发起方"与"被关联方"的属性名称。（使用场景：需求拆解为多个任务，需求上使用的属性为"拆解任务"，任务上使用的属性为"来源需求"）
- 不拆分属性：不区分"发起方"与"被关联方"的属性名称。（使用场景：相似需求之间的关联，则需求上只需要使用同一个属性"相似需求"来表示即可）
![工作项属性 配图 2](https://docs.ones.cn/assets/images/c4b97ad551f9643e-46b4abc08019e50d73811e395c6f8c36.png)

关联工作项属性化后，支持更多属性相关的特性；包含配置到列表表头，直接编辑工作项属性；并支持批量编辑属性、导入导出等操作。

![工作项属性 配图 3](https://docs.ones.cn/assets/images/9201a6cc4e777d91-c8e1dcaa1bdea56d5151efa25198310f.png)

### 2 关联 Wiki 页面

支持自定义多个"关联 Wiki 页面"属性。

关联 Wiki 页面属性化后，支持更多属性相关的特性；包含配置到列表表头，直接编辑工作项属性；并支持批量编辑属性、导入导出等操作。

![工作项属性 配图 4](https://docs.ones.cn/assets/images/cff8bd5d01ddd776-d6c8e158ed72fa00cddb809c858960e8.png)

### 3 文件

支持自定义多个"文件"属性。

文件属性化后，支持更多属性相关的特性；包含配置到列表表头，直接编辑工作项属性；并支持批量编辑属性、导入导出等操作。

![工作项属性 配图 5](https://docs.ones.cn/assets/images/ba5ac9a15948f869-d468792c3c1e966f61976c768efb5426.png)

支持「工作项汇总文件列表」控件，支持汇总工作项上各种来源的附件，包含描述、富文本属性、文件属性、评论等

![工作项属性 配图 6](https://docs.ones.cn/assets/images/6a92d81e9e74e265-492bb1b20cc05f1b653f61675c5b83f5.png)

### 4 级联属性

级联属性是一种具有层级结构的选择字段，通过父子关系组织选项，上级选择决定下级可选范围，常用于地理位置选择（国家→省份→城市）、产品分类（大类→子类→具体型号）等需要逐级筛选的场景。

支持自定义单选、多选级联属性

- 级联属性支持配置「可选层级」，包含"必须选到末级"和"可选到任意一级"
- 配置选项：支持配置最多 12 个层级，可批量导入选项
![工作项属性 配图 7](https://docs.ones.cn/assets/images/d733453f413bf74f-749f4e5f95baaefcb06758e747dafc76.png)

![工作项属性 配图 8](https://docs.ones.cn/assets/images/09ea2db5c63ff49c-72fefe7b5e59de3067e9f79ca47538ad.png)

### 5 富文本

- 所有富文本属性的编辑器都替换为"Wiki编辑器"，拥有大部分"Wiki编辑器"的能力，包括插入表格、协同编辑能力等。
![工作项属性 配图 9](https://docs.ones.cn/assets/images/a3151bc83eb5dd8d-9e0a12251e26670cb1e493613cb76049.png)

支持自定义多个富文本属性

![工作项属性 配图 10](https://docs.ones.cn/assets/images/182b68dfd6b2b301-93faac1f9b94786407d115f21326343e.png)

### 6 标签属性

支持标签属性，允许普通成员按照自己诉求自主添加标签，灵活标记工作项。

- 只要有工作项的「编辑工作项」权限，就支持添加标签选项
![工作项属性 配图 11](https://docs.ones.cn/assets/images/2956697171a6eeb6-f08db3c2f4c52809c72d6726b4c44b5b.png)

![工作项属性 配图 12](https://docs.ones.cn/assets/images/1c7286d453379b62-c2dcf8028f4261ca17469d018263a968.png)

### 7 链接属性

支持配置快速跳转访问的链接属性

![工作项属性 配图 13](https://docs.ones.cn/assets/images/cab03ae5576d6afb-0f8ed23813cb3b074ebe8c4c289ef93a.png)

### 8 引用菜单选项

可以将以创建的"单选菜单""多选菜单"类型的工作项属性的选项值进行直接复用。当引用来源的选项值发生变更值，"引用菜单选项"字段的选项值也会发生变更。

![工作项属性 配图 14](https://docs.ones.cn/assets/images/ca7d7a801cd98be3-d048f832d315643d6135a4a5edd81baa.png)

### 9 引用外部数据

通过配置接口，转换函数清洗数据后，即可将外部数据转化为菜单选项

![工作项属性 配图 15](https://docs.ones.cn/assets/images/e602fcc06ae4775f-bd76d6ac7a5e7e1771911fba82493e22.png)

![工作项属性 配图 16](https://docs.ones.cn/assets/images/421ea9f207d1cd15-f4e4d42865532d229fc38c0a55961c4c.png)

![工作项属性 配图 17](https://docs.ones.cn/assets/images/ea10f8d31012c9a2-1bbe6f77418357ebef191a551fa13223.png)

### 10 公式计算属性

由用户自定义公式，将其他工作项属性的属性值进行计算得出新的数值。 [点击了解更多](https://docs.ones.cn/ones-project/issues/issue-field-types/formula-field/)

通过公式编辑器，由用户自定义公式，可以用于进度汇算，资源投入汇算，数据统计等多种业务场景，帮助用户在度量和报表之外，在详情页表单直接查看相关指标

![工作项属性 配图 18](https://docs.ones.cn/assets/images/6f56db25b76ca06e-3e59e0f720270397030f0ea443e516cc.png)

![工作项属性 配图 19](https://docs.ones.cn/assets/images/2d306c97d48e40b2-955cf7066d699bcac8245bea80f8b0c6.png)

## 三、属性说明

当属性的业务含义较为复杂时，管理员可以配置属性说明，用来对属性的含义/用法做出进一步解释。

![工作项属性 配图 20](https://docs.ones.cn/assets/images/ff23882b34c40813-4f1d073314b4e6e6a05687bb20034091.png)

属性说明会在工作项详情页、新建页、步骤页、表格视图的表头等场景下生效。以详情页为例，使用效果为：

![工作项属性 配图 21](https://docs.ones.cn/assets/images/91a228c2789ae0b0-9946db9089e0ecc31a601b045bf45393.png)