Context-Sensitive Help > Fields > Common Field Group Detail (Fields Tab)

Common Field Group Detail (Fields Tab)

Defines new common field groups. See Common Field Groups.

Note: Only common field group fields can be used when defining dynamic field rules. You cannot use work item rule fields.

Fields

Name: The name of the common field group (up to 30 characters).

Marked for Delete: If unchecked, the item is active. If checked, marks the item for deletion.

XTRAC deletes the item during the nightly batch cycle after there are no dependencies. Selecting an item and clicking Delete on the summary window also marks the item for deletion. Before the delete occurs, you can uncheck this option if you change your mind.

Note: The Marked for Delete check box is available only after an item is created.

Description: Additional information about the common field group (up to 60 characters).

Common Field Group Label: The label for the common field group that displays on the XTRAC work item (up to 30 characters). If you add a label name, XTRAC displays a border around the common field group on the work item window.

Field: A list of all of the predefined and custom fields, with the exception of Item Type, Subtype, Status, Memo, and Description.

Visible: Whether the field is visible on the work item:

Checked: The field displays on the work item.
Unchecked: No field displays in user-defined work items. You cannot hide a field on a standard, XTRAC-defined work item.

Note: You cannot hide the Item Type, Subtype, Status, or Memo field.

Create State: The attribute of each field on a work item that has the designated item type when the work item is created.

Required: Must contain a value.
Optional: Does not require a value, but an operator can add a value if they want to.
Protected: An operator can view the field, but cannot modify it. If you protect the Description field, operators cannot change existing text. However, they can append text to it. Operators must have the Description security function in their security group to change the Description field.

Note: Item Type and Status cannot have an Optional field attribute. These fields must have the Protected or Required attribute.

Update State: The attribute of each field on a work item that has the designated item type when the work item is updated:

Required: Must contain a value.
Optional: Does not require a value, but an operator can add a value if they want to.
Protected: An operator can view the field but cannot modify it. If you protect the Description field, operators cannot change the existing text. However, they can append text to it. Operators must have the Description security function in their security group to change the Description field.

Note: Item Type and Status cannot have an Optional field attribute. These fields must have the Protected or Required attribute.

Resolution State: The attribute of each field on a work item that has the designated item type when the work item is resolved:

Required: Must contain a value.
Optional: Does not require a value, but an operator can add a value if they want to.
Protected: An operator can view the field, but cannot modify it. If you protect the Description field, operators cannot change the existing text. However, they can append text to it. Operators must have the Description security function in their security group to change the Description field.

Note: Item Type and Status cannot have an Optional field attribute. These fields must have the Protected or Required attribute.

Value Group: A subset of values that are available to the operator on the work item window for this field.

Note: For the Subtype field, this value group also determines the values that display in the Show Fields On drop-down list box.

Default Value: The value that automatically displays in a field when an operator creates, updates, or resolves a work item.

Allow Override: If checked, the field in the common field group can be overridden by the work item rule. If unchecked, the field cannot be overridden.

Change Request ID: The ID of the request to create or modify this XTRAC record (up to 30 characters).

Memo: The reason why this XTRAC record was created or modified (up to 60 characters).

Buttons

Check Visible: Checks the Visible check box for the selected field so it displays on the work item.

Uncheck Visible: Clears the Visible check box for the selected field so it no longer displays on the work item.

Check Override: Checks the Allow Override check box for the selected field so a work item rule can override the field.

Uncheck Override: Clears the Allow Override check box for the selected field so a work item rule cannot override the field.

Remove: Removes the selected item from the list.

History: Displays the history of the component, including the following details:

Admin group of the operator that created or updated the component.
Date and time of the creation or update.
Event that occurred.
ID of the operator.
IP address and machine name of the machine where the change was made.
Change Request ID and Memo explaining why the component was created or updated.

Layout: Opens the Common Field Group Template window where you can arrange the fields in the common field group.

WARNING: When you create a common field group or a work item rule, you can make the layout window smaller than the fields that are contained in it. XTRAC does not show any warning or error in this circumstance.

Save: Saves the changes that you made in this window.

Close: Closes this window.

If you made changes in the window and have not yet clicked Save, a warning displays that all of your changes will be lost. Click Yes to close the window and discard any changes. Click No to return to the window so you can save any changes.