Типы колонок
Без вариантов выбора
Типы полей, которые не предлагают вариантов для выбора.
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 (все дни выбраны).
8
Decimal
Этот тип поля поддерживает нецелые числа, с двумя цифрами после разделителя (например, 12.34).
Скалярный тип: decimal
Тип значения в скриптах: number
Длина, пример значения или критерии проверки:
12.33
Duration
Этот тип поля используется для указания продолжительности между двумя событиями в миллисекундах. Оно хранит целое число.
Скалярный тип: int8
Тип значения в скриптах: number
Длина, пример значения или критерии проверки:
- Срока ввода классифицируется по дате и времени (дни, часы, минуты, секунды).
- Значение преобразуется в общее количество миллисекунд и сохраняется как произвольное целое число значение (Big Integer).
3600000
Encrypted Password
Этот тип поля используется для обеспечения безопасного хранения паролей в базе данных с возможностью декодирования (двухстороннего шифрования). На платформе версии 1.23 алгоритм шифрования изменился с AES-128 на AES-256.
После ввода пароля и сохранения записи, поле становится пустым, пароль недоступен на форме.
Если вы импортируете SOP-файл с записью предыдущей версии или собираетесь восстановить версию записи со старым алгоритмом шифрования, вам будет необходимо ввести пароль заново и сохранить запись с паролем для включения шифрования AES-256.
Скалярный тип: 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>"Привет, мир!"</code></p></body></html>
Integer
Это числовой тип поля. Размер сохраняемых данных – 4 байта.
Скалярный тип: int4
Тип значения в скриптах: number
Длина, пример значения или критерии проверки: Указанное значение не должно превышать этот диапазон: [-2147483648 ... +2147483647].
1211345967
Journal Input
Этот тип поля используется для работы с виджетом комментариев. Из-за своих особенностей оно не может быть доступно только для чтения. Он реализован в виде текстовой области с подсказкой внутри поля или заголовком поля.
Есть два способа ввести комментарии через поле типа Journal Input:
-
через само поле:
- Введите текст в поле.
- Нажмите Сохранить или Сохранить и выйти.
-
через виджет Лента активности:
- Нажмите на виджет Лента активности.
- Выберите секцию, которая больше подходит по смыслу вашего сообщения (рабочая заметка, дополнительный комментарий).
- Введите текст и отправьте его.
Когда в поле такого типа добавляются комментарии, они сохраняются в виде записей в двух таблицах:
- Активности (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
Длина, пример значения или критерии проверки: Это поле может содержать все виды символов. Длина значения ограничена 255 символами.
$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].
12
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
Длина, пример значения или критерии проверки:
// используются следующие колонки справочника Пользователи: username, active, locked_out
{
"1":
{
"156943341303994936": "new_user"
},
"2":
{
"156943341308746896": "1"
},
"3":
{
"155931135900001086": "0"
}
}
Пустое значение поля:
[]