> 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/guan-li-gong-zuo-xiang/gong-zuo-xiang-lei-xing-shu-xing-yu-shi-tu/quan-ju-shi-tu.md).

# 全局视图配置

## 1. 什么是全局视图？

全局视图主要用于管理某个工作项类型显示哪些属性、属性默认值、是否必填、详情表单与新建表单的内容。全局视图的配置对所有应到到该工作项类型的项目生效。

## **2. 全局视图的应用场景**

* 希望新建表单与详情表单的属性、布局不一样时，例如，新建需求时，不需要用户填写故事点、所属迭代等属性或者使用关联代码和工时等模块，但是在详情表单中后续的工作会使用到这些属性、模块，可以将新建表单与详情表单的属性布局设置的不一样。
* 希望给系统里不同项目的同一个工作项类型增加一个某个字段时，例如我们希望给系统里不同项目的“需求”增加一个“需求来源”的字段。我们只需要在这些项目使用的视图配置里添加“需求来源”的字段，就能实现给多个项目的需求加字段的效果。

![](/files/-MdB8kDlgRGhwumXP0QE)

## 3. 功能特性

### 3.1  新建全局视图

&#x5728;**`项目管理配置配置中心`**> **`视图配置`** 中，界面会列出系统里的全部视图配置，在列表会显示每个视图配置适用于哪种工作项类型，被哪些项目使用，并列出详情表单和新建表单的配置入口。

每新增一种工作项类型，会自动生成其对应的全局视图。也可以&#x5728;**`项目管理配置配置中心`**> **`视图配置`** 中，点&#x51FB;**`新建视图配置`**，在弹窗内输入视图名称，选择适用的工作项类型。

### **3.2 配置详情表单**

视图配置支持以所见即所得的方式编辑详情表单。在列表中，选择任一视图配置，点击`详情表单`，在弹窗内进行详情表单配置。

详情视图的配置界面分为三栏：左栏提供属性配置的入口。中栏为详情视图的效果预览，用户可以通过右上角的按钮切换预览宽屏详情页与窄屏详情页。右栏是选中标签页或卡片后的配置项。

![](/files/-MdGkfX_he3tyuGYNMGO)

**3.2.1 配置模块标签页**

选中模块标签页，即可在右栏编辑标签页。用户可以添加系统预设的模块标签页到详情页里（比如详情、子工作项、关联内容）。预览宽屏详情页时，支持点击切换标签页，来查看标签页里的内容。

![](/files/-MdGkiEfg7SgOqJIYZaf)

#### 3.2.2 在详情视图添加或移除属性 <a href="#zai-xiang-qing-shi-tu-tian-jia-huo-yi-chu-shu-xing" id="zai-xiang-qing-shi-tu-tian-jia-huo-yi-chu-shu-xing"></a>

如果希望在界面上添加或移除属性，可以选中界面已有的“属性”卡片，在右栏添加想要显示的属性。每个属性在详情视图上只能出现一次；添加属性时不添加已显示的属性。

![](/files/-MdGkoXB99zMnqUPiI9z)

{% hint style="info" %}
特定的系统属性只能通过预设的系统卡片添加到界面上。比如“所属项目”、“创建者”、“更新时间”等系统属性只能通过“基础信息”这个系统卡片添加。
{% endhint %}

**预设的模块标签页与相关属性**

在 ONES 系统中，部分功能需要多个属性一起出现才能正常工作（比如“工时”模块与“预估工时”、“剩余工时”等属性）。因此，系统将他们打包成了预设的模块标签页。‌当用户使用这些模块标签页时，相关属性会自动添加到工作项属性里。 ‌

模块标签页与相关属性的对应关系如下：

| 模块标签页    | 相关属性                                                                        |
| -------- | --------------------------------------------------------------------------- |
| 工时       | <ul><li>预估工时</li><li>已登记工时</li><li>剩余工时</li><li>工时进度</li><li>预估偏差</li></ul> |
| 周期与进度    | <ul><li>计划开始日期</li><li>计划完成日期</li><li>进度</li></ul>                          |
| “基础信息”卡片 | <ul><li>所属项目</li><li>工作项类型</li><li>创建者</li><li>创建时间</li><li>更新时间</li></ul>  |

