Назначение
Читает или записывает данные через сохранённое подключение. Доступные свойства зависят от сервиса: 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 | Измерение, элементы которого читаются. | По умолчанию: emptyДо 256 символов |
hierarchy | Иерархия выбранного измерения. | По умолчанию: emptyДо 256 символов |
cube | Куб для чтения или записи. | По умолчанию: emptyДо 256 символов |
mapping | Встроенное сопоставление полей таблицы с измерениями куба и значением. | По умолчанию: not set |
environment | Среда UBC Analytics; выберите её до объекта и полей. | По умолчанию: emptyДо 80 символов |
form | Форма UBC Analytics для чтения или записи. | По умолчанию: emptyДо 256 символов |
read_scope | Для формы: все записи или запись, запустившая поток. | Варианты: all, launch_recordПо умолчанию: all |
columns | Читать только поля или все доступные столбцы, включая коды и названия объекта. | Варианты: fields, allПо умолчанию: fields |
write_mode | Для формы: добавление insert, обновление update или добавление/обновление upsert. | Варианты: insert, update, upsertПо умолчанию: insert |
key_field | Ключевое поле формы для поиска записи при update/upsert. | По умолчанию: emptyДо 256 символов |
form_mapping | Сопоставление входных столбцов, констант, параметров, справочных или генерируемых значений с полями формы. | По умолчанию: not set |
view | Общее представление куба IBM; личные представления не поддерживаются. | По умолчанию: emptyДо 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. | По умолчанию: emptyДо 255 символов |
defined_scope | Область именованного диапазона: книга или лист. | По умолчанию: emptyДо 128 символов |
json_path | Путь к массиву записей в документе JSON. | По умолчанию: emptyДо 1024 символов |
xml_path | Путь к элементам, читаемым как строки XML. | По умолчанию: ./*До 1024 символов |
file_id | Идентификатор или путь файла в выбранном хранилище. | По умолчанию: emptyДо 2048 символов |
sheet | Название листа книги. | По умолчанию: emptyДо 128 символов |
range | Диапазон ячеек в обозначении A1, например A1:F500. | По умолчанию: A1:M100До 40 символов |
header | Считать первую строку диапазона названиями полей. | По умолчанию: enabled |
delimiter | Разделитель полей текстового файла. | Варианты: ,, ;, tabПо умолчанию: ; |
clear_range | Очистить остаток настроенного диапазона после записи; данные вне него не изменяются. | По умолчанию: disabled |
target_mode | Записать данные в объект или запустить процесс IBM TurboIntegrator. | Варианты: write, processПо умолчанию: write |
process | Имя процесса TurboIntegrator из доступного списка. | По умолчанию: emptyДо 256 символов |
process_parameters | Параметры процесса: константа, параметр запуска или столбец входных данных. | Количество: 0–100 |
external | Настройки таблицы, запроса или ресурса внешнего сервиса, API или базы данных. | По умолчанию: not set |
cube_write | Поведение записи в куб: сложение, замена или транзакционное сложение; необязательная очистка перед записью. | По умолчанию: not set |
Сопоставление и запись в куб
| Параметр | Настройка |
|---|---|
| mapping.bindings | Каждое измерение и иерархия; источник «столбец/константа/параметр», значение, необязательный 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. Режим 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 для замены указанных ячеек; после успеха покажите сообщение с результатом.
Запись в измерение IBM
Для получателя выберите «Измерение», нужное измерение и иерархию. В «Запись в измерение» выберите столбец основного имени. Разрешите создание отсутствующих числовых конечных элементов или отключите его для строгого контроля справочников. Для обновления атрибута выберите его имя, столбец значения и режим обновления: без очистки или с предварительной очисткой остальных значений. Строки-дубли одного элемента должны содержать одинаковое значение атрибута.
Консолидированный родитель может поступать из константы, параметра запуска или столбца. Для многоуровневой структуры добавьте до 20 пар «столбец родителя → столбец потомка». Отсутствующие родители могут создаваться как консолидации; циклы и неподходящие типы элементов отклоняются. Существующие связи не удаляются. Симуляция читает и проверяет иерархию без изменения IBM; перед записью состояние проверяется повторно. Передавайте таблицу без сопоставления куба.
Поля для специальных сценариев
| Параметр | Используйте |
|---|---|
| simulation_record / simulation_previous | Запись формы для симуляции и запись, предоставляющая значения до сохранения; только для источника launch_record. |
| dimension_write | Настройки измерения IBM как получателя: имя элемента, атрибут, родитель и иерархические связи. |
| file_kind=agent_folder | Файл в разрешённой локальной папке через UBC Agent. |