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

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

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

Примечание

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

  • IntelliJ IDEA - 2022.2.5.

  • Citeck - 4.2

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

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

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

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

Для обновления скачайте последнюю версию дистрибутива плагина из release page

Удалите старую версию из Settings -> Plugins и установите последнюю версию плагина Settings -> Plugins -> Install Plugin from disk

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

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

File -> New project

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

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

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


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

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

    ../_images/058.png

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

    ../_images/069.png

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

    ../_images/079.png

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

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

    ../_images/089.png

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

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

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

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

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

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

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

    ../_images/08_1.png

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

../_images/098.png

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

../_images/108.png

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

    1. Формы ECOS:

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

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

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

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

    • Типы данных (быстрый переход к атрибутам, ролям, статусам и т.д.)

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

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

    • Формы - проверка уникальности ключей компонентов форм с учетом областей (container, datagrid).

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

../_images/146.png

  1. Генерация компонентов формы:

Если в форме задан typeRef

../_images/comp_gen_01.png

то доступна генерация компонентов по атрибутам указанного в typeRef типа данных.


../_images/comp_gen_05.png

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

../_images/156.png

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

../_images/166.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 с пересобранным плагином.