#Глава 4. Формы и детали — ввод и просмотр в одном месте

В прошлой главе мы собрали список заявок и через простую форму внесли тестовые данные. Здесь усовершенствуем работу с формой — оптимизируем раскладку полей в блоке формы, добавим блок деталей, настроим связные правила и подключим историю изменений для отслеживания каждого редактирования заявки.

#4.1 Дорабатываем форму создания заявки

В прошлой главе мы создали быструю работающую форму, теперь её усовершенствуем — поправим порядок полей, зададим значения по умолчанию, оптимизируем раскладку. Если Вы пропустили блок быстрой формы, ничего страшного — здесь начнём с нуля.

#Добавляем кнопку «Создать»

1. Убедитесь, что включён UI Editor (переключатель в правом верхнем углу).
2. На странице «Список заявок» нажмите «Actions» над блоком таблицы.
3. Отметьте «Add».
4. Над таблицей появится кнопка «Add», открывающая всплывающее окно.

#Настраиваем форму во всплывающем окне

1. Нажмите кнопку «Add», откроется окно.

2. Во всплывающем окне нажмите «Add block» → Data block → Form (Add).

3. Выберите «Current collection». Окно уже привязано к нужному контексту таблицы — указывать вручную не нужно.

   

4. В форме нажмите «Fields» и отметьте поля:

Заметьте, что у поля «Заголовок» автоматически появляется звёздочка * — потому что в Главе 2 при создании поля мы установили его обязательным, и форма наследует это правило с уровня таблицы. Отдельно настраивать не нужно.

Лайфхак: если поле на уровне таблицы не помечено обязательным, но в этой форме хочется сделать его обязательным, можно настроить в параметрах поля.

#Добавляем кнопку «Submit»

1. Под блоком формы нажмите «Actions».
2. Отметьте «Submit».

3. После заполнения пользователь нажимает «Submit» — создаётся новая заявка.

#4.2 Связные правила: значения по умолчанию и связки полей

Для одних полей нужно автоматическое заполнение (например, «Статус» по умолчанию — «На рассмотрении»), для других — динамическое поведение (например, обязательное описание для срочных заявок). Сейчас функция значений по умолчанию в 2.0 ещё развивается, поэтому в этом учебнике используем связные правила для default-значений и связок.

1. В правом верхнем углу блока формы нажмите настройки блока (иконка трёх линий).
2. Найдите «Linkage rules» — справа откроется панель настройки.

#Значения по умолчанию

Сначала зададим значения по умолчанию для «Статуса» и «Заявителя»:

1. Нажмите «Add linkage rule».
2. Условие не задаём (оставляем пустым) — связное правило без условий выполняется при загрузке формы.

3. Настройте действия (Actions):
   • Поле «Статус» → Set default value → На рассмотрении
   • Поле «Заявитель» → Set default value → Текущий пользователь

Внимание при выборе значений: при настройке обязательно сначала выбирайте «Current form» в качестве источника. Для связных полей (категория, заявитель, обработчик и т. п. — поля «многие к одному») выбирайте сам объект, а не его развёрнутые подполя.

При выборе переменной (например, «Текущий пользователь») сначала кликом выделите её, а затем двойным кликом перенесите в строку выбора.

Если хотите, чтобы поле нельзя было редактировать (например, статус), в настройках поля установите «Display mode» в «Readonly».

Три режима отображения: Editable, Readonly (нельзя редактировать, но поле выглядит как обычное), Easy-reading (только текст).

#Срочные заявки требуют описание

Добавим связное правило с условием: при выборе приоритета «Срочный» поле «Описание» становится обязательным — пусть заявитель опишет ситуацию подробнее.

1. Нажмите «Add linkage rule».

2. Настройте правило:
   • Condition: Current form / Приоритет равен Срочный
   • Actions: поле «Описание» → Required

3. Сохраните правило.

Тестируем: выбираем приоритет «Срочный» — у поля «Описание» появляется красная звёздочка *. Выбираем другой приоритет — звёздочка пропадает.

Подгоним раскладку, как в предыдущих главах:

Что ещё умеют связные правила? Помимо значений по умолчанию и обязательности, можно управлять видимостью полей и динамически назначать значения. Например: при статусе «Закрыто» скрыть поле «Обработчик». Подробности — в следующих главах.

#4.3 Блок деталей

В прошлой главе мы добавили в строки кнопку «View» — клик открывает выезжающую панель. Теперь настроим её содержимое.

1. В таблице нажмите кнопку «View» какой-либо строки — откроется панель.
2. В панели нажмите «Add block» → Data block → Details.
3. Выберите «Current collection».

4. В блоке деталей нажмите «Fields» и расставьте поля по такой схеме:

