Сайт ↗
Разделы документации
UI интерфейс · 0.8.1

Content: модули, сущности и поля

Организуйте модель приложения, найдите нужную сущность и сохраните изменения перед генерацией.

На этой странице

Что находится в Content

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

Навигация и поиск

Введите имя или подпись в Find module or entity, чтобы быстро найти объект модели. Этот поиск не обращается к записям приложения. Стрелка у модуля сворачивает список сущностей, нажатие на его название открывает настройки. Virtual-сущности выделены отдельным бейджем.

После выбора сущности откроется таблица Fields. Нажмите строку поля для настройки; значки удаления и раскрытия выполняют свои действия отдельно. Свойства можно увидеть сразу по бейджам: Required, Primary key, Searchable, Filterable и Sortable.

Модули

Сначала создайте модуль, затем добавляйте в него сущности. Модуль объединяет их в интерфейсе и входит в адреса API.

Поле Пример Назначение
Module name site-data Техническое имя: строчные буквы, цифры и дефисы, начало с буквы
Module title Контент сайта Подпись в меню; пустое значение оставляет техническое имя

Нажмите Create module для создания или Save module для сохранения правок. В настройках есть список сущностей с переходом к каждой из них. Move up / Move down меняют порядок модулей; перед этим сохраните или отмените черновик. Delete module доступна только для пустого модуля: сначала перенесите его сущности. Если меняете техническое Module name непустого модуля, подтвердите последствия. Обычное изменение подписи адреса API не меняет. Перенести сущность можно в настройках сущности; её API получит префикс нового модуля.

Как сохраняются изменения

  1. Откройте создание или настройку объекта.
  2. Заполните Basic settings и при необходимости Advanced settings / Access.
  3. Нажмите Finish; в редакторе выбранных полей проекции используется Save fields.
  4. Дождитесь подтверждения сохранения и обновления модели.
  5. Перейдите в Generate для применения изменений к файлам.

Можно переключаться между вкладками без потери введённых значений. Для сохранения нажмите Finish: Cancel и закрытие панели его не заменяют. Если остались несохранённые правки, редактор предложит разобраться с черновиком. При параллельном изменении модели обновите состояние и сравните версии — устаревшая форма не должна затереть чужую работу.

Если связь с генератором прервалась и результат записи неизвестен, нажмите предложенный Refresh. Сначала проверьте, что сохранилось, и только потом повторяйте действие — это поможет не создать дубликат.

Рекомендуемый порядок проектирования

Например, для каталога создайте модуль catalog, сущности Category и Product и их идентификаторы. Добавьте обычные поля, затем связь Product → Category. После этого задайте доступ. Если сайту нужен отдельный состав ответа, добавьте виртуальную сущность. Завершите настройку через Preview/Generate.

Подробности: сущности, поля, доступ, связи, виртуальные сущности.

При необходимости модель можно редактировать через CLI; команды находятся в отдельном разделе. Не меняйте структуру приложения вручную в generated-файлах — для этого используйте модель.