Быстрый старт
Введение.
В этой инструкции описаны шаги для быстрой установки и старта использования Entaxy.
Будет выполнена установка, настройка и проверка взаимодействия двух систем через файловый сервис.
Установка Entaxy.
Установку компактной версии можно выполнить по следующей инструкции: Установка компактной версии.
Настройка Entaxy после установки.
После установки Entaxy сразу готова к работе: в наличии различные типы коннекторов, включая файловые, а также предустановленный маршрут по умолчанию с подтверждением доставки сообщений.
-
Для того чтобы отправить\получить сообщения необходимо создать профили, роли систем, а также входной\выходной коннекторы.
-
Проверяем готовность системы Entaxy к работе. В браузере открываем: http://localhost:8181/system/health. При полной готовности система выдаст следующую информацию:
-
Заходим в консоль управления. В браузере открываем: http://localhost:8181/hawtio/. Вводим username/password (по умолчанию: entaxy/entaxy).
Создаем профили систем.
См. также - Управление профилями в шине, Профили внешних систем.
-
Переходим в раздел
Профилии на вкладкеProfilesнажимаем кнопкуAdd profile.
-
В открывшемся окне видим перечень параметров:
-
General
-
Factory - Идентификатор используемой фабрики. Обязательный параметр с предустановленным значением
System-profile; -
System Name - Обязательный параметр назначающий уникальное имя создаваемому профилю системы; Системное имя может содержать только латинские буквы, цифры и дефис, и должно начинаться с буквы. Минимальная длина - 3 символа;
-
Display name - Отображаемое имя профиля. Необязательный параметр;
-
Description - Необязательный параметр для краткого описания.
Подробная информация об остальных параметрах профиля.
-
-
-
Заполняем требуемые поля:
Вводим название для системы 1 (назовем ее, например,system1) и нажимаем кнопкуAdd.
-
Повторяем те же действия для создания системы 2 (называем ее, например, system2).
Настройка взаимодействия систем через файловый сервис
Создаем коннекторы систем.
См. также Управление коннекторами в шине, Коннекторы.
Создание входного файлового коннектора системы 1.
-
В разделе
Профиливыбираем профиль системы 1 -system1и переходим на вкладкуProfile Diagram.В данном руководстве мы будем использовать файловые коннекторы. Для создания которых воспользуемся одним из доступных вариантов, через Диаграмму профиля с применением палитры коннекторов. Назначение конкретного коннектора осуществляется посредством перетаскивания выбранного типа коннектора в рабочую область диаграммы профиля.
-
Для создания входного файлового коннектора выбираем направление IN, затем выбираем файловый коннектор и перетаскиваем его в область Диаграммы профиля.
-
В открывшемся окне видим панель с перечнем разделов:
Раздел Описание general
Основные настройки конфигурации коннектора.
redelivery policy
Настройки для управления повторной отправкой сообщений и обработки ошибок.
routes
Определяет маршруты, по которым будут передаваться сообщения.
response
Настройки обработки и отправки ответов.
entaxy
Конфигурация целевой системы для интеграции.
consumer
Общие параметры для настройки обработки сообщений.
advanced
Расширенные параметры для детальной настройки обработки сообщений.
common
Общие настройки для всех типов конфигураций.
consumer (advanced)
Дополнительные параметры для настройки обработки сообщений.
filter
Параметры для фильтрации сообщений, поступающих на обработку.
lock
Параметры для управления блокировкой файлов в процессе обмена сообщениями.
scheduler
Настройки расписания для выполнения операций по таймеру.
sort
Параметры для сортировки сообщений или файлов.
-
При создании входного коннектора в разделе
entaxyнеобходимо указать название целевой системы, куда будут направлены данные. В данном случае вводим системуsystem2.
-
Нажимаем кнопку
Add connector.
Создание выходного файлового коннектора системы 2.
-
В разделе
Профиливыбираем профиль системы 2 -system2и переходим на вкладкуProfile Diagram. -
Для создания выходного файлового коннектора выбираем направление OUT, затем выбираем файловый коннектор и перетаскиваем его в область Диаграммы профиля.
-
Оставляем все параметры без изменений и нажимаем кнопку
Add.
Отправка и получение сообщений с использованием файловых коннекторов.
Для того чтобы запустить обмен сообщениями между системами, вы можете передать данные на входной коннектор системы источника. Затем сообщения будут доставлены в принимающую систему.
Инструкция и отправка тестовых сообщений
-
В навигационном меню найдите раздел
Ресурсы(Resources). Подробнее о ресурсах вы можете прочитать здесь. -
Внутри раздела
Ресурсынайдите подразделentaxy-fileи перейдите на вкладкуResources.
-
Подготавливаем тестовое сообщение (например, создаем тестовый файл
test.json)
-
Внутри "entaxy-file" найдите папку системы 1: "system1.file-connector-in.main"
-
Загрузите ваш тестовый файл "test.json" в папку "system1.file-connector-in.main"
-
Далее, перейдите в папку "system2.file-connector-out.main". Проверьте наличие файла внутри этой папки, чтобы удостовериться, что данные успешно передались.
-
Проверьте папку "system1.file-connector-in.main" и убедитесь, что она теперь пуста, так как данные были успешно перенесены в систему 2.