议题看板

议题看板#

议题看板在极狐GitLab 中提供了一种可视化的方式来管理和跟踪工作。议题看板：

1. 以卡片形式在基于标签、里程碑或受让人的可定制列表中显示议题。
2. 通过不同阶段跟踪议题。
3. 支持敏捷方法论，如看板和 Scrum。
4. 为不同团队和项目组织多个看板。
5. 在整个过程中可视化工作量和进度。

您的议题会以竖直列表中的卡片形式出现，根据分配的标签、里程碑、迭代或受让人进行组织。

向您的议题添加元数据，然后为现有议题创建相应的列表。准备好后，您可以将议题卡从一个列表拖动到另一个列表。

议题看板可以支持常见的框架，如看板和 Scrum。

为了让团队成员组织自己的工作流程，使用多个议题看板。这允许在同一项目中创建多个议题看板。

不同的议题看板功能在不同的极狐GitLab 版本中可用：

阅读更多关于极狐GitLab 企业功能。

多个议题看板#

多个议题看板允许为以下情况创建多个议题看板：

1. 所有版本中的项目
2. 专业版和旗舰版中的群组

多个议题看板非常适合于包含多个团队的大型项目，其中一个代码库托管多个产品的代码，并且当您希望创建看板以支持软件开发生命周期中的不同工作流程时使用。

在菜单顶部的搜索框中，您可以筛选列出的看板。

当您有十个或更多的看板可用时，菜单中还会显示一个最近部分，提供到您最近访问的四个看板的快捷方式。

当您在具有多个看板的项目或群组中重新访问议题看板时，极狐GitLab 会自动加载您最后访问的看板。

创建议题看板#

先决条件：

• 您必须至少拥有项目的计划员角色。

要创建新的议题看板：

1. 在议题看板页面的左上角，选择当前看板名称的下拉列表。
2. 选择创建新看板。
3. 输入新看板的名称并选择其范围：里程碑、迭代、标签、受让人或权重。
4. 选择创建看板

删除议题看板#

先决条件：

• 您必须至少拥有保存看板的项目或群组的计划员角色。

要删除打开的议题看板：

1. 在议题看板页面的右上角，选择配置看板 (
   )。
2. 选择删除看板。
3. 选择删除以确认。

如果您删除的看板是最后一个，则会创建一个新的 Development 看板。

议题看板的使用场景#

您可以根据自己的工作流程定制极狐GitLab 议题看板。有关基于工作流程的文档，请参阅教程：规划和跟踪您的工作。

单个议题看板的使用场景#

使用极狐GitLab Flow 您可以在议题中讨论提案，对其进行标记，并使用议题看板组织和优先处理它们。

例如，让我们考虑这个简化的开发工作流程：

1. 您有一个托管应用程序代码库的代码库，您的团队积极贡献代码。
2. 您的后端团队开始进行新实现，收集反馈和批准，然后将其交给前端团队。
3. 当前端完成后，新功能会部署到预发布环境进行测试。
4. 测试成功后，它会部署到生产环境。

如果您有标签后端、前端、预发布和生产，以及每个标签的议题看板，您可以：

• 可视化从开发生命周期开始到部署到生产的整个实现流程。
• 通过垂直移动它们来优先处理列表中的议题。
• 在列表之间移动议题，以根据您设置的标签进行组织。
• 通过选择一个或多个现有议题，将多个议题添加到看板中的列表中。

Scrum 团队#

在 Scrum 团队中，使用多个议题看板，以便每个 Scrum 团队都有自己的看板。在 Scrum 看板上，您可以轻松地将议题移动到流程的每个部分。例如：待办事项、进行中和已完成。

快速分配#

要快速将议题分配给您的团队成员：

1. 为每个团队成员创建受让人列表。
2. 将议题拖到团队成员的列表中。

议题看板术语#

一个议题看板代表您的议题的独特视图。它可以有多个列表，每个列表由表示议题的卡片组成。

一个列表是议题看板上的一列，显示符合某些属性的议题。除了默认的 "Open" 和 "Closed" 列表外，每个附加列表都显示符合您选择的标签、受让人或里程碑的议题。在每个列表的顶部，您可以看到属于它的议题数量。列表类型包括：

• Open (默认)：所有未属于其他列表的开放议题。始终显示为最左侧的列表。
• Closed (默认)：所有关闭的议题。始终显示为最右侧的列表。
• 标签列表：某个标签的所有开放议题。
• 受让人列表：分配给某个用户的所有开放议题。
• 里程碑列表：某个里程碑的所有开放议题。
• 迭代列表：某个迭代的所有开放议题。

