Сущности: конструктор типов записей

Что такое сущность

Сущность (Entity) — это пользовательский тип записей: своя таблица данных с произвольным набором полей, своей моделью состояний и своими автоматизациями. Заявки, клиенты, сотрудники, активы, проекты — всё это не встроенные модули платформы, а обычные сущности, настроенные администратором через один и тот же конструктор.

Все типы сущностей видны администратору в разделе Сущности левого меню (Управление приложением → Сущности). Это список всех созданных в системе типов записей с переходом в редактор каждого.

Конкретный пример того, как сущность, модель состояний, автоматизации и бизнес-процесс складываются в готовый сценарий, разобран в Service Desk (IT-поддержка) — там показан пресет «Заявки» от начала до конца.

Создание сущности

Новая сущность создаётся пошаговым мастером (3 шага).

Шаг 1 — основная информация

1. Откройте Сущности → Создать
2. Заполните Название — человекочитаемое имя сущности (например, «Заявки»)
3. Системное имя таблицы предлагается автоматически транслитерацией названия, но его можно изменить вручную. Системное имя должно начинаться с латинской буквы и может содержать только латинские буквы, цифры и _ — это и есть table_name, по которому сущность будет доступна в адресе /e/<table_name>
4. Нажмите Далее

Шаг 2 — поля

На этом шаге добавляются поля будущей записи: кнопка + Добавить поле для каждого нового поля. Для каждого поля задаются:

• человекочитаемое название (по нему автоматически предлагается системное имя),
• системное имя (латиница, цифры, _),
• тип поля — из выпадающего списка (см. полный каталог типов в Типы полей),
• флажок Обязательное.

На этом шаге доступен сокращённый набор типов: текст, целое число, число с точкой, да/нет, дата, дата и время, email, многострочный текст, список значений, пользователь, файл. Остальные типы (категория, связанная сущность, изображение, точка на карте и т.д.) добавляются позже — в полном редакторе схемы.

Шаг 3 — параметры и создание

Здесь показывается сводка (название, системное имя, список добавленных полей с типами) и два параметра:

• Добавить в меню — создаёт пункт левого меню для этой сущности (включено по умолчанию);
• Поле для отображения — какое поле будет использоваться как «заголовок» записи в списках и ссылках (по умолчанию подбирается автоматически).

Нажатие Создать сохраняет сущность и переводит в список её записей. Под кнопками мастера есть ссылка на список всех сущностей — туда же можно перейти, чтобы продолжить настройку через полный редактор схемы.

Мастер создаёт только базовый каркас. Модель состояний, связи с другими сущностями, автоматизации, шаблоны, бизнес-процессы и тонкая настройка полей (валидация, видимость по ролям, зависимости между полями) настраиваются после создания — в редакторе схемы сущности (открывается кликом на сущность в списке Сущности). Редактор организован вкладками: общие настройки, разметка формы (layout), виджеты, шаблоны, процессы, дашборд, связи, автоматизация, вычисления, кнопки действий, форматирование списка.

Подробно про модель состояний — в Модели состояний, про автоматизации — в Автоматизации. Про связи между сущностями — в Связи, про древовидные справочники — в Категоризацию.

Список записей сущности

Открыв пункт меню сущности (или адрес /e/<table_name>), вы видите табличный список всех её записей.

Возможности списка:

• Строка поиска сверху — быстрый поиск по всем колонкам.
• Фильтр в заголовке колонки — отдельный фильтр для каждого поля (текстовый, числовой, по дате — в зависимости от типа поля).
• Группировка — выпадающий список Группировать по позволяет сгруппировать записи по значению одного из полей.
• Столбцы — кнопка Столбцы открывает чекбокс-список видимости колонок, можно скрыть лишние поля.
• Inline-редактирование — простые поля (текст, число, да/нет, статус, список значений и т.п.) можно менять прямо в ячейке таблицы, без открытия записи.
• Сортировка — кликом на заголовок колонки.
• Контекстное меню (правый клик на ячейке) — фильтр по значению, исключить значение, копировать, сортировка, группировка по полю.
• Массовые операции — выбор нескольких строк чекбоксами открывает панель с количеством выбранных записей и кнопкой Удалить для массового удаления (при наличии прав).
• Экспорт — выгрузка текущего списка в CSV или JSON.
• Создать — кнопка в правом верхнем углу открывает форму новой записи (доступна при наличии прав на создание).

Клик по строке открывает карточку записи; Ctrl/Cmd+клик — открывает её в новой вкладке.

Карточка записи

Карточка записи — это единая форма, которая используется и для создания новой записи, и для редактирования существующей (адрес /e/<table_name>/create и /e/<table_name>/:id).

Что есть на карточке:

• Поля формы, сгруппированные по секциям (секции можно сворачивать). Расположение полей определяется разметкой формы (layout), настроенной администратором в редакторе сущности. Обязательные поля отмечены *.
• Кнопки — Сохранить, Сохранить и закрыть, Отмена, а также пользовательские кнопки действий, если они настроены для сущности.
• Вкладка статуса — таймлайн смены статусов записи, если у сущности настроена модель состояний (подробнее — в Модели состояний).
• Вкладки связанных записей — по одной вкладке на каждую настроенную связь с другой сущностью (см. Связи).
• Граф связей — визуальная схема того, с какими записями других сущностей связана текущая запись.
• Боковая панель с блоками Процессы (активные задачи бизнес-процессов по записи, см. Бизнес-процессы), Сообщения (внутренний чат по записи) и История (журнал изменений записи, см. Журнал аудита).
• Поля типов «Файл» и «Изображение» позволяют прикреплять вложения прямо внутри формы, отдельной вкладки для файлов нет.

При создании записи можно применить шаблон (если для сущности настроены шаблоны) — это заранее заполняет часть полей.

Импорт данных

Если в сущность нужно загрузить много записей сразу, используйте массовый импорт — кнопка с подсказкой Импорт данных в списке записей. Мастер импорта принимает файлы Excel (.xlsx, .xls), CSV и JSON, даёт сопоставить колонки файла с полями сущности (включая выбор поля для дедупликации, чтобы повторный импорт обновлял существующие записи, а не создавал дубликаты), показывает предпросмотр перед запуском и отчёт с числом созданных, обновлённых записей и списком ошибок после завершения.

Подробное описание шагов импорта не входит в этот раздел — это отдельный инструмент, доступный из списка записей любой сущности.