创建和自定义字段

字段有助于说明特定工作项的特征,如“名称”、“说明”、“优先级”或“所有者”。字段对于工作区或项目来说可以是可见或隐藏、必填或可选、对某一工作项唯一或跨多个工作项共享。

您可以编辑 CA Agile Central 提供的某些标准字段值,并创建自己的自定义字段以满足您的开发需求。

要管理、编辑或创建字段,您必须具有订阅或工作区管理员权限

管理字段

“字段”摘要页面提供与工作项相关的所有字段的信息。您可以从工作区或项目的视角来查看“字段”摘要。当从这些不同的位置访问该页面时,向您显示特定项目、项目组或整个工作区中的字段状态时,数据将会有所差异。

管理字段包括:

“字段”摘要页面

使用“字段”摘要页面可以执行以下任务:

  • 查看单个工作项类型的所有字段
  • 按名称、类型、自定义与标准字段、必填字段和可见性排序字段
  • 创建自定义字段
  • 编辑标准和自定义字段

查看字段

按照诸如缺陷、用户情景和任务等工作项类型对字段进行排序。要查看特定工作项类型的字段,请使用“类型”下拉列表,然后选择要显示的类型。系统将自动刷新与选定工作项相关联的字段列表。

“字段”摘要页面为您提供有关各个字段的以下信息:

含义
名称 字段在摘要页面、编辑器和其他位置中显示的名称。字段同时具有系统名称和显示名称。
属性类型 字段的类型。例如,文本、字符串或布尔型。
自定义 如果字段不是 CA Agile Central 的标准字段且已由管理员创建,则将显示一个复选标记。
必填 如果选中,该字段则必须输入值才能创建或保存对工作项的更改。必填字段不能在特定项目中隐藏,且在整个工作区都处于可视状态。请注意,在保存要求之前创建的工作项,可能具有从网格摘要页面和应用程序中进行过内联编辑的其他字段,且编辑时未输入必填字段的值。
可见 如果字段在通过其访问“字段”摘要页面的项目中处于可见状态,则会显示复选标记。
在子项目上可见 如果查看具有打开子项目的项目的“字段”摘要页面,则显示。如果该字段在所有子项目中均处于可见状态,则会显示复选标记;如果某些子项目可以使用该字段而其他子项目却不能,则会显示“混合”。
跨工作项共享 某些如“排定状态”等标准字段将在多个工作项类型之间共享。更改共享字段的设置将会影响使用该字段的所有工作项类型。

不会在此页上显示由 CA Agile Central 系统在内部使用的字段。

对字段所做的更改将记录在修订历史记录中。对特定项目中某字段的可见性所做的更改将记录在项目的修订历史记录中,而全局更改(如创建新字段)将显示在工作区的修订历史记录中。

自定义字段修订

删除字段

您无法删除字段。而是从工作区查看“字段”摘要时编辑该字段,然后在“可见”(所有项目)下拉列表中选择“”。

自定义字段是否可见

或者,如果您对同一类型的其他自定义字段有此需求,则可以编辑该字段并更改名称以调整其用途。

字段类型

CA Agile Central 提供用于各种用途的不同字段类型。请参阅下表以了解各个类型的说明。

类型 说明
布尔型 包含选项“否”或“是”的下拉列表。“否”是默认值。
日期 在工作项编辑器中显示日历图标。选定某日期时,该日期会以文本格式显示在日历旁。
小数 小数点前最多六位数、小数点后最多三位数的数字。
下拉列表 包含一系列字符串或文本信息的选项列表。
下拉列表 (多值) 包含一个或多个预定义字段的列表,用户可从中选择多个项。此列表的有效选项可进行自定义。
下拉列表 (用户) 您的 Agile Central 用户的列表。
整数 包含最多九位数字的数字字段。
字符串 接受字母数字和特殊字符的字段。限制为 256 个字符。
文本 提供包含格式文本格式选项的字段。文本字段最多可以容纳 32 KB 数据。
Web 链接 使用此字段可在外部系统中嵌入 Web 链接或对象的引用。

字符串字段可以接受并显示某些 HTML 标记。有关支持的标记和字段的完整列表,请参阅我们的 HTML 白名单策略

一旦创建字段类型,就无法对其进行更改。

下拉列表 (多值)

订阅和工作区管理员可以为用户创建多值的自定义字段。自定义字段让 CA Agile Central 用户可以定制我们的产品以满足其独特需求。多值自定义字段扩展了单值自定义字段的值,且在支持自定义字段的所有构件类型中均可用。选择“下拉列表 (多值)”作为字段类型之后,在“字段”编辑器弹出窗口中配置这些字段。

管理员配置之后,将在可以包含自定义字段的相同页面中提供多值下拉列表,其中包括:

  • 可编辑详细信息页面

  • 旧的详细信息页面

  • 新样式网格

  • 旧的网格

  • 信息板

  • “迭代状态”页面上的高级搜索组件

下拉列表 (用户)