一个卡片是列表上的一个框，表示一个议题。您可以将卡片从一个列表拖到另一个列表，以更改其标签、受让人或里程碑。您可以在卡片上看到的信息包括：

• 议题标题
• 相关标签
• 议题编号
• 受让人
• 权重
• 里程碑
• 迭代（在专业版和旗舰版中）
• 截止日期
• 时间追踪估计
• 健康状态

一个泳道是议题看板上的议题的水平分组，例如按父史诗分组。

在列表中排序议题#

先决条件：

• 您必须至少拥有项目的计划员角色。

当创建一个议题时，系统会分配一个相对顺序值，该值大于该议题的项目或顶级群组的最大值。这意味着议题位于其出现的任何议题列表的底部。

当您访问一个看板时，议题会在任何列表中按顺序出现。您可以通过拖动议题来更改该顺序。更改后的顺序会被保存，以便任何以后访问同一看板的人都能看到重新排序，除了一些例外情况。

每次您拖动并重新排序议题时，其相对顺序值都会相应更改。然后，任何时候该议题出现在任何看板中，排序都会根据更新的相对顺序值进行。如果您在极狐GitLab 实例中将议题 A 拖动到议题 B 上方，则在该实例中的任何看板中随后加载这两个议题时，排序都会保持不变。这可能是不同的项目看板或不同的群组看板。

此排序还会影响议题列表。在议题看板中更改顺序会更改议题列表中的排序，反之亦然。

专注模式#

在专注模式下，导航 UI 被隐藏，使您可以专注于看板中的议题。要启用或禁用专注模式，请在右上角选择切换专注模式 (

)。

群组议题看板#

在群组导航级别可以访问，群组议题看板提供与项目级看板相同的功能。它可以显示来自群组及其后代子群组下的所有项目的议题。

极狐GitLab 基础版的用户可以使用单个群组议题看板。

极狐GitLab 企业版的议题看板功能#

极狐GitLab 议题看板在极狐GitLab 基础版中可用，但某些高级功能仅在更高版本中存在。

可配置的议题看板#

议题看板可以与里程碑、标签、受让人、权重和当前迭代相关联，从而自动过滤看板议题。这使您能够根据团队的需要创建独特的看板。

您可以在创建看板时定义看板的范围，也可以通过选择配置看板 (

)按钮进行定义。在议题看板上分配了里程碑、迭代、受让人或权重后，您将无法在搜索栏中通过这些进行过滤。要进行过滤，您需要从议题看板中移除所需的范围（例如，里程碑、受让人或权重）。

如果您在某个看板上没有编辑权限，您仍然可以通过选择看板配置 (

)查看配置。

受让人列表#

与显示所有具有选定标签的议题的常规列表一样，您可以添加一个受让人列表，显示分配给某个用户的所有议题。您可以拥有一个既有标签列表又有受让人列表的看板。

先决条件：

• 您必须至少拥有项目的计划员角色。

要添加受让人列表：

1. 选择新建列表。
2. 选择受让人。
3. 在下拉列表中选择一个用户。
4. 选择添加到看板。

现在受让人列表已添加，您可以通过移动议题到受让人列表中或从受让人列表中移除议题来分配或取消分配议题给该用户。要移除受让人列表，只需像标签列表一样选择垃圾桶图标。

里程碑列表#

您可以创建里程碑列表，通过分配的里程碑筛选议题，从而在议题看板上提供更多自由度和可视性。

先决条件：

• 您必须至少拥有项目的计划员角色。

要添加里程碑列表：

1. 选择新建列表。
2. 选择里程碑。
3. 在下拉列表中选择一个里程碑。
4. 选择添加到看板。

像受让人列表一样，您可以通过拖动议题到里程碑列表或从里程碑列表中移除议题来操纵被拖动议题的里程碑。与其他列表类型一样，选择垃圾桶图标以移除列表。

迭代列表#

您可以创建迭代中的议题列表。

先决条件：

• 您必须至少拥有项目的计划员角色。

要添加迭代列表：

1. 选择新建列表。
2. 选择迭代。
3. 在下拉列表中选择一个迭代。
4. 选择添加到看板。

像里程碑列表一样，您可以通过拖动议题到迭代列表或从迭代列表中移除议题来操纵被拖动议题的迭代。

在泳道中分组议题#

通过泳道，您可以按史诗分组可视化议题。您的议题看板保留所有其他功能，但议题的视觉组织不同。此功能在项目和群组级别都可用。

先决条件：

• 您必须至少拥有项目的计划员角色。

要在议题看板中按史诗分组议题：

1. 选择查看选项 (
   )。
2. 选择史诗泳道。

然后，您可以在不离开此视图的情况下编辑议题，并通过拖动来更改其位置和史诗分配：

