Fields - Custom Fields
You can configure an arbitrary number of custom fields for a tracker. To add a new custom choice, reference, or data field, use the commands from the dropdown list at the bottom of the page.
If you use many custom-defined fields, tables or lists of items or issues can become very wide. Using tracker customization, you can exclude fields from table or list views.
Select the List checkbox to configure fields that must be displayed (as table or list columns), and fields that must only appear on the details or editor screen.
Figure: Tracker Actions Customize Fields Tab
In the Title column, you can specify the column title to be displayed in the Label column. The column resizes to the width of the column's title.
 | For a field to appear as table or list column, select the checkbox in the List column. You must have at least Read permission for this field for the default status, specified under Field Access. |
| | In per status configuration for custom fields, default permissions affect the visibility in the report composer and in new item creation. |
Use the Fields tab to define certain properties of a field such as field layout, sequence, type, label, title, minimums and maximums, whether it is listed, and hierarchical field dependencies (aggregation and distribution). Other properties of the field, such as default value, or the choice list, are defined under the Field Access and Choice Lists tabs.
Pos. | The sequence of the field on the Edit, Submit, and List forms. You can edit the sequence as follows: 1. Using a drag-and-drop operation: a. Locate  on the leftmost side of the field that you want to edit.b. Drag to move it to a different position.2. Editing manually: a. Select the Show field position checkbox to show the Pos. column. b. Locate the field that you want to edit and double-click its Pos. value to start editing. c. Modify the value of the sequence by ensuring it is unique and does not match the value of other existing fields. d. Click a non-editable area of the page to store the new value on the field. e. Click Save to permanently save the change. | ||
Property | Non-editable. Property name used by Codebeamer. | ||
Type | Usually non-editable. The type of data that can be recorded in the custom field. Available data types: • Text - Used for recording any kind of textual information. • Integer - Used for recording whole numbers. • Decimal - Used for recording fractional numbers, '.' character is used as a decimal point. • Date - Used for recording dates. • Color - Used for recording colors. • Duration - Used for recording time periods. • Bool - Used for recording logical truth values, possible values: true, false. • Language - Used for recording languages. • Country - Used for recording country names. • Wikitext - Used for recording text with Wiki Markup.
• Wiki Link / URL - Used for recording references to wiki pages. Integer and decimal types can have minimum and maximum values. | ||
Label | Editable. The label of the field, which may be different from the displayed title. | ||
List | The setting to configure whether the field is displayed on the issue list or details. | ||
Title | Editable. Displayed Title of a field. | ||
Distribution Rule | Setting to indicate that the child issue's field value depends on the parent's value. | ||
Aggregation Rule | Setting to indicate that the parent issue's field value depends on the child’s value or values. | ||
Width | The displayed field's width, in which 1 means 1/3 of the page width, 2 means 1/2 the page width and 3 means the full page width. | ||
Newline | The setting for the field to start at the first-left position on a new row. | ||
digits | For decimal fields, the number of fraction digits to be displayed on the table view or item details pages (possible values: 1-10). If empty, the necessary fraction digits are displayed. | ||
Multiple | The checkbox to allow selection of multiple assigned to members. | ||
Reference | Choices to refer to fields from other trackers, such as releases, members, and so on. See Reference Fields, below. | ||
Width | Box shown for custom fields with Text or Wikitext type. It sets the width of the field in number of characters in item edit mode. | ||
Height | Box shown for custom fields with Text or Wikitext type. It sets the height of the field in number of lines or rows in item edit mode. |
Aggregate or Distribute: If you have parent or child hierarchies of configuration items or issues, you can now define dependencies between parent field values and the appropriate child field values (recursively). If, for example, you wish to ensure that a parent issue is not closed until all the child issues (children) are closed, you can manage this dependency using one of the distribution rules defined in this document. Similarly, if you wish to define the Spent Hours parent issue as the sum of the Spent Hours of the children issues, you can define this aggregation rule too. For more information, see Dynamic pick-list fields.
| | Changing the type of a tracker field is restricted. You can change the type of a text field to wiki text and vice-versa, and the type of an integer field to decimal. Other field type changes are not allowed. |