Назначение
Собирает значения запуска, показывает пояснения и добавляет параметры со значениями как столбцы к каждой строке. Параметры также доступны следующим условиям, формулам и сопоставлениям. Форму можно показывать в мастере, отдельном диалоге или использовать настроенные значения без формы.
Входы и выходы
Один вход in. Обычно один выход out с добавленными столбцами. Если у одного переключателя radio задано outputs=true, каждая позиция становится отдельным выходом; активируется только выбранная.
Параметры
| Параметр | Настройки и значения | Варианты и ограничения |
|---|---|---|
wizard | Показывать блок как шаг мастера выполнения. | По умолчанию: disabled |
display | hidden — без формы, wizard — шаг мастера, dialog — отдельный диалог. | По умолчанию: not set |
dialog_width | Ширина диалога в пикселях. | По умолчанию: 760Ограничения: 360…1600 |
dialog_height | Высота диалога в пикселях. | По умолчанию: 560Ограничения: 240…1200 |
dialog_stop_label | Собственная подпись кнопки остановки; пустое значение использует стандартную. | По умолчанию: emptyДо 60 символов |
dialog_continue_label | Собственная подпись кнопки продолжения. | По умолчанию: emptyДо 60 символов |
dialog_stop | Разрешить остановку выполнения из диалога. | По умолчанию: enabled |
dialog_maximize | Показывать возможность развернуть диалог. | По умолчанию: enabled |
dialog_close | Показывать кнопку закрытия. | По умолчанию: enabled |
title | Заголовок для пользователя. | По умолчанию: emptyДо 200 символов |
description | Пояснение, помогающее пользователю заполнить форму или сделать выбор. | По умолчанию: emptyДо 4000 символов |
columns | Количество столбцов раскладки формы: от 1 до 4. | Варианты: 1, 2, 3, 4По умолчанию: 1 |
rows | Количество строк сетки; пустое значение определяет его автоматически. | По умолчанию: not set |
row_gap | Расстояние между строками сетки. | По умолчанию: not set |
column_gap | Расстояние между столбцами сетки. | По умолчанию: not set |
fields | От 1 до 100 полей формы; весь поток также ограничен 100 параметрами. | Количество: 1–100 |
Типы полей формы
| Параметр | Что настраивает |
|---|---|
| constant | Постоянное значение запуска. |
| text / textarea | Однострочный или многострочный текст. |
| number | Числовое значение. |
| date | Календарная дата. |
| member | Выбор элемента измерения или иерархии из подключения; можно ограничить подмножеством. |
| toggle | Две позиции с собственными значениями off_value/on_value и подписями. |
| radio | Несколько позиций с уникальными id, label и value; отображаются переключателем или кнопками. |
| file | Прикреплённый файл, который можно использовать в сообщениях. |
| info | Информационный текст с форматированием и цветом; не создаёт столбец. |
Свойства полей
| Параметр | Что настраивает |
|---|---|
name / label / hint | Внутреннее имя, подпись в форме и подсказка. |
required / locked / value | Обязательность, запрет редактирования и значение по умолчанию. |
row / column / row_span / col_span | Начальная позиция в сетке и количество занимаемых строк и столбцов. Без row поле размещается в своём столбце автоматически. |
connection_id / dimension / hierarchy / subset / private | Источник списка элементов для member и режим подмножества. |
options / outputs | Позиции radio и включение отдельных выходов. До 20 вариантов. |
appearance / option_gap / per_row / align / color | Вид позиций переключателя, интервалы, количество в строке, выравнивание и цвет. |
text / text_format / info_color | Текст информационного поля, формат plain/html и цвет. |
Пошаговая настройка
- Разместите блок перед шагами, использующими его параметры. Введите заголовок и пояснение.
- Добавьте поля с уникальными внутренними именами и понятными подписями. Выберите тип каждого поля.
- Задайте значения по умолчанию, обязательность, запрет редактирования и подсказки.
- Выберите режим отображения и раскладку. Позиции полей не должны перекрываться.
- Для выбора элемента укажите подключение, измерение, иерархию и при необходимости подмножество.
- Свяжите параметры со следующими фильтрами, формулами или получателями и проверьте форму в симуляции.
Правила и диагностика
- Имена параметров уникальны во всём потоке. Имя параметра не может перезаписывать входной столбец; иначе возникает PARAMETER_COLUMN_CONFLICT.
- Значения доступны после выполнения блока; следующие шаги не могут использовать параметры невыполненной или несвязанной ветки.
- Информационное сообщение не имеет значения и не становится столбцом. Поле вложения не имеет значения по умолчанию.
- Обязательному заблокированному полю нужно значение по умолчанию. Сетка формы проверяет границы и пересечения.
- Только один переключатель radio в блоке может иметь отдельные выходы. Если выбранная позиция не подключена, ветка заканчивается.
- Режим hidden остаётся скрытым только если все поля, которые должен заполнить пользователь, уже имеют значения. Иначе система показывает форму в мастере.
Пример настройки
Создайте «Scenario» как radio с Budget/Forecast, «Period» как member измерения Month и «Rate» как number=1. Значения добавляются в каждую строку; следующий фильтр использует «Period», а формула умножает Value на param("Rate").
Подписи, раскладка и переданные значения
Поля предоставляют show_label и label_gap для управления видимой подписью и отступами. Визуально скрытая подпись остаётся доступной программам чтения с экрана. Информационные поля могут содержать форматированный текст и собственный цвет, но не создают столбцы. Для вариантов radio в виде кнопок задайте количество в строке, выравнивание, цвет и интервалы. Проверьте форму до запуска.
Расписания, API и другие потоки могут передавать параметры. Подпоток или фоновый вызов не обращается к человеку через мастер: он использует переданные значения или значения по умолчанию. Переданные имена должны совпадать с внутренними именами полей. Предыдущий параметр запуска, поле первой строки и константа — разные источники, их нужно выбирать явно.