自定义项目实体

每个项目划分为项目实体，例如需求、缺陷、测试和分析图。实体包含用户输入的有关特定应用程序管理流程的数据。此部分描述如何自定义项目实体以满足您的独特需求。

在本主题中︰

概述

每个实体均包含系统字段和用户定义的字段。

系统字段	这些是默认字段。不能添加或删除系统字段。只能修改它们。 您可以通过限制用户只能从关联的列表选择值、强制填写某些字段和保留在字段中输入值的历史记录，来修改这些字段的行为。
用户定义的字段	这些是您可以定义并包括在项目中以针对特定项目需求进行自定义的字段。可以添加、修改和删除用户定义字段。 例如，如果要在应用程序的几个内部版本上运行测试，可以将检测于内部版本字段添加到“添加缺陷”对话框。然后可以创建包含值 Build1、Build2 和 Build3 的选择列表，并将该列表与“检测于内部版本”字段关联。

返回页首

添加用户定义的字段

您可以通过将最多 99 个用户定义的字段添加到每个实体来自定义项目。

交叉项目自定义: 对每个实体，每个模板项目和链接的项目可包含最多 99 个用户定义的字段。

要添加用户定义的字段，请执行以下操作:

1. 在“项目自定义”窗口的左窗格中，单击项目实体。

2. 在项目实体下展开实体。

   Note: 如果在需求实体中添加用户定义的字段，则必须将该实体分配到特定需求类型。有关详细信息，请参见自定义需求类型。

3. 单击“用户字段”文件夹。

4. 要添加用户定义的字段，您可以：

   • 要添加数字、字符串、日期或列表类型字段，请单击“新建字段”。

   • 要添加备注字段，请单击“新建字段”旁的箭头并选择“新建备注字段”。每个实体最多可添加 5 个备注字段。

     Note: 可以通过编辑 EXTENDED_MEMO_FIELDS 参数，扩充可添加的备注字段数量。有关详细信息，请参阅设置配置参数。

5. 在“设置”选项卡中设置新字段的属性。

   

   属性	描述
   名称	表示在数据库表中使用的字段名称。只读。
   标签	表示显示在用户界面中的字段名称。可以输入新名称或使用默认名称。 此标签不能为空或不可包含以下字符: ( ) @ \ / : * ? " ` < > | + = ; , %
   类型	指定用户可在字段中输入的数据类型。包括以下类型： 数字。仅允许整数条目。 字符串。允许任何字符串条目。 日期。允许选择日期。 查找列表。显示“查找列表”区域并允许从下拉列表选择。 用户列表。允许从用户列表中选择用户名。 备注。允许数据块条目。
   长度	表示字段大小。（仅当选中字符串类型时才可用。） 最大字段长度是 2000 个字符。
   清理类型	指定字段的清理类型。（仅当选中字符串类型时才可用。） 包括以下类型： 无。原样返回数据库中存储的值。 HTML。根据允许的 HTML 内容预定义列表对值进行清理。 文本。此值为 HTML 编码的值。
   历史记录	保留在所选字段中输入的值日志。
   必填	表示用户必须为此字段输入值。 如果在已包含数据的项目中将某个字段设置为必填，则在此字段已经为空的情况下，用户在修改现有记录时无需为此字段输入值。
   已屏蔽	表示字段的输入数据掩码。（仅当选中字符串类型时才可用。）有关详细信息，请参见定义输入掩码。
   版本控制	版本控制： 指示是否保存版本控制中的每个版本实体/字段的字段值。 对于大多数字段，此复选框默认选中。可以关闭用户自定义字段和某些系统字段的版本控制。 在某些情况下，会禁用此选项卡，例如当字段的父实体未进行版本控制时。 关闭相关字段的版本控制会使工作流脚本和 OTA 脚本无需签入实体便可运行。 有关版本控制的详细信息，请参阅版本控制。
   可搜索	指示此字段是否可搜索。(仅当为数据库启用“文本搜索”选项时可用。) 有关文本搜索的详细信息，请参阅配置文本搜索。
   查找列表	包括预定义列表的列表。（仅当选中查找列表类型时才可用。） 要将字段与预定义列表相关联，请从查找列表框中选择列表。要查看或修改所选列表，请单击“转到列表”按钮。
   新建列表	新建列表。（仅当选中查找列表类型时才可用。） 要将字段与新列表相关联，请单击新建列表按钮。 有关自定义列表的详细信息，请参见自定义字段列表。
   转到列表	显示预定义的列表。（仅当选中查找列表类型时才可用。） 要打开预定义的列表，请从查找列表框中选择列表。单击转到列表按钮。 有关自定义列表的详细信息，请参阅 自定义字段列表。
   验证值	将用户限制为仅从列表框列出的项中选择值。（仅当选中查找列表或用户列表时才可用。）
   允许多个值	对于用户定义的字段，此选项允许用户在与预定义的查找列表关联的任何字段中选择多个值。 例如，如果在“缺陷”实体中创建语言用户字段并启用允许多个值选项，则用户可以在输入此字段的值的同时选择英语、法语和德语语言值。 注: 此选项仅在选择“查找列表”类型且 ALLOW_MULTIPLE_VALUES 参数不存在或设置为 Y 时可用。 此选项在“测试步骤”实体中不可用。 如果根据包含多个值的字段对数据网格或摘要图分组，则每组值都用作分组的类别。例如，具有“英语”和“法语”的值将一次性分组为“英语;法语”，而不作为单独的“英语”和“法语”类别的一部分。 有关自定义列表的详细信息，请参见自定义字段列表。

