Призначення

Для рядків, що відповідають умовам, присвоює полям сталі величини, параметри, значення інших полів, результати формул або NULL. Без умов діє на всі рядки.

Входи та виходи

Один in та один out. Кількість рядків зберігається; нові поля створюються в усіх рядках, а у невідібраних залишаються NULL.

Параметри

ПараметрНалаштування та значенняВаріанти й межі
modeall/any для умов відбору рядків.Варіанти: all, any
Типово: all
predicatesУмови відбору рядків. Кожна умова містить поле, оператор та значення для порівняння.Кількість: 0–100
assignmentsВід 1 до 100 присвоювань у порядку виконання. Кожне поле задається в блоці лише один раз.Кількість: 1–100
decimalДесятковий роздільник для числових значень у вхідних даних.Варіанти: ., ,
Типово: .

Як задати умову

ПараметрЩо налаштовує
columnПоле рядка, яке перевіряється.
opДорівнює eq, не дорівнює ne, більше gt, не менше gte, менше lt, не більше lte, містить contains, починається starts_with, входить до переліку in, не входить not_in, порожнє empty, непорожнє not_empty.
value_modeДжерело порівняння: constant — стале значення; parameter — параметр попереднього блоку; field — інше поле поточного рядка. Для порівняння з іншою таблицею спочатку приєднайте потрібне поле через Join.
value / value_fieldСтала величина або назва поля порівняння. Для in і not_in задайте одне значення в кожному рядку.
parameter_block / parameterБлок параметрів і назва параметра; параметр має бути підготовлений раніше в цій гілці.
numericУвімкніть для числового порівняння. Порожнє значення не задовольняє числовій умові; текст, який неможливо прочитати як число, спричиняє помилку.

Параметри присвоювання

ПараметрЩо налаштовує
fieldЦільове поле.
sourceconstant, parameter, field, formula або empty.
value / value_typeСтала величина й тип text/number/boolean/date.
parameter_block / parameterПосилання на параметр попереднього блоку.
source_fieldІнше поле цього рядка.
expressionФормула того самого формату, що в «Розрахункових полях».

Покрокове налаштування

  1. За потреби додайте умови вибору рядків; без умов змінюються всі.
  2. Додайте присвоювання й виберіть цільове поле або введіть нову назву.
  3. Вкажіть джерело constant/parameter/field/formula/empty.
  4. Для сталої величини виберіть тип; для формули перевірте доступні поля та параметри.
  5. Перевірте відповідні та невідповідні умові рядки.

Правила та діагностика

  • Присвоювання виконуються згори вниз: пізніше бачить значення, встановлене раніше.
  • Існуюче поле перезаписується лише у вибраних рядках.
  • Дати-константи задаються як РРРР-ММ-ДД. Числа повинні бути скінченними; логічні значення приймають відповідні так/ні.
  • Відсутнє поле-джерело або ще не підготовлений параметр зупиняє блок.
  • Порівняння з довідником не підтримується тут; маршрутизуйте рядки раніше.

Приклад налаштування

Умова Status=Draft. Присвоювання Status ← текст Submitted, SubmittedAt ← формула today(), AmountUAH ← field("Amount") * param("Rate"). Інші рядки залишать свій Status, а нові поля в них будуть NULL.

Порівняння з елементом довідника

Для умови можна вибрати value_mode=member: елемент виміру IBM Planning Analytics, виміру UBC Analytics або значення поля-зв’язку форми. Виберіть підключення й об’єкт, а потім елемент та спосіб зіставлення. Значення порівняння фіксується під час налаштування умови; це не динамічне приєднання другого джерела до кожного рядка. Після зміни потрібного елемента чи атрибута перевірте вибір повторно. Для порівняння двох колонок поточного рядка використовуйте value_mode=field.