Как вставить большой заголовок? Fields > markdown > Edit markdown > в редакторе выберите переменную > Current record > Заголовок. Так заголовок записи динамически вставится в Markdown-блок. Удалите дефолтный текст и Markdown-синтаксисом превратите его в заголовок второго уровня (т. е. поставьте ## в начало).

Поле «Заголовок» в самой панели можно убрать — настроим раскладку:

Лайфхак: несколько полей можно ставить в одну строку перетаскиванием — раскладка получится плотнее и опрятнее.

1. В блоке деталей в «Actions» отметьте «Edit» — будет удобно из деталей сразу переходить в редактирование.

#Настройка формы редактирования

При клике на «Edit» откроется новое всплывающее окно — внутри нужна форма редактирования. Поля у неё практически такие же, как у формы создания. Настраивать всё заново?

Не надо. Сохраним форму создания как шаблон, а форма редактирования будет на него ссылаться.

Шаг 1: возвращаемся к форме создания и сохраняем как шаблон

1. Закройте текущее окно, вернитесь к списку заявок и нажмите «Add», чтобы открыть форму создания.
2. В правом верхнем углу формы нажмите настройки блока (иконка трёх линий) и найдите «Save as template».

3. Сохраните; по умолчанию используется «Reference» — все формы, ссылающиеся на шаблон, разделяют одну конфигурацию: меняешь в одном месте, синхронизируется везде.

Наша форма заявки несложная, поэтому удобнее «Reference». «Copy» создаёт независимые копии для каждой формы — изменения у каждой свои.

Шаг 2: ссылаемся на шаблон в форме редактирования

1. Возвращаемся к панели деталей или строке таблицы, нажимаем «Edit» — открывается окно редактирования.

Может показаться: «Создать блок → Other blocks → Block templates» — самый быстрый путь? Но Вы получите форму создания, и поля не подгрузятся автоматически. Это распространённая ловушка.

Правильный путь:

2. Нажмите «Add block» → Data block → Form (Edit) — обычный блок формы редактирования.
3. В нём нажмите «Fields» → «Field templates» и выберите сохранённый шаблон.
4. Поля заполнятся одним кликом, идентично форме создания.
5. Не забудьте добавить кнопку «Submit», чтобы пользователь мог сохранить изменения.

В будущем достаточно изменить шаблон — обе формы обновятся.

#Быстрое редактирование: меняем данные без открытия окна

Помимо редактирования через окно, NocoBase поддерживает быстрое редактирование прямо в таблице — без открытия чего-либо, мышью.

Включается в двух местах:

• Уровень блока таблицы: настройки блока (иконка трёх линий) → «Quick editing». Все поля таблицы будут поддерживать быстрое редактирование.
• Уровень отдельного поля: настройки колонки → «Quick editing» — управление полем-по-полю.

После активации при наведении на ячейку появится иконка карандаша — клик откроет редактор поля, изменения сохраняются автоматически.

Когда полезно? Очень удобно, когда нужно массово менять статус, обработчика и т. д. Например, администратор просматривает список и быстро переводит заявки из «На рассмотрении» в «В обработке», не открывая окна.

#4.4 Включаем историю изменений

В системе заявок очень важно: кто, когда и что изменил — должно быть видно. Plugin «История записей» автоматически фиксирует каждое изменение.

#Настройка истории

1. В Settings → Plugin Manager убедитесь, что plugin «Record History» включён.

2. Зайдите в страницу настройки plugin, нажмите «Add collection» и выберите «Заявки».
3. Отметьте поля для журналирования: Заголовок, Статус, Приоритет, Обработчик, Описание и т. д.

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

4. Теперь в настройках нажмите «Sync history snapshots» — plugin сделает текущее состояние всех заявок первой записью истории, а далее каждая правка добавит новую запись.

#История на странице деталей

1. Возвращаемся в панель деталей заявки (клик «View» на строке).
2. В панели «Add block» → Record History.
3. Выберите «Current collection», данные — «Current record».
4. Внизу панели появится timeline: видно, кто и когда какое поле и с какого на какое значение изменил.

Даже если заявка прошла через нескольких людей, все изменения как на ладони.

#Итоги главы

В этой главе мы прошли полный жизненный цикл данных:

• Форма — пользователь создаёт новую заявку, есть default-значения и валидация
• Связные правила — у срочных заявок описание автоматически становится обязательным
• Блок деталей — наглядно показывает всю информацию о заявке
• История записей — автоматический аудит каждого изменения (коммерческий plugin, опционально)

От «видеть» к «вводить» и «находить» — система заявок стала по-настоящему пригодной к использованию.

#Связанные ресурсы

• Блок формы — подробная настройка формы
• Блок деталей — настройка блока деталей
• Связные правила — описание связных правил