Довідник семантичних типів полів
Семантичний тип поля в Користувацьких даних визначає формат збереження, валідацію та відображення в таблиці записів і картці. У редакторі типи згруповані за категоріями; технічні ключі (text, integer, association тощо) задаються автоматично при виборі типу в UI.
Для налаштування типів у редакторі див. Налаштувати тип поля. Системні типи — Налаштувати системні типи полів.
Основні
| Тип у UI | Призначення | Підказка в UI |
|---|---|---|
| Текст | Короткий текст (STRING) | До ~255 символів; назви, коди |
| Довгий текст | Багаторядковий TEXT | Коментарі, описи |
| Число | Ціле INTEGER | Кількість, ID, оцінки |
| Велике число | BIGINT | Великі цілі |
| Число з комою | FLOAT | Дробові значення, суми |
| Прапорець | BOOLEAN | Так / ні |
| Дата | DATE без часу | Дата події |
| Дата і час | DATE + time picker | Мітка часу |
| Час | Маска HH:mm або HH:mm:ss | Години роботи, слоти |
| Колір | Hex + swatch у таблиці | Кольорові мітки |
| JSON | JSON-об’єкт | Структуровані дані; truncate у таблиці |
Контакти й посилання
| Тип у UI | Призначення | Підказка в UI |
|---|---|---|
| Текст з валідацією email | Клікабельний лист | |
| Телефон | tel-інпут | Маска телефону |
| Посилання | URL з валідацією | Відкрити посилання у таблиці |
| Координата | Широта/довгота STRING | Карта OpenStreetMap; формат «50.4501,30.5234» |
Списки і звʼязки
| Тип у UI | Призначення | Підказка в UI |
|---|---|---|
| Список | Статичні опції SELECT | Фіксований перелік значень |
| Список по API | Опції з ActionJail-дії | Дія + поле підпису; інструкція |
| Звʼязок з таблицею | FK на іншу таблицю Custom Data | Таблиця, Поле підпису, Поле значення (FK) |
Many-to-many зв’язки в v2 — лише перегляд у редакторі (Зв’язок many-to-many (лише перегляд)).
Медіа
| Тип у UI | Призначення | Підказка в UI |
|---|---|---|
| Файл | Завантаження файлу в запис | Завантажити файл |
| Зображення (URL) | URL з превʼю | Відкрити перегляд зображення |
Системні
Посилання на сутності платформи; у таблиці зберігається ID.
| Тип у UI | Джерело довідника |
|---|---|
| Користувач | Користувачі з налаштувань |
| Скіл-група | OP settings |
| Тема | Subjects з OP settings |
| Статус діалогу | Статуси діалогу з OP settings |
| Тег | Теги з OP settings |
| Пріоритет | Пріоритети заявок (Tickets settings) |
Загальні параметри поля (усі типи)
| Параметр у UI | Опис |
|---|---|
| Підпис | Назва колонки / поля в картці |
| Технічний ключ | Ключ для API та процесів; до збереження таблиці можна змінити |
| Обовʼязкове | Поле має бути заповнене при збереженні |
| Унікальні значення | Заборона дублікатів |
| Лише перегляд у таблиці | Без inline-редагування в сітці |
| Приховати колонку / Таблиця на вкладці відображення | Видимість у таблиці записів |
| Картка | Поле в боковій панелі запису |