Плагин для IntelliJ IDEA для работы с платформой ECOS

Разработан плагин для IntelliJ IDEA, ускоряющий работу с проектами и артефактами ECOS. Плагин доступен для Community и Ultimate версий IntelliJ IDEA

Исходный код плагина доступен по ссылке: ecos-idea-plugin

Примечание

Минимально необходимые версии:

  • IntelliJ IDEA - 2022.2.5.

  • ECOS - 4.2

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

Скачать дистрибутив плагина можно из release page или собрать из исходников самостоятельно.

Далее установить плагин в IDEA: Settings -> Plugins -> Install Plugin from disk

Функционал плагина

  1. Создание новых проектов ECOS (приложение, микросервис).

File -> New project

Доступен пункт ECOS и варианты создания приложения/ микросервиса:


../_images/017.png

../_images/027.png

Создается проект со соответствующей структурой:

Приложение
Микросервис

../_images/036.png

../_images/045.png

  1. Создание артефактов по шаблону.

    По правой кнопке в контекстном меню доступен пункт ECOS Artifact:

    ../_images/055.png

    Вводим название, выбираем тип данных:

    ../_images/066.png

    артефакт генерируется в соответствии с шаблоном:

    ../_images/076.png

  2. Загрузка/выгрузка артефактов на/с локального сервера (формы ECOS, журналы, дашборды, процессы).

    Для артефакта доступны следующие действия:

    ../_images/086.png

    • Deploy File - выгрузка артефакта на сервер.

    • Fetch File - загрузка артефакта с сервера

    • Open In Browser- просмотр артефакта в браузере

    • Open Documentation - переход на страницу с документацией по артефакту

    Выгрузите артефакт по кнопке Deploy File на стенд или локально:


    ../_images/deploy_a.png

    ../_images/select_server.png

    Откройте артефакт (например, форму) по кнопке Open In Browser в no-code редакторе на стенде или локально, отредактируйте:


    ../_images/form_1.png

    ../_images/form_2.png

    Загрузите измененный артефакт обратно по кнопке Fetch File:

    ../_images/08_1.png

  3. Поиск артефактов по их идентификаторам (расширение для search everywhere):

../_images/095.png

  1. Навигация в коде по артефактам ECOS через гиперссылки:

../_images/105.png

  1. Автодополнение кода JavaScript (IDEA Ultimate):

    1. Формы ECOS:

      • Автодополнение объекта data списком компонент формы.


../_images/115.png

../_images/125.png

  1. Навигация в файлах:

    • Формы (быстрый переход к компонентам по их имени);

    • Журналы (навигация по колонкам);

Пока доступно только для формата json.

../_images/135.png

  1. Инспекции кода:

    • Формы - проверка задвоений ключей компонентов.

Пока доступно только для формата json.

../_images/145.png

  1. Расширения областей поиска файлами, содержащими артефакты ECOS:

../_images/155.png

  1. Language Injection (JavaScript) в формах ECOS:

../_images/165.png

  1. Деплой проекта ECOS

Деплой проекта возможен из meta.yml по нажатию на Deploy File:

../_images/deploy_app_1.png

Далее можно нажать Open In Browser, чтобы посмотреть и отредактировать приложение в ECOS:

../_images/app.png

Так же деплоить можно из контекстного меню, выбрав ECOS-Deploy Application:

../_images/deploy_app_2.png

Конфигурация серверов

Настройка серверов ECOS: Settings -> ECOS Settings -> Servers

Примеры настройки:

../_images/server_settings.png

Для локального стенда используется метод basic.

Для метода OAuth2:

  • Grant Type - client_credentials

  • Client ID и Client Secret можно получить в соответствии с инструкцией

Сборка дистрибутива плагина

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

    Настроить используемую JVM для Gradle в IDEA можно по следующему пути: Settings -> Build, Execution, Deployment -> Build Tools -> Gradle -> Gradle JVM

  2. Сборка осуществляется Gradle задачей buildPlugin.

  3. Собранный дистрибутив будет расположен по следующему пути: build/distributions/

Разработка

Для разработки плагина можно использовать Gradle задачу runIde.

При выполнении задачи будет запущен новый экземпляр IDEA с пересобранным плагином.