Формы

Раздел «Формы» предназначен для конфигурирования пользовательских интерфейсов системы. В нём создаются и настраиваются объекты формы, определяющие структуру экрана, состав элементов, источники данных и набор доступных действий. Сохранённая форма может быть назначена пункту меню, ссылкой в другой форме или целевой страницей для действия «Открыть форму».

Описание интерфейса

Свойства формы

При создании или редактировании формы задаются базовые атрибуты: «Наименование», «Описание», «Заголовок страницы» и «Вид».

Поле «Наименование»Наименование» является обязательным и используется как идентификатор формы в административном интерфейсе, а также как базовый заголовок при отображении формы пользователю.

Поле «Описание»Описание» содержит произвольный поясняющий текст о назначении формы и сценариях её использования. Значение поля носит информационный характер и не влияет на выполнение операций.

Поле «Заголовок страницы»страницы» задаёт текст, отображаемый в шапке окна при открытии формы. При отсутствии значения в этом поле в качестве заголовка используется значение поля «Наименование».

Поле «Вид»Вид» определяет компоновку экрана и общий сценарий работы пользователя с формой. Доступны следующие варианты значения поля «Вид».

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

Значение «Книжка»Книжка» предназначено для последовательного представления информации по одной сущности. Экран логически разделяется на страницы, между которыми пользователь переключается с сохранением контекста выбранного объекта. Каждая страница содержит собственный набор элементов: основные сведения, связанные документы, историю операций, журналы и т.д. Вид «Книжка» используется для реализации сложных карточек с большим количеством полей и логических разделов.

Значение «Альбом» ориентировано на панельное или плиточное отображение данных. Элементы формы размещаются по сетке и, как правило, представляют агрегированную или визуализированную информацию. Такой вид применяется для дашбордов, обзорных панелей, сводных отчётных экранов и интерфейсов мониторинга, где основная задача пользователя — контроль показателей и навигация по агрегированным данным.

Значение «Пользовательский» используется для нестандартных интерфейсов, когда требуется специфичная логика компоновки или интеграция с нестандартными компонентами. В этом режиме компоновка, распределение областей и визуальное поведение элементов определяются разработчиком конфигурации.

Конструктор содержимого

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

Редактор элемента формы содержит три вкладки: «Элемент», «Отображение», «Действия».

Вкладка «Элемент» включает общие параметры компонента. Основным полем является «Тип элемента», определяющий источник данных и поведение компонента.

Тип «Контент» используется для работы непосредственно с материалами определённого типа. Элемент отображает список или карточку контента, опираясь на стандартные механизмы хранения материалов. Применяется для построения справочников, карточек и реестров, где достаточно прямого доступа к сущностям.

Тип «Зависимый контент» предназначен для случаев, когда выводимый контент должен фильтроваться по значению другого элемента формы. Элемент получает контекст от родительского компонента и ограничивает набор материалов по указанному признаку. Так реализуются мастер‑детальные сценарии, в которых подчинённый список содержит только связанные записи.

Тип «Данные представления» применяется для отображения результата одного представления без табличного списка. Элемент формирует сводный блок или карточку с агрегированными данными по текущему контексту. Логика отбора и расчётов полностью задаётся конфигурацией выбранного представления.

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

Тип «Зависимые данные представления список» работает аналогично типу «Данные представления список», но дополнительно учитывает контекст другого элемента формы. Представление получает значения ключевых полей из родительского компонента, что позволяет выводить связанные данные: подчинённые записи, детали выбранного объекта, историю операций.

Тип «Комментарии» подключает механизм комментариев для выбранной сущности. Элемент отображает ленту сообщений и предоставляет пользователю возможность добавлять новые комментарии, связанные с объектом данных. Компонент используется для фиксации замечаний и обсуждений по конкретным карточкам.

Тип «Процессы БП» отображает запуски бизнес‑процессов, связанных с текущим контекстом. Элемент формирует список экземпляров процессов, их статусов и параметров, обеспечивая контроль выполнения процедур по объекту.

Тип «Задачи БП» ориентирован на отображение задач, сформированных механизмом бизнес‑процессов. Элемент может использоваться как список задач конкретного исполнителя или как перечень задач по выбранной сущности с возможностью перехода к выполнению.

Тип «Отчёт» встраивает отчётный компонент в форму. Элемент загружает указанный отчёт, применяет к нему параметры контекста и отображает результат. Это позволяет объединять интерфейсы ввода данных и аналитические представления в одном экране.

Тип «Справка» служит для отображения статического или формируемого программно справочного материала: инструкции по заполнению формы, регламента работы с разделом, ссылок на внешние ресурсы. Элемент не взаимодействует с данными и имеет информационное назначение.

