Skip to main content

База знаний Appliner

Print

Форма

Posted
Updated
Appliner Admin
Views4

 

 Компонент “Форма” используется для создания форм в веб-интерфейсе, с помощью которых пользователь может вводить какие-либо данные, отправлять их на обработку или осуществлять другие действия. 
При “перетаскивании” иконки “Форма” на рабочий стол система предложит осуществить выбор компонента, с которым создаваемая форма должна будет взаимодействовать.

Доступен выбор между:

  • Системными действиями;
  • Моделью данных (то есть, выполнением операций с таблицами в модели данных);
  • Процессами;
  • Процедурами Blockly.

При выборе “Системных действий” будет предложено выбрать действие из выпадающего списка; список соответствует пунктам меню “Действия” – “Системные действия” Конструктора процедур.

При выборе “Модели данных” можно обратиться к любой созданной пользователем таблице и к некоторым системным.

При выборе “Процессов” будет создана форма, запускающая заранее созданный процесс;

При выборе “Процедур Blockly” можно выбрать любую заранее созданную процедуру; выпадающий список соответствует пунктам меню “Действия” – “Процедур Blockly” Конструктора процедур.

 

Форма для осуществления системных действий

Рассмотрим процесс создания различных форм подробнее. Например, нам необходимо создать экранную форму для отправки письма по электронной почте. Перетаскиваем иконку “Форма” на рабочий стол, выбираем “Системные действия”, затем из выпадающего списка – “Отправить Email”. На экране появится форма, состоящая из набора стандартных полей, предназначенных для заполнения, несколько кнопок “Загрузить файл” и кнопка “Отправить электронное письмо”.

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

Во вкладке “Настройки” в правой части экрана для всех элементов формы можно при необходимости указать идентификатор или наименование, 

а также настроить видимость элемента для группы пользователей с определенной ролью.

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

С таблицей можно осуществлять следующие действия:

  • Создать запись – создаёт с заполненными полями запись в выбранной модели данных, на форме отображается перечень полей, которые необходимо  заполнить для создания записи и кнопка “Создать запись”;
  • Обновить запись – обновляет указанную в параметре  запись согласно заполненным полям на форме в выбранной модели данных, на форме отображается перечень полей с содержимым записей, которые можно изменить и кнопка “Обновить запись”, необходимо указать параметр по которому определяется запись для обновления;
  • Вставить запись – вставляет с заполненными полями данных запись в выбранную модель данных, на форме отображается перечень полей, который необходимо заполнить для вставки записи в модель данных и кнопка “Вставить запись”;
  • Удалить запись – удаляет запись по указанному параметру в выбранной модели данных, на форме отображается кнопка “Удалить запись”, необходимо указать параметр, по которому определяется запись для удаления;
  • Удалить все записи – удаляет все записи в выбранной модели данных, на форме отображается кнопка “Удалить все записи”.
  • Создать несколько записей – фактически это форма для загрузки данных из файла формата CSV. Форма содержит кнопку для выбора файла для загрузки и кнопку “Создать несколько записей” для запуска процесса импорта.
  • Импортировать из гугл-таблицы – форма импорта данных из гугл-таблиц. Форма содержит поля для заполнения (URL, Идентификатор, Лист/диапазон) и кнопку запуска импорта.
  • Экспортировать в гугл-таблицу – Форма аналогичная описанной выше, но запускающая процесс экспорта выбранной таблицы.

Дополнительная информация и примеры взаимодействия с компонентом “Форма” представлены здесь.

Форма для запуска процессов

При выборе формы для работы с процессами создается простая форма, содержащая поле “Идентификатор задачи” и кнопку “Запустить процесс”. Форма предназначена для запуска через пользовательский интерфейс исполняемого BPMN-процесса, заранее созданного в Конструкторе процессов.

Форма для запуска Процедур Blockly

Создаётся простая форму с кнопкой “Выполнить процедуру”, запускающая выполнение процедуры, ранее созданной в Конструкторе процедур.

Настройки формы

Все элементы формы могут быть отредактированы и отформатированы по желанию пользователя с помощью стандартных встроенных инструментов, расположенных во вкладке “Стили” в правой части экрана. Любое из полей может быть удалено, могут быть изменены размеры и расположение элементов, применена заливка, изменен шрифт и т.п.

В зависимости от параметров формы поля имеют следующие настройки:

  • Запрос – позволяет выбрать, с каким полем записи в таблице будет работать данное поле, по умолчанию название поля на форме соответствует полю таблицы.
  • Метка “Обязательное поле” – если такая метка присутствует в форме, то она не позволяет совершить действие, регламентированное кнопкой, до тех пор, пока данное поле не заполнено. По умолчанию метка снята.
  • Фильтрация по полю – позволяет выбрать поле, по которому будет осуществляться фильтрация. По умолчанию не заполняется;
  • Фильтрация по ключу – позволяет указать ключ, по которому будет осуществляется фильтрация. По умолчанию не заполняется.

Добавление и удаление полей. Конструирование собственных форм

В Конструкторе форм создаем страницу, на которую будем выводить форму. 

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

В результате получаем такую форму на макете страницы:

 

 

Эта же форма в режиме предварительного просмотра:

С помощью инструментов в закладке “Стили” можно редактировать размеры полей, артибуты шрифтов, форму и цвет кнопок – по аналогии с редактированием прочих компонентов. Подробно об этом рассказывается в статье “Стили и Настройки“. Теперь добавим в форму дополнительные поля. 

Например, необходимо добавить поле логического выбора (чекбокс), позволяющее указать, работает ли некий сотрудник на полную ставку. Для этого в таблице “Сотруднкики” создайте поле с названием “Полная ставка” и типом данных “Логический”. 

Перетащите на форму компонент “логический выбор”.

Укажите поле таблицы в котором бутет хранится запись о выборе пользователя. Если полей с одинаковым типом данных несколько, будет предложено выбрать поле из списка. В результате получим добавленный в созданную форму “чекбокс”. 

При установке или снятии “галочки” выбор пользователя будет сохраняться в выбранном поле таблицы “Сотрудники”, и к нему всегда можно будет обратиться впоследствии. Аналогичным образом в форму подставляются другие элементы формы. Самое главное, чтобы предварительно в таблице были созданы поля с соотыетствующим типом данных.

Оставить комментарий

Оглавление