Назначение
Записывает выбранную роль и/или пользователя в столбцы каждой строки. Используется для ответственных лиц, маршрутизации согласований и полей форм. Работает в UBC Data Bridge в составе UBC Analytics.
Входы и выходы
Один вход in и выход out; выбранные столбцы добавляются или перезаписываются в каждой строке. При активном выполнении значения читаются заново.
Параметры
| Параметр | Настройки и значения | Варианты и ограничения |
|---|---|---|
connection_id | Сохранённое подключение, через которое блок обращается к системе. | По умолчанию: emptyДо 64 символов |
environment | Среда UBC Analytics; выберите её до объекта и полей. | По умолчанию: emptyДо 80 символов |
role_field | Имя столбца роли; пустое значение отключает добавление роли. | По умолчанию: РольДо 256 символов |
role_code | Код выбранной роли. | По умолчанию: emptyДо 128 символов |
role_label | Сохранённая подпись роли для интерфейса. | По умолчанию: emptyДо 200 символов |
role_value | Записывать имя или код роли. | Варианты: name, codeПо умолчанию: name |
user_field | Имя столбца пользователя; пустое значение отключает добавление пользователя. | По умолчанию: КористувачДо 256 символов |
user_id | Идентификатор выбранного пользователя. | По умолчанию: not set |
user_label | Сохранённая подпись пользователя для интерфейса. | По умолчанию: emptyДо 400 символов |
user_value | Записывать full_name, email или id пользователя. | Варианты: full_name, email, idПо умолчанию: full_name |
Пошаговая настройка
- Добавьте блок в среде UBC Analytics и выберите подключение и среду.
- Задайте нужную роль и формат её значения.
- Задайте пользователя и выберите полное имя, адрес почты или ID.
- Назовите целевые столбцы; ненужную часть отключите пустым именем поля.
- Проверьте значения и сопоставьте их с соответствующими полями целевой формы.
Правила и диагностика
- Удалённая или отключённая роль вызывает CMS_ROLE_MISSING; отсутствующий или неактивный пользователь — CMS_USER_MISSING. Повторно выберите актуальную запись.
- ID пользователя передаётся текстом, совместимым с соответствующими полями формы.
- Существующий столбец с выбранным именем перезаписывается в каждой строке.
- На неактивном маршруте блок передаёт структуру без обращения к UBC Analytics.
- В автономной установке этот блок не предоставляет доступ к ролям UBC Analytics.
- Нужно добавить хотя бы один столбец. При добавлении роли и пользователя целевые имена должны различаться.
Пример настройки
Для заявок задайте role_field=ApprovalRole, role_value=code и роль согласующего; задайте user_field=OwnerID, user_value=id и ответственного пользователя. Затем сопоставьте эти столбцы с полями формы.