◫UBC Data BridgeДокументация2.1.1
Сайт продукта Консультация

UBC DATA BRIDGE

Документация

Практические инструкции: первый поток, подготовка и перенос данных, API, Agent, коннекторы, выполнение, доступ и примеры.

Начало работы

Что нового в UBC Data Bridge 2.1.1

UBC Data Bridge 2.1.1: обмен данными, API, ресурсы закрытой сети и управляемые процессы.

↗
Возможности UBC Data Bridge

От источника данных до проверенного результата в одном визуальном потоке.

↗
Первый поток

Пошагово: загрузите таблицу, отберите строки и получите файл.

↗
Основные понятия

Источник, подключение, блок, поток, черновик и запуск — разные объекты системы.

↗

Архитектура

Архитектура системы

Компоненты системы и их ответственность независимо от языков реализации.

↗
Движок и производительность

Как система выполняет граф, управляет ресурсами и подготавливает запись.

↗
Варианты развёртывания

Отдельный продукт или интеграция с UBC Analytics; онлайн- и офлайн-дистрибутивы.

↗
Метаданные и хранение файлов

Что находится в базе, что хранится в файлах и как устроена изоляция.

↗

Потоки и выполнение

Библиотеки и организация работы

Поиск потоков, подключений и источников, работа с папками и блокировками редактирования.

↗
Конструктор потока

Полотно, блоки, порты, свойства и анализ промежуточных результатов.

↗
Черновики и Production

Редактирование, автосохранение, симуляция и публикация рабочей версии.

↗
Запуск, проверка и результаты

Как читать статусы и избегать дублирования после сбоя.

↗
Кнопка запуска на другом сайте

Запуск потока с корпоративного портала: назначение, встраивание по URL, статусы и интерактивный мастер.

↗
Расписания и автоматические задания

Запуск по времени, интервалу или изменению источника.

↗

Источники и коннекторы

Источники файлов и диапазоны

Как превратить файл в стабильную таблицу для потока.

↗
Менеджер файлов

Управляемые файлы, версии, папки и настройки хранения.

↗
Удалённые файловые хранилища

Настройка Google Drive, OneDrive, S3, FTP/FTPS и сетевого диска.

↗
Работа с подключениями

Общий порядок создания, проверки и использования доступа к сервисам.

↗
Чтение и запись баз данных

Таблицы, запросы, ключи и режимы добавления/обновления.

↗
REST API и OData

Ресурсы, форматы, страницы ответа и передача строк.

↗
Microsoft Dynamics 365

Настройки подключения, обязательные поля и правила использования.

↗
1С:Предприятие 8 (локальный сервер)

Настройки подключения, обязательные поля и правила использования.

↗
Microsoft SQL Server

Настройки подключения, обязательные поля и правила использования.

↗
Azure SQL Database

Настройки подключения, обязательные поля и правила использования.

↗
Oracle Database

Настройки подключения, обязательные поля и правила использования.

↗
IBM Db2

Настройки подключения, обязательные поля и правила использования.

↗
PostgreSQL

Настройки подключения, обязательные поля и правила использования.

↗
MySQL / MariaDB

Настройки подключения, обязательные поля и правила использования.

↗
ClickHouse

Настройки подключения, обязательные поля и правила использования.

↗
Redis

Настройки подключения, обязательные поля и правила использования.

↗
Источник данных ODBC

Настройки подключения, обязательные поля и правила использования.

↗
REST API (любой HTTP-сервис)

Настройки подключения, обязательные поля и правила использования.

↗
Электронная почта (SMTP)

Настройки подключения, обязательные поля и правила использования.

↗
Бот Telegram

Настройки подключения, обязательные поля и правила использования.

↗

Настройка API

API: три направления обмена

Выберите направление API, подготовьте доступ, опубликуйте поток и проверьте полный цикл обмена.

↗
Приём данных и файлов через API

Настройте входную точку, проверку полей, поток Production, защиту от повторов и отслеживание доставки.

↗
Чтение и отправка во внешние API

Настройте REST-подключение: аутентификацию, разбор ответа, страницы, порционную запись и управление повторами.

↗
Выдача данных потока через API

Опубликуйте набор данных с фильтрами, страницами, проверкой актуальности или запуском по запросу.

↗
API-клиенты, ключи и подпись запросов

Предоставьте внешней системе управляемый доступ к потокам и проверьте ключ, подпись HMAC и права.

↗
Техническая документация и проверка API

Сформируйте актуальный справочник точки из её настроек, предоставьте доступ интеграторам и проверьте правила обмена.

↗

Настройка Agent

UBC Data Bridge Agent: начало работы

Подключите UBC Data Bridge к ресурсам закрытой сети, зарегистрируйте Agent и управляйте его доступом на всех этапах эксплуатации.

↗
Agent в Windows: установка и настройка

Установите службу Windows, безопасно зарегистрируйте её, предоставьте доступ к папкам, проверьте подключение и настройте обслуживание Agent.

↗
Agent в macOS: установка и настройка

