Использование плагина для IntelliJ IDEA#

Расположение плагина#

Данный плагин размещен в архиве компонента EVTP:

• Разархивируйте архив EVTP-clients-[version]-distrib.zip, где <version> — версия компонента EVTP.

• В директории intellij-idea-plugin расположены плагины под поддерживаемые версии IDEA в формате zip-архива.

Установка плагина#

1. Запустите IntelliJ IDEA.

2. Перейдите в раздел Plugins:

   • для Windows и Linux: File | Settings | Plugins;

   • для macOSIntelliJ IDEA | Preferences | Plugins.

   

3. Нажмите на шестеренку и выберите Install Plugin from Disk.

   

4. Выберите файл плагина.

5. Перезагрузите IntelliJ IDEA.

Удаление плагина#

1. Запустите IntelliJ IDEA.

2. Перейдите в раздел Plugins:

   • для Windows и Linux: File | Settings | Plugins;

   • для macOS: IntelliJ IDEA | Preferences | Plugins.

   

3. Перейдите во вкладку Installed.

4. В списке выберите плагин TransformationRule.

5. Нажмите Uninstall в правой части окна.

   

6. Перезагрузите IntelliJ IDEA.

Обновление плагина#

1. Удалите плагин. Подробнее описано в подразделе «Удаление плагина».

2. Скачайте плагин. Подробнее описано в подразделе «Расположение плагина».

3. Установите плагин. Подробнее описано в подразделе «Установка плагина».

Первоначальная конфигурация плагина#

Для корректной работы плагина необходимо указать путь до консольной утилиты тестирования в настройке Event Process Flow distributive path.

1. В верхней панели перейдите в Settings... или Preferences...:

   

2. В списке выберите Event Process Flow CLI.

3. Заполните необходимые поля:

   

В поле «Event Process Flow CLI Main Class» указать значение: ru.sbt.cep.flow.event.process.CliApp.

6. Нажмите OK.

Описание полей General Configuration#

• Event Process Flow distributive path — путь до корня разархивированного дистрибутива EVTP-clients-*-distrib.zip;

• Event Process Flow JVM arguments — JVM аргументы;

• Event Process Flow Main Class — Main класс запускаемого приложения.

Проверка корректности файла трансформации#

1. Перейдите в файл трансформации (.tr).

2. Сохраните файл.

3. Нажмите кнопку run на первой строке .tr файла, выберите Run -> Check: <имя файла>.

   

4. В лог будет записан результат проверки корректности файла.

Использование Run Configuration для тестирования файлов трансформации#

Создание Run Configuration#

1. В верхней панели справа выберите Open 'Edit Run/Debug configurations dialog'.

2. В списке выберите Edit Configurations....

   

3. В верхнем левом углу нажмите Add New Configuration.

4. В списке выберите Event Process Flow.

   

5. Откроется окно создания конфигурации запуска Event Process Flow.

   

6. Нажмите OK.

Редактирование Run Configuration#

1. В верхней панели справа выберите Open 'Edit Run/Debug configurations dialog'.

2. В списке выберите Edit Configurations....

   

3. В списке слева выберите нужную конфигурацию из перечня Event Process Flow.

   

4. В выбранной конфигурации создайте/отредактируйте поля.

5. Нажмите OK.

Запуск Run Configuration#

1. В верхней панели справа выберите Open 'Edit Run/Debug configurations dialog'.

2. В списке выберите нужную конфигурацию запуска либо создайте ее.

3. В верхней панели справа нажмите Run.

   

4. В консоли должно появиться сообщение об успешном выполнение программы.

Описание полей Run Configuration#

1. Run type — тип запуска конфигурации.

2. Configuration path — путь до файла конфигурации.

3. Stub configuration path — путь до файла конфигурации заглушек для source/destination.

4. Output path — путь до файла, куда будет выведен результат.

5. Arguments — дополнительные аргументы.

6. JVM arguments — дополнительные JVM аргументы.

Прикрепление схем (XML/JSON/AVRO) к файлам трансформации#

1. Перейдите в файл трансформации (.tr).

2. В верхней панели справа выберите Add Relation Files.

3. В открытом окне для входных/выходных файлов добавьте схемы:

   • Кнопка Add — добавление файла(-ов) (поддерживается множественный выбор);

   • Кнопка Delete — удаление файла(-ов) из списка добавленных (поддерживается множественный выбор);

   • Кнопка Clear — очистка списка добавленных файлов.

Использование контекстных подсказок#

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

2. После определенного IN/OUT нажмите ..

3. Выберите один из предложенных вариантов.

4. При необходимости повторите процедуру.