Override The override functionality allows you to change the overriding column value and attributes in the child tables extended from the base table. For example, a column override changes the default value of the Impact field from Low in the Task table to Medium in the Incident table.
Please keep in mind that column override is available only for tables having the is_extendable property equal to TRUE.
| Note |
|---|
How to define a column override
To create a column override, complete the following steps:
- Navigate to System Settings → Navigate to System Definition → Column Overrides.
- Click New and fill in the fields.
- Click Save or Save and Exitexit to apply the changes.
Column Override form fields
| Field | Mandatory | Description |
|---|
| Base Tabletable | Y | Select a In this dictionary field, you can select the uppermost (in terms of inheritance) table containing the field to override. |
| Table | Y | Select In this dictionary field, you can select the child table that will be affected by overriding. |
| Column | Y | Select In this dictionary field, you can select a column to be overridden. |
| Display by ref override | N | Select this checkbox if you need to override the Display by ref setting which is responsible for what column will be displayed instead of reference idsto use the values of the Column as the Display Name in Reference fields that refer to the Table. |
Default value override | N | Select this checkbox to display the Default value field. | Field | Mandatory | Description |
|---|
| Default Value | N |
Enter the default value that will override the original one |
| Note |
|---|
Note that using the override functionality for read-only fields that have the dynamic default value may cause validation errors. As a workaround, you can set a read-only attribute for these fields with a client script using the SimpleForm methods. |
|
| Dependent on column override | N | Select this checkbox to display the Dependent on column field. | Field | Mandatory | Description |
|---|
| Dependent on column | N | Define the column on which the current field depends. |
|
| Reference qualifier override | N | Select the checkbox to display the the Reference Qualifiers fieldset field set, which overrides the reference qualifier for the reference qualifier for the field on the extended table. Reference - in this field, select a table to which | Mandatory | Description |
|---|
| Reference | Y | Select a table that the overriding column |
| refers to. | | Reference qualifier type |
| N | Select the reference qualifier type |
. Available options: | | Reference qualifier condition |
| N | Build a reference filter that will |
| meet the necessary conditions. | | Dynamic reference qualifier |
| N | Select the reference qualifier type from the table. This field appears when the Reference qualifier type field value is Dynamic. |
|
| Title override | N | Select the checkbox to display the Title field, which overrides the field title in the extended table. That is, a child table will inherit the properties of the parent table's column, but the title will be different. | Field | Mandatory | Description |
|---|
| Title | N | Enter a new title of the column. |
|
| Mandatory override | N | Select the checkbox to display the the Mandatory field, which overrides whether checkbox that overrides the behavior when the field on the extended table must contain a value to save a record. |
| Read - only override | N | Select this checkbox to display the the Read -only field, which overrides whether only checkbox that overrides the behavior when a user can change the field value on in the extended table. |
| Dependent on column ID override | Select this checkbox to display the Dependent on column field, which overrides the field on which the current field depends. |
Defining an override for choice fields
When creating achoice-like field (for example, Choice), it is recommended to set text values in the Value field to increase code readability. For example, it can be Incoming, or Active, or Failed values.
Regarding task states, it makes sense to make values numerical; this can help with selection construction (see the code sample below).
| Code Block |
|---|
| language | js |
|---|
| theme | Eclipse |
|---|
| title | addQuery |
|---|
|
task.addQuery('state', '>', '2'); // all states after In ProgressOverride example
For example, you need to override the Email field in the User (user) table. The field should be non-mandatory and have a new title Work mail in the Employee (employee) table. At the same time, the Email field on the User form must remain mandatory with the same title.
To create the appropriate override, complete the following steps:
- Create an override entry via the navigator menu or the Related List of the Email column record.
- In the Table field, select the level at which the override will be performed. All tables containing the column are available for the selection.
- Select the Mandatory override checkbox and specify a new mandatory value. In this case, leave the Mandatory checkbox clear.
- Select the Title override checkbox and enter a new title value in the Title field.
- Save the record.
| Warning |
|---|
When doing so, keep in mind that incorrect changes may harm your system, so double-check the changes and verify them on a test instance if possible. |