# Довідник семантичних типів полів

Семантичний тип поля в **Користувацьких даних** визначає формат збереження, валідацію та відображення в таблиці записів і картці. У редакторі типи згруповані за категоріями; технічні ключі (`text`, `integer`, `association` тощо) задаються автоматично при виборі типу в UI.

> Для налаштування типів у редакторі див. [Налаштувати тип поля](../how-to/configure-field-type.md). Системні типи — [Налаштувати системні типи полів](../how-to/configure-system-field-types.md).

---

## Основні

| Тип у 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** | Текст з валідацією email | Клікабельний лист |
| **Телефон** | tel-інпут | Маска телефону |
| **Посилання** | URL з валідацією | **Відкрити посилання** у таблиці |
| **Координата** | Широта/довгота STRING | Карта OpenStreetMap; формат «50.4501,30.5234» |

---

## Списки і звʼязки

| Тип у UI | Призначення | Підказка в UI |
|----------|-------------|---------------|
| **Список** | Статичні опції SELECT | Фіксований перелік значень |
| **Список по API** | Опції з ActionJail-дії | Дія + **поле підпису**; [інструкція](../how-to/configure-select-api-field.md) |
| **Звʼязок з таблицею** | 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-редагування в сітці |
| **Приховати колонку** / **Таблиця** на вкладці відображення | Видимість у таблиці записів |
| **Картка** | Поле в боковій панелі запису |

---

## Пов'язані матеріали

- [Налаштувати тип поля](../how-to/configure-field-type.md)
- [Налаштувати системні типи полів](../how-to/configure-system-field-types.md)
- [Налаштувати відображення полів](../how-to/configure-field-display.md)
- [Створити зв'язок між таблицями](../how-to/create-association-between-tables.md)
- [Розширені налаштування моделей](./advanced-model-options-reference.md)