Призначення
Збирає значення запуску, показує пояснення та додає значущі параметри як колонки кожного рядка. Параметри також доступні наступним умовам, формулам і зіставленням. Можна показати форму в майстрі, окремому діалозі або використовувати налаштовані значення без форми.
Входи та виходи
Один вхід in. Зазвичай один вихід out із доданими колонками. Якщо один перемикач radio має outputs=true, кожне його положення стає окремим виходом; активується лише вибране.
Параметри
| Параметр | Налаштування та значення | Варіанти й межі |
|---|---|---|
wizard | Показувати блок як крок майстра виконання. | Типово: вимкнено |
display | hidden — без форми, wizard — крок майстра, dialog — окремий діалог. | Типово: не задано |
dialog_width | Ширина діалогу в пікселях. | Типово: 760Межі: 360…1600 |
dialog_height | Висота діалогу в пікселях. | Типово: 560Межі: 240…1200 |
dialog_stop_label | Власний підпис кнопки зупинки; порожнє значення використовує типовий. | Типово: порожньоДо 60 символів |
dialog_continue_label | Власний підпис продовження. | Типово: порожньоДо 60 символів |
dialog_stop | Дозволити зупинити виконання з діалогу. | Типово: увімкнено |
dialog_maximize | Показувати можливість розгортання діалогу. | Типово: увімкнено |
dialog_close | Показувати кнопку закриття. | Типово: увімкнено |
title | Заголовок, який бачить користувач. | Типово: порожньоДо 200 символів |
description | Пояснення, що допомагає заповнити форму або зробити вибір. | Типово: порожньоДо 4000 символів |
columns | Кількість колонок компонування форми: від 1 до 4. | Варіанти: 1, 2, 3, 4Типово: 1 |
rows | Кількість рядків сітки; порожнє значення визначає їх автоматично. | Типово: не задано |
row_gap | Відстань між рядками сітки. | Типово: не задано |
column_gap | Відстань між колонками сітки. | Типово: не задано |
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 залишається прихованим лише тоді, коли всі поля, які користувач мав би заповнити, уже мають значення. Інакше система показує форму в майстрі.
Приклад налаштування
Створіть «Сценарій» як radio з Budget/Forecast, «Період» як member виміру Month та «Курс» як number=1. Значення додаються до кожного рядка; далі фільтр використовує «Період», а формула множить Value на param("Курс").
Підписи, компонування та передані значення
Поле має налаштування show_label та label_gap: показ назви над контролом і відстань до нього. Прихована візуальна назва залишається доступною засобам читання екрана. Інформаційний блок може містити форматований текст і власний колір; він не створює колонку. Для кнопок положень radio задайте кількість у рядку, вирівнювання, колір і проміжок. Перевірте форму кнопкою попереднього перегляду до запуску.
Параметри можуть бути передані розкладом, API або іншим потоком. У підпотоці чи фоновому виклику майстер не запитує їх у людини: беруться передані або стандартні значення. Імена переданих параметрів мають збігатися з внутрішніми іменами полів. Параметр попереднього блоку, значення першого рядка й стала величина — різні джерела, які потрібно вибрати явно.