• 要重新排序议题，请将其拖动到列表中的新位置。
• 要将议题分配给另一个史诗，请将其拖动到史诗的水平泳道中。
• 要从史诗中移除议题，请将其拖动到未分配史诗的议题泳道中。
• 要同时将议题移动到另一个史诗和另一个列表中，请对议题进行对角线拖动。

议题权重之和#

每个列表的顶部显示属于该列表的议题的权重之和。这在将看板用于容量分配时非常有用，尤其是在与受让人列表结合使用时。

工作进行中限制#

您可以为议题看板上的每个议题列表设置工作进行中 (WIP) 限制。设置限制后，当前状态和配置的限制会显示在看板列表标题中。

列表中的一条线将限制内的项目与超出限制的项目分隔开。您不能在默认列表（Open 和 Closed）上设置 WIP 限制。

限制类型#

极狐GitLab 支持两种类型的 WIP 限制：

• 项目：限制列表中的议题数量，无论其权重如何。看板标题显示列表中的议题数量和项目限制。

  例如，如果有 4 个议题和 3 的项目限制，标题显示为 4/3。

  

• 权重：限制列表中议题的总权重。看板标题显示列表中议题的总权重和权重限制。

  例如，如果有权重加起来为 8 的议题和 5 的权重限制，标题显示为 8/5。

  

示例：

• 当您有一个包含四个议题且项目限制为五的列表时，标题显示为 4/5。如果超出限制，当前议题数量将以红色显示。
• 您有一个包含五个议题且项目限制为五的列表。当您将另一个议题移动到该列表时，列表的标题显示为 6/5，其中六显示为红色。工作进行中限制线显示在第六个议题之前。
• 当使用权重限制时，如果您有三个权重分别为 1、2 和 5（总权重为 8）的议题且权重限制为 5，标题显示为 8/5，其中 8 显示为红色。工作进行中限制线出现在权重之和在限制内的议题之后，将其与超出限制的议题分隔开。

设置工作进行中限制#

先决条件：

• 您必须至少拥有项目的计划员角色。

要在议题看板中为列表设置 WIP 限制：

1. 在您要编辑的列表顶部，选择编辑列表设置 (
   )。列表设置侧边栏会在右侧打开。
2. 在工作进行中限制旁边，选择编辑。
3. 从下拉列表中选择限制类型：
   • 项目：按议题数量限制。
   • 权重：按议题总权重限制。
4. 输入项目的最大数量或最大权重。
5. 按 Enter 保存。

要移除 WIP 限制，请选择移除限制。

被阻止的议题#

如果一个议题被另一个议题阻止，则其标题旁边会显示一个图标以指示其被阻止状态。

当您将鼠标悬停在被阻止图标 (

) 上时，会显示一个详细信息弹出窗口。

在议题看板上可以执行的操作#

1. 编辑议题。
2. 创建新列表。
3. 移除现有列表。
4. 从列表中移除议题。
5. 过滤议题以显示您的议题看板上的结果。
6. 移动议题和列表。
7. 拖动并重新排序列表。
8. 更改议题标签（通过在列表之间拖动议题）。
9. 关闭议题（通过将其拖动到关闭列表）。

编辑议题#

您可以在不离开看板视图的情况下编辑议题。要打开右侧边栏，请选择议题卡（而不是其标题）。

先决条件：

• 您必须至少拥有项目的计划员角色。

您可以在右侧边栏中编辑以下议题属性：

• 受让人
• 保密性
• 截止日期
• 史诗
• 健康状态
• 迭代
• 标签
• 里程碑
• 通知设置
• 标题
• 权重
• 时间追踪

如果您的管理员启用了议题抽屉，当您从议题看板中选择议题卡时，议题会在抽屉中打开。在那里，您可以编辑所有字段，包括描述、评论或相关项目。

创建新列表#

您可以在两个现有列表之间或议题看板的右侧创建新列表。

要在两个列表之间创建新列表：

1. 在左侧边栏中，选择搜索或转到并找到您的项目。

2. 选择计划 > 议题看板。

3. 将鼠标悬停或将键盘焦点移动到两个列表之间。

4. 选择新建列表。新列表面板打开。

   

5. 选择基于新列表的标签、用户、里程碑或迭代。

6. 选择添加到看板。

新列表将被插入到看板上新列表面板所在的位置。

要移动和重新排序列表，请将它们拖动。

或者，您可以选择看板右端的新建列表。新列表将插入在列表的右端，在关闭之前。

移除列表#

移除列表不会影响议题和标签，因为只是列表视图被移除。如果需要，您可以随时重新创建它。

先决条件：

• 您必须至少拥有项目的计划员角色。

要从议题看板中移除列表：

