Версия: 1.21.3

Типы колонок

Без вариантов выбора

Типы полей, которые не предлагают вариантов для выбора.

Big Integer

Это числовой тип поля, используемый для хранения огромных чисел. Размер сохраняемых данных – 8 байт.

В SimpleOne тип отображается в виде поля ввода с числовым значением.

Скалярный тип: int8

Тип значения в скриптах: number

Длина, пример значения или критерии проверки:

В SimpleOne следующий диапазон используется для ID записей: [100000000000000000 … 999999999999999999]
Вы можете использовать следующий диапазон целочисленных значений: [-9223372036854775808 … 9223372036854775807]

Пример содержимого поля:

166674708111757858

Days of Week

Это поле отображается в виде раскрывающегося списка с флажками, указывающими дни недели: Понедельник, Вторник, Среда, Четверг, Пятница, Суббота, Воскресение. Можно выбрать несколько дней.

Технически поле хранит числовое значение или сумму значений. Размер данных одной опции равен 2 байтам. Каждому дню недели присвоено значение:

Понедельник = 1 Вторник = 2 Среда = 4 Четверг = 8 Пятница = 16 Суббота = 32 Воскресенье = 64

Например, если выбраны Вторник (2) и Среда (4), значение поля будет равно 6.

Скалярный тип: int2

Тип значения в скриптах: number

Длина, пример значения или критерии проверки: Минимальное значение – 0 (дни не выбраны). Максимальное значение поля – 127 (все дни выбраны).

Пример содержимого поля:

Decimal

Этот тип поля поддерживает нецелые числа, с двумя цифрами после разделителя (например, 12.34).

Скалярный тип: decimal

Тип значения в скриптах: number

Длина, пример значения или критерии проверки:

Пример содержимого поля:

12.33

Duration

Этот тип поля используется для указания продолжительности между двумя событиями в миллисекундах. Оно хранит целое число.

Скалярный тип: int8

Тип значения в скриптах: number

Длина, пример значения или критерии проверки:

Срока ввода классифицируется по дате и времени (дни, часы, минуты, секунды).
Значение преобразуется в общее количество миллисекунд и сохраняется как произвольное целое число значение (Big Integer).

Пример содержимого поля:

Encrypted Password

Этот тип поля используется для обеспечения безопасного хранения паролей в базе данных с возможностью декодирования (двухстороннего шифрования).

После ввода пароля и сохранения записи, поле становится пустым, пароль недоступен на форме.

Скалярный тип: varchar

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Это поле может содержать все виды символов. Длина значения ограничена 255 символами.

Пример содержимого поля:

0YATXJjpWt5wFPL6FiKxQA==

Float

Этот тип поля предназначен для чисел с плавающим разделителем.

Скалярный тип: float4

Тип значения в скриптах: number

Длина, пример значения или критерии проверки:

Допускаются только цифры, запятая или точка.
Максимальная длина значения – 14 символов.
Максимальный размер дроби – 12 символов (после разделителя, которым может выступать точка или запятая, в зависимости от пользовательских предпочтений).

Пример содержимого поля:

0.333

HTML

Этот тип поля реализован как виджет форматированного текста. Для него существуют различные настройки, которые отображаются в виде HTML-тегов в базе данных.

Когда это поле доступно только для чтения, данные отображаются в формате HTML; в ином случае они отображаются как текст, который можно редактировать.

В этом поле можно использовать два режима: редактор форматированного текста и редактор исходного кода. Вы можете войти в редактор исходного кода, нажав Источник на панели.

Изменения, сделанные в одном из режимов, отображаются в другом, и наоборот.

Скалярный тип: text

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Это поле может содержать все виды символов, оно не имеет длины, пока не будет ограничено атрибутом Максимальная длина.

Пример содержимого поля:
<html><head><title></title></head><body><h3>Email body:</h3><p><code>&quot;Привет, мир!&quot;</code></p></body></html>

Integer

Это числовой тип поля. Размер сохраняемых данных – 4 байта.

Скалярный тип: int4

Тип значения в скриптах: number

Длина, пример значения или критерии проверки: Указанное значение не должно превышать этот диапазон: [-2147483648 ... +2147483647].

Пример содержимого поля:

1211345967

Journal Input

Этот тип поля используется для работы с виджетом комментариев. Из-за своих особенностей оно не может быть доступно только для чтения. Он реализован в виде текстовой области с подсказкой внутри поля или заголовком поля.

Есть два способа ввести комментарии через поле типа Journal Input:

