• 查看任务
• 创建任务
  • 从任务列表项创建
• 添加现有任务到议题
• 编辑任务
  • 使用富文本编辑器
• 将任务升级为议题
• 从议题中移除任务
• 删除任务
• 重新排序任务
• 分配用户到任务
• 为任务分配标签
• 设置开始日期和截止日期
• 添加任务到里程碑
• 设置任务权重
• 将任务添加到迭代
• 查看任务系统备注
• 评论和主题
• 复制任务引用
• 复制任务电子邮件地址
• 私密任务
  • 将任务设置为私密
    • 在新任务中
    • 在现有任务中
  • 谁可以看私密任务
  • 私密任务标识
• 两列布局
• 任务中的关联项
  • 添加关联项
  • 移除关联项

任务

• 引入于 14.5 版本，功能标志为 work_items。默认禁用。
• 创建、编辑和删除任务功能引入于 15.0 版本。
• 在 SaaS 和私有化部署版上启用于 15.3 版本。

已知限制：

• 当前无法通过 REST API 访问任务。

使用任务来跟踪关闭议题所需的步骤。

在规划议题时，您需要一种方法来捕获和分解完成它所需的技术要求或步骤，有相关任务的议题可以更好地被定义，因此您可以提供更准确的议题权重和完成标准。

查看任务

在 任务 部分中，查看议题中的任务。

您还可以用 Type = task 过滤议题列表。

如果您从议题中选择任务，它将在对话框窗口中打开。 如果您选择要在新浏览器选项卡中打开的任务，或从议题列表中选择该任务，则该任务会以全页视图打开。

创建任务

先决条件：

• 您必须至少具有项目的报告者角色，或者项目必须是公开的。

要创建任务：

1. 在议题描述的 任务 部分中，选择 添加。
2. 选择 新建任务。
3. 输入任务标题。
4. 选择 创建任务。

从任务列表项创建

引入于 15.9 版本。

先决条件：

• 您必须至少具有该项目的报告者角色。

在带有任务列表项的议题描述中：

1. 将鼠标悬停在任务列表项上并选择选项菜单 ()。
2. 选择 转换为任务。

任务列表项将从议题描述中删除，并根据其内容在任务部件中创建了一个任务。 任何嵌套的任务列表项都会向上移动一个嵌套级别。

添加现有任务到议题

引入于 15.6 版本。

先决条件：

• 您必须至少具有该项目的访客角色，或者该项目必须是公开的。

添加任务：

1. 在议题描述的 任务 部分，选择 添加。
2. 选择 现有任务。
3. 按标题搜索任务。
4. 选择一个或多个任务添加到议题中。
5. 选择 添加任务。

编辑任务

先决条件：

• 您必须至少具有项目的报告者角色。

要编辑任务：

1. 在议题描述的 任务 部分中，选择您要编辑的任务。任务窗口打开。
2. 可选。要编辑标题，请选择它并进行更改。
3. 可选。要编辑说明，请选择编辑图标 ()，进行更改，然后选择 保存。
4. 选择关闭图标 ()。

使用富文本编辑器

• 在对话框视图中进行富文本编辑引入于极狐GitLab 15.6，功能标志为 work_items_mvc。默认禁用。
• 以全页视图进行富文本编辑引入于极狐GitLab 15.7。

使用富文本编辑器编辑任务描述。

先决条件：

• 您必须至少具有该项目的报告者角色。

要编辑任务的描述：

1. 在 任务 部分中，选择要编辑的任务的标题。任务窗口打开。
2. 在 说明 旁边，选择编辑图标()。出现描述文本框。
3. 在文本框上方，选择 富文本。
4. 进行更改，然后选择 保存。

将任务升级为议题

引入于极狐GitLab 16.1。

先决条件：

• 您必须至少具有该项目的报告者角色。

要将任务升级为议题，请使用 /promote_to issue 快捷操作。

从议题中移除任务

先决条件：

• 您必须至少具有项目的报告者角色。

您可以从议题中移除任务。任务没有被删除，但两者不再关联。无法再次关联它们。

要从议题中移除任务：

1. 在议题描述的 任务 部分中，在您要删除的任务旁边，选择选项菜单 ()。
2. 选择 移除任务。

删除任务

先决条件：

• 您必须满足以下条件之一：
  • 作为任务的作者并至少具有项目的访客角色。
  • 具有项目的所有者角色。

要删除任务：

1. 在议题描述的 任务 部分中，选择您要编辑的任务。
2. 在任务窗口的选项菜单中（），选择 删除任务。
3. 选择 确定。

重新排序任务

引入于极狐GitLab 16.0。

先决条件：

• 您必须至少具有该项目的报告者角色。

