Довідник JSON-конфігурації полів Custom Data
Короткий довідник: які ключі в columns_json і front_json керуються з Редактора моделі Custom Data, а які — лише через перемикач JSON або розширений довідник.
Рівні налаштувань
| Рівень | Де в UI | Що зберігається |
|---|---|---|
| Тип поля | Вкладка Поля → картка поля | type, семантика (system_ref, association, options, …) |
| Дані та валідація | Поля → деталі картки | default, unique, rules, non_editable |
| Відображення | Відображення полів | width, align, hidden_in_table, modal_entity, columns_chooser, table_stylization, modal_entity_layout |
| Розширені | JSON або розширений довідник | hidden_all, hide_in_filter, highlight_rules, widgets (MAP, SLIDER, …) |
Картка поля
| Контрол | JSON-ключ | Призначення |
|---|---|---|
| Значення за замовчуванням | default | Початкове значення при створенні запису |
| Обовʼязкове | rules: ["required"] | Поле має бути заповнене |
| Унікальні значення | unique | UNIQUE index у БД |
| Лише перегляд | non_editable | Заборона inline-редагування в таблиці |
| Правила перевірки | rules | email, url, digits, json, … |
Ключі типу (system_ref, association) задає обраний Тип, а не окремі поля картки.
Вкладка «Відображення полів»
| Налаштування UI | Зберігання |
|---|---|
| Порядок полів (drag-and-drop) | columns_chooser[].position |
| Toggle Таблиця | columns_json[key].hidden_in_table + columns_chooser[].active |
| Toggle Картка | membership у front_json.modal_entity |
| Підпис / іконка / колір / редаговане | front_json.modal_entity[key].{label,icon,icon_color,editable} |
| Ширина / вирівнювання | columns_json[key].{width,align} |
| Підсумок по полю | columns_json[key].total_* + front_json.table_stylization.total_row |
| Підсвітка рядків | front_json.table_stylization.colorize або highlight_rules |
| Групи картки запису | front_json.modal_entity_layout |
modal_entity_layout
{
"version": 1,
"display": "accordion",
"groups": [
{ "id": "main", "title": "Основне", "fields": ["name", "status"] }
]
}
- Поля з toggle Картка без групи потрапляють у секцію Інше.
- Без
modal_entity_layoutкартка запису — плоский список (зворотна сумісність).
Системні типи (system_ref)
{
"type": "INTEGER",
"label": "Відповідальний",
"system_ref": "user"
}
Допустимі значення: user, skill_group, subject, chat_status, tag, priority. У БД — INTEGER id.