Customizing Project Entities

Using the Project Entities page, you can customize your ALM project to suit your environment.

Each ALM project is divided into project entities. Entities contain data entered by users for a specific application management process. The data is stored in tables.

The Settings Tab

The Settings tab displays the field properties. The following properties are available:

Properties	Description
Name	Indicates the field name used in the ALM database table. Read-only.
Label	Indicates the field name as it is displayed in ALM. You can type a new name or use the default name. The label cannot be blank and cannot include the following characters: *( ) @ \ / : ? " ` < > \| + = ; , %**
Type	Specifies the type of data that the user can enter in the field. It includes the following types: Number. Enables integer entry only. String. Enables the entry of any character string. Date. Enables the selection of a date. Lookup List. Displays the Lookup List area and enables the selection from a drop-down list. User List. Enables the selection of a user name from your ALM users list. Memo. Enables the entry of blocks of data. Note that by default, you can add up to five memo fields to each ALM entity. In Site Administration's Site Configuration tab, you can edit the EXTENDED_MEMO_FIELDS parameter, which extends the number of memo fields you can add. For details, see Setting ALM Configuration Parameters.
Length	Indicates the field size. (Available only when the String type is selected.) Note: The maximum field length is 255 characters.
Sanitization type	Specifies the sanitization type of the field. (Available only when the String type is selected.) It includes the following types: None. Returns the value as it is stored in the database. HTML. The value is sanitized according to a predefined white list for allowed HTML content. Text. The value is HTML encoded.
History	Preserves a log of values entered in the selected field.
Required	Indicates that a user must enter a value for the field. Note: If you set a field as required in a project that already contains data, users do not need to enter a value for the field when they modify an existing record if the field is already empty.
Masked	Indicates the input data mask for the field. (Available only when the String type is selected.) For details, see Defining Input Masks.
Versioned	Version Control: Indicates whether to save field values for each version of entities/fields under version control. This check box is selected, by default, for most fields. You can turn off versioning for user-defined fields and some system fields. Note: In some cases, the check box is disabled—for example, if the field's parent entity is not version-controlled. Tip: Turning off versioning for relevant fields enables workflow scripts and OTA scripts to run without requiring entities to be checked in.
Searchable	Indicates a searchable field. (Available only when the Text Search option is enabled in the DB Servers tab in Site Administration. For details, see Defining Searchable Fields.)
Lookup List	Includes a list of predefined lists. (Available only when the Lookup List type is selected.) To associate a field with a predefined list, select a list from the Lookup List box. To view or modify the selected list, click the Goto List button.
New List	Creates a new list. (Available only when the Lookup List type is selected.) To associate a field with a new list, click the New List button. The Project Lists dialog box opens. For details on customizing a list, see Customizing Project Lists.
Goto List	Displays a predefined list. (Available only when the Lookup List type is selected.) To open a predefined list, select a list from the Lookup List box. Click the Goto List button. The Project Lists dialog box opens. For details on customizing a list, see Customizing Project Lists.
Verify Value	Limits the user to select a value only from the items that are listed in the list box. (Available when Lookup List or User List is selected.)
Allow Multiple Values	For user-defined fields, this option allows the user to select more than one value in any field that is associated with a predefined lookup list. (Available only when the Lookup List type is selected.) For details, see the ALLOW_MULTIPLE_VALUES site parameter. For example, if you create a Language user field in the Defect entity and enable the Allow Multiple Values option, a user can select `English`, `French`, and `German` language values at the same time when entering this field's value. Note: This option is not available in the TEST STEP entity. If you group a data grid or summary graph by a field containing multiple values, the information in each value is grouped as its entire value. This value is the category for grouping. For example, a value with `English` and `French` is grouped once as `English;French`, and not as part of separate `English` and `French` categories. For details on customizing a list, see Customizing Project Lists.