默认情况下，任务按创建日期排序。 如要重新排序，请进行拖动。

分配用户到任务

引入于极狐GitLab 15.4。

要显示任务的责任人，您可以为项目分配用户。

极狐GitLab 基础版上的用户可以为每个任务分配一个用户。 专业版和旗舰版上的用户可以将多个用户分配给单个任务。 另请参阅议题的多个指派人。

先决条件：

• 您必须至少具有该项目的报告者角色。

要更改任务的指派人：

1. 在议题描述的 任务 部分中，选择要编辑的任务的标题。任务窗口打开。
2. 在 指派人 旁边，选择 添加指派人。
3. 从下拉列表中，选择要添加为指派人的用户。
4. 选择下拉列表之外的任何区域。

为任务分配标签

引入于极狐GitLab 15.5。

先决条件：

• 您必须至少具有该项目的报告者角色。

要将标签添加到任务中：

1. 在议题描述的 任务 部分中，选择要编辑的任务的标题。任务窗口打开。
2. 在 标签 旁边，选择 添加标签。
3. 从下拉列表中选择要添加的标签。
4. 选择下拉列表之外的任何区域。

设置开始日期和截止日期

• 引入于极狐GitLab 15.4，功能标志为 work_items_mvc_2。默认禁用。
• 在 JihuLab.com 和私有化部署版本上启用于极狐GitLab 15.5。

您可以为任务设置开始日期和截止日期。

先决条件：

• 您必须至少具有该项目的报告者角色。

您可以设置任务的开始日期和截止日期，以显示工作应该开始和结束的时间。

要设置截止日期：

1. 在议题描述的 任务 部分中，选择要编辑的任务的标题。任务窗口打开。
2. 如果任务在 截止日期 旁边已有截止日期，请选择。否则，选择 添加截止日期。
3. 在日期选择器中，选择所需的截止日期。

要设置开始日期：

1. 在议题描述的 任务 部分中，选择要编辑的任务的标题。任务窗口打开。
2. 如果任务在 开始日期 旁边已有开始日期，请选择。否则，选择 添加开始日期。

3. 在日期选择器中，选择所需的开始日期。

   截止日期必须等于或晚于开始日期。 如果您选择的开始日期晚于截止日期，则截止日期将和开始日期为同一天。

添加任务到里程碑

• 引入于 15.5 版本，功能标志为 work_items_mvc_2。默认禁用。
• 功能标记变更为 work_items_mvc 于 15.7 版本。默认禁用。
• 在 SaaS 和私有化部署版上启用于 15.7 版本。

您可以将任务添加到里程碑。 查看任务时可以看到里程碑标题。 如果您为已经属于里程碑的议题创建任务，则新任务会继承里程碑。

先决条件：

• 您必须至少具有该项目的报告者角色。

将任务添加到里程碑：

1. 在议题描述中，在 任务 部分，选择您要编辑的任务的标题。任务窗口打开。
2. 在 里程碑 旁边，选择 添加到里程碑。如果任务已经属于里程碑，下拉列表将显示当前里程碑。
3. 从下拉列表中选择要与任务关联的里程碑。

设置任务权重

引入于 15.3 版本。

先决条件：

• 您必须至少具有项目的报告者角色。

您可以为每项任务设置权重，以显示它需要多少工作量。 此值仅在您查看任务时可见。

设置任务的议题权重：

1. 在议题描述的 任务 部分中，选择您要编辑的任务的标题。任务窗口打开。
2. 在 权重 旁边，输入一个正整数。
3. 选择关闭图标 ()。

将任务添加到迭代

• 引入于 15.5 版本。
• 功能标记变更为 work_items_mvc 于 15.7 版本。默认禁用。
• 在 SaaS 和私有化部署版上启用于 15.7 版本。

您可以将任务添加到迭代。 只有在查看任务时才能看到迭代标题和周期。

先决条件：

• 您必须至少具有项目的报告者角色。

要将任务添加到迭代：

1. 在议题描述的 任务 部分中，选择您要编辑的任务的标题。任务窗口打开。
2. 在 迭代 旁边，选择 添加到迭代。
3. 从下拉列表中，选择要与任务关联的迭代。

查看任务系统备注

• 引入于 15.7 版本，功能标志为 work_items_mvc_2。默认禁用。
• 功能标志变为 work_items_mvc 于 15.8 版本。默认禁用。
• 更改活动排序顺序功能引入于 15.8 版本。
• 过滤活动功能引入于 15.10 版本。
• 在 SaaS 和私有化部署版上启用于 15.10 版本。

