1. 什么是工作项类型？

“工作项类型“是拥有特定工作项属性或工作流的工作项的分类，主要用于管理团队内各种不同的事务，每种工作项类型都有不同的属性与视图、权限、工作流、通知方案、提醒方案来满足不同的事务管理需求。

系统默认的出厂配置中包含研发场景下常用的需求、缺陷、任务、发布等标准工作项，以及子需求、子工作项、子检查项等子工作项类型。拥有项目管理权限的用户也可以自定义工作项类型，或者修改工作项类型的配置来满足不同业务场景的需求。

本章节以项目管理配置中心里的全局配置为例说明如何管理工作项类型。

1.1 新建工作项类型

在项目管理配置中心>工作项类型中，点击新建工作项类型，输入工作项类型名称，并选择类型和图标，点击确定，即可创建新的工作项类型。新建好的工作项类型内预制了一套属性视图、工作流、权限和通知方案，有配置中心管理工作项权限的用户可以进行修改。

1.2 从已有工作项类型复制

若新建的工作项类型和已有工作项类型相似，可直接复制。在项目管理配置中心>工作项类型中

选择任一工作项类型，在操作列点击复制，输入工作项类型名称并选择类型和图标，点击确定，即可复制一个新的工作项类型。

1.3 删除工作项类型

在项目管理配置中心>工作项类型，选择任一工作项类型，点击删除工作项类型，即可删除当前工作项类型。系统默认的工作项类型不可删除，已经使用在项目的工作项需要在项目中移除后，方可删除。

1.4 重命名工作项类型

在项目管理配置中心>工作项类型中，选择任一工作项类型，在操作列点击重命名，即可修改工作项类型的名称和图标。只可修改自定义工作项类型的名称和图标。

1.5 编辑工作项类型

在项目管理配置中心>工作项类型中，选择任一工作项类型，在操作列点击编辑，即可对工作项类型的属性与视图、权限、工作流、通知、提醒进行设置。编辑工作项类型的配置不影响已经使用到当前工作项类型的项目，只会在应用到当前工作项类型的新项目中生效。

1. 什么是工作项优先级?

工作项优先级主要用于表达工作项的紧急或者重要程度，系统预置 最高、较高、普通、较低、最低 五种优先级可供使用，也可以根据团队应用场景进行自定义配置。

2. 功能特性

2.1 新建优先级

在项目管理配置中心>优先级中，点击新建优先级，在弹窗内输入优先级名称、设置配色以及描述后，点击确定，即可新建优先级。

2.2 编辑优先级

在项目管理配置中心>优先级中，选择任一优先级，点击编辑图标，在弹窗内修改优先级名称、设置配色以及描述后，点击确定，即可编辑优先级。

2.3 删除优先级

在项目管理配置中心>优先级中，选择任一优先级，点击删除图标，即可删除优先级。如当前优先级已在项目中使用，则需要将影响到的工作项的优先级从当前优先级调整为其他优先级。

2.4 设置默认优先级

在项目管理配置中心>优先级中，点击设置默认优先级，在弹窗内选择任一优先级，并点击确定即可。

2.5 优先级排序

在项目管理配置中心>优先级中，在优先级列表，选中任一优先级可以拖拽调整优先级排序。

1. 什么是工作项属性及视图？

工作项属性是对工作项特征的具体描述，通过不同类型的属性字段来表达，用于快速说明此工作项的状态、负责人、优先级等信息，是工作项类型配置的必备信息。例如，在需求这种工作项类型中，如果需要记录需求来源时，可以将需求来源这个属性增加到需求工作项类型中，以更加结构化的描述需求。

工作项视图主要用于设置用户在新建或者查看具体一条工作项有哪些模块标签、有哪些属性，哪些属性有默认值或者是否必填。

2. 管理工作项属性

2.1 新建工作项属性

在 配置中心> 项目管理配置>工作项属性 中，显示了团队内所有可用的自定义或者系统工作项属性。点击新建工作项属性，在弹窗内，输入属性名称并选择属性类型，可以新建工作项属性。

自定义属性类型包含：单选菜单、多选菜单、单行文本、多行文本、日期、时间、单选迭代、单选成员、多选成员、整数、浮点数、间隔时间、属性选项停留次数、属性选项停留时间、出现时间。

