In SimpleOne, data is stored in two forms: tables and records. Tables consist of columns.

Role required: admin.

To create a table, perform the following steps:

  1. Navigate to System Definition → All Tables.
  2. Click New and fill in the fields.
  3. Click Save or Save and Exit to apply the changes.

Table attributes


Table attributes allow users to configure tables and connect them to other tables.

Main area

AttributeMandatoryDescription

Title

Y

Specify a table title. The title should be meaningful and human-readable like Incident or Known Error. You can use Latin or Cyrillic letters, [0..9] numbers, and the underscore symbol ( _ ). Unlike the Name field, the values from the Title field can be translated to other languages.

When filling in the Title field, the Name field is populated automatically with a corresponding value and prefix.

Name

Y

This field is populated automatically with a system table name. The table name should be unique and meaningful. You can use symbols are Latin letters, [0..9] numbers, and the underscore symbol ( _ ); the name should start with a letter. System table names are used in scripting.

When filling in the Title field, the Name field is populated automatically with a corresponding value and prefix.

Typically, developers create tables while working on applications and within these applications. In this case, a prefix is added automatically to the system table name. You can specify the default prefix to add to the application settings; this point is highlighted in the Applications article.


The default table naming policy is as follows:

  1. For custom tables created within the Simple application, the "c_" prefix is added.
    • For example: if you create a table and specify the title "Table," then the name c_table is generated automatically.
  2. For custom tables created within another application, an application prefix and a client instance prefix are added.
    • For example: consider that you are creating a table within the ITSM application (generally having the itsm prefix) on your instance. The vendor has provided the instance client prefix for you. The title of the newly created table is "Table." As a result, the itsm_instance_table name will be generated automatically.

In table names, elements are connected with the underscore symbol.


Parent

NSpecify a parent table for this table. All fields of the parent table except for the system fields will be inherited when creating the table. A table can be a parent for another table if its is_extendable attribute is equal to true.

Is Extendable

NSelect the checkbox to make the table extendable (to be a parent for other tables.) For more information, refer to the Table Extension article.

Add Menu Item

NSelect the checkbox to create a new menu category in the Navigation menu, or add the table as a new menu item for an existing menu category. If the checkbox is selected, the Menu Item tab will appear in the Related Lists area.

Controls Tab

AttributeMandatoryDescription

Prefix

N

Define a prefix that will be added at the beginning of every record number in this table.

Is VCS Enabled

N

This attribute is responsible for enabling and disabling the table versioning. When the checkbox is selected, changes in the affected table are stored as records in the VCS records (sys_vcs_record) table.

Please keep in mind that you will be unable to change this attribute value after the table is created.


Is Audit

N

When the checkbox is selected, the changes in the affected table are logged to the History (sys_history) table. For more information, refer to the System History section.

Record Deletion Logging

NSelect the checkbox so that records deleted from this table are logged to the Record Deletion Log (sys_record_deletion_log) and can be restored.

Menu Item tab

The Menu Item tab appears when the Add Menu Item attribute is selected.

AttributeMandatoryDescription

Menu Category

YSpecify a menu category to which the menu item should be related.

Menu Item

NSpecify a name of the new menu item.

Add Menu Category

N

Select the checkbox if you want to create a new menu category. When selected, the following fields appear:

Field

Mandatory

Description

Menu Category TitleYSpecify a category title to display.
OrderYDetermine the category order in the navigator (categories are arranged in ascending order).
Menu ItemNSpecify the name of the new menu item.

See the Navigation article to learn more about menu items and categories.

User interface actions

After a table is created, the following user interface actions appear on the table form:

  • Configure from layout – opens the page where you can set up a form of table records.
  • Configure list layout – opens the page where you can set up columns that will be displayed on the table list.
  • Create record – opens a form to create a table record.
  • Open list – opens the table list.
  • Show schema – opens a dependency map and shows all the tables related to the table which form you opened. You can click any table name on the dependency map to open the table form. The image below is an example of a dependency map.