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


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

Тип поляОписаниеСкалярный типТип значения в скриптеДлина, пример значения или критерии проверки

Big Integer

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

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

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

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

    166674708111757858

Days of week

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

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

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

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

int2number

Минимальное значение – 0 (дни не выбраны).

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

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

8

Decimal

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

12.33

Duration

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

Процесс проверки:

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

3600000

Encrypted Password

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

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

varcharstring

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

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

0YATXJjpWt5wFPL6FiKxQA==

Float

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

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

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

0.333

HTML

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

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

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

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

textstring

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

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

<html><head><title></title></head><body><h3>Email body:</h3><p><code>&quot;Hello world!&quot;</code></p></body></html>

Integer

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

int4number

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

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

1211345967

Journal Input

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

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

  • через само поле:

    1. Введите текст в поле.

    2. Нажмите Сохранить или Сохранить и выйти.

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

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

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

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

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

""

JSON

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

jsonbstring

Поля типа 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

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

varcharstring

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

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

$2y$13$MtP.z1mkGN.SdrzhzBQQ7.XaXgg58IS/qm2/wwQSeT/B58fxNMQGK

Percent Complete

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

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

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

99.90

Phone

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

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

varcharstring

Критерии проверки номера:

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

+74951818520

Script 

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

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

textstring

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

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

// console.log()

Small Integer

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

int2number

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

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

12

String

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

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

varcharstring

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

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

ivan.ivanov12

Text

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

textstring

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

Field content example:

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

Translated Text

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

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

varcharstring

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

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

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

URL

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

varcharstring

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

Field content example:

https://example.simpleone.ru/portal

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


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

Тип поляОписаниеСкалярный типТип значения в скриптеДлина, пример значения или критерии проверки

True/False

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

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

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

true

Choice

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

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

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


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

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

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

varcharstring

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

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

Изменено

Color

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

varcharstring

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

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

#B80000

Conditions

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

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

textstring

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

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

(active=true)

Date

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

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

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

datestring

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

  • ГГГГ-ММ-ДД

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

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

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

  • Числа
  • Слэш ( / )
  • Дефис ( - )
  • Точка ( . )
Пример содержимого поля:

2022-11-15

Date/Time

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

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

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

timestampstring

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

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

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

ЭлементДиапазонКомментарий
Секунда[00..59]

Указанное значение не должно превышать этот диапазон.

Минута[00..59]

Указанное значение не должно превышать этот диапазон.

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

2022-11-15 11:01:34

Date Time Specific

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

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

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

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

timestampstring

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

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

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

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

2022-11-15 13:59:53

Document ID

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

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

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

В общем 128 бит.

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

uuidstring

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

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

022c7bf5-6eb7-09f0-0244-bd40328f5f0f

Field Name

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

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

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

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

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

165062848110459919

Image

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

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

int8string

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

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

165062848110459919

List

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

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

textstring

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

  • Все элементы должны быть отделены запятой.
Пример содержимого поля:

165062848110459919, 166608269714919765

Record Class

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

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

int8string

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

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

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

165062848110459919

Reference

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

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

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

int8string

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

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

165062848110459919

Template

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

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

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

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




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

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

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

[]

Time

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

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

timestring

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

чч:мм:сс

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

ЭлементДиапазонКомментарий
Секунда[00..59]

Указанное значение не должно превышать этот диапазон.

Минута[00..59]

Указанное значение не должно превышать этот диапазон.

Час[00..23]Указанное значение не должно превышать этот диапазон.

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

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

11:00:54

  • No labels