6. 单击保存将保存对“项目实体”页面的更改。

返回页首

修改系统和用户定义的字段

可以在项目中修改系统和用户定义的字段的属性。

修改之前

在修改实体字段之前，请考虑以下事项。

不能修改某些字段	例如，不能修改系统字段的“类型”或“长度”属性。此外，对类型为“查找列表”的系统字段，不能修改该字段与哪个列表关联，也不能允许多个可选值。
交叉项目自定义	如果要使用链接到模板项目的项目，则不能修改由模板项目定义的系统字段或用户定义的字段，也不能删除由模板项目定义的用户定义字段。模板项目定义的字段以模板图标显示。

要修改系统字段或用户定义的字段，请执行以下操作:

1. 在“项目自定义”窗口的左窗格中，单击项目实体。

2. 在“项目实体”下展开实体。

3. 展开“系统字段”文件夹或“用户字段”文件夹。

4. 单击要自定义的字段。该字段的设置出现在“设置”选项卡中。

5. 修改所选字段的属性。有关详细信息，请参阅设置选项卡。

6. 单击保存将保存对“项目实体”页面的更改。

要删除用户定义的字段：

1. 在“项目自定义”窗口的左窗格中，单击项目实体。

2. 在“项目实体”下展开实体。

3. 展开“用户字段”文件夹。

4. 单击要删除的字段，然后单击“删除字段”。

5. 单击确定以确认。

6. 单击“保存”将保存对“项目实体”页面的更改。

返回页首

定义输入掩码

输入掩码选项用于提示用户使用掩码模式输入数据。如果用户尝试输入与输入掩码冲突的字符，则发生错误。可以只为字符串类型字段定义输入掩码。

例如，要提示用户输入电话号码，可定义以下输入掩码：

!\(000\)000-0000

此输入掩码限制用户只能输入数字字符。它在编辑框中显示如下：

(___) ___ - ____

要为实体字段定义输入掩码，请执行以下操作:

1. 在实体字段的“设置”选项卡中，选择“已屏蔽”。

2. 在“已屏蔽的编辑属性”下面，单击“定义”。

   

3. 在输入掩码框中，输入输入掩码或选择预定义掩码。

   定义输入掩码时可以使用以下字符：

   掩码字符	描述
   !	用作前导或尾部空白的空格。
   #	数字。
   。	十进制数。
   :	时间分隔符。
   /	日期分隔符。
   \	将掩码字符串中的下一个字符作为文字处理。例如，可以在掩码中包括 (、)、#、&、A 和 ? 字符。
   >	将后面所有字符转换为大写。
   <	将后面所有字符转换为小写。
   A	字母数字字符（必需输入）。例如: a 到 z、A 到 Z 或 0 到 9。
   a	字母数字字符（可选输入）。例如: a 到 z、A 到 Z 或 0 到 9。
   C	字符（必需输入）。有效值是以下范围中的 ANSI 字符：32 到 126 和 128 到 255。
   c	字符（可选输入）。有效值是以下范围中的 ANSI 字符：32 到 126 和 128 到 255。
   L	字母字符或空格（必需输入）。例如: a 到 z 或 A 到 Z。
   l	字母字符或空格（可选输入）。例如: a 到 z 或 A 到 Z。
   0	数字（必需输入）。例如：0 到 9。
   9	数字（可选输入）。例如：0 到 9。
   _	插入空格。用户在字段框中输入字符时，光标会跳过 _ 字符。

4. 在“测试输入”框中，测试输入掩码。

5. 单击确定关闭“输入掩码编辑器”对话框。

6. 单击保存将保存对“项目实体”页面的更改。

返回页首

另请参阅：

• 自定义需求类型
• 保存项目自定义变更