Создание графов
Граф OneBridge — это наименьшая исполняемая единица рабочего процесса. В графе описан процесс преобразования данных.
После создания проекта вы можете создать новый граф, выбрав в контекстном меню проекта New grf file.
Действия с проектом на панели Project structure
Задайте имя графа в открывшемся диалоговом окне. Граф будет помещен в выбранный проект. Расширение .grf будет добавлено к заданному имени автоматически. Затем в панели Project structure появится файл new-graph.grf. Он автоматически откроется в рабочей области сразу после создания.
После создания файл открывается в рабочей области
В верхнем меню во вкладке View можно настроить отображение сетки (Grid), прилипание (Sticking) и отображение метаданных на ребрах (Show metadata).
Настройка отображения вспомогательных элементов
Далее в этой главе описываются следующие темы:
- Размещение компонентов
- Редактор шагов
- Соединение компонентов рёбрами
- Структура графа
Размещение компонентов
Чтобы создать граф для обработки данных, нужно наполнить граф компонентами. Все доступные к использованию компоненты находятся на правой панели Компоненты.
Найдите шаг FlatFileReader среди шагов группы Readers. Перетащите его из списка компонентов в Рабочую область.
Размещение первого компонента в Рабочей области
Сделайте то же самое с FlatFileWriter из группы Writers. Поместите их в ряд, слева направо.
Размещение компонента для записи
Перемещение нескольких компонентов
Для того чтобы переместить компонент, нужно захватить его курсором и перетянуть в нужное место, затем отпустить. Для перетаскивания нескольких компонентов нужно сначала выделить их, затем перетаскивать все вместе.
Для множественного выделения нужно зажать CTRL и затем прокликать все компоненты, которые нужно выделить. Либо зажать CTRL и курсором нарисовать прямоугольник вокруг нужных компонентов.
Выделенные компоненты получают жирную чёрную рамку. Рёбра всегда выделяются вместе с шагом, из которого выходят.
Чтобы сбросить выделение, зажмите CTRL и кликните на пустом пространстве Рабочей области.
Добавление заметок
Еще одним видом компонентов являются заметки - в них можно записать дополнительную информацию к графу, например, объяснить логику работы сложного графа. Заметка всегда располагается под шагами и может служить контейнером для них. Чтобы закрепить шаг на заметке, атрибуту шага parent присваивается значение id заметки - parent="Note0". В рабочей области во вкладке Ui в правом верхнем углу шага появится значок замка, это значит, что данный шаг закреплен на заметке.
Компонент Note (заметка) можно найти на панели компонентов в группе Others. Перетащив заметку на рабочую область можно задать ей размер, потянув за правый нижний угол.
Добавление заметки к графу
Дважды кликните на область заметки, чтобы открыть редактор текста заметки. Атрибуты заметки настраиваются в редакторе на вкладке Attributes.
Редактирование текста заметки
Изменение атрибутов заметки
Когда граф и все входные данные для него готовы, можно запустить его в работу. Запуск и выполнение подробно описаны в следующей главе - "Выполнение графов".
Редактор шагов
Для того чтобы настроить или изменить значения атрибутов шага, используйте Редактор шага. Его можно открыть дважды кликнув по пустому пространству на поверхности шага. Чтобы сохранить изменения значений атрибутов, нажмите Save. Для отмены всех внесённых изменений - Cancel.
Настройка шага в Редакторе
Соединение компонентов рёбрами
Теперь нужно соединить компоненты ребром. Для этого есть два способа:
- Можно нажать на выходной порт FlatFileReader, появится ребро красного цвета с незакреплённым концом. Перетащите свободный конец ребра на входной порт FlatFileWriter.
- Быстрое соединение - зажать курсором выходной порт первого шага и протянуть, не отпуская, до входного порта второго шага.
Соединение компонентов ребром
Ребро по-прежнему красного цвета, поскольку ему не назначены метаданные. Чуть ниже описано создание и присвоение метаданных ребру.
Структура графа
Все компоненты, используемые в текущем графе, отображаются на панели Outline.
Щелкнув по имени компонента вы перейдёте в редактор выбранного шага.
Список компонентов текущего графа
Создание и присвоение метаданных ребру
Чтобы передавать данные между компонентами графа, необходимо задать метаданные и присвоить их рёбрам графа. Метаданные в графе можно задать тремя способами:
- Создать через редактор метаданных.
- Подключить файл с внешними метаданными.
- Скопировать метаданные из другого графа и вставить в текущий.
1) Создание метаданных в редакторе метаданных
На панели Outline откройте контекстное меню группы Metadata -> New Metadata, откроется редактор метаданных.
Здесь можно задать имя метаданных и разделитель записей. Чуть ниже определить имена, типы и разделитель полей.
Кнопкой + создайте новую запись и укажите ее атрибуты. Сохраните изменения кнопкой Save.
Создание метаданных
2) Подключение файла с внешними метаданными
Для подключения внешних метаданных нужно указать ссылку на файл, в котором они описаны. На панели Outline в контекстном меню группы Metadata выберите Link metadata. В поле fileURL укажите путь к файлу с описанием метаданных.
Подключение файла метаданных
3) Копирование метаданных из другого графа
Метаданные можно копировать из графа в граф. Для этого в панели Outline откройте контекстное меню нужных метаданных -> Copy metadata.
В графе, в который метаданные нужно вставить, в панели Outline откройте контекстное меню блока Metadata -> Paste metadata.
При попытке вставить метаданные с именем, аналогичным тому, что уже есть в графе - они будут вставлены с постфиксом "Copy + номер копии".
Назначение метаданных ребру
Назначить созданные метаданные ребру графа возможно несколькими способами:
- В контекстном меню ребра выберите пункт Edit, откроется редактор ребра. Для атрибута
Metadataвыберите из выпадающего списка нужное имя метаданных, сохраните изменения кнопкой Save. - Перетащить на ребро нужные метаданные с панели Outline методом drag-and-drop.
Назначение метаданных
Метаданные назначены
Назначение параметров
Иногда бывает удобно создать константу, чтобы переиспользовать её в нескольких местах внутри графа. Параметры можно создать в графе либо указать ссылку на файл с описанием параметров.
Создать параметры
Чтобы создать параметр, перейдите в редактор параметров из панели Outline: Parameters -> Edit parameters.
Создание параметров
Созданный параметр можно указать используя синтаксис ${parametr_name}.
Использование параметра
Добавить ссылку на файл параметров
Чтобы добавить в граф ссылку на файл с описанием параметров, откройте редактор ссылок параметров из панели Outline: Parameters -> Link parameters. Вставьте путь к файлу параметров в поле fileURL.
Подключение файла параметров
Установка соединения с базой данных
Для корректной работы некоторых шагов нужно создать подключение к базе данных. Возможно описать соединение в графе либо привязать ссылку на отдельный файл с описанием соединения.
Создать подключение
На панели Outline щелкните правой кнопкой мыши по Connections -> New connection, чтобы создать новое внутреннее соединение с базой.
Для создания соединения выберите один из доступных драйверов и заполните атрибут URL по приведённому шаблону. Для подключения через ODBC используйте строку подключения, начинающуюся с odbc:..., добавив имя драйвера и остальные стандартные настройки подключения к выбранной базе.
Создание соединения
Добавить ссылку на файл подключения
На панели Outline щелкните правой кнопкой мыши по Connections -> Link connection, чтобы подключить файл, содержащий конфигурацию соединения с нужной базой данных. Заполните атрибут dbConfig, указав путь к файлу с параметрами соединения.
Подключение файла соединения
Добавление словаря
В словаре можно хранить данные в рамках запуска графа и передавать данные между всеми компонентами этого графа.
Чтобы создать запись словаря, нужно открыть редактор словаря на панели Outline: Dictionary -> Edit dictionary.
Создание словаря
В редакторе нужно внести имя записи словаря и выбрать его тип. Можно задать значение по-умолчанию.
Редактор словаря
Добавление хэш-таблицы
Чтобы добавить хэш-таблицу, воспользуйтесь редактором хэш-таблиц. Чтобы открыть редактор, в контекстном меню группы Lookup Table на панели Outline выберите Edit lookup table. Для создания хэш-таблицы обязательно заполнить поля Name, Key, Metadata. Если заполнить поле File, будет создан файл, в который данные таблицы будут сохранены. Иначе таблица будет существовать в памяти только на время работы графа.
Меню хэш-таблиц
Редактор хэш-таблиц
Редактор ссылок на хэш-таблицы