через само поле:
1. Введите текст в поле.
2. Нажмите Сохранить или Сохранить и выйти.
через виджет Лента активности:
- Нажмите на виджет Лента активности.
- Выберите секцию, которая больше подходит по смыслу вашего сообщения (рабочая заметка, дополнительный комментарий).
- Введите текст и отправьте его.

Когда в поле такого типа добавляются комментарии, они сохраняются в виде записей в двух таблицах:

Активности (sys_activities_stream_field) – комментарии из Ленты активности, которые выступают форматерами пользовательского интерфейса.
Объекты ленты активности (sys_activity_feed_item) – комментарий в виджете, который настраивается через Simple-тег <activityFeed>.

примечание

Если выполняются асинхронные после бизнес-правила, вы можете работать со значениями полей типа Journal Input так же, как и в правилах типа после при обращении к current контексту.
Поля типа Journal Input не поддерживаются в отчетах.

Скалярный тип: text

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Это поле может содержать все виды символов, оно не имеет длины, пока не будет ограничено атрибутом Максимальная длина. По умолчанию колонки типа Journal Input содержат пустую строку.

Пример содержимого поля:

""

JSON

Данные в полях этого типа хранятся в формате JSON.

Скалярный тип: jsonb

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Поля типа JSON проверяются так, как поля типа String, содержащие JSON. Чтобы узнать больше, обратитесь к официальной документации JSON.

Пример содержимого поля:
{"name": "White", "color": "#ffffff", "policy": "Open", "sys_id": 158462172516422349, "application_id": 155931135900000002, "sys_created_at": "2020-03-19 12:42:05", "sys_created_by": 155931135900000001, "sys_updated_at": "2020-03-19 12:42:05", "sys_updated_by": 155931135900000001}

Password

Этот тип поля хранит пароли. Он отображается в виде поля для ввода. После ввода пароля и сохранения записи, поле становится пустым, пароль недоступен на форме.

Скалярный тип: varchar

Тип значения в скриптах: string

Пример содержимого поля:
$2y$13$MtP.z1mkGN.SdrzhzBQQ7.XaXgg58IS/qm2/wwQSeT/B58fxNMQGK

Percent Complete

Этот тип поля используется для отображения хода выполнения задачи в процентах.

Скалярный тип: decimal

Тип значения в скриптах: number

Длина, пример значения или критерии проверки:

Может содержать числа [0..100].
Максимальный размер дроби – 2 символа.
Максимальная длина – 4 символа.

Пример содержимого поля:

99.90

Phone

Этот тип поля хранит номера телефонов.

В интерфейсе SimpleOne он отображается в виде поля ввода с номером телефона.

Скалярный тип: varchar

Тип значения в скриптах: string

Длина, пример значения или критерии проверки:

Может содержать: (+), пробелы и цифры.
Максимальная длина – 15 символов.

Пример содержимого поля:

+74951818520

Script

Этот тип поля является текстовой строкой без ограничения длины.

В интерфейсе SimpleOne он отображается как виджет CodeMirror (компонент JavaScript, который обеспечивает возможность редактировать код в браузере).

Скалярный тип: text

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Это поле может содержать все виды символов и не имеет длины, пока не будет ограничено атрибутом Максимальная длина.

Пример содержимого поля:

// console.log()

Small Integer

Это числовой тип поля. Размер сохраняемых данных – 2 байта.

Скалярный тип: int2

Тип значения в скриптах: number

Длина, пример значения или критерии проверки: Указанное значение не должно превышать диапазон: [-32768 ... +32767].

Пример содержимого поля:

String

Этот тип поля реализован в виде строки длиной 255 символов.

В интерфейсе SimpleOne он отображается как поле для ввода текста.

Скалярный тип: varchar

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Это поле может содержать все виды символов. Если длина значения не задана, то она ограничена 255 символами; в ином случае ограничение длины может быть больше или меньше.

Пример содержимого поля:
john.doe12

Text

Этот тип поля реализован в виде текстовой строки без указанной длины. Память выделяется динамически при обработке значения поля.

Скалярный тип: text

Тип значения в скриптах: string

Пример содержимого поля:
Содержимое письма:\n"Привет, мир!"

Translated Text

Этот тип поля позволяет одному и тому же полю отображать различное значение в зависимости от выбранного пользователем языка.

Подробнее читайте в статье Поля типа Translated Text.

Скалярный тип: varchar

Тип значения в скриптах: string

Пример содержимого поля:

Отправить письмо

URL

Этот тип поля предназначен для хранения URL.

Скалярный тип: varchar

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Это поле может содержать все виды символов. Длина значения ограничена 1024 символами.

