# 详情页配置

URL: https://docs.ones.cn/on-premises/7.33/product-manual/ones-project/issues/issue-layout/details-page-configuration

## 1 介绍

在项目协作中，不同团队和业务场景对于工作项详情页的关注点往往不同。通过配置工作项布局，管理员可以灵活定义详情页中展示的属性、控件和标签页，使表单更加贴合实际业务流程，也可根据具体的流程信息配置详情页属性等内容的出现条件、默认值、是否为必填、可选项范围等，实现属性的动态联动，以应对不同场景下的使用。

功能入口：「工作项类型」-「属性与布局」-「编辑详情布局」

![详情页配置](https://docs.ones.cn/assets/images/c990d2fb600199f4-a6a67b154c4c9b61bec85b6b2f8182cf.png)

## 2 功能说明

### 2.1 表单资源库

配置页左侧的 **表单资源库** 展示了系统内全部的工作项属性和控件，管理员可以从表单资源库拖拽属性和控件到表单的指定位置下。

![详情页配置](https://docs.ones.cn/assets/images/8787796d6f208276-80cf3a24a166ccf026d3b4631c9c2c4c.png)

#### 搜索表单项

管理员可以搜索属性或控件的名称，定位到该表单项，并拖拽到表单内进行添加。请注意， **目前一个属性只能在表单内添加一次** 。

![详情页配置](https://docs.ones.cn/assets/images/d81100823043cf45-9d06b21b227f21f025885f8568aeb794.png)

#### 新建和添加属性

如果已有属性不能够满足配置工作项的诉求，配置者可以点击左下角 的 **「新建属性」** 来 新建自定义属性，新建成功后，属性会自动展示在资源库内供使用。

![详情页配置](https://docs.ones.cn/assets/images/53ca017ce248a18d-4e177b224eb2cc825ad9569351658742.png)

#### 定位表单项

当表单内添加的表单项较多、难以直接看到时，配置者可以在左侧搜索栏搜索表单项名称，点击卡片上 的 **「定位」按钮** ，会自动定位到该表单项所在位置。

![详情页配置](https://docs.ones.cn/assets/images/a69562e68275798f-498278549e9c1e3dbb0af6e85149626b.png)

### 2.2 标签页

标签页承载了工作项的属性、控件等信息，配置者可以根据实际业务场景，自由定义标签页的 **名称、排序、内容、可见性** 等。

![详情页配置](https://docs.ones.cn/assets/images/03b7843b6273e12d-157bd43e950218ff067017e3d87fe1bd.png)

#### 新建标签页

为了管理表单的信息，管理员可以 **新建标签页** ，点击「新建标签页」，选择「新建空白标签页」，即创建成功。创建后，可以从左侧的表单资源库内拖拽属性、控件等到标签页内进行配置。 **自定义的标签页支持重命名。**

![详情页配置](https://docs.ones.cn/assets/images/51be97d42dad31665623-099304fbacfe8b56796b679ffef89218.gif)

#### 添加系统标签页

- 除了新建标签页外，ONES也提供了一系列 **预置的标签页** 。
![详情页配置](https://docs.ones.cn/assets/images/958b2d573ca3a13b-d18804b0f619f29fa45885e510468ed2.png)

- 这些系统标签页是针对特定业务场景封装的，因此 **可以添加的内容类型有限** 、只能添加与对应业务相关的属性/控件。具体规则如下：

| **系统标签页名称** | **可以添加的表单资源项** | **使用场景** |
| --- | --- | --- |
| 子工作项 | 只能添加「父工作项」、「子工作项」 | 管理工作项父-子结构层级业务 |
| 文件 | 只能添加「文件」类型的属性和「工作项文件汇总列表」控件 | 汇总管理工作项下的文件 |
| 测试情况 | 只能添加「测试情况」控件 | 汇总工作项的测试计划、用例等 |
| 关联内容 | 只能添加「关联工作项」类型的属性和「关联内容」控件 | 管理工作项关联业务 |
| 代码关联 | 只能添加「代码分支」、「代码合并请求」、「代码提交记录」 三个控件 | 管理代码提交相关业务 |
| 关联wiki页面 | 只能添加「关联Wiki页面」类型的属性 | 汇总管理工作项相关的wiki页面 |
| 工时 | 只能添加「工时信息」控件 | 管理、登记工作项的工时信息 |
| 前置依赖 | 只能添加「前置依赖」控件 | 管理工作项在项目计划中的前置依赖项 |
| 后置影响 | 只能添加「后置影响」控件 | 管理工作项在项目计划中的后置影响项 |
| 发布内容 | 只能添加「发布内容」属性 | 管理发布类型工作项包含的任务内容 |
| 史诗内容 | 只能添加「史诗内容」属性 | 管理史诗类型工作项包含的任务内容 |

#### 设置可见范围

支持配置标签页的可见性，即 **对哪些成员/角色展示** 。点击标签页后的按钮，选择「设置可见范围」，可以在弹窗内进一步设置哪些成员可以看到当前的标签页。

请注意，标签页的可见性会影响属性。当某个标签页对用户不可见时，该用户看不到标签页下的任何属性和控件，如果有属性配置了必填、选项值范围、默认值等规则，规则并不会生效。

使用场景：为了避免信息冗余、提升协作的效率，可以让不同角色成员关注不同的标签页，例如对于「需求」工作项，可以配置产品关注「客户信息」标签页，测试关注「测试情况」标签页，研发关注「需求拆解任务」标签页。

![详情页配置](https://docs.ones.cn/assets/images/56640d0a8c4fccb5-e6af01014d68bbaa25b7d5399b640d37.png)

![详情页配置](https://docs.ones.cn/assets/images/0f493169e3c80032-2d878c430044774c375662fa56376b11.png)

#### 删除标签页

如果标签页不再使用，配置者可以选择删除该标签页，但「详情」标签页不支持删除。

删除标签页的影响：

1. 该标签页包含的属性、控件都会从详情页表单被移除
2. 若标签页被添加到了新建页，则新建页内，该标签页包含的分组、表单资源项也会连带被删除
3. 若标签页下的属性被添加到了步骤页，则步骤页内，该属性也会被删除、失效处理。
删除后，对于已有的工作项，此标签页内填写的属性值或控件值并不会被删除，如果再次把属性或控件添加至表单，仍可正常展示。

![详情页配置](https://docs.ones.cn/assets/images/8b3ff484a48c255b-15316082070135fa64d7aa1486e41059.png)

系统标签页删除后还可以通过点击「新建标签页」下的选择框再次添加。

![详情页配置](https://docs.ones.cn/assets/images/ee15748ff10fa042-33b3e5ad9421362864b0f28a3af83670.png)

#### 分组

标签页下支持进行分组设置。表单配置者可以用分组来汇总相关的属性等信息。

使用场景：对于需求管理业务，可以新建一个相关角色和人员分组，集中放置该需求的相关人员属性，例如产品、研发、测试等

![详情页配置](https://docs.ones.cn/assets/images/8e6a2a574e23d1a2-3de4137997f62ab21b84b09e579babae.png)

点击页面下方的「新建分组」，可以在当前标签页下创建空分组并命名。

在当前标签页下点击分组名称区域并拖拽，可以进行 **排序** 。

![详情页配置](https://docs.ones.cn/assets/images/763c3d8905270fb515fe-6b93fa0a70e1e97eb681c9a0fa8d2e33.gif)

分组可以被删除、重命名。

分组的删除影响与标签页类似：

1. 该分组包含的属性、控件都会从详情页表单被移除
2. 若分组被添加到了新建页，则新建页内，该分组包含的表单项也会被一并删除
3. 若分组下的属性被添加到了步骤页，则步骤页内，该属性也会被删除、失效处理。
![详情页配置](https://docs.ones.cn/assets/images/8a6d27a5a5e55d67-5f3b4a65c0967fcdca01149b6cb51227.png)

**分组的可见性** 受到分组内容的影响，具体规则如下：

1. 当分组内所有的表单项对当前用户不可见时，整个分组都不展示
2. 当分组内没有表单项时，整个分组不会展示。
使用时，成员可自由展开/收起分组，方便阅读。

![详情页配置](https://docs.ones.cn/assets/images/a05fc72e1f412398-5320851d8f0a36968da5876a87e016e9.png)

#### 快捷操作

对于一些高频使用的工作项操作，例如关联、登记工时等，可以让操作固定展示在工作项详情的右上角区域（快捷操作区），方便使用者查看、点击。

![详情页配置](https://docs.ones.cn/assets/images/73619d48d89e7a9f95ca-42e50251a2f329892358945cddbe15b1.gif)

点击快捷操作区域，可以在页面右侧的配置栏内进行操作的添加、删除、排序。点击「添加」，弹窗内会展示当前系统里所有的快捷操作。

如果快捷操作提示不可以添加，一般是因为该操作对应的属性未被添加到表单，需要先把属性配置到表单、再添加对应的快捷操作。

例如，如果希望在快捷操作区展示"登记工时"操作，需要先把对应的"工时信息"控件加入到表单，再添加"登记工时"操作。

![详情页配置](https://docs.ones.cn/assets/images/bd6e52b0bef09c1b-cc6229cb15cfe6ad56127b870f62e2c2.png)

#### 关键属性

对于一些需要重点关注和强调的工作项属性信息（例如：负责人、截止日期），可以配置为关键属性，在详情页的标题区域展示。目前，管理关键属性的方式有两种：1、配置者可以直接点击加号按钮、选择属性；2、通过在标签页下选中属性、点击图钉按钮，添加到关键属性。

通过拖拽，配置者可以 **自定义顺序** 。请注意，最多添加5个关键属性。

![详情页配置](https://docs.ones.cn/assets/images/c20832029258b23c669b-1da68d46764753294e762ecb56308c93.gif)

#### 预览

配置完详情页后，可以点击「预览」按钮， **预览宽详情、窄详情** 下的布局表现。

![详情页配置](https://docs.ones.cn/assets/images/85a355a798ddb54f25d2-923d3a66193f94aca79927451eee97f5.gif)

### 2.3 表单规则

对于属性、控件等表单项，配置者可以在页面右栏配置显示条件、默认值、是否必填等规则。每个表单项可配置的规则不一样，取决于该表单项的使用场景。

#### 显示条件

可以配置属性或控件在表单上的显示、隐藏行为，支持配置 **默认展示、默认不展示、在某个条件下展示** 。

请注意，这里的展示或隐藏 **与属性可见权限无关** 。即配置了不展示的属性， **仍然可以在工作项详情外的其他模块（例如筛选器、工作项列表等）里展示。**

![详情页配置](https://docs.ones.cn/assets/images/b6046fdbd57b43c0-26490d42957374e4f1642594ebd3b951.png)

若业务需要根据不同的场景、上下文设置属性展示或隐藏，可选择为"在某条件下显示"。配置条件时，可以配置属性作为条件、成员作为条件。

使用场景：在需求管理中， 当需求类型是「路线图需求」时，对所有人展示「所属史诗」属性；当需求类型是「交付需求」时，只对「BA」角色、「PMO」角色展示「描述」。

![详情页配置](https://docs.ones.cn/assets/images/ffe76f0a42675943a34e-c6cd9c0b14331658121269b3e3555815.gif)

#### 默认值

默认值配置的说明请见 [新建页配置](https://docs.ones.cn/on-premises/7.33/product-manual/ones-project/issues/issue-layout/new-page-configuration/) - 「默认值」部分。

注意，详情页的「默认值」配置只在 新建页布局方式选择"与详情保持一致"时生效。

#### 是否必填

管理员可以在详情页配置属性是否必填，支持配置「必填」、「非必填」。

注意，对于同一个属性，详情页的必填配置和新建页、步骤页的必填配置可以不同（例如，详情页可以配置属性为"必填"，新建页/步骤页可以配置为"非必填"），但对于大部分业务场景，推荐 **保持相同的必填配置** 。

![详情页配置](https://docs.ones.cn/assets/images/e93063d136db761d-d5d36073461f6cb8cb543e5cb2b6bee6.png)

#### 选项值范围

对于特定类型的属性（单选菜单、多选菜单等），可以配置用户填属性时、下拉框内可选的值范围。支持配置「展示全部选项值」、「展示部分选项值」

![详情页配置](https://docs.ones.cn/assets/images/05b873495aeaa6fd-6fb7121f3d1799fe59cd40237d446c6f.png)

若希望该属性在某个场景下，只有部分值可选，可以配置为「展示部分选项值」。

配置弹窗内，可以点击「添加一组条件与选项值」、创建多个条件&选项值场景，管理不同场景下的预期；也可以添加「未命中时展示的选项值」，定义未命中场景的选项值展示。

![详情页配置](https://docs.ones.cn/assets/images/b90c9f738840853d4fc0-c7b8d63e34b125a42e0d579e3108a622.gif)

当配置了多组条件与选项值场景时，若不同场景的触发条件有重合，系统将按照左侧栏从上到下的顺序来匹配，即优先执行排序在上的条件配置。管理员可以拖拽配置、进行排序。

#### 占位文本

占位文本可以用于对属性填写行为做提示、说明或引导等。配置占位文本后，使用者在填写属性值时可以看到提示信息。

![详情页配置](https://docs.ones.cn/assets/images/09d60145c9d45d8e-6e65ecafa1feac25ae788ac84e38ddbb.png)

使用侧展示效果如下：

![详情页配置](https://docs.ones.cn/assets/images/67e77af279df744a-76dfaea39dd951f6d874c85ae246eb02.png)

## 3 常见问题

### 为什么配置在表单里的属性，使用时不显示？

原因：可能是属性所在标签页被隐藏。

措施：可以检查标签页的可见性配置：点击标签页后的配置按钮，选择「设置可见范围」，检查配置情况。

### 为什么使用详情页时，快捷操作显示不支持使用？

原因：可能是快捷操作对应的属性/控件命中了隐藏，或属性所在标签页命中了隐藏。

措施：可以参考下表，检查操作对应属性/控件的「显示条件」配置和标签页的「设置可见范围」配置。

快捷操作-属性/控件对应关系表：

| **快捷操作** | **相关工作项属性和控件** |
| --- | --- |
| 关联wiki页面 | 系统属性「关联wiki页面」 |
| 关联工作项 | 控件「关联内容」 |
| 关联迭代 | 系统属性「所属迭代」 |
| 登记工时 | 控件「工时信息」 |
| 关联用例 | 控件「测试情况」 |
| 添加父层级属性 | 父层级属性 |
| 添加子层级属性 | 子层级属性 |
| 新建子层级属性 | 子层级属性 |
| 批量新建子层级属性 | 子层级属性 |