In SimpleOne, all data is stored in tables. Tables consist of columns. A table row is called a record and have a unique identifier.

Role required: admin.

To create a new table, complete the following steps:

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

Table form fields

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 ( _ ).

The Title field can be translated to other languages.

Name 

Y

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

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 automatically added to the system table name. You can specify a default prefix to add to the application settings. See the Applications article to learn more.


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 the Is extendable checkbox is selected.

Is extendable

NSelect the checkbox to make the table extendable. It can 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.

Controls Tab

Record number

N

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

Is VCS enabled

N

Select the checkbox to enable the table versioning. Changes in the affected table are stored as records in the VCS records (sys_vcs_record) table.

This field is read-only after the record is created.


Is audit

N

Select the checkbox to log the changes in the affected table to the History (sys_history) table. See the Record Audit article to learn more.

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.

Indicate presence

N

Select this checkbox to enable the presence indication. When this checkbox is selected, the record forms of the table have an indication when other users interact with the same record.

The presence indication is enabled by default for the Task table and its child tables.

Menu Item tab

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

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 menu category.

See the Menu Categories and Items article to learn more.

Menu category titleY

Specify a category title to display.

This field appears when the Add menu category checkbox is selected.

OrderY

Determine the category order in the navigator. Categories are arranged in ascending order.

This field appears when the Add menu category checkbox is selected.

Menu itemN

Specify the name of the new menu item.

This field appears when the Add menu category checkbox is selected.

User interface actions

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

  • Configure form 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.
  • Configure inline editing – opens a window where you can restrict editing of table fields in the list view. 
  • 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.