订阅和工作区管理员可以创建自定义字段,允许从 Agile Central 用户列表中进行选择。工作项、项目、工作区和用户中允许使用用户类型自定义字段。

用户下拉列表

对于该字段将显示您的 Agile Central 用户的列表。

用户类型自定义字段

注意:
  • 时间表中不支持用户类型自定义字段。
  • 用户类型自定义字段在报告中是不可选的。

支持的项

以下工作项和对象支持自定义字段:

  • 缺陷
  • 缺陷集
  • 迭代
  • 里程碑
  • 项目组合项
  • 项目
  • 发布
  • 任务
  • 测试用例
  • 测试用例结果
  • 测试集
  • 用户情景
  • 工作区

创建自定义字段

您可以创建自己的字段以支持您独一无二的开发过程。自定义字段由订阅或工作区管理员添加,且可以对整个工作区、单个项目或项目层次结构中的某部分可见。可以在编辑器页面、自定义视图中使用自定义字段,可以在详细信息页面和摘要页面中查看这些字段。

注意:
  • 添加新的项目组合项类型时,请确保将全局范围确定为添加该类型的同一工作区。否则,将显示验证错误。
  • 可以从项目管理页面或工作区管理页面创建自定义字段。但是,自定义字段在数据库中位于工作区级别上,而可见性可以从工作区级别或项目级别进行控制。
  • 您创建自定义字段的位置可以帮助您控制其可见性。如果您仅想让少数几个项目有权访问某新字段,请在特定项目或您想使用的项目层次结构顶级创建该字段。如果您想仅对少数几个项目隐藏某新字段,请在工作区级别创建该字段,然后在这些项目中将其设为隐藏状态。
  • 字段在工作区中只能存在一次。多个项目可以共享一个字段,但是他们将使用相同的值和设置。要创建独立的字段,它必须具有不同的名称。
  • 在工作区级别设置自定义字段的“必填”值。如果您创建新的自定义字段且为必填字段,那么该字段在所有打开的项目中均为可见和必填状态。
  • CA Agile Central 的标准字段(不是由管理员创建的字段)可以是可见或隐藏,但仅限工作区级别。

要创建新的自定义字段,请执行以下操作:

  1. 导航到工作区或项目的“字段”摘要页面。最佳实践
  2. 单击“类型”下拉列表,然后选择您想添加字段的工作项类型。
  3. 单击“新建字段”。
  4. 在“名称”和“显示名称”字段中输入值。
    您必须在“名称”和“显示名称”中输入唯一的值。
  5. 从“类型”下拉列表中选择字段类型。
  6. 如果您想要求用户必须在创建或编辑工作项时输入值,请选中“必填”选项。只有字段对所有项目可见时,才能设置此项。
  7. 根据您的项目或工作区需求设置字段的可见性
  8. 单击“保存并关闭”。

创建新的自定义字段

编辑字段

  1. 导航到工作区或项目的“字段”摘要页面。
  2. 单击“类型”下拉列表并选择工作项类型。
  3. 单击字段左侧的齿轮图标,然后选择“编辑”。
  4. 更新相应的字段值。
  5. 单击“保存并关闭”确认所做的更改。

编辑自定义字段

注意:
  • 跨多个工作项使用共享字段。编辑这些字段将会影响其他工作项,以及在其通知规则或自定义视图中包括这些字段的其他用户。
  • 某些如“类型”等 CA Agile Central 标准字段不可进行编辑。
  • CA Agile Central 系统所使用的字段可能为必填。在这种情况下,您将无法编辑字段。

编辑器窗口字段

字段 说明
名称 CA Agile Central 应用程序使用此名称。对于 CA Agile Central 字段,已填充此名称。此名称不会显示在“字段”摘要页面中,但会显示在“创建”和“编辑”屏幕中以便管理工作项字段。
显示名称 这是文本字段,让您可以输入名称以便显示给工作区的用户。
类型 字段的类型。在字段创建之后无法更改。
出现次数 计算出的数字,表示工作区中的工作项使用某字段的频率。单击“查看次数”可查看包含这些特定出现次数相关信息的可排序表。
必填 要求在创建或编辑时即填充该字段。注意:将字段标为“必填”对内联编辑、多重编辑和导入数据有影响。某些信息板或网格应用程序上的“添加”按钮会强制显示完整的编辑器窗口,这样可能在创建新工作项时填充必填字段。在强制要求之前创建的工作项可能具有已从网格摘要页面中进行内联编辑的其他字段以及未输入必填值的应用程序。此外,如果在集成就位后将某字段标为必填,那么现有集成可能失败。
可见 从工作区访问时,将显示单个下拉列表,该列表可控制所有项目的字段可见性。如果只将某些项目设为可以查看该字段,那么该字段会设为“混合”。选择“是”或“否”选项将在保存之后的所有打开项目中显示或隐藏该字段。从具有子项目的项目访问时,将显示两个下拉列表。上面的下拉列表控制从中访问编辑器的项目的可见性,而下面的下拉列表控制所有子项目的可见性。