2.2 修改工作项属性

点击右侧编辑图标，可修改工作项属性名称或者选项值。

2.3 删除工作项属性

点击右侧x，可删除该工作项属性。如某个工作项属性正在被任一工作项使用，则不可删除。系统属性也不可删除。

3. 添加工作项属性到工作项类型中

每种工作项类型都可以设置不同的工作项属性，满足不同业务场景的需要，使工作项管理更加灵活和高效。

在 配置中心> 项目管理配置>工作项类型 中，选择任一工作项类型，并进入工作项属性与视图配置界面，界面中将会显示当前工作项类型的所有属性。点击添加工作项属性，并在弹窗内选择属性名称、设置是否必填后，点击确定，将选中的属性增加到当前工作项类型中。

当已有的工作项属性不能满足需要时，可以新增工作项属性。参考新建工作项属性。

4. 设置工作项类型的关键属性

工作项类型的关键属性主要用于在工作项列表中显示一些关键信息，例如优先级、负责人等。除标题，描述，状态和关注者外，最多可以添加5个属性，选项类型的属性配色方案需在工作项属性中单独设置。

5. 设置工作项类型的模块标签页

模块标签页主要用于控制工作项的详情页和新建表单时模块的顺序以及是否显示。

例如，新建需求时，希望不显示关联代码和工时两个模块，以简化新建需求表单内容。管理员可以通过设置是否显示开关来实现；管理员可以通过拖拽调整模块顺序，将优先级较高的模块内容调整到表单的前面。

6. 设置工作项类型的视图

视图主要用于设置用户在新建或者查看具体一条工作项有哪些模块标签、有哪些属性，哪些属性有默认值或者是否必填。在属性与视图配置中，默认使用本地视图作为模版应用到项目中，也可以点击切换视图配置，选择全局视图配置来作为默认视图。了解如何配置全局视图。

1. 什么是工作项权限？

工作项权限主要用于控制哪些用户可以创建、编辑、查看工作项等权限。在ONES 系统中，可以按照权限点来设置用户在某种工作项类型下的权限。

2、功能特性

2.1 设置工作项权限

在 项目管理配置中心> 工作项类型>，选择任一工作项类型，例如需求，进入工作项权限配置界面。在当前界面找到想要控制的权限点，并为其设置对应的成员域，即可为成员设置对应的权限。

2.2 工作项权限点一览表

1. 什么是关联关系类型？

关联关系类型主要用于配置工作项之间的关联关系，在关联工作项时使用，帮助清晰表达工作项之间的关系。例如，工作项 A 由工作项 B 复制而来时，为清晰说明两者复制与被复制的关系，可以通过自定义关联关系实现。目前：

• 支持限制关联关系某一端可以选择哪些工作项类型

• 支持三种关联关系：单向关联（一对多）、单向关联（多对多）、相互关联

2. 功能特性

2.1 新建关联关系

在 配置中心 > 关联关系类型 中，界面会列出系统里的全部关联关系，按照自定义和系统默认分类展示。点击新建关联关系的按钮，在弹窗内选择关联关系类型，并点击确定，进入关联关系配置页面。具体配置参考下方配置案例。

2.2 编辑关联关系

点击右侧编辑图标，可修改关联关系的名称、描述和可选的数据范围。

2. 3 删除关联关系

点击右侧x，可删除该关联关系类型。如某个关联关系正在被任一工作项使用，则不可删除。

3. 配置案例

3.1 单向关联（一对多）

在单向关联（一对多）的关联关系里，发起关联方可以选择多条被关联方的数据，但是被关联方选择发起关联方时，只能选择一条数据。

以“史诗拆解需求”为例，我们希望史诗能拆解出多条需求，但是需求只能有一条来源史诗。于是我们进行以下配置：

• 关联关系名称：史诗拆解需求

• 发起关联方的描述：来源史诗

• 发起关联方的工作项类型：史诗

• 被关联方的描述：拆解得到的需求

• 被关联方的工作项类型：需求

我们能直接在右侧预览配置的效果，如图所示：

提交配置后，即可在全局使用“史诗拆解需求”这个关联关系：

• 在史诗里关联工作项时，可以选择“拆解得到的需求”这一关联描述。“拆解得到的需求”只能选择工作项类型为“需求”的工作项，支持选择多条需求；

