DevOps知识库
Space shortcuts
Page tree
Skip to end of metadata
Go to start of metadata

您可以通过更改以下内容来修改 JIRA 系统中的每个自定义字段：

  • Name  — 自定义字段向用户显示时出现在其左侧的标签。
  • Description — 自定义字段在“Simple Search”列中显示时出现在其下方的帮助文本。
  • Search template — 使自定义字段可搜索的机制。
  • Default value — 自定义字段首次显示给用户时的默认值。
  • Options（仅适用于选择和多选字段）— 可供用户选择的值。请参见下文。
  • User filtering（仅适用于“User Picker”字段）— 可用户选择的用户组。请参见下文。
  • Context — 对于一个项目和事务类型的组合，可以适用的 Default Value 和 Options。请参见下文。
    (tick)您可以创建多个上下文，以便为项目和/或事务类型的不同组合指定不同的“Default Values”和“Options”。
  • Screens — 创建、编辑或通过工作流转换事务时显示自定义字段的屏幕。请参见下文（另请参见定义屏幕）。
  • Renderers —（仅适用于某些字段类型）— 请参见配置呈现器和指定字段行为。
  • Hide/Show — 请参见指定字段行为。
  • Required/Optional — 请参见指定字段行为。

(warning) 注意：要执行以下所有步骤，您必须以具有 JIRA Administrators 全局权限的用户身份登录。

本页内容：

查看自定义字段

  1. 选择 > Issues。 
  2. 选择 Fields > Custom Fields，以打开“Custom Fields”页面。

编辑自定义字段

通过编辑自定义字段，您可以更改其名称（标签）、描述（帮助文本）和搜索模板。

  1. 导航至 Custom Fields 页面，找到所需的自定义字段，并选择齿轮图标 > Edit：
    • Name 是自定义字段向用户显示时出现在其左侧的标签。

    • Description 是自定义字段显示时出现在其下方的帮助文本。

    • 搜索模板负责为自定义字段编制索引，并使其可通过简单搜索和高级搜索进行搜索（注意，自定义字段无法通过快速搜索进行搜索）。每个自定义字段类型都有预配置搜索模板，但您可以使用此步骤选择其他模板。

  2. 根据需要修改字段，并单击 Update。

配置自定义字段

自定义字段上下文（又称为自定义字段配置方案）与字段配置方案不相关，它用于为自定义字段指定以下内容：

  • 默认值
  • 选项
  • 要应用默认值和选项的事务类型和项目

如果需要将不同的默认值和选项与特定项目或事务类型相关联，则可以创建多个上下文。

每个自定义字段都有名为 Default Configuration Scheme for ... 的上下文，这是在添加自定义字段时自动创建的。

上下文

  1. 导航至 Custom Fields 页面，找到所需的自定义字段，并选择齿轮图标 > Configure。
  2. 找到名为 Default Configuration Scheme for ... 的上下文，并单击 Edit Configuration 链接。
  3. 在 Choose applicable issue types 下，选择要应用默认值和选项的事务类型。如果需要，可以选择任何事务类型。
  4. 在 Choose applicable contexts 下，选择要应用默认值和选项的项目。请注意，这仅适用于属于上述选定事务类型的事务。

添加新上下文

通过添加新上下文，您可以针对事务类型和项目的不同组合对自定义字段进行不同的配置。

  1. 导航至 Custom Fields 页面，找到所需的自定义字段，并选择齿轮图标 > Configure。
  2. 单击 Add newcontext 链接。系统将显示“Add configuration scheme context”页面（请参见下文）。
    • 在“Add configuration scheme context”下，为新上下文输入“Label”和“Description”，这些仅用于管理，不会向最终用户显示。
    • 在“Choose applicable issue types”下，选择要应用默认值和选项的事务类型。如果需要，可以选择 Any issue types。
    • 在 Choose applicable contexts 下，选择要应用默认值和选项的项目。请注意，这仅适用于属于上述选定事务类型的事务。

每个 JIRA 项目的自定义字段只能有一个上下文。因此，您不能在同一个项目中为不同的事务类型使用多个上下文。

默认值

  1. 导航至 Custom Fields 页面，找到所需的自定义字段，并选择齿轮图标 > Configure。
  2. 找到相关上下文（通常只有一个名为“Default Configuration Scheme for ...”的上下文），并单击右侧列中的 Edit Default Value 链接。系统将显示“Set Custom Field Defaults”页面，且页面因自定义字段类型而异：
    • （对于单选列表或多选列表）从下拉列表中选择合适的默认值。
      (info)要清除单选字段的默认值，请单击当前的默认值以使其不再突出显示，然后保存，如此处所述：无法取消选择多选自定义字段的默认值。
    • （对于级联选择列表）从下拉列表中选择合适的默认值（每个级别选择一个）。
    • （对于日期字段）指定一个日期，或勾选复选框以将当前日期设为默认值。
    • （对于其他类型的字段）从下拉列表中选择合适的默认值（每个级别选择一个）。
      (info)某些类型的自定义字段可能无法选择默认值，因而没有 Edit Default Value 链接。

选项

可以对以下类型的自定义字段指定选项值：

  • 单选列表
  • 多选列表
  • 级联选择列表
  • 单选按钮
  • 多选复选框

您可以添加和删除选项、按字母顺序对其重新排序和分类，以及编辑选项值的文本。您还可以在选项值中添加 HTML 内容，只要确保使用完整的标签对并确保 HTML 内容正常显示。