Установите Agent на Mac, зарегистрируйте его, настройте права службы и сетевые тома и управляйте обновлениями.

↗
Agent в Linux: установка и настройка

Подготовьте Linux, подключите Agent к Data Bridge, предоставьте доступ к папкам и проверьте работу службы.

↗
Agent: ресурсы, права и сеть

Настройте разрешённые папки, базы данных и API, аутентификацию прокси, доверенные сертификаты и маршрут к Data Bridge.

↗
Agent: диагностика и устранение неполадок

Найдите причины сбоев Agent, проверьте сеть и права, безопасно повторите файловые операции и подготовьте полезный отчёт для поддержки.

↗

Блоки и преобразования

Справочник блоков конструктора

Блоки обработки, взаимодействия, вызова потоков, API и передачи результатов.

↗
Файл

Читает зарегистрированный файловый источник или записывает в его диапазон.

↗
Подключение

Единый блок для бизнес-систем, баз данных, файловых хранилищ и внешних API.

↗
Порядок и видимость полей

Оставляет нужные поля, меняет их порядок и названия.

↗
Разворот столбцов в строки

Преобразует широкую таблицу периодов в строки «период — значение».

↗
Сопоставление столбцов

Создаёт новую таблицу из выбранных столбцов и постоянных значений.

↗
Фильтр

Оставляет строки, соответствующие заданным условиям.

↗
Группировка

Группирует строки по ключам и рассчитывает итоговые показатели.

↗
Параметры запуска

Пользовательская форма и постоянные значения для управления выполнением.

↗
Объединение строк

Объединяет строки нескольких таблиц в один набор данных.

↗
Соединение таблиц

Добавляет поля из других таблиц по общим ключам.

↗
Удаление дублей

Оставляет нужное вхождение каждого ключа или только ключи, встречающиеся один раз.

↗
Маршрутизация

Распределяет строки между ветками по условиям, в том числе по справочникам.

↗
Разветвление

Передаёт всю таблицу в несколько веток одновременно.

↗
Вычисляемые поля

Добавляет вычисления для чисел, текста, дат и условий.

↗
Выбор файла во время выполнения

Совместимость с сохранёнными потоками, загружающими файл на этом шаге.

↗
Просмотр данных

Таблица для проверки во время выполнения и способ завершить ветку без записи.

↗
Экспорт данных

Создаёт файл Excel, CSV, TXT, JSON, XML или SQLite.

↗
Преобразование текста

Последовательная очистка и приведение текстовых полей к единому виду.

↗
Уникальный идентификатор

Добавляет GUID, Snowflake ID или порядковый номер.

↗
Форматы чисел и дат

Распознавание, нормализация и форматирование чисел и календарных значений.

↗
Очистка и контроль качества данных

Правила замены, отклонения строк и остановки при ошибках качества.

↗
Дополнение однострочной таблицей

Добавляет показатели из одной вспомогательной строки к каждой строке основной таблицы.

↗
Транспонирование строк и столбцов

Меняет местами строки и столбцы таблицы.

↗
Сообщение

Показывает уведомление или диалог при запуске с участием пользователя.

↗
Выбор варианта

Ручное решение пользователя, активирующее одну ветку.

↗
Слияние веток

Продолжает одну из выполнившихся альтернативных веток.

↗
Задать значения полей

Изменяет существующие поля и добавляет новые по условию.

↗
Электронная почта

Отправляет письма через настроенное почтовое подключение.

↗
Сообщение Telegram

Отправляет сообщения и вложения через бота.

↗
Роль и пользователь

Добавляет значения текущей роли и пользователя UBC Analytics.

↗
Справочник функций формул

Все функции описываемой версии: сигнатуры, назначение и примеры.

↗
Передача файлов

Копирование и перемещение файлов и папок между Менеджером файлов и подключёнными хранилищами.

↗
Маршрут по способу запуска

Отдельные ветки для ручного запуска, входящего API и кнопки Workspace.

↗
Вызов потоков

Запускает рабочие версии Production одного или нескольких других потоков с параметрами и данными.

↗
Получить данные из потока

Вход для подпотока или процесса, получающего таблицу из другого потока.

↗
Вызвать поток как подпоток

Повторно использует поток как функцию: входная таблица и преобразованная выходная таблица.

↗
Вернуть данные в поток

Объявленный выход, возвращаемый вызывающему блоку подпотока.

↗
Входные данные API

Блок-источник данных и файлов внешнего запроса: форматы, поля, ключи, проверка и симуляция.

↗
Публикация данных API

Завершающий ветку блок, публикующий результат потока с параметрами, фильтрами и режимом выполнения.

↗

IBM Planning Analytics

IBM Planning Analytics: возможности интеграции

Как UBC Data Bridge работает с TM1, какие объекты доступны и как выбрать сценарий интеграции.

↗
Создание и проверка подключения TM1

REST-адрес, сетевой доступ, сертификаты и пять способов аутентификации.

↗
CAM, единый вход и личная сессия пользователя

Как совместно работают вход в UBC Data Bridge, Cognos и доступ к TM1 с личными правами.

