Для чего нужна кнопка
Кнопка запуска позволяет выполнить подготовленный поток 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 секунд, затем состояние готовности. | Проверьте бизнес-результат. |
| «Ошибка» | Красный ! и красная рамка. | Прочитайте подсказку и журнал и устраните причину перед повтором. |
| «Частичный результат» | Красный !; точный статус указан в подсказке. Часть действий подтверждена. | Сначала сверьте уже выполненные действия. |
| «Требуется сверка» | Красный !; целевая система не дала однозначного подтверждения. | Проверьте её состояние перед новым запуском. |
| «Остановлено» | Кнопка снова готова. Следующий запуск начинается с начала. | Учитывайте подтверждённые внешние действия: остановка их не откатывает. |
Краткий разрыв связи может сопровождаться вращающимся индикатором и сообщением об автоматическом переподключении в подсказке. Сервисные проблемы временно меняют название на «Разрешите всплывающие окна», «Не удалось запустить», «Соединение потеряно» или «Кнопка недоступна». Подробности см. в журнале выполнения.
Какой мастер может открыться
Мастер показывает шаги, настроенные автором потока. Их последовательность зависит от связей и активной ветви. Универсальная форма перед каждым запуском не добавляется.
| Шаг | Что видит пользователь | Настройка потока |
|---|---|---|
| Обновление файла | Выберите или перетащите файл; просмотрите формат, правила чтения и результат проверки. | Блок «Файл» из Менеджера файлов → «Запрашивать обновлённый файл у пользователя». |
| Параметры запуска | Период, сценарий, подразделение, текст, числа, переключатели или элементы измерений. | «Параметры запуска» → отображение в мастере или отдельном диалоге. |
| Просмотр данных | Таблица для проверки строк и полей. | Блок просмотра данных, отображаемый в мастере. |
| Выбор маршрута | Выбор продолжения, определяющий активную ветвь. | Блок выбора и настроенные переходы. |
| Сообщение | Пояснение, результат проверки или предупреждение. | Блок сообщения и его режим отображения. |
| Сохранение результата | Получение созданного файла на компьютер. | Файловый получатель с соответствующим назначением. |
Выполнение потока
Загрузите новую версию Management reporting.xlsx. В примере используется именованный диапазон «ReportData».
При обновлении связанного файла сохранённая версия не подставляется вместо нового файла. «Продолжить» становится доступно после загрузки и успешного чтения. В рабочем запуске подтверждённый файл сохраняется новой версией под названием объекта Менеджера файлов, даже если локальное имя отличается. Симуляция или проверка новую версию не сохраняет.
Для нового потока используйте актуальный блок «Файл» . Отдельный устаревший блок выбора файла сохранён для совместимости с существующими потоками. Для параметров запускаавтор может изменить названия и доступность кнопок, размеры и заголовок отдельного диалога.
Вход, окна и повторные нажатия
Если действующего сеанса нет, открывается вход в Data Bridge. При другом домене интерактивные формы открываются в отдельном окне браузера: разрешите его для адреса Data Bridge. Если страница-контейнер и Data Bridge имеют одинаковые протокол, домен и порт, форма может появляться поверх страницы.
Если окно уже открыто, повторное нажатие возвращает к нему. Для собственного активного запуска без форм ещё одно нажатие не создаёт второй параллельный запуск. Закрытие активного мастера любым способом останавливает этот запуск. Следующий старт начинается с начала без отката подтверждённых внешних действий.
Сообщения потока могут отображаться в окне или области кнопки. Поток без видимых шагов выполняется без дополнительных форм и автоматического открытия журнала.
Права и границы интеграции
Пользователь должен иметь право запуска потока в Data Bridge и соответствовать правилу доступа кнопки. Доступ к внешнему сайту эти права не заменяет. IBM также требует соответствующих прав у учётной записи подключения TM1.
Изменение разрешённых адресов или списка пользователей либо отключение кнопки отзывает действующие разрешения и останавливает незавершённые запуски. Изменение названия и оформления нового входа не требует; оформление загрузится при обновлении страницы-контейнера.
Фильтры и выбранные значения стороннего сайта автоматически в поток не передаются. Задайте их в форме параметров или самом потоке. После записи обновите отчёт, если он ещё показывает старые данные.