您可以查看与该任务相关的所有系统备注。默认情况下，它们按 最早在前 排序。您始终可以将排序顺序更改为 最新在前，并且跨会话有效。 除了跨会话有效的默认 所有活动 之外，您还可以按 仅评论 和 仅历史记录 过滤活动。

评论和主题

您可以在任务中添加评论和回复主题。

复制任务引用

引入于极狐GitLab 16.1。

要引用极狐GitLab 中其他位置的任务，您可以使用其完整 URL 或简短引用，类似 namespace/project-name#123，其中 namespace 是群组或用户名。

要将任务引用复制到剪贴板：

1. 在左侧边栏中，选择 搜索或转到 并找到您的项目。
2. 选择 计划 > 议题，然后选择您的任务进行查看。
3. 在右上角，选择垂直省略号 ()，然后选择 复制引用。

您现在可以将引用粘贴到其他描述或评论中。

有关任务引用的更多信息，请参阅极狐GitLab Flavored Markdown。

复制任务电子邮件地址

引入于极狐GitLab 16.1。

您可以通过发送电子邮件在任务中创建评论。 向此地址发送电子邮件会创建包含电子邮件正文的评论。

有关通过发送电子邮件创建评论和必要配置的更多信息，请参阅通过发送电子邮件回复评论。

要复制任务的电子邮件地址：

1. 在左侧边栏中，选择 搜索或转到 并找到您的项目。
2. 选择 计划 > 议题，然后选择您的议题进行查看。
3. 在右上角，选择垂直省略号 ()，然后选择 复制任务电子邮件地址。

私密任务

引入于极狐GitLab 15.3。

私密任务是仅具有足够权限的项目成员可见的任务。 您可以使用私密任务来保护安全漏洞的私密性或防止意外泄露。

将任务设置为私密

默认情况下，任务是公开的。 您可以在创建或编辑任务时将其设为私密。

先决条件：

• 您必须至少具有该项目的报告者角色。
• 如果该任务有一个非私密的父议题，并且您希望将该议题设为私密，您必须首先将所有子任务设置为私密。 私密议题只能有私密子议题。

在新任务中

创建新任务时，文本区域正下方的复选框可用于将任务标记为私密。

选中该框并选择 创建任务。

在现有任务中

要更改现有任务的私密性：

1. 打开任务。
2. 在右上角，选择垂直省略号 ()。
3. 选择 开启私密。

谁可以看私密任务

当任务被设置为私密时，只有至少具有项目报告者角色的用户才可以访问任务。

具有访客或最小访问权限的用户无法访问该任务，即使他们在任务被更改为私密之前积极参与此任务。

但是，具有访客角色的用户可以创建私密任务，但只能查看他们自己创建的任务。

如果具有访客角色的用户或非成员用户被分配给该任务，则他们可以查看该私密任务。 当具有访客角色的用户或非成员用户被取消分配私密任务后，他们将无法再查看该任务。

没有权限的用户在搜索时，私密任务不会展示在搜索结果中。

私密任务标识

私密任务在视觉上与常规任务在一些方面有所不同。 无论在何处列出任务，您都可以在标记为私密的任务旁边看到私密()图标。

如果您没有足够的权限，您将无法看到私密任务。

同样，在任务内部，您可以在面包屑旁边看到私密()图标。

从常规到私密和从私密到常规的每次更改，都由任务评论中的系统注释进行标识，例如：

• Jo Garcia 在五分钟前将任务标记为私密
• Jo Garcia 刚刚将任务标记为公开

两列布局

引入于极狐GitLab 16.2，功能标志为 work_items_mvc_2。默认禁用。

启用后，任务使用两列布局，类似于议题。 描述和主题位于左侧，属性（例如标签或指派人）位于右侧。

任务中的关联项

引入于极狐GitLab 16.5，功能标志为 linked_work_items。默认禁用。

关联的项目是双向的，并显示在表情符号下方的部分中。您可以关联同一项目中的目标、关键结果或任务。

仅当用户可以看到这两个项目时，该关系才会显示在 UI 中。

添加关联项

先决条件：

• 您必须至少具有该项目的访客角色。

要将项目关联到任务：

1. 在任务的 关联项 部分中，选择 添加。
2. 选择两个项目之间的关系：
   • 关联
   • 阻塞
   • 被阻塞
3. 输入该项目的搜索文本。
4. 添加所有要关联的项目后，选择搜索框下方的 添加。

添加完所有关联的项目后，您可以看到它们已分类，以便可以更加直观地理解它们之间的关系。

移除关联项

先决条件：

• 您必须至少具有该项目的访客角色。

在任务的 关联项 部分中，在每个项目旁边，选择垂直省略号 ()，然后选择 删除。

由于双向关系，该关系不再出现在任一项目中。