• 在需求里关联工作项时，可以选择“来源史诗”这一关联描述。“来源史诗”只能选择工作项类型为“史诗”的工作项，且只能选择一条史诗。

3.2 单向关联（多对多）

在单向关联（多对多）的关联关系里，发起关联方可以选择多条被关联方的数据，被关联方也可以选择多条发起关联方的数据。

以“工单转需求”为例，一条工单可能转为多条需求，同时一条需求可能有多条来源工单。于是我们进行以下配置：

• 关联关系名称：工单转需求

• 发起关联方的描述：来源工单

• 发起关联方的工作项类型：工单

• 被关联方的描述：工单转需求

• 被关联方的工作项类型：需求

我们能直接在右侧预览配置的效果，如图所示：

提交配置后，即可在全局使用“工单转需求”这个关联关系：

• 在工单里关联工作项时，可以选择“工单转需求”这一关联描述。“工单转需求”只能选择工作项类型为“需求”的工作项，支持选择多条需求；

• 在需求里关联工作项时，可以选择“来源工单”这一关联描述。“来源工单”只能选择工作项类型为“工单”的工作项，支持选择多条工单。

3.3 相互关联

在互相关联的关联关系里，不区分关联关系的发起关联方和被关联方。关联时可以选择多条数据。

以“相似需求”为例，整理需求池时，可以把相似的需求关联在一起，关闭重复的、只留下一条待执行的。于是我们进行以下配置：

• 关联关系名称：相似需求

• 描述：相似需求

• 被关联方的工作项类型：需求

我们能直接在右侧预览配置的效果，如图所示：

提交配置后，即可在全局使用“相似需求”这个关联关系：

• 在需求里关联工作项时，可以选择“相似需求”这一关联描述。“相似需求”只能选择工作项类型为“需求”的工作项，支持选择多条需求。

1. 如何设置项目中的工作项类型？

项目管理的范围和内容决定当前项目中有哪些工作项类型。在创建项目时，根据选择的项目模版，新的项目中会预置对应的工作项类型以及对应的配置信息。有项目管理权限的用户也可以根据当前项目的应用场景，增加新的工作项类型或者调整工作项类型的配置。

2. 功能特性

2.1 添加工作项类型

在项目设置>工作项类型中，点击添加工作项类型，在弹窗内从已有全局配置中选择工作项类型，并点击确定，即可将选中的工作项类型添加到当前项目中。如已有的工作项类型不满足业务场景需要时，可选择新建工作项类型。了解如何新建工作项类型。

2.2 从已有项目复制

若已有的项目中有配置好的工作项类型方案可用, 可使用复制工作项类型的功能。在项目设置>工作项类型中，点击从已有项目复制，在弹窗内选择项目和想要复制的工作项类型后，点击确定，即可将工作项及其配置信息复制到当前项目。

2.3 删除工作项类型

在项目设置> 工作项类型中，选择任一工作项类型，进入配置界面，点击删除工作项类型，即可从项目中删除当前工作项类型。

2.4 工作项类型排序

当一个项目内的工作项类型数量较多时，可以对工作项类型进行排序，方便操作。在项目设置> 工作项类型中，点击排序，在弹窗内对工作项进行排序，点击确定后，将在工作项类型列表更新排序。

2.5 工作项类型配置

项目中的工作项类型配置会默认继承创建项目时项目管理配置中心> 工作项类型 中的工作项配置信息，有项目管理权限的用户也可以根据当前项目的应用场景，调整工作项类型的配置项，调整后，只对当前项目生效。

具体操作参考：

工作项属性与视图

工作项权限设置

工作项状态与工作流

工作项通知

工作项提醒

1. 什么是工作项通知？

工作项通知主要用于设置哪些成员可以收到工作项动态的通知，并为其设置通知渠道。在ONES Project 中，每种工作项类型的通知方案都可以进行自定义配置，管理员可以根据实际的业务场景，设置特定的通知触发事件和通知方式，让信息的触达更加精准和有效。

2. 功能特性

2.1 设置工作项通知