**3.2.3 配置属性的默认值、是否必填**

在详情表单左栏，都提供“默认值和是否必填”和“关键属性”的配置入口。

点&#x51FB;**`默认值和是否必填`**，打开视图配置所用到的所有属性的列表。可以在这个列表上管理属性的默认值与是否必填。

点&#x51FB;**`关键属性`**，在关键属性列表设置哪些属性信息会显示在工作项窄详情布局的左栏列表、看板的工作项、全局视图配置方案里面。

![](/files/-MdGlGtgePWrzqWCSkl7)

### **3.3 配置新建表单**

新建表单的配置界面分为三栏：左栏提供属性配置的入口。中栏为详情视图的效果预览。右栏是选中标签页或卡片后的配置项。

**3.3.1 快捷配置：与详情视图保持一致**

新建表单支持设置为“与详情视图保持一致”，从而快速配置新建表单。新建表单会以窄屏详情页的顺序，展示详情视图里配置的标签页与卡片。标签页在新建表单对应为快速导航。详情视图里的工时日志卡片会在新建表单显示为预估工时卡片。用户不能修改的属性（比如“创建者”、“创建时间”这些系统属性）与卡片（比如“关键属性”卡片）会被自动隐藏

**3.3.2 快捷配置：自定义配置**

新建表单支持配置模块标签页来控制新建表单提供哪些内&#x5BB9;**，**&#x652F;持在新建表单中添加或移除工作项属性。

**3.3.4 配置属性的默认值、是否必填**

在新建表单左栏，都提供“默认值和是否必填”和“关键属性”的配置入口。

点&#x51FB;**`默认值和是否必填`**，打开视图配置所用到的所有属性的列表。可以在这个列表上管理属性的默认值与是否必填。

点&#x51FB;**`关键属性`**，在关键属性列表设置哪些属性信息会显示在工作项窄详情布局的左栏列表、看板的工作项、全局视图配置方案里面。

### 3.4  复制、重命名、删除视图

在 **`项目管理配置中心`** > **`视图配置`** 中，选择任一视图，点击操作按钮“`…`”，可以执行复制、重命名、删除视图等操作。如果某个视图配置正在被任一项目使用，则不能删除。

## 4. 在项目中应用全局视图

目前支持两种方式来应用全局视图配置。

方法一：在 **`项目管理配置中心`** > **`视图配置`** 里找到配置好的视图配置，点击操作按钮“`…`”，点击“**`应用到`**”选项，然后在弹窗里选择要应用到哪一个项目的工作项类型。

![](/files/-MdGkVLWqu3Y--6bi09i)

方法二：打开具体项目的项目配置， 找到对应工作项类型&#x7684;**“`属性与视图`”** 。 点击“**`切换视图配置`**” ，可以看到“使用全局视图配置”的选项。选择此选项，然后选择一套视图配置，点击“**`应用`**”，即可在项目里应用全局视图配置。

![](/files/-MdGkZ3_rCxFBUKAHHxz)

## 5. 全局视图和本地视图的区别

**本地视图**：

* 可以配置工作项类型的属性、关键属性、模块标签等信息，新建表单或者详情表单按系统默认显示。
* 修改本地视图中工作项类型的属性、关键属性、模块标签等设置，不影响已经使用到该本地视图的项目。
* 在`工作项类型`>`属性与视图`中，默认使用本地视图，也可以切换使用某个全局视图为默认视图。

![](/files/-MdBDqSIMoYEWYrd-RQO)

**全局视图**：

* 为工作项的新建表单或者详情表单分别设置不同的工作项属性、模块标签和布局。
* 修改全局视图的配置后，会自动在应用这套配置的项目里生效

![](/files/-MdBE1uWiypeg1vHqd6_)
