Для чого потрібна кнопка
Кнопка запуску дає користувачу змогу виконати підготовлений потік UBC Data Bridge без переходу до конструктора. Її можна розмістити поруч зі звітом або робочою формою на дозволеному HTTPS-сайті. Натискання запускає визначену автором послідовність: отримання даних, введення параметрів, перевірки, перетворення та передавання результату.
Приклад назви — «Оновити управлінський звіт». Напис пояснює результат дії. Інші доречні назви: «Передати затверджений бюджет», «Оновити прогноз продажів», «Завантажити дані підрозділу».
Кнопка викликає потік Data Bridge. Якщо в ньому налаштовано отримувач TurboIntegrator, цей потік може також запустити процес IBM. Для книги PAW дивіться окрему інструкцію для IBM Planning Analytics Workspace.
Можливості та сценарії
| Можливість | Призначення |
|---|---|
| Запуск із робочої сторінки | Оновлення звіту або передавання даних з місця, де користувач аналізує результат. |
| Одна кнопка — один потік | Зрозумілий напис, визначені права та керований сценарій виконання. |
| Стан на кнопці | Індикатор, смуга прогресу за наявності даних і пояснення в підказці. |
| Інтерактивний майстер | Файл, параметри, перегляд даних, вибір і повідомлення — відповідно до блоків потоку. |
| Виконання без форм | Потік із готовими значеннями працює без додаткових вікон після необхідного входу. |
| Централізоване керування | Адміністратор задає напис, оформлення, дозволені сайти та користувачів. |
Відкриття сторінки з кнопкою саме по собі нічого не запускає. Повний журнал і результат виконання зберігаються у Data Bridge.
Налаштування у Data Bridge
- Підготуйте потік, перевірте джерела, отримувачі та інтерактивні кроки. Для робочого використання опублікуйте перевірену версію Production.
- Увійдіть як адміністратор і для потрібного потоку відкрийте «Кнопка для Workspace». Ця назва команди використовується й для інших дозволених сайтів.
- Позначте «Увімкнути кнопку цього потоку». У полі «Напис на кнопці» введіть «Оновити управлінський звіт».
- У «Дозволені адреси Workspace» додайте адресу сайта-контейнера: протокол, сервер і порт. Приклади:
https://portal.example.comабоhttps://portal.example.com:8443. Одна адреса в рядку, без шляху сторінки, параметрів URL і символів*. - Оберіть «Адміністратори та вибрані користувачі» або «Усі, хто має право запуску цього потоку». У першому режимі додайте потрібних користувачів. Порожній список залишає доступ лише адміністраторам.
- Налаштуйте оформлення, перевірте попередній вигляд і натисніть «Зберегти налаштування».
- Натисніть «Скопіювати адресу». Вбудовуйте саме згенеровану адресу кнопки.
Типова структура адреси — https://bridge.example.com/embed/flows/…; за встановлення у підкаталозі він також входить до URL. Домен у прикладі умовний: копіюйте повну адресу зі своєї установки.
Розміщення через посилання
На іншому сайті додайте компонент «Веб-сторінка», «Вбудований вміст» або iframe та вставте URL кнопки. Початковий розмір — 280 × 44 px. Це розмір кнопки на сторінці, а не розмір майстра.
<iframe
src="СКОПІЙОВАНА_HTTPS_АДРЕСА_КНОПКИ"
title="Оновити управлінський звіт"
width="280" height="44"
style="border:0">
</iframe>Замініть заповнювач у src адресою з налаштувань Data Bridge. Сайт-контейнер має дозволяти цей вбудований вміст і відкриття вікна запуску. Якщо платформа обмежує iframe, узгодьте необхідні дозволи з її адміністратором.
Звичайне гіперпосилання відкриває сторінку з кнопкою. Для відображення її стану поруч зі звітом використовуйте вбудований веб-компонент. Адреса не містить пароля й сама по собі не надає права запуску.
Статуси та індикатори
Основний напис під час звичайного запуску зберігається. Стан передається значком, смугою прогресу та підказкою при наведенні. Синя рамка фокуса означає вибір кнопки, а не успішне завершення.
| Стан | Вигляд і значення | Дія користувача |
|---|---|---|
| Готова | Власний напис без індикатора. | Натисніть один раз, щоб почати. |
| Вхід / запуск / «У черзі» | Обертання та рухома смуга: вхід, підготовка або очікування виконавця. | Дочекайтеся потрібної форми чи початку обробки. Це ще не підтверджений запис. |
| «Виконується» | Обертання; прогрес за наявності відсотка. Рухома смуга без відсотка означає невизначену тривалість. | Стежте за станом. |
| «Очікує дії користувача» | Жовта пауза й жовта смуга. Потрібен файл, параметри, вибір або підтвердження. | Завершіть крок майстра; натискання повертає до поточного вікна. |
| «Успішно» | Зелена ✓ приблизно на 8 секунд, потім стан готовності. | Перевірте бізнес-результат. |
| «Помилка» | Червоний ! і червона рамка. | Прочитайте підказку та журнал, виправте причину перед повтором. |
| «Частковий результат» | Червоний !; точний статус у підказці. Частину дій підтверджено. | Спочатку звірте, що вже виконано. |
| «Потрібна звірка» | Червоний !; немає однозначного підтвердження від цільової системи. | Перевірте її стан до повторного запуску. |
| «Зупинено» | Кнопка знову готова. Наступний запуск почнеться з початку. | Урахуйте вже підтверджені зовнішні дії: зупинка їх не відкочує. |
За короткочасного розриву зв’язку можливі обертання та повідомлення про автоматичне повторне підключення у підказці. Службові проблеми можуть тимчасово змінити напис: «Дозвольте спливаючі вікна», «Помилка запуску», «Немає зв’язку» або «Кнопка недоступна». Деталі перевіряйте в журналі виконання.
Який майстер може відкритися
Майстер показує кроки, передбачені автором потоку. Їхня послідовність залежить від зв’язків і активної гілки. Універсальна форма перед кожним запуском не додається.
| Крок | Що бачить користувач | Налаштування потоку |
|---|---|---|
| Оновлення файла | Вибір або перетягування файла, формат, правила читання, результат перевірки. | Блок «Файл» із Менеджера файлів → «Запитувати в користувача оновлений файл». |
| Параметри запуску | Період, сценарій, підрозділ, текст, числа, перемикачі або елементи вимірів. | «Параметри запуску» → показ у майстрі чи окремому діалозі. |
| Перегляд даних | Таблиця для перевірки рядків і полів. | Блок перегляду даних із показом у майстрі. |
| Вибір маршруту | Варіант продовження, що визначає активну гілку. | Блок вибору та налаштовані переходи. |
| Повідомлення | Пояснення, результат перевірки або попередження. | Блок повідомлення та його режим відображення. |
| Збереження результату | Отримання створеного файла на комп’ютер. | Файловий отримувач із відповідним призначенням. |
Виконання потоку
Завантажте нову версію файлу Управлінська звітність.xlsx. Приклад використовує іменований діапазон «ReportData».
У сценарії оновлення пов’язаного файла збережена версія не підставляється замість нового файла. «Продовжити» стає доступним після завантаження й успішного читання. У робочому виконанні підтверджений файл зберігається як нова версія під назвою об’єкта Менеджера файлів, навіть якщо локальна назва інша. У симуляції чи перевірці нова версія не зберігається.
Для нового потоку використовуйте сучасний блок «Файл». Окремий застарілий блок вибору файла збережено для сумісності наявних потоків. Для параметрів запуску автор може змінити підписи й доступність кнопок, розміри та заголовок окремого діалогу.
Вхід, вікна й повторний запуск
За відсутності дійсного сеансу відкривається вхід у Data Bridge. На іншому домені інтерактивні форми відкриваються в окремому вікні браузера: дозвольте його відкриття для адреси Data Bridge. За спільних протоколу, домену й порту сторінки-контейнера та Data Bridge форма може відображатися поверх сторінки.
Якщо вікно вже відкрите, повторне натискання повертає до нього. Для власного активного запуску без форм повторне натискання не створює ще один паралельний запуск. Закриття активного майстра будь-яким способом зупиняє цей запуск. Наступний старт починається з початку, без відкату підтверджених зовнішніх дій.
Повідомлення, передбачені потоком, можуть з’являтися у вікні або в області кнопки. Потік без видимих кроків працює без додаткових форм та автоматичного відкриття журналу.
Права та межі інтеграції
Користувач повинен мати право запуску потоку в Data Bridge і відповідати правилу доступу кнопки. Доступ до зовнішнього сайта не замінює цих прав. Для IBM також потрібні відповідні права облікового запису підключення TM1.
Зміна дозволених адрес, списку користувачів або вимкнення кнопки відкликає її чинні дозволи й зупиняє незавершені запуски. Напис і оформлення змінюються без повторного входу; новий вигляд завантажується після оновлення сторінки-контейнера.
Фільтри та вибрані значення стороннього сайта автоматично до потоку не передаються. Задайте їх у формі параметрів або в самому потоці. Після запису оновіть звіт, якщо він ще показує попередні дані.