在 项目管理配置配置中心>工作项类型 中，选择任一工作项类型，并进入工作项通知配置界面，在当前界面找到收到通知的触发事件，并为其设置通知方式以及通知对象如部门、用户组等。例如：想要设置在创建需求的时候，通过邮件告知需求的负责人，则可以参考以下配置方式。

2.2 工作项通知渠道

目前支持系统内通知中心、邮件、飞书、钉钉、企业微信、有度等通知渠道。其中，飞书、钉钉、企业微信、有度属于第三方通知，需要团队管理员在配置中心绑定第三方账号后，方可启用。

2.3 工作项通知触发事件一览表

1. 什么是工作项提醒？

工作项提醒主要用对工作项的一些关键时间节点设置提醒时间、提醒渠道、提醒对象，告知团队成员及时关注任务处理的时间进度。

2. 功能特性

2.1 添加工作项提醒

在 项目管理配置中心>工作项类型 中，选择任一工作项类型，并进入工作项提醒配置界面，点击添加提醒规则，在弹窗内设置提醒规则。

例如：如果任务没有完成的情况下， 想要在截止日期前 1 天 提醒任务负责人及时处理任务，可参考以下配置方案。

规则设置完成后，提醒对象在工作项详情中可以看到对应属性的提醒图标，显示当前属性的提醒规则， 到达提醒时间，提醒对象会按照设置的提醒规则收到提醒 。

2.2 编辑工作项提醒

在工作项提醒规则列表，选中任一条提醒规则，点击编辑图标，进入编辑界面，可以对工作项提醒规则进行修改。

2.3 删除工作项提醒

在工作项提醒规则列表，选中任一条提醒规则，点击删除图标，进入编辑界面，可以删除工作项提醒规则。

2.4 提醒规则说明

2.4.1 提醒时间：主要用于设置什么时间节点发工作项提醒，其中可选的属性来源于当前工作项类型中时间或日期类型的属性

选择时间类型的属性：

提醒节点可选：之前，当时，之后; 选择当时，不可设置具体的天时分; 时间单位：分钟，小时，天，最小值 1；

选择日期类型的属性：

提醒节点可选：之前，当天，之后； 选择当天，不能配置天，只能选择当天具体的时间； 时间单位：只能为天，最小值 1 ；

2.4.2 提醒方式 ：主要用于设置可以通过哪些渠道收到通知。目前支持通知中心、邮件、飞书、钉钉、企业微信、有度等通知渠道。其中，飞书、钉钉、企业微信、有度属于第三方通知，需要团队管理员在配置中心绑定第三方账号后，方可启用。

2.4.3 工作项限制 ：主要用于限制满足哪些条件的工作项可发工作项提醒；支持当前工作项类型下的筛选器。

2.4.4 提醒对象 ：主要用于设置工作项通知可以发送给哪些用户；支持搜索角色，用户组，部门，成员。

1. 什么是全局视图？

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

2. 全局视图的应用场景

• 希望新建表单与详情表单的属性、布局不一样时，例如，新建需求时，不需要用户填写故事点、所属迭代等属性或者使用关联代码和工时等模块，但是在详情表单中后续的工作会使用到这些属性、模块，可以将新建表单与详情表单的属性布局设置的不一样。

• 希望给系统里不同项目的同一个工作项类型增加一个某个字段时，例如我们希望给系统里不同项目的“需求”增加一个“需求来源”的字段。我们只需要在这些项目使用的视图配置里添加“需求来源”的字段，就能实现给多个项目的需求加字段的效果。

3. 功能特性

3.1 新建全局视图

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

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

3.2 配置详情表单

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

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

3.2.1 配置模块标签页

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

3.2.2 在详情视图添加或移除属性

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

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

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

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

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

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

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

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

3.3 配置新建表单

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

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

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

3.3.2 快捷配置：自定义配置

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

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

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

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

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

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

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

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

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

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

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

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

本地视图：

• 可以配置工作项类型的属性、关键属性、模块标签等信息，新建表单或者详情表单按系统默认显示。

• 修改本地视图中工作项类型的属性、关键属性、模块标签等设置，不影响已经使用到该本地视图的项目。

• 在工作项类型>属性与视图中，默认使用本地视图，也可以切换使用某个全局视图为默认视图。

全局视图：

• 为工作项的新建表单或者详情表单分别设置不同的工作项属性、模块标签和布局。