Пример содержимого поля:
https://example.simpleone.ru/portal

Поля с выбором

Типы полей, которые предполагают выбор и могут быть заполнены путем выбора значения.

True/False

Этот тип поля реализует двоичную логику (true или false, 1 or 0).

В интерфейсе SimpleOne он отображается как флажок. Вы можете изменить его значение по умолчанию на true or false, установив или сняв флажок.

Скалярный тип: boolean

Тип значения в скриптах: boolean

Пример содержимого поля:

true

Choice

Этот тип поля реализует функциональность выбора.

В интерфейсе SimpleOne он отображается в виде выпадающего списка.

Читайте статью Поля выбора, чтобы узнать больше.

Скалярный тип: varchar

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Это поле может содержать все виды символов. По умолчанию максимальная длина составляет 80 символов.

Пример содержимого поля:

Changed

Color

Этот тип поля предназначен для хранения и обмена информацией о системном цвете или цвете элемента интерфейса. Этот тип поля используется, например, при настройке Правил оформления.

Скалярный тип: varchar

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Это поле может содержать 4 или 7 символов (краткая или полная запись RGB), начиная с символа решетки (#). Допустимые символы: цифры, английские буквы (от A до F) и символ решетки.

Пример содержимого поля:

#db3e00

Conditions

Используйте этот тип поля для построения фильтров И/ИЛИ.

В интерфейсе SimpleOne он отображается как виджет настройки фильтра. Данные условий хранятся в формате JSON.

Скалярный тип: text

Тип значения в скриптах: string

Длина, пример значения или критерии проверки:

Это поле может содержать любые символы.
Для этого поля должен быть настроен атрибут Зависит от колонки.
Это поле должно содержать операторы условий, чтобы быть действующим условием.

Пример содержимого поля:
(active=true)

Time

Этот тип поля используется для хранения времени, не учитывая часовой пояс. Дата не сохраняется. Размер данных – 8 байтов.

Подробнее о поле читайте в статье Колонки даты и времени.

Скалярный тип: time

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Время записывается на основе стандарта ISO 8601.

Пример содержимого поля:
11:00:54

Date

Этот тип поля хранит даты в следующем формате: ГГГГ-MM-ДД и не отображает текущее время. Размер сохраняемых данных – 4 байта.

В интерфейсе SimpleOne он отображается как поле ввода с выбором даты.

Подробнее о полях читайте в статье Колонки даты и времени.

Скалярный тип: date

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Дата должна быть на основе стандарта ISO 8601.

Пример содержимого поля:
2022-11-15

Date/Time

Этот тип поля хранит отметку времени, измеренную в секундах.

В интерфейсе SimpleOne он отображается как поле ввода с выбором даты и времени.

Подробнее о полях читайте в статье Колонки даты и времени.

Скалярный тип: timestamp

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Дата и время могут быть записаны на основе стандарта ISO 8601.

Пример содержимого поля:
2022-11-15 11:01:34

Date/Time Specific

Этот тип поля хранит отметку времени, измеренную в секундах.

В интерфейсе SimpleOne он отображается как поле ввода с выбором даты и времени.

Этот тип поля в основном используется в календарях. В отличие от поля типа Date Time, этот тип использует параметр смещения UTC, который указан в часовом поясе системы.

Подробнее о полях читайте в статье Колонки даты и времени.

Скалярный тип: timestamp

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Дата и время могут быть записаны на основе стандарта ISO 8601.

Пример содержимого поля:
2022-11-15 13:59:53

Document ID

Этот тип поля используется для хранения различных ID. Они хранятся как универсальные уникальные идентификаторы (UUID).

UUID состоит из 32 шестнадцатеричных символов, разделенных дефисами на пять групп по схеме 8-4-4-4-12:

8-значная группа
три группы по 4 знака в каждой
12-значная группа
Всего 32 символа, 128 бит.

На форме поле этого типа отражается как ссылочное поле. Этот тип поля используется для хранения ссылки на колонку в конкретной таблице и содержит список колонок указанной таблицы. Чтобы указать ссылку, нажмите на строку или на иконку лупы , выберите таблицу и колонку.

Скалярный тип: uuid

Тип значения в скриптах: string

Длина, пример значения или критерии проверки:

Введенное значение проверяется на то, что оно является строчным значением.
Далее, проверка выполняется в соответствии с заранее заданным шаблоном, как описано в колонке Описании.

Пример содержимого поля:
022c7bf5-6eb7-09f0-0244-bd40328f5f0f

Field Name

Этот тип поля используется для хранения ссылки на колонку в таблице и содержит список ее колонок.

Скалярный тип: int8

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Введенное строчное значение проверяется на то, что оно действительно строчное.

Пример содержимого поля:

165062848110459919

Image

Этот тип поля используется для хранения загружаемых файлов изображений в следующих форматах: .jpeg, .png, .gif, .webp, .bmp, .svg, .ico.

В интерфейсе SimpleOne оно отображается в виде модального окна загрузки.

Скалярный тип: int8

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Указанное значение не должно превышать этот диапазон: [9223372036854775807 ... 9223372036854775806].

Пример содержимого поля:

166851128418198961

List

Этот тип поля реализован в виде текстовой строки без указанной длины. Оно хранит ID записей указанной таблицы и отображается в виде списка значений записи, которые являются ссылками на форму записей.

Читайте статью Ссылочные поля, чтобы узнать больше.

Скалярный тип: text

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Все элементы должны быть отделены запятой.

Пример содержимого поля:
166807095216015872,166608269714919765

Record Class

Это системное поле, которое становится доступным при создании дочерних таблиц. Каждой дочерней таблице присваивается значение, которое также наследуют все ее записи. Используйте фильтр по полю Record class на списке родительской таблицы, чтобы отфильтровать записи определенных дочерних таблиц.

Изначально при создании новой корневой таблицы (без каких-либо родительских) этого поля не будет. Тип сохраняемых данных – ID. Размер сохраняемых данных – 8 байт.

Скалярный тип: int8

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Указанное значение не должно превышать этот диапазон: [100000000000000000 .. 999999999999999999].

Пример использования:

Таблица Задачи и ее дочерняя таблица Инциденты содержат несколько записей.
Когда вы просматриваете список задач, вы можете найти среди записей инциденты.
Вам необходимо найти инциденты, находясь в контексте таблицы Задачи.
Для этого вы можете отфильтровать эти записи на основе поля типа Record Class.
Поле Record Class является системным. Оно всегда доступно только для чтения и недоступно для редактирования.

Пример содержимого поля:

155931135900000084

Reference

Этот тип поля работает как внешний ключ и хранит ID записей указанной таблицы. Эта таблица должна быть указана в поле Ссылка. Значение хранится как произвольное целое число (Big Integer).

Чтобы ограничить количество записей при ссылке на поле, используйте определитель ссылок.

Читайте статью Ссылочные поля, чтобы узнать больше.

Скалярный тип: int8

Тип значения в скриптах: string

Длина, пример значения или критерии проверки: Вы можете использовать следующий диапазон целочисленных значений: [-9223372036854775808 … 9223372036854775807]

Пример содержимого поля:

155931135900000001

Template

Этот тип поля позволяет хранить набор имен колонок и их значений в формате JSON для всех таблиц. Этот формат поддерживает вложенность. На первом уровне вложенности в качестве ключей используются номера элементов, начиная с 1.

Из-за того что тип поля хранит пары данных наименование колонки ↔ значение, он обычно используется для шаблонных форм. Поля записей, созданных из шаблонов, автоматически заполняются соответствующими данными, которые хранятся в системе.

Элементы являются объектами в следующем формате:

ключ − ID колонки в справочнике Колонки (sys_db_column)
значение − значение колонки.

Скалярный тип: json

Тип значения в скриптах: string

Длина, пример значения или критерии проверки:

Template:
// используются следующие колонки справочника Пользователи: username, active, locked_out
  {
  "1":
  {
    "156943341303994936": "new_user"
  },
  "2":
  {
    "156943341308746896": "1"
  },
  "3":
  {
    "155931135900001086": "0"
  }
}

Пустое значение поля:

Пример содержимого поля:

[]

Без вариантов выбора​

Big Integer​

Days of Week​

Decimal​

Duration​

Encrypted Password​

Float​

HTML​

Integer​

Journal Input​

JSON​

Password​

Percent Complete​

Phone​

Script​

Small Integer​

String​

Text​

Translated Text​

URL​

Поля с выбором​

True/False​

Choice​

Color​

Conditions​

Time​

Date​

Date/Time​

Date/Time Specific​

Document ID​

Field Name​

Image​

List​

Record Class​

Reference​

Template​

Без вариантов выбора

Big Integer

Days of Week

Decimal

Duration

Encrypted Password

Float

HTML

Integer

Journal Input

JSON

Password

Percent Complete

Phone

Script

Small Integer

String

Text

Translated Text

URL

Поля с выбором

True/False

Choice

Color

Conditions

Time

Date

Date/Time

Date/Time Specific

Document ID

Field Name

Image

List

Record Class

Reference

Template