Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Column attributes define the type of data to store in the column, relations, and connections between columns, and system behavior.
Tip |
---|
Set of attributes differs depending on the column type. |
Column attributes description
Attribute | Mandatory | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
Table | Y | Specify the table name that will be a parent for this column. This mandatory field is a reference to the Tables dictionaryin which the column should be created. If this table has child tables, then this column will also be available within them. This field references to the Tables (sys_db_table) dictionary. | ||||||||
Column Type | Y | Specify a column type. The column type specifies the type of the data stored, also, depending on the type selected, additional tabs or fields may appear on the form (see below). For more information, refer to the Column Types article.
| ||||||||
Title | Y | A column title displayed on the form. It is preferred to be sensible and human-readable. This field is mandatory. Latin, Cyrillic, [0..9] numbers and the underscore symbol ( _ ) are allowed. | ||||||||
Column Name | Y | A system column name. It is preferred to be human-readable and keep the kind of stored data. Latin letters, [0..9] numbers and the underscore symbol ( _ ) are allowed.
The maximum length of the column name is 63 symbols.
| ||||||||
Active | N | Select this checkbox to activate or deactivate the column | Active | Select this checkbox, and customizing of this field displayed on the form and list will be possible. If unselected, then such field will be not available for choosing in Form Layout or List layoutLayout. | ||||||
Read Only | N | Select this checkbox to make the field read-only.
| ||||||||
Mandatory | N | Select this checkbox to make the field mandatory. | ||||||||
Full Text Search | N | Set this attribute equal to TRUE Select this checkbox to make it possible to perform a Global Search against the current column.
| ||||||||
Display by Ref | N | When a record references to another record and the table or column containing this record has the attribute Display by Ref Ref equal to TRUE'true', then the column value will be displayed. By default, this attribute is set equal to TRUE for the 'true' for the sys_id column column (this column contains unique IDs). If a table contains a field that has Display by Ref = TRUE, equal to 'true', the value of this field will be displayed when referencing this table in the the Reference field field of the referencing table. | ||||||||
Unique | N | When turned onselected, there is no way to add a record with a value of this field, if a record with the same value already exists. |
Type Specification Tab
In SimpleOne, several column types have an extended attribute set, unlike other types. In addition to the standard fieldset, these column types demonstrate a dynamic change of the sys_db_column object attribute set depending on its type. Some of these attributes can be defined in the Type Specification tab.
Tip | |||||
---|---|---|---|---|---|
| |||||
|
|
|
The Choice, Conditions, Reference, List, Image, Template, and Field Name column types have a specific set of fields. See the description in the sections below:
See the Choice columns article to learn more about this column type.
Field | Mandatory | Description | |||||||
---|---|---|---|---|---|---|---|---|---|
Choice Table | N | Reference to a table. | |||||||
Choice Type | Y | Define whether the option "None" is applicable for the field. Available options:
If the Dropdown without --None-- is chosen, the Default value tab becomes mandatory. | |||||||
Choice Field | Y | Reference to a particular column of the table specified in the Choice Table field. | |||||||
Extra Attributes | N | Enter the text below to apply radio buttons style to the choice field:
|
See the Conditions columns to learn more about this column type.
Field | Mandatory | Description |
---|---|---|
Dependent on Column | Y | A reference to the Tables dictionary. Specify a table that will share the fields with the newly created column. |
Extra Attributes | N |
Extra attributes
You can specify the extended operators |
like this: |
So, these operators become available to use on the column view. |
See the Reference Fields to learn more about this column types.
Field | Mandatory | Description | |
---|---|---|---|
Reference | Y | Specify a dictionary with the values you need. | |
On Delete | N | The field appears at the Type Specification tab. It defines actions to be taken in case the referenced record is deleted. Available options:
|
|
Image column type:
Field | Mandatory | Description |
---|---|---|
Extra Attributes | N | Specify |
maximum image width and height, like this:
|
This field allows extending column properties compared to the regular.
Default Value Tab
Field Name and Template column types:
Field | Mandatory | Description |
---|---|---|
Dependent on Column | Y | A reference to the Tables dictionary. Specify a table that will share the fields with the newly created column. |
Default Value tab
The Default Value tab is available for all column types.
Attribute | Mandatory | Attribute | Description | |
---|---|---|---|---|
Default Value | N | Specify a default value that will be populated automatically to the field when creating a new record. This field may be specified by a Javascript scenario as well.
| ||
Use Dynamic Default | N | Select this checkbox if you want to generate the default value dynamically. | ||
DynamicdefaultDefault | N | This field appears only when the Use dynamic defaultDynamic Default attribute is set to TRUE'true'. Select the script from the Dynamic Default Values (sys_default_value_dynamic) dictionary, so its execution result will be automatically calculated and entered into this field; this . This value will be the default value for the column specified.
|
Client-side logic on columns
In SimpleOne, several column types have an extended attribute set, unlike other types.
Depending on the column type, in addition to the standard fieldset, these column types demonstrate a dynamic change of the sys_db_column object attribute set depending on its type.
These column types and their additional attributes are listed below.
The field appears at the Type Specification tab. It defines actions to be taken in case the referenced record is deleted. Available options:
- No Action – if the referenced record is deleted, no actions will be taken.
- Set NULL – if the referenced record is deleted, the reference to this record will be deleted from the field (the value is to be NULL).
- Cascade – if the referenced record is deleted, the record containing reference to it will be deleted as well.
- Restrict – deleting of the referenced record is forbidden.
- Set Default – if the referenced record is deleted, the reference to it will be changed to the default value defined at the Default Value tab.
Note |
---|
Mind to set the default value at the Default Value tab if the Set Default option is chosen. In case the default value is not set and the referenced record is deleted, the reference to this record will be deleted from the field (the value is to be NULL). |
Choice field type:
- Dropdown with None – a drop-down list with None value. If the field is mandatory, then it will be impossible to save the form with None value.
- Dropdown without None – a drop-down list without None value. Please define a default value for this list type. When this option is selected, the Default value field becomes mandatory.
This field is mandatory for the fields of this type.
Reference Qualifier tab
Info |
---|
The Reference Qualifier tab appears for the following column types:
|
Field | Mandatory | Description |
---|---|---|
Reference Qualifier Type | N | Select the type of reference qualifier. Available options:
|
Reference Qualifier Condition | N | Configure the filters using the Condition Builder. This field appears when the Reference Qualifier Type value is Simple. |
Dynamic Reference Qualifier | N | Select the dynamic reference qualifier from the list. This field appears when the Reference Qualifier Type value is Dynamic. |
Reference Qualifier Fixed | N | Select this checkbox to fix the breadcrumbs in the dictionary when using this field. This functionality will block using the Condition Builder functionality in this field. |
Table of Contents | ||||
---|---|---|---|---|
|