1. 在您要移除的列表顶部，选择编辑列表设置 (
   )。列表设置侧边栏会在右侧打开。
2. 选择移除列表。
3. 在确认对话框中，再次选择移除列表。

将议题添加到列表#

先决条件：

• 您必须至少拥有项目的计划员角色。

如果您的看板范围是一个或多个属性，请转到要添加的议题并应用与看板范围相同的属性。

例如，要在群组议题看板中将议题添加到范围为 Doing 标签的列表中：

1. 转到群组或其子群组或项目中的议题。
2. 添加 Doing 标签。

该议题现在应该显示在您的议题看板上的 Doing 列表中。

从列表中移除议题#

当一个议题不再属于某个列表时，您可以将其移除。

先决条件：

• 您必须至少拥有项目的计划员角色。

步骤取决于列表的范围：

1. 要打开右侧边栏，请选择议题卡。
2. 移除使议题保留在列表中的内容。如果是标签列表，请移除标签。如果是受让人列表，请取消分配用户。

过滤议题#

您可以使用议题看板顶部的过滤器仅显示您想要的结果。它类似于在议题跟踪器中使用的过滤。

先决条件：

• 您必须至少拥有项目的计划员角色。

您可以按以下内容过滤：

• 受让人
• 作者
• 史诗
• 迭代
• 标签
• 里程碑
• 我的反应
• 发布
• 类型（议题/事件）
• 权重

在群组看板中过滤议题#

在群组看板中过滤议题时，请记住以下行为：

• 里程碑：您可以按群组及其后代群组的里程碑进行过滤。
• 标签：您只能按群组的标签进行过滤，而不是其后代群组的标签。

当您使用右侧边栏单独编辑议题时，您还可以选择议题所属项目的里程碑和标签。

移动议题和列表#

您可以通过拖动议题和列表来移动它们。

先决条件：

• 您必须至少拥有极狐GitLab 项目的计划员角色。

要移动议题，请选择议题卡并将其拖动到其当前列表中的另一个位置或其他列表中。了解在列表之间拖动议题中的可能效果。

要移动列表，请选择其顶部栏，并水平拖动它。您无法移动Open 和Closed 列表，但您可以在编辑议题看板时隐藏它们。

将议题移到列表开头#

您可以使用菜单快捷方式将议题移到列表顶部。

您的议题被移到列表顶部，即使其他议题被过滤器隐藏。

先决条件：

• 您必须至少拥有项目的计划员角色。

要将议题移到列表开头：

1. 在议题看板中，将鼠标悬停在要移动的议题的卡片上。
2. 选择卡片选项 (
   )，然后选择移到列表开头。

将议题移到列表末尾#

您可以使用菜单快捷方式将议题移到列表底部。

您的议题被移到列表底部，即使其他议题被过滤器隐藏。

先决条件：

• 您必须至少拥有项目的计划员角色。

要将议题移到列表末尾：

1. 在议题看板中，将鼠标悬停在要移动的议题的卡片上。
2. 选择卡片选项 (
   )，然后选择移到列表末尾。

在列表之间拖动议题#

要将议题移到另一个列表，请选择议题卡并将其拖动到该列表上。

当您在列表之间拖动议题时，结果根据源列表和目标列表的不同而不同。

提示#

需要记住的几点：

• 在列表之间移动议题会移除其来源列表的标签并添加目标列表的标签。
• 如果议题有多个标签，它可以存在于多个列表中。
• 如果议题被标记，列表会自动填充议题。
• 在卡片中选择议题标题会将您带到该议题。
• 在卡片中选择标签可以快速过滤整个议题看板，并仅显示所有列表中具有该标签的议题。
• 出于性能和可见性原因，每个列表默认显示前 20 个议题。如果您有超过 20 个议题，请开始向下滚动，接下来的 20 个议题会出现。

议题看板故障排除#

在按作者或受让人过滤时，群组议题看板上显示“获取用户时出现问题”#

如果您在群组议题看板上按作者或受让人过滤时收到“获取用户时出现问题”错误的横幅，请确保您已添加为当前群组的成员。当在议题看板上按作者或受让人进行过滤时，非成员无权列出群组成员。

要解决此错误，您应将所有用户至少以访客角色添加到顶级群组中。

使用 Rails 控制台修复议题看板不加载和超时#

如果您在界面中看到议题看板不加载和超时，请使用 Rails 控制台调用议题重新平衡服务以修复它：

1. 启动 Rails 控制台会话。

2. 运行以下命令：

   ruby
   p = Project.find_by_full_path('<username-or-group>/<project-name>')
   
   Issues::RelativePositionRebalancingService.new(p.root_namespace.all_projects).execute

3. 要退出 Rails 控制台，输入 quit。