Column Types

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

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

Тип поля	Описание	Скалярный тип	Длина или пример значения, критерии проверки
Big Integer	Это числовой тип поля, используемый для хранения огромных чисел. Размер сохраняемых данных – 8 байт. В SimpleOne тип отображается в виде поля ввода с числовым значением.	int8	В SimpleOne следующий диапазон используется для ID записей: [100000000000000000 … 999999999999999999] Вы можете использовать следующий диапазон целочисленных для своих целей: [-9223372036854775808 … 9223372036854775807]
Days of week	Это поле отображается в виде раскрывающегося списка с флажками, указывающими дни недели: Понедельник, Вторник, Среда, Четверг, Пятница, Суббота, Воскресение. Можно выбрать несколько дней. Технически поле хранит числовое значение или сумму значений. Размер данных одной опции равен 2 байтам. Каждому деню недели присвоено значение: Понедельник = 1 Вторник = 2 Среда = 4 Четверг = 8 Пятница = 16 Суббота = 32 Воскресенье = 64 Например, если выбраны Вторник (2) и Среда (4), значение поля будет равно 6.	int2	Минимальное значение – 0 (дни не выбраны). Максимальное значение поля – 127 (все дни выбраны).
Decimal	Этот тип поля поддерживает нецелые числа, с двумя цифрами после разделителя (например, 12.34).	decimal
Duration	Этот тип поля используется для указания продолжительности между двумя событиями в миллисекундах. Оно хранит целое число.	int8	Процесс проверки: Срока ввода классифицируется по дате и времени (дни, часы, минуты, секунды). Значение преобразуется в общее количество миллисекунду и сохраняется как цельночисленное значение. (big integer).
Encrypted Password	Этот тип поля используется для обеспечения безопасного хранения паролей в базе данных с возможностью декодирования (двухстороннего шифрования).	varchar	Это поле может содержать все виды символов. Длина значения ограничена до 255 символов.
Float	Этот тип поля предназначен для чисел с плавающим разделителем.	float4	Критерии проверки: Допускаются только цифры, запятая или точка. Максимальная длина значения – 14 символов. Максимальный размер дроби – 12 символов (после разделителя, которым может выступать точка или запятая, в зависимости от пользовательских предпочтений).
HTML	Этот тип поля реализован как виджет форматированного текста. Для него существуют различные настройки, которые отображаются в виде HTML-тегов в базе данных. Когда это поле доступно только для чтения, данные отображаются в формате HTML; в ином случае они отображаются как текст, который можно редактировать и преобразовывать. В этом поле можно использовать два режима: редактор форматированного текста и редактор исходного кода. Вы можете войти в редактор исходного кода, нажав Source на панели. Изменения, сделанные в одном из режимов, отображаются в другом, и наоборот.	text	Это поле может содержать все виды символов, оно не имеет длины, пока не будет ограничено атрибутом Максимальная длина.
Integer	Это числовой тип поля. Размер сохраняемых данных – 4 байта.	int4	Указанное значение не должно превыщать этот диапазон: [-2147483648 ... +2147483647].
Journal Input	Этот тип поля используется для работы с виджетом комментариев. Из-за своих особенностей оно не может быть доступно только для чтения. Он реализован в виде текстовой области с подсказкой внутри поля или заголовком поля. Есть два способа ввести комментарии через поле типа Journal Input : через само поле: Введите текст в поле. Нажмите Сохранить или Сохранить и выйти. через модуль Лента активности: Нажмите на модуль Лента активности. Выберите секцию, которая больше подходит по смыслу вашего сообщения (Рабочая заметка, Дополнительный комментарий). Введите текст и отправьте его. Когда в поле такого типа добавляются комментарии, они сохраняются записями в двух таблицах: Активности (sys_activities_stream_field) – комментарии из Ленты активности, которые выступают форматтерами пользовательского интефейса. Объекты ленты активности (sys_activity_feed_item) – комментарии в виджете, который настраивается через Simple-тег <activityFeed>. Если выполняется асинхронные бизнес правила типа after, вы можете работать со значениями полей типа Journal Input так же, как и в правилах типа after при обращении к current контексту.	text	Это поле может содержать все виды символов, оно не имеет длины, пока не будет ограничено атрибутом Максимальная длина.
JSON	Этот тип поля хранит значения в JSON формате.	jsonb	Пример значения поля: 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} Поля типа JSON проверяются так, как поля типа String, содержащие JSON. Чтобы узнать больше, обратитесь к официальной документации JSON.
Password	Этот тип поля хранит пароли. Он отображается в виде поля для ввода.	varchar	Это поле может содержать все виды символов. Длина значения ограничена до 255 символов.
Percent Complete	Этот тип поля используется для отображения хода выполнения задачи в процентах.	decimal	Критерии проверки поля: Может содержать числа [0..100]. Максимальный размер дроби – 2 символа. Максимальная длина – 6 символов.
Phone	Этот тип поля хранит номера телефонов. В интерфейсе SimpleOne, он отображается в виде поля ввода с номером телефона.	varchar	Критерии проверки номера: Может содержатть: (+-), пробелы и цифры. Максимальная длина – 15 символов.
Script	Этот тип поля является текстовой строко без ограничения длины. В интерфейсе SimpleOne он отображается как виджет CodeMirror (компонент JavaScript, который обеспечивает возможность редактировать код в браузере).	text	Это поле может содержать все виды символов и не имеет длины, пока не будет ограничено атрибутом Максимальная длина.
Small Integer	Это числовой тип поля. Размер сохраняемых данных – 2 байта.	int2	Указанное значение не должно превышать диапазон: [-32768 ... +32767].
String	Этот тип поля реализован в виде строки длиной 255 символов. В интерфейсе SimpleOne, он отображается как поле ввода текста.	varchar	Это поле может содержать все виды символов. Если длина значения не задана, то она ограничена до 255 символов; в ином случае ограничение длины может быть больше или меньше.
Text	Этот тип поля реализован в виде текстовой строки без указаной длины. Память выделяется динамически при обработке значения поля.	text	Это поле может содержать все виды символов и не имеет длины, пока не будет ограничено атрибутом Максимальная длина.
Translated Text	Этот тип поля позволяет одному и тому же полю отображать различное значение в зависимости от выбранного пользователем языка. Читайте статью Колонки типа Translated Text, чтобы узнать больше.	varchar	Это поле может содержать все виды символов и не имеет длины, пока не будет ограничено атрибутом Максимальная длина.
URL	Этот тип поля предназначен для хранения URL.	varchar	Это поле может содержать все виды символов. Длина значения ограничена до 2048 символов.