↗
Корпоративный вход и фоновые запуски

Сохранённая учётная запись для автоматических потоков, шлюз Cognos и ограничения входа.

↗
Чтение кубов и общих представлений

Настройки источника IBM, выходные столбцы, консолидации и ограничения объёма.

↗
Измерения, иерархии и атрибуты

Как выгружать справочники IBM со структурой, весами и повторными вхождениями элементов.

↗
Подмножества и параметры элементов IBM

Выбор элемента измерения в форме запуска и использование его значения в получателях.

↗
Сопоставление строк с ячейками TM1

Измерения, константы, таблицы соответствий, псевдонимы и обработка повторных координат.

↗
Запись в куб: проверки, порции и результаты

Что проверяется до записи и как обрабатывать подтверждённые или неопределённые результаты.

↗
Очистка куба и транзакционное сложение

Сложение, замена, контролируемая очистка и обновление куба по событиям сохранения формы.

↗
Процессы TurboIntegrator и автоматизация

Выбор процесса TI, параметры, симуляция, статус IBM и отличие от Chores.

↗
Кнопка запуска в IBM Planning Analytics Workspace

Подключение книги через URL: настройка Data Bridge и PAW, примеры оформления, статусы и мастер обновления отчёта.

↗

Администрирование

Пользователи, роли и права

Единая модель доступа для локального входа, OIDC, IBM CAM и UBC Analytics.

↗
Интеграция с UBC Analytics

Среды, рабочие пространства, формы, кубы и кнопки запуска.

↗
Импорт, экспорт и перенос

Как переносить потоки, источники и подключения между средами.

↗
Диагностика и частые ошибки

От сообщения об ошибке к проверке конкретного блока.

↗
Лицензирование и состояние установки

Активация, срок действия и проверка работы системы.

↗
Об этой документации

Использование документации, примеров и иллюстраций UBC Data Bridge 2.1.1.

↗

Примеры потоков

20 настроенных потоков

Практический путь от простого импорта CSV до записи в IBM Planning Analytics.

↗
01. Преобразование CSV в JSON

Прочитайте файл продаж с разделителем «точка с запятой», сохраните имена столбцов и сформируйте JSON для следующей интеграции.

↗
02. Excel: месяцы из столбцов в строки

Подготовьте широкий бюджетный шаблон Excel для загрузки в модель с измерением периода.

↗
03. JSON: извлечение массива вложенных записей

Возьмите массив data.items из JSON и создайте плоский CSV с согласованным порядком столбцов.

↗
04. XML: каталог товаров в Excel

Выберите повторяющиеся элементы XML, используйте атрибут id как код и запишите каталог в Excel.

↗
05. Нормализация кодов и удаление дублей

Приведите коды товаров к единому написанию и сохраните последнюю запись каждого кода.

↗
06. Последовательные правила качества

Исправьте пропуски и отрицательные количества, замените ошибки Excel и отклоните строки с недопустимым текстом.

↗
07. Выручка и итоги по регионам

Рассчитайте выручку каждой продажи и подготовьте сводную таблицу по регионам.

↗
08. Соединение продаж со справочником цен

Присоедините цены к продажам по числовому ключу, сохраняя строки без цены.

↗
09. Объединение данных филиалов

Объедините два набора продаж в одну таблицу по именам столбцов, даже если их порядок различается.

↗
10. Маршрутизация крупных заказов

Разделите заказы на приоритетные и обычные по сумме с отдельным файлом для каждой ветки.

↗
11. Маршрутизация по справочнику лимитов

Сравните сумму заявки с индивидуальным лимитом её подразделения, а не общей константой для всех.

↗
12. Фильтр с параметром запуска

Позвольте пользователю выбирать регион и минимальную сумму без редактирования самого потока.

↗
13. SQL: выбор открытых заказов

Прочитайте ограниченный набор записей SQL одним запросом SELECT и создайте проверочный CSV.

↗
14. SQL: добавление и обновление справочника товаров

Обновите существующий товар по ключу sku и добавьте отсутствующий в учебную таблицу SQL.

↗
15. REST API: заказы из ответа JSON

Прочитайте ресурс API, извлеките массив data.items, оставьте открытые заказы и сформируйте Excel.

↗
16. IBM Planning Analytics: выгрузка общего представления

Прочитайте общее представление куба IBM Planning Analytics и передайте в табличный отчёт.

↗
17. IBM Planning Analytics: бюджет Excel в куб

Разверните месяцы бюджетной книги и запишите четыре значения в учебный куб с явным сопоставлением каждого измерения.

↗
18. IBM Planning Analytics: запуск TurboIntegrator

Запустите один учебный процесс TI с фиксированным годом и сценарием, выбранным в мастере выполнения.

↗
19. Ручной выбор сценария и слияние веток

Позвольте оператору одобрить или отклонить набор заявок и вернуться к общему экспорту после выбранного действия.

↗
20. Уведомления об исключениях по почте и в Telegram

Найдите заказы с отрицательной суммой и отправьте краткий отчёт контрольной группе по двум каналам.

↗
Увеличенная иллюстрация