Быстрый старт

Введение.

В этой инструкции описаны шаги для быстрой установки и старта использования Entaxy.

Будет выполнена установка, настройка и проверка взаимодействия двух систем через файловый сервис.

Установка Entaxy.

Установку компактной версии можно выполнить по следующей инструкции: Установка компактной версии.

Настройка Entaxy после установки.

После установки Entaxy сразу готова к работе: в наличии различные типы коннекторов, включая файловые, а также предустановленный маршрут по умолчанию с подтверждением доставки сообщений.

  1. Для того чтобы отправить\получить сообщения необходимо создать профили, роли систем, а также входной\выходной коннекторы.

  2. Проверяем готовность системы Entaxy к работе. В браузере открываем: http://localhost:8181/system/health. При полной готовности система выдаст следующую информацию:

    system health
  3. Заходим в консоль управления. В браузере открываем: http://localhost:8181/hawtio/. Вводим username/password (по умолчанию: entaxy/entaxy).

    hawtio logo

Создаем профили систем.

  1. Переходим в раздел Профили и на вкладке Profiles нажимаем кнопку Add profile.

    ui add profile
  2. В открывшемся окне видим перечень параметров:

    profile create
    • General

      • Factory - Идентификатор используемой фабрики. Обязательный параметр с предустановленным значением System-profile;

      • System Name - Обязательный параметр назначающий уникальное имя создаваемому профилю системы; Системное имя может содержать только латинские буквы, цифры и дефис, и должно начинаться с буквы. Минимальная длина - 3 символа;

      • Display name - Отображаемое имя профиля. Необязательный параметр;

      • Description - Необязательный параметр для краткого описания.

        Подробная информация об остальных параметрах профиля.

  3. Заполняем требуемые поля:
    Вводим название для системы 1 (назовем ее, например, system1) и нажимаем кнопку Add.

    system profile name
    system profile done
  4. Повторяем те же действия для создания системы 2 (называем ее, например, system2).

Настройка взаимодействия систем через файловый сервис

Создаем коннекторы систем.

Создание входного файлового коннектора системы 1.

  1. В разделе Профили выбираем профиль системы 1 - system1 и переходим на вкладку Profile Diagram.

    В данном руководстве мы будем использовать файловые коннекторы. Для создания которых воспользуемся одним из доступных вариантов, через Диаграмму профиля с применением палитры коннекторов. Назначение конкретного коннектора осуществляется посредством перетаскивания выбранного типа коннектора в рабочую область диаграммы профиля.

  2. Для создания входного файлового коннектора выбираем направление IN, затем выбираем файловый коннектор и перетаскиваем его в область Диаграммы профиля.

    add connector diagram step1
  3. В открывшемся окне видим панель с перечнем разделов:

    add connector diagram step2
    Раздел Описание

    general

    Основные настройки конфигурации коннектора.

    redelivery policy

    Настройки для управления повторной отправкой сообщений и обработки ошибок.

    routes

    Определяет маршруты, по которым будут передаваться сообщения.

    response

    Настройки обработки и отправки ответов.

    entaxy

    Конфигурация целевой системы для интеграции.

    consumer

    Общие параметры для настройки обработки сообщений.

    advanced

    Расширенные параметры для детальной настройки обработки сообщений.

    common

    Общие настройки для всех типов конфигураций.

    consumer (advanced)

    Дополнительные параметры для настройки обработки сообщений.

    filter

    Параметры для фильтрации сообщений, поступающих на обработку.

    lock

    Параметры для управления блокировкой файлов в процессе обмена сообщениями.

    scheduler

    Настройки расписания для выполнения операций по таймеру.

    sort

    Параметры для сортировки сообщений или файлов.

  4. При создании входного коннектора в разделе entaxy необходимо указать название целевой системы, куда будут направлены данные. В данном случае вводим систему system2.

    add connector diagram step3
  5. Нажимаем кнопку Add connector.

    file conn in done
    file connector in

Создание выходного файлового коннектора системы 2.

  1. В разделе Профили выбираем профиль системы 2 - system2 и переходим на вкладку Profile Diagram.

  2. Для создания выходного файлового коннектора выбираем направление OUT, затем выбираем файловый коннектор и перетаскиваем его в область Диаграммы профиля.

    add connector diagram step4
  3. Оставляем все параметры без изменений и нажимаем кнопку Add.

    add connector diagram step5
    add connector diagram step6
    file conn out done list

Отправка и получение сообщений с использованием файловых коннекторов.

Для того чтобы запустить обмен сообщениями между системами, вы можете передать данные на входной коннектор системы источника. Затем сообщения будут доставлены в принимающую систему.

Инструкция и отправка тестовых сообщений

  1. В навигационном меню найдите раздел Ресурсы (Resources). Подробнее о ресурсах вы можете прочитать здесь.

  2. Внутри раздела Ресурсы найдите подраздел entaxy-file и перейдите на вкладку Resources.

    resources entaxy files
  3. Подготавливаем тестовое сообщение (например, создаем тестовый файл test.json)

    json text
  4. Внутри "entaxy-file" найдите папку системы 1: "system1.file-connector-in.main"

    entaxy file connector1
  5. Загрузите ваш тестовый файл "test.json" в папку "system1.file-connector-in.main"

    entaxy file json
  6. Далее, перейдите в папку "system2.file-connector-out.main". Проверьте наличие файла внутри этой папки, чтобы удостовериться, что данные успешно передались.

    entaxy file json out
  7. Проверьте папку "system1.file-connector-in.main" и убедитесь, что она теперь пуста, так как данные были успешно перенесены в систему 2.