Тип «Формы» позволяет встроить одну форму внутрь другой. Элемент загружает указанную форму и отображает её как часть текущего интерфейса. Механизм используется для построения сложных экранов из переиспользуемых компонент.

Для типов, работающих с представлениями, используется поле «Представления», в котором выбирается конкретное view, задающее источник данных и структуру набора. Набор доступных представлений формируется в разделе настройки представлений.

Флаг «Внешний ID» включает использование внешнего идентификатора объектов при работе элемента. При установке флага операции над записями выполняются с учётом внешнего идентификатора, что необходимо для интеграции с внешними системами и синхронизации нумерации.

Опция «Фильтровать по автору» определяет, должен ли список автоматически ограничиваться записями, созданными текущим пользователем. При включении опции в запрос выборки добавляется условие по полю автора, и элемент формирует персональный список объектов.

Вкладка «Отображение» содержит параметры визуального представления элемента. В разделе «Заголовок» задаётся текст заголовка блока и настройки его отображения. В разделе «Список» настраиваются характеристики табличной части: количество строк на странице, параметры постраничной навигации, сортировка по умолчанию, режим выбора строк. В разделе «Настройки поля» конфигурируются отдельные колонки и поля: видимость, порядок следования, формат отображения, маски и подсказки.

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

Действия значения

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

«Действия значения» настраиваются во вкладке Действия → Действия значения и относятся к конкретной строке списка или к конкретному значению элемента.

Где появляются:
панель кнопок над списком, кнопка-меню в строке, контекстное меню в таблице (в зависимости от позиции).

Основные настройки действия:

• Тип

  • «Действие» — одиночная кнопка.

  • «Меню» — выпадающий список, внутрь которого добавляются поддействия.

• Название
  Подпись кнопки или пункта меню («Редактировать», «Просмотр», «Удалить», «Открыть журнал»).

• Подсказка
  Всплывающий текст при наведении.

• Включить подтверждение операции
  Если нужно запросить подтверждение пользователя перед выполнением (удаление, отмена и т.п.).
  При включении становятся доступны поля:

  • «Заголовок подтверждения»

  • «Текст подтверждения».

• Позиция
  Где отрисовать действие: на панели, в меню строки и т.д. (на скрине выбрана «Панель»).

• Действие по умолчанию
  Если отмечено, то это действие можно вызывать двойным кликом по строке.

Блок «Действия» внутри карточки действия задает, что именно произойдет. Для каждой строки выбирается:

• Сущность
  С каким типом данных будет работать действие (например, «Мероприятия», «Журналы контроля»).

• Тип действия:

  • Открыть форму
    Открывает форму для выбранной сущности.
    Примеры: редактирование журнала, просмотр карточки мероприятия, создание записи на основе текущей строки.

  • Запустить процесс
    Запуск бизнес-процесса с привязкой к выбранной записи.
    Пример: «Согласовать мероприятие», «Создать заявку в техподдержку по этому помещению».

  • Маршрутизация
    Смена статуса, перевод объекта по маршруту, выполнение перехода в процессе или в модели данных.

  • Управление данными
    Создание, изменение или запись связанных данных (обновить поле, создать связанную запись).
    Используется для простых операций без полноценного скрипта.

  • Ручной скрипт
    Выполнение пользовательского скрипта по выбранной записи.
    Подходит для сложной логики: несколько шагов, интеграции, нетипичные проверки.

  • Удалить контент
    Удаление объекта (обычно с подтверждением).
    Например, удалить мероприятие, журнал, запись наблюдения.

Таким образом, «действия значения» нужны для операций «над строкой»: открыть, отредактировать, удалить, запустить процесс по конкретному журналу или мероприятию.

---

Действия элемента

Раздел «Действия элемента» описывает операции, относящиеся к элементу в целом. Такие действия выводятся на панели элемента и могут инициировать создание новых записей, массовые операции, формирование отчётов или запуск процессов без привязки к конкретной строке. Конфигурация действий элемента аналогична конфигурации действий значения и включает выбор сущности и типа действия.

«Действия элемента» настраиваются во вкладке Действия → Действия элемента и относятся ко всему элементу целиком, а не к отдельной строке.

Где появляются:
обычно в панели инструментов элемента (верхние кнопки формы или блока списка).

Типичные сценарии:

• открыть форму создания нового журнала/мероприятия;

• массовая операция над выбранными строками (если это поддерживает конкретный тип действия);

• запуск общего процесса по данным элемента;

• вызов отчета, который использует текущие фильтры списка.

Настройки внутри карточки действия элемента аналогичны действиям значения: задается название, подсказка, при необходимости подтверждение, позиция и «вложенные» действия (Открыть форму, Запустить процесс, Управление данными и т.д.).
Разница только в контексте: действия элемента не привязаны к отдельной строке, а работают от имени элемента или выбранного набора записей.