Создание графов
Граф OneBridge — это наименьшая исполняемая единица рабочего процесса. В графе описан процесс преобразования данных.
После создания проекта вы можете создать новый граф, выбрав в контекстном меню проекта New grf file.
Задайте имя графа в открывшемся диалоговом окне. Граф будет помещен в выбранный проект. Расширение .grf будет добавлено к заданному имени автоматически. Затем в панели Project structure появится файл new-graph.grf. Он автоматически откроется в рабочей области сразу после создания.
После создания файл открывается в рабочей области
В верхнем меню во вкладке View можно настроить отображение сетки (Grid), прилипание (Sticking) и отображение метаданных на ребрах (Show metadata).
Настройка отображения вспомогательных элементов
Далее в этой главе описываются следующие темы:
Размещение компонентов
Чтобы создать граф для обработки данных, нужно наполнить граф компонентами. Все доступные к использованию компоненты находятся на правой панели Компоненты.
Найдите FlatFileReader среди Readers. Перетащите его из списка компонентов в Рабочую область.
Размещение первого компонента в Рабочей области
Сделайте то же самое с FlatFileWriter из Writers. Поместите их по порядку, слева направо.
Размещение компонента для записи
Добавление заметок
Еще одним видом компонентов являются заметки - в них можно записать дополнительную информацию к графу, например, обьяснить логику работы сложного графа. Заметка всегда располагается под шагами и может служить контейнером для них. Чтобы закрепить шаг на заметке, атрибуту parent присваивается значение guiName шага - parent="Note0". Во вкладке Ui на шаге появится значок замка, это значит, что данный шаг закреплен к заметке.
Компонент "Заметка" можно найти на панели компонентов. Перетащив заметку на рабочую область можно задать ей размер, потянув за правый нижний угол.
Добавление заметки к графу
Дважды кликните на область заметки, чтобы открыть редактор текста заметки. Атрибуты заметки настраиваются в редакторе на вкладке Attributes.
Редактирование текста заметки
Изменение атрибутов заметки
Когда граф и все входные данные для него готовы, можно запустить его в работу. Запуск и выполнение подробно описаны в следующей главе - "Выполнение заданий".
Редактор шагов
Настройка шага в Редакторе
Соединение компонентов рёбрами
Теперь нужно соединить компоненты ребром. Для этого есть два способа:
- Можно нажать на выходной порт FlatFileReader, появится незакреплённое ребро. Перетащите свободный конец ребра на входной порт FlatFileWriter.
- Быстрое соединение - зажать курсором выходной порт первого шага и протянуть, не отпуская, до входного порта второга шага.
Соединение компонентов ребром
Ребро по-прежнему красного цвета, поскольку ему не назначены метаданные. Чуть ниже описано создание и присвоение метаданных ребру.
Структура задания
Все компоненты, используемые в текущем графе, отображаются на панели Структура задания.
Щелкнув по имени компонента вы перейдёте в редактор выбранного шага.
Список компонентов задания текущего графа
Создание и присвоение метаданных ребру
Чтобы передавать данные между компонентами графа, необходимо задать метаданные и присвоить их рёбрам графа. Это возможно несколькими способами:
- На панели Outline выберите
Metadata -> New Metadata, откроется редактор метаданных.
Здесь нужно задать имя метаданных и разделитель записей. Чуть ниже определить имена, типы и разделитель полей.
Кнопкой + создайте новую запись и укажите ее атрибуты. Сохраните изменения кнопкой Save.
Создание метаданных
Чтобы назначить созданные метаданные ребру графа, двойным кликом откройте редактор ребра.
- Выберите из выпадающего списка нужное имя метаданных, сохраните изменения ребра.
- Ещё можно зажать одновременно Shift + имя созданной метадаты на панели OutLine, перенести на нужное ребро и отпустить.
Назначение метаданных
Метаданные назначены
- На панели Outline щелкните правой кнопкой мыши по Metadata -> Link metadata, чтобы подключить файл с описанием метаданных.
Подключение файла метаданных
- Скопируйте нужные вам метаданные и вставьте их через контекстное меню.
Метаданные можно копировать - в панели Outline откройте контекстное меню нужной метадаты -> Copy metadata.
В графе, в котрый метадату нужно в ставить, в панели Outline откройте контекстное меню блока Metadata -> Paste metadata.
Если после копирования в графе стало две метадаты с одинаковым именем и это нужно исправить - смените одно из имён в редаторе метаданных.
Назначение параметров
Иногда бывает удобно создать параметр, чтобы переиспользовать его в нескольких местах. Это возможно двумя способами:
- Чтобы создать параметр, перейдите в редактор параметров
Parameters -> Editor.
Создание параметров
Созданный параметр можно указать используя синтаксис ${parametr_name}.
Использование параметра
- На панели Outline щелкните правой кнопкой мыши по Parameters -> Link parameters, чтобы подключить файл с описанием параметров.
Подключение файла параметров
Установка соединения с базой данных
Для корректной работы некоторых шагов нужно создать подключение к базе данных. Это возможно двумя способами:
- На панели Outline щелкните правой кнопкой мыши по Connections -> New connection, чтобы создать новое внутреннее соединение с базой.
Для создания соединения выберите один из доступных драйверов и заполните атрибут URL по приведённому шаблону.
Создание соединения
- На панели Outline щелкните правой кнопкой мыши по Connections -> Link connection, чтобы подключить файл, содержащий конфигурацию соединения с нужной базой данных. Заполните атрибут
dbConfig, указав путь к файлу с параметрами соединения.
Подключение файла соединения
Добавление словаря
В словаре можно хранить данные в рамках запуска графа и передавать данные между всеми компонентами этого графа.
Чтобы создать запись словаря, нужно открыть редактор словаря на панели Outline: Dictionary -> Edit dictionary.
Создание словаря
В редакторе нужно внести имя записи словаря и выбрать его тип. Можно задать значение по-умолчанию.
Редактор словаря
