Override The override functionality allows you to change the 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.
How to define To create a column override, complete the following steps:
- Navigate to to System Definition → Settings → 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 |
TableIn this dictionary field, you can select the uppermost (in terms of inheritance) Select a table containing the field to override. |
| Table | Y |
In this dictionary field, you can select | Select the child table that will be affected by overriding. |
| Column | Y |
In this dictionary field, you can select | Select a column to be overridden. |
| Display by |
Ref Override| 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 IDs.| to use the values of the Column as the Display Name in Reference fields that refer to the Table. |
Default value override |
Default Value Override | N | Select this checkbox to display |
the Default Value field, which overrides the default value for the field on the extended table.After selecting this checkbox, the Default Value field appears. the Default value field. | Field | Mandatory | Description |
|---|
| Default Value | N | Enter the default value that will override the original one |
|
. Reference Qualifier Override
| 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 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 | Field | Mandatory | Description |
|---|
| Reference | Y | Select a table that the overriding column |
|
is referenced Qualifier Type - choose your | qualifier type | N | Select the reference qualifier type |
|
, is it Simple or Dynamic.. Available options: | | Reference qualifier condition | N | Build |
|
Reference Qualifier Condition - build | a reference filter that will |
|
fit | meet the necessary conditions. | | Dynamic |
|
Reference Qualifier - if you have chosen the Dynamic type from the choice menu above, then select the appropriate one from the dictionary.| 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 |
Mandatory Override | N | Select the checkbox to display |
the 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| only override | N | Select this checkbox to display |
the Read Only field, which overrides whether the Read only checkbox that overrides the behavior when a user can change the field value |
on Dependent on Column ID Override
N | Select this checkbox to display the Dependent on Column field, which overrides the field on which the current field depends. | example
For
Override example
As an example, you may need to override some column where the base table and the child table are the same. This can help as a workaround in case if you need to change some protected column options before they are changed correctly.
| Warning |
|---|
When doing this, please keep in mind that inaccurate changes may harm your system, so recheck twice, and verify on some testing instance firstly if possible. |
To perform such override, please fill in the fields as described below when filling in the column overriding form:
- Base Table - select a base table.
- Table - select the same table.
- Column - select a column you need to override.
- Specify an attribute you are going to override. These column attributes can be overridden:
- Mandatory
- Read Only
- Display by Ref
- Reference Qualifier
- Dependent on Column
- Default Value
- Specify new attribute value.
- Click Save or Save and Exit to apply changes.
To be more specific, have a look on the screenshot below. It shows the Mandatory attribute overriding of the IT Service column related to the Agreement table.
Image Removed
Defining an override for choice fields
When creating a choice-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).
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. |
| Code Block |
|---|
| language | js |
|---|
| theme | Eclipse |
|---|
| title | addQuery |
|---|
|
| task.addQuery('state', '>', '2'); // all states after In Progress |