Підключення

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

Призначення

Читає або записує дані через збережене підключення. Набір доступних властивостей залежить від сервісу: IBM Planning Analytics, UBC Analytics, сховище файлів, база даних або API. Дані доступу налаштовуються в самому підключенні; у блоці вибирають об’єкт і правила обміну.

Входи та виходи

Джерело не має входів і віддає таблицю через out. Отримувач приймає in та має необов’язкові виходи success і failure. success переносить записану таблицю; failure — однорядковий опис помилки. Для процесу TurboIntegrator блок є отримувачем, який запускає процес один раз або для кожного унікального поєднання колонок параметрів.

Параметри

Параметр	Налаштування та значення	Варіанти й межі
`role`	Роль блоку: джерело читає дані, отримувач записує результат.	Варіанти: `source`, `target`
`connection_id`	Збережене підключення, через яке блок звертається до системи.	До 64 символів
`object_type`	Тип об’єкта бізнес-системи: куб, вимір або форма. Вимір IBM доступний як джерело й отримувач; вимір UBC Analytics — як джерело.	Варіанти: `cube`, `dimension`, `form` Типово: `cube`
`dimension`	Вимір, елементи якого читаються.	Типово: `порожньо` До 256 символів
`hierarchy`	Ієрархія вибраного виміру.	Типово: `порожньо` До 256 символів
`cube`	Куб читання або запису.	Типово: `порожньо` До 256 символів
`mapping`	Вбудоване зіставлення полів таблиці з вимірами та значенням куба.	Типово: `не задано`
`environment`	Середовище UBC Analytics; виберіть його до об’єкта та полів.	Типово: `порожньо` До 80 символів
`form`	Форма UBC Analytics для читання або запису.	Типово: `порожньо` До 256 символів
`read_scope`	Для форми: усі записи або запис, із якого запущено потік.	Варіанти: `all`, `launch_record` Типово: `all`
`columns`	Читати лише поля або всі доступні колонки, включно з кодами/назвами об’єкта.	Варіанти: `fields`, `all` Типово: `fields`
`write_mode`	Для форми: додати insert, оновити update або додати/оновити upsert.	Варіанти: `insert`, `update`, `upsert` Типово: `insert`
`key_field`	Ключове поле форми для пошуку запису під час update/upsert.	Типово: `порожньо` До 256 символів
`form_mapping`	Зіставлення вхідних колонок, констант, параметрів, довідникових або генерованих значень з полями форми.	Типово: `не задано`
`view`	Спільне подання куба IBM; особисті подання не підтримуються.	Типово: `порожньо` До 256 символів
`read_mode`	Читати вибране подання або куб.	Варіанти: `view`, `cube` Типово: `view`
`element_mode`	Читати всі, лише листові або лише консолідовані елементи виміру.	Варіанти: `leaf`, `consolidated`, `all` Типово: `all`
`value_column`	Поле таблиці, що містить значення показника.	Типово: `Value` До 256 символів
`file_kind`	Тип файлового сервісу для сумісних підключень.	Варіанти: `google_sheets`, `google_drive`, `onedrive`, `s3`, `ftp`, `network`, `agent_folder` Типово: `google_drive`
`selection_mode`	Читати задані комірки або іменований діапазон книги.	Варіанти: `cells`, `defined_name` Типово: `cells`
`defined_name`	Ім’я діапазону, визначене в книзі Excel.	Типово: `порожньо` До 255 символів
`defined_scope`	Область дії іменованого діапазону: книга або аркуш.	Типово: `порожньо` До 128 символів
`json_path`	Шлях до масиву записів у документі JSON.	Типово: `порожньо` До 1024 символів
`xml_path`	Шлях до елементів, які потрібно читати як рядки XML.	Типово: `./*` До 1024 символів
`file_id`	Ідентифікатор або шлях до файла у вибраному сховищі.	Типово: `порожньо` До 2048 символів
`sheet`	Назва аркуша книги.	Типово: `порожньо` До 128 символів
`range`	Діапазон комірок у записі A1, наприклад A1:F500.	Типово: `A1:M100` До 40 символів
`header`	Вважати перший рядок діапазону назвами полів.	Типово: `увімкнено`
`delimiter`	Роздільник полів текстового файла.	Варіанти: `,`, `;`, `табуляція` Типово: `;`
`clear_range`	Очистити решту налаштованого діапазону після запису; поза ним дані не змінюються.	Типово: `вимкнено`
`target_mode`	Записати дані в об’єкт або запустити процес IBM TurboIntegrator.	Варіанти: `write`, `process` Типово: `write`
`process`	Назва процесу TurboIntegrator із доступного списку.	Типово: `порожньо` До 256 символів
`process_parameters`	Параметри процесу: стале значення, параметр запуску або колонка вхідних даних.	Кількість: 0–100
`external`	Налаштування таблиці/запиту/ресурсу зовнішнього сервісу, API або бази даних.	Типово: `не задано`
`cube_write`	Поведінка запису в куб: додавання, заміна або транзакційне додавання; за потреби попереднє очищення.	Типово: `не задано`

Зіставлення та запис у куб