• 修改全局视图的配置后，会自动在应用这套配置的项目里生效

1. 什么是工作项状态及工作流？

工作项状态是指工作项在某个特定时间点的状态，是工作项工作流的重要组成部分。

工作流是指工作项在其生命周期过程中将不同的状态以一定顺序串联，按照步骤流转，从开始到结束的过程。

ONES Project 支持不同工作项类型的工作流定制，让不同的工作项类型，在不同的项目中可以有不同的流转过程，帮助团队规范流程的同时兼具灵活性。

2. 管理工作项状态

2.1 新建工作项状态

在项目管理配置中心>工作项状态 ，点击新建工作项状态在弹窗内填写状态名称，并选择状态类型后，点击确定，即可完成创建。

2.2修改工作项状态

2.3 删除工作项状态

3. 配置工作流

在系统出厂设置中，每一种工作项类型都有默认的工作流，可直接使用，也可以在此基础上进行调整。在工作流配置界面，系统提供 3 种视图：

• 流程视图

• 表格视图

• 详情视图

下面以自定义工作项工作流的表格视图为例讲解如何配置工作流。在自定义工作项的工作流中，默认包含未开始、进行中、已完成 3 种状态，可以实现如下工作流流转：

如需要对工作流进行调整时，可参照以下方法：

3.1 添加工作项状态

点击添加工作项状态，在弹窗内选择当前工作项需要流转的状态，并点击确定。新增加的状态会显示在表格的最后一行和最后一列。

3.2 设置初始状态

初始状态为工作项创建时状态的默认值，一个工作流有且只有一个初始状态。点击设置初始状态，在弹窗内选择工作项状态，设置完成后，对应的状态将会带有初始状态的标签。

3.3 新建步骤

步骤是两个工作项状态之间的连接，使工作项从一个状态转换到另一个状态的过程，在工作项状态流转时使用。在表格视图中，可以通过勾选表格上的复选框，可以建立一条从“开始状态”到“目标状态”的步骤，默认步骤名称为“目标状态”的名称。

也可以点击新建步骤，在弹窗内选择开始状态和目标状态，来新建步骤。

3.4 编辑步骤

在表格视图中，点击步骤旁的编辑图标，进入步骤编辑界面。在该界面中可以设置步骤验证、步骤属性、后置动作、重命名步骤或者删除步骤。

3.4.1 设置步骤验证

步骤验证用于执行步骤时的验证条件，比如设置哪些成员域可以执行当前步骤。可以在下方的成员域选择框中项目角色、成员或者用户组。

3.4.2 设置步骤属性

步骤属性用于执行状态流转时，需要提交的字段，比如设置属性值、上传文件或者关联 Wiki 页面。

3.4.3 设置后置动作

后置动作用于步骤执行成功后，执行修改属性、发送通知、更新工作项状态等操作。存在多条后置动作时，按照列表的顺序从上到下执行。后置动作以系统权限执行，其执行结果不会影响当前步骤的执行结果。

4. 工作项状态联动

在研发场景中，需求等工作项往往会被拆分或关联到不同的工作项，所以在需求等工作项关联不同的子工作项或关联工作项后，若两者的执行步骤可以联动，团队协作将更加顺畅，也可以缩小管理成本。

4.1 应用场景

• 如「需求」下的子需求全部完成时，「需求」要同步完成，可在某子需求处进行「后置动作」设置；

• 如「需求」关联的研发任务全部完成时，「需求」要同步完成，可在研发任务处进行「后置动作」设置；

4.2 配置案例

4.2.1 配置入口

进入当前工作项的工作流步骤中，在后置动作中选择“状态联动”。

4.2.2 当目标工作项为“父工作项”，进入其子工作项进行配置

工作项及工作项状态为全局选项，完成选择后需核查是否匹配目标工作项的流转场景

4.2.3 目标为“关联工作项”，进入其相关联的工作项进行配置

工作项及工作项状态为全局选项，完成选择后需核查是否匹配目标工作项的流转场景

4.2.3 执行步骤时步骤验证、步骤属性、后置动作设置条件的提醒

步骤执行的条件将在步骤按钮中以图标形式展示，步骤如新增执行条件相应图标将被点亮，并且会描述条件详情，使用者可以通过描述了解流转条件。