问题字段允许向你的各个存储库中的问题添加结构化元数据。 为了避免依赖标签或自由文本这种临时解决方法,可以创建诸如优先级、工作量、影响或满足团队具体需求的任何自定义类别等字段。 字段在组织或用户级别定义,并应用于所有仓库。
关于问题字段类型
最多可以创建 25 个问题字段。 以下字段类型可用:
- 单选:从预定义列表中选择一个选项。 选项可以具有名称、说明和颜色。
- 文本:捕获自由格式的文本。 URL 会自动检测并显示为可单击的链接。
- 数字:接受数字输入,包括小数。
- 日期:提供用于选择日期的日期选取器。
默认字段
启用问题字段后,会自动创建四个默认字段:
- 优先级 (单选):紧急、高、中、低
- 工作量 (单选):高、中、低
- 开始日期 (日期)
- 目标日期 (日期)
这些默认字段固定到问题类型,如下所示:
| 领域 | 无类型 | Bug | Task | Feature |
|---|---|---|---|---|
| Priority | ||||
| 努力 | ||||
| 开始日期 | ||||
| 目标日期 |
这些默认字段是完全可自定义的。 可以编辑其名称、说明和选项,或者如果它们不适合工作流,请将其删除。
提示
可以重命名选项、更改其颜色、重新排序或添加新值以匹配团队的工作流。 例如,可以将“努力”选项更改为 T 恤大小(XS、S、M、L、XL)。
创建问题字段
- 在组织名称或用户配置文件下,单击“ 设置”。
- 在边栏的“规划”部分中,单击问题字段。
- 单击“新建字段”。
- 在“字段名称”下,键入新字段的名称。
- (可选)在“说明”下,键入说明以帮助其他人了解字段的目的。
- 在“字段类型”下,选择要创建的字段的类型。
- 如果选择 了“单选”,请为字段添加选项:
- 单击“ 添加”选项 并键入选项名称。
- (可选)若要设置选项的颜色,请单击 选项旁边的选项,单击“ 编辑”选项,选择颜色,然后单击“ 保存”。
- 重复添加更多选项。
- 在“字段可见性”下,选择以下选项之一:
- 权限:选择谁可以查看字段及其值。 选项为 “受限”(默认)或 “公开”。 此设置仅适用于公共存储库中的问题。
- 固定到类型:单击 以选择问题查看器和创建者中显示此字段的问题类型。 选择一个或多个问题类型,或“没有类型的问题”。 未固定且无值的字段将继续隐藏在问题视图和创建工具中。
- 单击 “创建” 。
编辑问题字段
- 在组织名称或用户配置文件下,单击“ 设置”。
- 在边栏的“规划”部分中,单击问题字段。
- 在要编辑的字段右侧,单击 。
- 单击 “编辑” 并进行更改。
- 单击“ 保存”字段。
删除问题字段
删除问题字段时,将永久删除针对该字段的问题设置的所有值。
- 在组织名称或用户配置文件下,单击“ 设置”。
- 在边栏的“规划”部分中,单击问题字段。
- 在要删除的字段右侧,单击 。
- 单击“ 删除 ”并确认删除。
提示
如果不想使用议题字段,可以从设置中删除所有默认字段。 这会从所有问题中删除它们。 可以随时重新创建字段。
重新排序问题字段
固定字段的顺序按问题类型进行管理。 字段顺序确定字段在问题边栏和问题创建模式中的显示方式。
- 在组织名称或用户配置文件下,单击“ 设置”。
- 在边栏的“规划”部分中,单击“ 问题类型”。
- 单击要重新排序字段的问题类型。
- 在“已固定的问题字段”下,拖动字段以对其进行重新排序。
- 单击“ 保存”。
将字段固定到问题类型
可以将问题字段与特定问题类型相关联,以便在创建或查看该类型的问题时仅显示最相关的字段。 例如,可以将“严重性”关联到 bug,将“影响”关联到特性。
- 在组织名称或用户配置文件下,单击“ 设置”。
- 在边栏的“规划”部分中,单击问题字段。
- 单击要固定的字段。
- 在“固定到类型”下,单击 并选择此字段应显示的问题类型。
- 单击“ 保存”字段。
固定字段自动根据所选问题类型显示在问题边栏中。 若要将字段固定到没有类型的问题,请选择“没有类型的问题”选项。
注意
字段必须被设置为至少一个事项类型,或“无类型事项”,才能显示在事项边栏中。 未固定到任何类型的 字段只能通过“添加字段 ”按钮或在项目中访问。
如果某个字段未出现在问题上,请检查它是否已固定到相关问题类型或“没有类型的问题”。 未固定且未设置值的字段将在问题侧边栏中隐藏。
设置字段可见性
对于具有公共存储库的组织或用户配置文件,可以控制每个问题字段对每个人可见,还是仅对成员、存储库所有者和协作者可见。
- 在组织名称或用户配置文件下,单击“ 设置”。
- 在边栏的“规划”部分中,单击问题字段。
- 在字段右侧,单击 。
- 单击 “编辑” 。
- 在“字段可见性”下,选择以下选项之一:
- 受限:只有组织成员和存储库协作者在组织拥有的存储库中至少具有读取访问权限,或者只有个人拥有的存储库中具有至少读取访问权限的存储库所有者和协作者才能看到该字段。
- 公共:此字段对查看此问题的任何人可见。
- 单击“ 保存”。
默认情况下,所有新的和现有字段都设置为“受限”。 可见性设置在 Web UI、API、问题时间线事件和搜索建议中强制实施。
问题字段和项目
你的组织或用户配置文件(包括公共项目和内部项目)中的任何项目中都提供了问题字段。 有关在项目中添加、删除和编辑问题字段的详细信息,请参阅 关于项目中的问题字段。
公共项目和内部项目中的可见性
仅公共可见性的字段在公共项目和内部项目中可用。 不显示设置为“受限”的字段。 向公共项目添加字段时,仅显示加载项对话框中的公共可见性字段。
如果字段的可见性从“公共”更改为“受限”,则在公共项目中使用时,将自动从项目中删除该字段。 若要还原它,请将字段的可见性更改回“公共”。
从项目字段迁移到问题字段
如果已对元数据(例如优先级或工作量)使用项目级自定义字段,则可以采用问题字段在问题级别集中这些值。
- 问题字段是事实来源。 该值存储在议题中,并且在该议题所属的所有项目中保持一致。
- 项目字段仅限于单个项目。 同一问题可以在不同的项目中具有不同的项目字段值。
- 两者都可以共存。 无需立即删除项目字段,但如果两者跟踪相同的概念(例如两个“优先级”字段),这两者都可能会导致混淆。
- 若要迁移,请创建等效的问题字段,然后在团队准备就绪时从项目视图中删除项目级字段。
项目中的字段限制
项目总共支持最多 50 个字段,问题字段和系统字段计入此限制。 如果项目已处于字段限制,则需要在添加问题字段之前删除现有字段。
Limits
| Resource | Limit |
|---|---|
| 问题字段 | 25 |
| 每个单选字段的选项 | 100 |
| 每个问题类型的固定字段数 | 10 |
| 项目中的字段总数(包括问题字段和系统字段) | 50 |