Параметр	Налаштування
mapping.bindings	Кожний вимір і його ієрархія; джерело column/constant/parameter, значення, Alias та таблиця відповідностей за потреби.
mapping.value_column / value_type / decimal	Поле показника, число або текст, десятковий роздільник.
mapping.blank / duplicates	skip/zero/error для порожнього; error/sum для повторної координати.
mapping.portion_cells / response_seconds	500–50 000 комірок, типово 10 000; 10–3600 секунд, типово 120.
cube_write.mode	add, replace або transaction. Транзакція використовує подію збереження форми UBC Analytics.
cube_write.clear	Увесь куб або зрізи за вибраними елементами, даними чи параметрами. З очищенням застосовується заміна.

Таблиці, API та зовнішні сервіси

Параметр	Що налаштовує
`external.object / source_mode / query`	Об’єкт читання або власний запит там, де сервіс його підтримує.
`select / filter / order_by`	Поля, умова відбору та порядок; синтаксис залежить від сервісу.
`write_mode / key_fields`	insert/update/upsert та ключові поля для підтримуваних операцій запису.
`method / query_params / body / records_path`	Для API: GET/POST/PUT/PATCH, параметри запиту, тіло та шлях до рядків у відповіді.
`pagination / next_link_path`	Без сторінок, посилання на наступну сторінку, номер сторінки або зсув. next_link_path задає шлях до посилання.
`page_param / size_param / page_size / first_page / max_pages`	Імена параметрів сторінок, розмір 1–10000, початкова сторінка 0/1 та максимум сторінок 1–10000.
`send_mode / batch_size / batch_key`	Надсилати кожен рядок або пакет; розмір пакета та ключ масиву в тілі запиту.
`value_format / value_field / ttl`	Для сумісного сховища ключ–значення: hash/json/string, поле вмісту та строк зберігання в секундах (до 31536000).
`extra_params`	Додаткові параметри підтримуваного сервісу; використовуйте лише властивості, які показує його форма.

Покрокове налаштування

Створіть і перевірте підключення в розділі «Підключення». Перетягніть його з палітри в потік.
Виберіть роль. Для бізнес-системи спочатку оберіть середовище та тип об’єкта, потім куб, вимір, форму або процес.
Для джерела задайте спосіб читання; для зовнішнього сервісу — об’єкт або запит, відбір і перелік полів. Прочитайте поля.
Для отримувача під’єднайте підготовлену таблицю. Налаштуйте зіставлення, режим запису та ключі оновлення.
Якщо потрібне продовження після запису, під’єднайте success до наступного кроку, failure — до повідомлення чи іншого обробника.
Виконайте симуляцію; перевірте адреси, кількість рядків і діапазон впливу, після чого запускайте запис.

Правила та діагностика

Можливості читання/запису визначає конкретний сервіс; наявність спільного поля конфігурації не означає підтримку всіх режимів кожним підключенням.
Куб потребує значення для кожного виміру та поля показника. Зазвичай прив’язку зберігають безпосередньо в отримувачі.
Форми UBC Analytics приймають табличне зіставлення; мапінг куба й запуск TI для них не застосовуються. Ключове поле update/upsert повинно отримувати значення із зіставлення.
У симуляції процес TI перевіряється в IBM, але не виконується. Порожнє стале значення параметра означає значення процесу за замовчуванням.
Вихід failure обробляє визначену помилку отримувача. Невизначений результат зовнішнього запису та скасування потребують окремої перевірки стану; не вважайте їх гарантовано невиконаним записом.

Приклад налаштування

Для завантаження плану оберіть підключення IBM, role=target, cube=SalesPlan. Прив’яжіть Product і Month до колонок, Version до сталої величини Budget, Measure до Amount, а value_column до Value. Виберіть replace для заміни адресованих комірок; після success покажіть повідомлення з результатом.

Запис у вимір IBM

Для отримувача виберіть «Вимір», вимір та ієрархію. У «Запис у вимір» задайте колонку основного імені елемента. Дозвольте додавання відсутніх числових листових елементів або вимкніть його для суворого контролю довідника. Для атрибута виберіть його назву, колонку значення та оновлення без очищення чи з очищенням усіх інших значень. Дублікати одного елемента повинні узгоджувати значення атрибута.

Батьківський консолідований елемент задається сталою величиною, параметром запуску чи колонкою. Для багаторівневої структури додайте пари «батьківська колонка → дочірня колонка», до 20. Відсутніх батьків можна створювати як консолідації; цикли та непридатні типи елементів відхиляються. Наявні зв’язки не видаляються. Симуляція читає й перевіряє ієрархію без зміни IBM; перед записом стан перевіряється повторно. Таблиця передається без мапінгу куба.

Поля спеціальних сценаріїв

Параметр	Використання
simulation_record / simulation_previous	Запис форми для симуляції й запис, що надає значення до збереження; використовуються лише для джерела launch_record.
dimension_write	Налаштування отримувача виміру IBM: ім’я елемента, атрибут, батьківський елемент та зв’язки ієрархії.
file_kind=agent_folder	Файл дозволеної локальної папки через UBC Agent.