Поля типов Choice

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

Field Type

Description

Scalar Type

Length or Example, validation criteria

Boolean

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

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

boolean

true или false

Choice

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

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

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

Для этого типа поля в таблице sys_db_column были созданы вспомогательные поля. Параметры конфигурации элементов, которые необходимо выбрать, находятся в таблице sys_choice. Доступны следующией типы вариантов (они зависят от настройки Типа списка на форме создания колонки):

Нет
Выпадающий список с опцией Нет
Выпадающий список без опции Нет (укажите значение по умолчанию).

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

varchar

Это поле может содержать все виды символов. Если длина значения не задана, то она ограничена до 80 символов.

Color

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

varchar

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

Пример: #B80000

Conditions

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

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

text

Критерии проверки:

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

Date

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

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

date

Дата должна иметь формат ISO 8601 format:

ГГГГ-ММ-ДД

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

Элемент	Диапазон	Комментарий
День	[01..31]	Указанное значение не должно превышать этот диапазон.
Месяц	[01..12]	Указанное значение не должно превышать этот диапазон.
Год	[0001..9999]	Указанное значение не должно превышать этот диапазон.

Допустимые символы в поле:

Числа
Слэш ( / )
Дефис ( - )
Точка ( . )

Date/Time

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

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

timestamp

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

ГГГГ-MM-ДД чч:мм:сс

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

Элемент	Диапазон	Комментарий
Секунда	[00..59]	Указанное значение не должно превышать этот диапазон.
Минута	[00..59]	Указанное значение не должно превышать этот диапазон.
Час	[00..23]	Указанное значение не должно превышать этот диапазон.
День	[01..31]	Указанное значение не должно превышать этот диапазон.
Месяц	[01..12]	Указанное значение не должно превышать этот диапазон.
Год	[1900..2099]	Указанное значение не должно превышать этот диапазон.

Date Time Specific

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

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

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

timestamp

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

ГГГГ-MM-ДД чч:мм:сс

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

Элемент	Диапазон	Комментарий
Секунда	[00..59]	Указанное значение не должно превышать этот диапазон.
Минута	[00..59]	Указанное значение не должно превышать этот диапазон.
Час	[00..23]	Указанное значение не должно превышать этот диапазон.
День	[01..31]	Указанное значение не должно превышать этот диапазон.
Месяц	[01..12]	Указанное значение не должно превышать этот диапазон.
Год	[1900..2099]	Указанное значение не должно превышать этот диапазон.

Document ID

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

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

8-значная группа
три группы по 4 знака в каждой
12-значная группа.

В общем 128 бит.

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

здесь должно быть изображение

uuid

Критерии проверки:

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

0229fa8a-bcbe-1f54-0163-45785d8a0001

Field Name

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

Чтобы указать ссылку, выполните следующие действия:

Добавьте это поле на форму используя настройку Представления формы.
Правой кнопкой мыши нажмите на заголовок поля и выберите Настройка поля.
Перейдите в секцию Настройка типа и укажите колонку таблицы в поле Зависит от колонки.
Нажмите Сохранить или Сохранить и выйти.

int8

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

Image

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

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

int8

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

List

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

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

text

Критерии проверки:

Все элементы должны быть отделены запятой.

Record Class

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

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

int8

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

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

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

Reference

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

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

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

int8

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

Template

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

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

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

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

Этот тип поля требует заполнения поля Зависит от поля в секции Настройки типа.

json

Template

// following columns of user dictionary are used: username, active, locked_out

{
  "1":
  {
    "156943341303994936": "new_user"
  },
  "2":
  {
    "156943341308746896": "1"
  },
  "3":
  {
    "155931135900001086": "0"
  }
}

Time

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

time

Время записается в ISO 8601 формате, как показано ниже:

чч:мм:сс

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

Элемент	Диапазон	Комментарий
Секунда	[00..59]	Указанное значение не должно превышать этот диапазон.
Минута	[00..59]	Указанное значение не должно превышать этот диапазон.
Час	[00..23]	Указанное значение не должно превышать этот диапазон.

Допустимо использование чисел и двоеточий ( : ).

Page tree

Column Types

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

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

Поля типов Choice

Boolean

Choice

Color

Conditions

Date

Date/Time

Date Time Specific

Document ID

Field Name

Image

List

Record Class

Reference

Template

Time