UBC DATA BRIDGE
Документація
Практичні інструкції: перший потік, ETL, API, Agent, конектори, запуск, доступ і приклади.
Перший потік
Підключення → перетворення → перевірка → запуск.
02Налаштування API
Приймання, запити, публікація та доступи.
03Налаштування Agent
Windows, macOS, Linux, ресурси й діагностика.
04Можливості конструктора
Параметри й правила кожного типу блока.
05Запуск з іншої програми
Кнопка, майстер, параметри та стани виконання.
Початок роботи
UBC Data Bridge 2.1.1: можливості для обміну даними, API, локальної мережі та керованих процесів.
↗Можливості UBC Data BridgeВід джерела даних до перевіреного результату — в одному візуальному потоці.
↗Перший потікПокроковий сценарій: завантажити таблицю, відібрати рядки та отримати файл.
↗Основні поняттяДжерело, підключення, блок, потік, чернетка та запуск — різні об’єкти системи.
↗Архітектура
Компоненти системи та їхня відповідальність — без прив’язки до мов реалізації.
↗Рушій і продуктивністьЯк система виконує граф, контролює ресурси та готує записи.
↗Варіанти розгортанняОкремий продукт або інтеграція з UBC Analytics; онлайн та автономна поставка.
↗Метадані та зберігання файлівЩо знаходиться у базі, що — у файловому сховищі, та як працює ізоляція.
↗Потоки та запуск
Як знаходити потоки, підключення та джерела, працювати з папками й блокуванням.
↗Конструктор потоківПолотно, блоки, порти, властивості та аналіз проміжного результату.
↗Чернетки та ProductionРедагування, автозбереження, симуляція та публікація робочої версії.
↗Запуск, перевірка та результатиЯк читати статуси й не створювати дублікати після збою.
↗Кнопка запуску на іншому сайтіЗапуск потоку з корпоративного порталу: призначення, підключення за посиланням, статуси та інтерактивний майстер.
↗Розклади та автоматичні завданняЗапуск за часом, інтервалом або зміною джерела.
↗Джерела й конектори
Як перетворити файл на стабільну таблицю для потоку.
↗Менеджер файлівКеровані файли, версії, папки та параметри зберігання.
↗Віддалені файлові сховищаНалаштування 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Налаштуйте вхідну точку, перевірку полів, Production-потік, ідемпотентність і відстеження доставки.
↗Читання та надсилання до зовнішніх APIНалаштуйте REST-підключення: автентифікацію, розбір відповіді, сторінки, пакетний запис і контроль повторів.
↗Видача даних потоку через APIОпублікуйте набір даних із фільтрами, сторінками, контролем актуальності або запуском на запит.
↗API-клієнти, ключі та підпис запитівНадайте зовнішній системі контрольований доступ до потоків і перевірте ключ, HMAC та права.
↗Технічна документація та перевірка APIСформуйте актуальну довідку точки з її налаштувань, передайте інтегратору доступ і перевірте контракт.
↗Налаштування Agent
Як з’єднати UBC Data Bridge з ресурсами закритої мережі, зареєструвати Agent і контролювати його доступ.
↗Agent у Windows: встановлення та налаштуванняПокрокове встановлення служби Windows, безпечна реєстрація, доступ до папок, перевірка й оновлення Agent.
↗Agent у macOS: встановлення та налаштуванняВстановлення Agent на Mac, реєстрація, права службового облікового запису, мережеві томи та контроль оновлень.
↗Agent у Linux: встановлення та налаштуванняЯк підготувати Linux, підключити Agent до Data Bridge, надати доступ до папок і перевірити роботу служби.
↗Agent: ресурси, права та мережаНалаштуйте дозволені папки, бази даних і API, проксі, сертифікати та маршрут між Agent і Data Bridge.
↗Agent: діагностика та усунення несправностейЯк знайти причину відмови Agent, перевірити мережу й дозволи, безпечно повторити операцію та підготувати дані для підтримки.
↗Блоки та перетворення
Блоки обробки, взаємодії, викликів потоків, API та доставки результатів.
↗ФайлЧитання зареєстрованого файлового джерела або запис у його діапазон.
↗ПідключенняЄдиний блок для бізнес-систем, баз даних, файлових сховищ і зовнішніх API.
↗Упорядкування та приховування полівЗалишає потрібні поля, змінює їхній порядок і назви.
↗Розгортання колонок (Unpivot)Перетворює широку таблицю періодів на рядки «період — значення».
↗Мапінг колонокБудує нову таблицю з вибраних колонок і сталих значень.
↗ФільтраціяЗалишає рядки, що відповідають заданим умовам.
↗ГрупуванняОб’єднує рядки за ключами та обчислює підсумки.
↗Параметри запускуФорма користувача та сталі значення для керування виконанням.
↗Об’єднання (Union)Додає рядки кількох таблиць в один набір.
↗З’єднання (Join)Додає поля інших таблиць за спільними ключами.
↗ДедублікаціяЗалишає потрібне входження кожного ключа або тільки неповторювані ключі.
↗МаршрутизаціяРозподіляє рядки між умовними гілками, зокрема за даними довідника.
↗РозгалужувачПередає всю таблицю одночасно в кілька гілок.
↗Розрахункові поляДодає обчислення для чисел, тексту, дат та умов.
↗Вибір файла під час виконанняСумісність зі збереженими потоками, які завантажують файл у цьому кроці.
↗Перегляд данихКонтрольна таблиця під час виконання та завершення гілки без запису.
↗Вивантаження данихСтворює файл Excel, CSV, TXT, JSON, XML або SQLite.
↗Перетворення текстуПослідовне очищення та уніфікація текстових полів.
↗Унікальний ідентифікаторДодає GUID, Snowflake або порядковий номер.
↗Формат чисел і датРозпізнавання, нормалізація та форматування чисел і календарних значень.
↗Очищення та контроль данихПравила заміни, відхилення рядків і зупинки при помилках якості.
↗Доповнення однорядковою таблицеюДодає показники одного службового рядка до кожного рядка основної таблиці.
↗Транспонування рядків і колонокМіняє місцями рядки та колонки таблиці.
↗ПовідомленняПоказує сповіщення або діалог у користувацькому виконанні.
↗Вибір варіантаРучне рішення користувача, яке активує одну гілку.
↗Злиття гілокПродовжує одну з альтернативних виконаних гілок.
↗Встановлення значень полівУмовно змінює наявні поля та додає нові.
↗Лист електронною поштоюНадсилає листи через налаштоване поштове підключення.
↗Повідомлення в TelegramНадсилає повідомлення та вкладення через бота.
↗Роль і користувачДодає актуальні значення ролі та користувача UBC Analytics.
↗Каталог функцій формулУсі функції з контракту наданої версії: сигнатури, призначення та приклади.
↗Переміщення файлівКопіювання й переміщення файлів та папок між Менеджером файлів і підключеними сховищами.
↗Маршрут за способом запускуОкремі гілки для ручного запуску, вхідного API та кнопки Workspace.
↗Виклик потоківЗапуск Production одного або кількох інших потоків із параметрами й передаванням даних.
↗Прийняти дані від потокуВхід підпотоку або процесу, якому інший потік передає таблицю.
↗Виклик потокуПовторно використовуйте потік як функцію: таблиця на вході, оброблений результат на виході.
↗Передати дані в потікОголошений вихід, результат якого повертається до блоку виклику підпотоку.
↗Вхідні дані APIБлок-джерело для даних і файлів зовнішнього запиту: формати, поля, ключі, перевірки та симуляція.
↗Видача даних APIБлок завершення гілки, який публікує результат потоку з параметрами, фільтрами та режимом запуску.
↗IBM Planning Analytics
Як UBC Data Bridge працює з TM1, які об’єкти доступні та як обрати сценарій інтеграції.
↗Створення та перевірка підключення TM1REST-адреса, мережевий доступ, сертифікат і п’ять способів автентифікації.
↗CAM, SSO та власний сеанс користувачаЯк пов’язані вхід у UBC Data Bridge, Cognos і робота в TM1 зі своїми правами.
↗Корпоративний вхід і фонові запускиЗбережений обліковий запис для автоматичних потоків, шлюз Cognos та обмеження входу.
↗Читання кубів і спільних поданьПараметри джерела IBM, структура вихідних колонок, підсумки й обмеження обсягу.
↗Виміри, ієрархії та атрибутиЯк вивантажити довідник IBM зі структурою, вагами та повторними входженнями елементів.
↗Підмножини та параметри елементів IBMВибір елемента виміру у формі запуску й використання значення в отримувачах.
↗Зіставлення рядків із комірками TM1Виміри, константи, таблиці відповідностей, псевдоніми та обробка повторних координат.
↗Запис у куб: перевірка, пакети, результатЩо перевіряється перед записом і як працювати з підтвердженим або невизначеним результатом.
↗Очищення куба та транзакційне додаванняДодавання, заміна, контрольоване очищення та зміна куба за подією збереження форми.
↗Процеси TurboIntegrator та автоматизаціяВибір TI-процесу, параметри, симуляція, статус IBM і відмінність від Chores.
↗Кнопка запуску в IBM Planning Analytics WorkspaceПідключення до книги за посиланням: налаштування Data Bridge і PAW, приклади стилю, статуси та майстер оновлення звіту.
↗Адміністрування
Єдина модель доступу для локального входу, OIDC, IBM CAM і UBC Analytics.
↗Інтеграція з UBC AnalyticsСередовища, робочі області, форми, куби та кнопки запуску.
↗Імпорт, експорт і перенесенняЯк переносити потоки, джерела та підключення між середовищами.
↗Діагностика та типові помилкиВід повідомлення про помилку до перевірки конкретного блоку.
↗Ліцензування та стан установкиАктивація, строк дії та перевірка працездатності системи.
↗Про цю документаціюЯк користуватися документацією UBC Data Bridge 2.1.1, прикладами та ілюстраціями.
↗Приклади потоків
Практичний маршрут від простого імпорту 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. Join: продажі з довідником цінПриєднати до продажів ціну за числовим ключем і зберегти рядки, для яких ціни немає.
↗09. Union: об’єднання даних філійСкласти два набори продажів в одну таблицю за назвами колонок, навіть якщо їхній порядок відрізняється.
↗10. Маршрутизація великих замовленьРозділити замовлення на пріоритетні й звичайні за сумою, з окремим файлом для кожної гілки.
↗11. Маршрутизація за довідником лімітівПорівняти суму заявки з персональним лімітом підрозділу, а не з однією константою для всіх.
↗12. Фільтр із параметром запускуДати користувачу змогу вибрати регіон і мінімальну суму без редагування самого потоку.
↗13. SQL: вибірка відкритих замовленьПрочитати обмежений набір записів SQL за одним запитом SELECT та створити контрольний CSV.
↗14. SQL: upsert довідника товарівОновити наявний товар за ключем sku і додати відсутній товар до навчальної SQL-таблиці.
↗15. REST API: замовлення з відповіді JSONПрочитати ресурс API, витягти масив data.items, залишити відкриті замовлення й сформувати Excel.
↗16. IBM Planning Analytics: експорт спільного поданняПрочитати спільне подання куба IBM Planning Analytics та передати його у табличний звіт.
↗17. IBM Planning Analytics: бюджет з Excel у кубРозгорнути місяці бюджетного Excel та записати чотири значення в навчальний куб із явним мапінгом усіх вимірів.
↗18. IBM Planning Analytics: запуск TurboIntegratorЗапустити один навчальний TI-процес із фіксованим роком і сценарієм, вибраним у майстрі виконання.
↗19. Ручний вибір сценарію та злиття гілокДати оператору вибір погодити або відхилити набір заявок і після вибраної дії повернутися до спільного експорту.
↗20. Сповіщення про винятки електронною поштою та в TelegramЗнайти замовлення з від’ємною сумою та надіслати контрольній групі стислий звіт двома каналами.
↗