Стандартные шаблоны

workflow

Вместе с FBI поставляется ряд наиболее часто используемых workflow. Все workflow принимают дополнительные параметры, которые перечисляются в параметре wf после названия так, как это принято для URL, например wf="form?param1=1&param2=2". Следующие параметры — общие для всех workflow:

Параметры:

• translate — имя словаря (mo-файла), используемого для перевода меток в шаблоне. По умолчанию для url /a/b/c используется словарь alterator-a
• redirect — после успешного сохранения (submit) формы возможно перенаправить браузер на следующую. Данный приём полезен для организации интерфейса типа wizard.

форма (form)

При чтении (GET) форма заполняется данными, прочитанными с бакенда. При сохранении формы (POST) модифицированные данные сохраняются обратно.

параметры:

• backend-url — по умолчанию адрес бакенда совпадает с адресом, по которому обращались к форме, однако иногда возникает необходимость нарушить это правило. Например, для формы /a/b использовать бакенд a-b, а для формы /a/c использовать бакенд a-c

картотека (card-index)

Двойная форма, применяется для управлением серией однотипных объектов. В html-шаблоне присутствуют две формы. Первая (class="selector-chooser") управляет основным объектом, в ней размещается селектор подъобекта (select c name="name"). Во второй (class="selector-data") выводятся параметры очередного выбранного объекта; в этой же форме обязательно должен присутствовать div с class="selector-name". Возможно также удаление объектов и создание новых. В формах также присутствуют кнопки со специальными именами.

первая форма:

• card-index-select — заполнение параметров для выбранного объекта;
• card-index-new — создание нового объекта (если в этом нет необходимости, то кнопка может отсутствовать);
• card-index-delete — удаление выбранного объекта (если в этом нет необходимости, то кнопка может отсутствовать);
• card-index-apply-main — сохранение общих параметров.

вторая форма:

• card-index-apply — сохранение параметров выделенного объекта

В первой форме все обращения к бакенду происходят по адресу, совпадающему с адресом формы, а во второй форме все обращения происходят по адресу, сформированному добавлением к адресу формы имени выделенного объекта.

Данный workflow может также применяться для моделирования «двухуровневого» выбора.

Виджеты

Все workflow умеют автоматически заполнять элементы формы, действуя по определённым правилам. Каждому виджету соответствует некоторый параметр бакенда, какой именно — указано в параметре name.

Для простых типов производится запрос read и значение параметра записывается в содержимое или в параметр value (зависит от конкретного виджета).

Для перечислимых типов содержимое параметра optionlist добавляется к адресу и производится запрос list. Для каждого прочитанного варианта учитываются параметры name (вариант) и label (название варианта для пользователя); в частности, текущим становится тот вариант, чьё значение name совпадает со значением виджета.

В html при записи формы передаются значения не всех виджетов, а только тех, чьи значения определены. В частности, если checkbox не выделен, его значение не будет фигурировать в списке переданных бакенду параметров. Это необходимо учитывать при разработке бакенда.

метка

<span class="alterator-label" name="name">

однострочное текстовое поле

<input type="text" name="name">

многострочное тестовое поле

<textarea name="name>

чекбокс

<input type="checkbox" name="name">

динамическое изображение

<img class="alterator-img" name="name">

Применяется для визуального отображения состояния, поэтому бакенд передаёт просто название состояния, а система заменяет его на путь к соответствующему изображению.

динамическая гиперссылка

<a class="alterator-ref">, <a class="alterator-ref2">

Применяется при создании серии ссылок на однотипные объекты. В первом варианте имя объекта добавляется к заданному в шаблоне значению href в качестве префикса, во втором — в качестве суффикса.

прогрессбар

<div class="alterator-progress" name="name">

Отображает в процентах состояние некоторого процесса.

список

<select name="name" optionlist="suburl">

динамическая таблица

<tbody class="alterator-list" optionlist="suburl">

Аналог многоколоночного списка в графическом интерфейсе. В шаблоне приводится строка, которая может содержать: метки, динамические гиперссылки, чекбоксы... Заполненные значениями каждого варианта копии этой строки и составляют результирующую таблицу. Более того, при сохранении (submit) формы для каждой строчки таблицы генерируется отдельная команда на запись, адрес которой состоит из адреса формы с добавленным суффиксом — именем варианта. Таким образом реализуются массовые операции над однотипными объектами (удаление, включение/выключение служб и т.д.).