(info)这些选项不区分大小写，因此，在针对通知模型使用单选或多选列表时，JIRA-ADMINISTRATORS 将与 jira-administrators 群组匹配。也就是说，您不能同时拥有 JIRA-ADMINSITRATORS 和 jira-administrators 选项，因为它们名称相同。

  1. 导航至 Custom Fields 页面，找到所需的自定义字段，并选择齿轮图标 > Configure。
  2. 找到相关上下文（通常只有一种，名称为“Default Configuration Scheme for ...”），然后单击右侧列中的 Options 链接。系统将显示“Edit Custom Field Options”页面（见下文）。在此处，您可以：
    • 从 Edit parent select list 下拉列表中选择要编辑的列表。（仅限级联选择列表）
    • 单击 Sort alphabetically 自动按字母顺序对选项重新排序。
    • 单击 Order 列中的相关箭头，或指定一个数字并单击 Move 按钮，对选项进行手动重新排序。
    • 单击 Edit 更改选项的文本。
    • 单击 Disable 隐藏选项，使选项不再可选。已使用的选项无法删除（为了保持数据的完整性），但是由于不断变化的业务需求，这些选项可能会随着时间的推移而失效，此时您可能希望这些选项对于新事务不可用。
    • 单击 Delete 删除选项。（此操作只能用于尚未使用的选项。）

用户过滤

可以限定您的用户选择器字段中可用的用户集。可将用户限定为特定群组和/或项目角色中的用户。

  1. 导航至 Custom Fields 页面，找到所需的自定义字段，并选择齿轮图标 > Configure。
  2. 单击 Edit User Filtering。
  3. 单击 Enable group or project role filtering，然后指定要将用户选择器限定到的群组和/或角色。
    用户选择器将只显示选定群组和角色中的用户。
  4. 单击 Save。

选择屏幕

  1. 导航到 Custom Fields 页面、找到所需自定义字段，然后选择齿轮图标 > Screens。
  2. 选中要用于显示该自定义字段的屏幕所对应的复选框。
    (info)注意：字段可见性取决于字段配置（与前文所述 custom field configuration scheme 不相关）。请参见指定字段行为，了解更多信息。

翻译自定义字段

您可以将创建的任何自定义字段的名称和描述翻译为其他语言。但只能从 JIRA 中已安装的语言包中进行选择。

  1. 导航到 Custom Fields 页面、找到所需自定义字段，然后选择齿轮图标 > Translate。
  2. 选择该自定义字段翻译所属的语言包（如法语），然后在 Field Name 和 Description 中输入翻译后的字符串。

有关自定义字段的提示

  • 限制自定义字段的数量 — 请仔细斟酌您在 JIRA 中定义的自定义字段数量。超过一千属于很大的数量，可能会影响 JIRA 的性能。请参见 设置 JIRA 6.4 的规模，了解更多信息。
  • 使用支持报告功能的字段 — 考虑需要从 JIRA 中获得哪些报告，然后只创建支持这些字段的报告。单选和多选等类型的自定义字段非常适合用于报告，而文本字段就不太有用，因为人们不是每次都能精确地按照报告查询的要求输入数据。
  • 合并字段内容 — 如果只是希望确保用户记得输入一些信息，可以考虑使用多行自定义文本字段，采用一个文本模板作为默认值。您可能还需要尝试使用“表格”自定义字段，从而能够在一个可搜索的表中输入数据。Atlassian 商城 具有一些插件，可以提供此类功能。注意，“Description”等标准 JIRA 字段目前不支持默认值（请参见 JRA-4812）。
  • 不重复使用名称 — 请勿在创建新的自定义字段时使用其他现有自定义字段的名称。每次创建自定义字段之前务必要确认是否已存在同名字段。 如果使用了相同的名称，则用户在 JQL 搜索中选择正确字段时会感到困惑。同样，也不要创建与标准 JIRA 字段同名的自定义字段。例如，拥有两个名称均为“Status”的字段特别令人感到困惑。 
  • 名称应尽可能通用 — 自定义字段应该使用非特定性名称，便于以后在其他地方重复使用。例如，将字段命名为“Objective”而不是“Marketing Objective”，并在字段配置中提供描述，以表明使用该字段的 JIRA 项目。

自定义字段故障排除

使用 JIRA Admin Helper

JIRA Admin Helper 可以帮助您诊断某个自定义字段未显示在屏幕上的原因。此工具仅供 JIRA 管理员使用。

  1. 导航到未显示该字段的“View Issue”、“Edit Issue”或“Create Issue”屏幕。
  2. 如果您要查看事务，请单击 More Actions > Where is my field? 如果您要创建或编辑事务，请单击 Configure Fields > Where is my field?
  3. 输入字段的名称。
  4. 单击 Submit。

提示：您还可以在事务导航器中通过各个事务的齿轮菜单访问“Where is my field?”对话框。 

更改自定义字段的描述

不更改字段配置中的描述意味着您对自定义字段的描述所做的任何更改均不可见。

您可以在 JIRA 中定义自定义字段的描述，如果字段配置描述留空，则原始描述文本将在创建或编辑事务时显示，并在事务导航器中显示为帮助文本。但是，您也可以在各个字段配置中定义不同的描述文本，这将覆盖原始字段描述文本。

例如，如果“My Field”自定义字段所定义的描述是“This is my field”，而字段配置没有任何更改，则显示的文本将是“This is my field”，和预期一样。如果使用了字段配置并将自定义字段的字段描述设置为“This is my excellent field”，则显示的文本将是“This is my excellent field”。 

  • No labels