管理项目的可见性

您可以将自定义字段设为在整个工作区、单个项目或项目组中可见。会在以下位置提供对项目可见的字段:

  • 工作项详细信息页面
  • 编辑器窗口
  • 摘要页面
  • 应用程序
  • 自定义视图
  • 通知规则
  • Web 服务 API

注意:
  • 更改页面中或应用程序内部的项目范围将会影响自定义字段的可用性,具体取决于其可见性设置。
  • 查看范围设为项目层次结构的“积压工作”页面时,将显示对某些子项目可见而对其他子项目不可见的字段。
  • 来自 Web 服务 API 的查询将遵循项目可见性。除非另有指定,否则查询将使用您的配置文件中设定的默认项目和范围。
  • 使用具有受支持版本的 WSAPI 的连接器时,将返回要提取的所有字段,而不管可见性设置如何。

使用字段编辑器的“可见”部分可控制哪些项目有权限使用该字段。

编辑器的“可见”部分

您从中访问“字段”摘要页面的位置将帮助您确定字段在特定项目中是否可见:

  • 在工作区中,所有项目均可用的字段会在“可见”列中显示复选标记。对某些项目可用但某些项目不可用的字段会在列中显示“混合”。
  • 在特定项目中,如果此项目可以使用该字段,“可见”列将显示复选标记。
  • 如果查看包含子项目的项目,将显示“在子项目上可见”列。如果所有打开的子项目中均可使用该字段,则将显示复选标记。如果仅可在某些子项目中使用该字段,则将显示“混合”。

有关如何创建字段或如何根据需要调整可见性的最佳实践建议,请参阅以下部分:

将字段设为由整个工作区使用

  1. 从工作区级别访问“字段”摘要页面
  2. 创建或编辑该字段。
  3. 在字段编辑器窗口中,将“可见”下拉列表设为“”。
  4. 所有打开的项目都将有权访问该字段。

将字段设为由单个项目使用

  1. 从您想要使用该字段的项目中访问“字段”摘要页面
  2. 创建或编辑该字段。
  3. 在字段编辑器窗口中,将“在此项目中可见”下拉列表设为“”。
  4. 针对每个您想在其中使用该字段的不相关项目重复此过程。

将字段设为由层次结构中的项目组使用

  1. 从想要使用该字段的项目层次结构的最高层级中访问“字段”摘要页面
  2. 创建或编辑该字段。
  3. 在字段编辑器窗口中,将两个“可见”下拉菜单都设为“”。
  4. 您从中访问“字段”摘要页面的项目以及所有打开的子项目都将有权访问该字段。

使用 Web 链接字段

通过“Web 链接”字段类型,您可以在外部系统中嵌入对象的引用。例如,如果您使用单独的基于 Web 的案例管理工具或缺陷跟踪器,创建 Web 链接字段可以将 CA Agile Central 中的情景或缺陷从 CA Agile Central 内部链接到外部项。

要创建新的 Web 链接字段,请执行以下操作:

  1. 单击“新建字段”按钮。
  2. 在“名称”和“显示名称”字段中输入值。这些值必须是唯一的。
  3. 在“类型”下拉列表中,选择“Web 链接”。
  4. 完成以下字段:
  • URL:提供外部系统的基本 URL。${Id} 用于指明来自外部系统的对象 ID 应插入的位置。例如,要链接到 Salesforce.com 用例,请使用基本 URL:https://na3.salesforce.com\{id}。CA Agile Central 通过将此 URL 与您在详细信息页面中提供的 ID 相组合来生成链接,以创建 Salesforce.com 用例的完整 URL:_https://na3.salesforce.com/a0A30000000xK8D_
  • 显示首选项:单击相应的单选按钮以指定外部 Web 链接字段在 CA Agile Central 中的显示方式:
    • 在新窗口中显示。 该选项将打开一个新的弹出窗口,以显示外部 Web 链接对象。
    • 在现有窗口中显示。此选项直接在 CA Agile Central 窗口中显示外部 Web 链接对象。
  • 单击“保存”。
  • 配置之后,就可以在编辑工作项或查看工作项详细信息页面时使用“Web 链接”字段。

    1. 提供外部对象的“名称”用作“链接标签”。(可选)
    2. 输入要在“ID”字段中添加链接的外部对象的 ID,然后保存您的输入。

    当您查看工作项详细信息时,单击外部对象的超链接名称可直接转到外部页面。

    请考虑使用 CA Agile Central Web 服务 API 界面来填充“链接标签”和“ID”字段。例如,您的案例管理工具可能通过 Web 服务插入缺陷,其中包含可返回原始用例的引用。

    反馈

    需要更多帮助? CA Agile Central 社区为您提供一站式自助和支持。要将反馈或支持请求提交到 CA Agile Central 支持、获取解答并与其他用户协作,请加入我们的 CA Agile Central 社区