Подгрузка данных

Назначение

Функция, которая исполняет сформированный пользователем визуально или явно SQL-запрос на базе данных для одной из операций: INSERT, UPDATE, SELECT. Является строго обязательным для настройки. Попытка сборки и запуска системы в несконфигурированномсостоянии функции приводит к ошибке.

Вид операции определяется либо инициализацией (открытием) самой web-страницы - тогда выполняется SELECT, либо событием управляющего воздействия пользователя на web-страницу (напр, нажатие кнопки “Сохранение”) - тогда выполняется INSERT или UPDATE.

Выполнение операции INSERT или UPDATE зависит от значения Переменной процесса с идентификатором: если переменная пуста, то выполняетсяINSERT - запрос, если содержит значение, то выполняется UPDATE - запрос.

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

Настройка

Наименование параметра	Обязательность	Назначение параметра	Принимаемые значения
Скрипт	Обязательный	позволяет указать один из вариантов реализации скрипта	FormServiceImpl - значение, выставляемое платформой по умолчанию. Обеспечивает сохранение и считывание значения любого визуального компонента, входящего в компоненту Форма, в/из базы данных. VariableFormService - обеспечивает считывание и/или сохранение значения любого визуального компонента, входящего в компоненту Форма, только из/в переменную процесса (не из/в базу данных).
Переменная процесса с идентификатором	Обязательный	позволяет выбрать из списка переменную процесса, содержащую в себе идентификатор смысловой единицы, которой посвящена компонента Форма (и web-страница приложения)	Список формируется автоматически из всех переменных используемых в BPMN-процессе. Является ограничивающим значением запроса (в секции WHERE primary_id = ), построенного в визуальном конструкторе параметра Граф сущностей. Благодаря этому ограничению компонента Форма как источник данных выбирает атрибуты единственной смысловой сущности создаваемого интерфейса. Указанная переменная процесса может не содержать значения, и это означает, что web - страница открыта для создания новой записи в базе данных и после нажатия на кнопку сохранения будет выполнен оператор INSERT. Указанная переменная процесса может содержать значение идентификатора, и это означает, что web - страница открыта для отображения текущих атрибутов одной существующей записи, в нее могут быть внесены изменения, и после нажатия на кнопку сохранения будет выполнен оператор UPDATE.
Источник данных. Скрипт	Обязательный	позволяет выбрать способ построения запроса - либо визуальный конструктор, либо кастомный SQL запрос	FormDaoImpl - Запрос формируется визуальным конструктором, значение по умолчанию CustomSqlFormDao - запрос может быть сформирован вручную в отдельном окне EditableOneToManyDaoImpl
Граф сущностей	Обязательный	позволяет с помощью визуального конструктора сформировать набор объектов базы данных, указать взаимосвязи между ними и\или дополнительные условия, тем самым подготовить запрос в базу данных.	При подгрузке данных сформированный запрос отрабатывает как Select-запрос, при сохранении новой информации как Insert-запрос, при внесении изменений как Update-запрос.
Скрипты валидации формы	Не обязательный	Сценарии проверки валидности данных на форме, которые выполняются при сохранении формы (например, проверка уникальности сохраняемой улицы (что в базе ее действительно пока еще нет, или проверка правильности соотнесения значений сразу нескольких полей и т.п.).Если валидация не прошла, то выдается ошибка и сохранение формы прекращается.	В базовой конфигурации сценарии не поставляются, они создаются дополнительно разработчиками под конкретные запросы пользователей. После подготовки программного кода такого скрипта и интеграции в платформу, его можно выбрать в этом пункте настроек по имени из выпадающего списка.
Скрипты, выполняемые после сохранения формы	Не обязательный	Вызов обработчиков после сохранения данных.	В качестве обработчиков могут выступать сценарии манипулирования данными на языке SQL с входными и выходными параметрами.