Быстрая разработка 

Citeck предоставляет инструменты для организации разработки и управления конфигурациями на любом этапе — от локального прототипирования до промышленного развёртывания.

Артефакты (типы данных, журналы, формы, бизнес-процессы и другие сущности), созданные в конструкторах платформы, можно упаковать в приложение — zip-архив с фиксированной структурой директорий. Приложение можно скачать, загрузить на другой стенд, задеплоить через Maven или закоммитить в систему контроля версий.

Если стандартных возможностей конструкторов недостаточно, можно создать отдельный микросервис на Spring Boot и реализовать в нём произвольную бизнес-логику.

На этой странице описано:

как создать и настроить приложение;
как перенести приложение между стендами;
как задеплоить приложение локально через Maven;
как сохранить приложение в системе контроля версий;
как создать микросервис.

Если вы ведёте разработку в IntelliJ IDEA, воспользуйтесь плагином для упрощённой работы с артефактами и проектами Citeck.

IntelliJ IDEA plugin for Citeck 

Плагин для IntelliJ IDEA интегрирует инструменты Citeck непосредственно в IDE: позволяет управлять артефактами, синхронизировать изменения со стендом и запускать сборку без переключения между окнами.

С чего начать 

Создайте артефакты бизнес-процесса. Например, создание процесса запроса на закупку оборудования описано в статье.

Как создать новое Citeck приложение 

Для создания приложения в рабочем пространстве администратора перейдите в раздел Управление системой, затем в пункт Приложения ECOS:

Нажмите + - Создать приложение:

Укажите Id (1), Имя (2), выберите все созданные типы данных (3) вашего процесса, измените Версию (5) при необходимости.

Для автоматической загрузки артефактов можно нажать «Загрузить артефакты для выбранных типов» (4).

Примечание

Не все типы артефактов загружаются автоматически. Дополните полученный список артефактов, нажав «Добавить»:

Сохраните.

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

Zip-архив имеет следующую структуру - все артефакты располагаются в директориях, в соответствии с их типом:

Как перенести между стендами 

Скачайте приложение:

Загрузите приложение на необходимом стенде:

Как задеплоить локально/на стенд 

Создайте локально Maven-проект с названием приложения, в папку src/main/resources/app скопируйте содержимое zip-архива:

В корне приложения разместите файл meta.yml, указав:

id: name

id: String - идентификатор приложения. По умолчанию равен artifactId проекта
name: MLText - имя приложения

Например:

ecos-assignments

Настройте главный pom файл следующим образом:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <modelVersion>4.0.0</modelVersion>

    <groupId>ru.citeck.ecos.eapps.assignments</groupId>
    <artifactId>ecos-assignments</artifactId>
    <version>1.0.0-SNAPSHOT</version>

    <parent>
        <groupId>ru.citeck.ecos.eapps.project</groupId>
        <artifactId>ecos-apps-simple-parent</artifactId>
        <version>1.0.3</version>
    </parent>

    <repositories>
        <repository>
            <id>citeck-public</id>
            <url>https://nexus.citeck.ru/repository/maven-public</url>
        </repository>
    </repositories>

</project>

Укажите в нем groupId, artifactId, version.

Создайте Jenkinsfile с содержимым:

ecosBuild()

Создайте ecos-build-config.yml с содержимым:

---
type: maven-ecos-apps

Соберите приложение командой:

mvn clean package

При сборке приложения получается zip-архив в папке target/classes/apps:

Далее загрузите созданный архив на необходимый стенд, как описано в главе выше.

Как закоммитить в систему контроля версий 

В системе контроля версий создайте репозиторий с названием приложения.

В репозиторий перенесите:

папку src со всем содержимым;

созданный pom.xml;

Jenkinsfile;

ecos-build-config.yml.

Как создать микросервис 

Если сконфигурированные в конструкторе артефакты не покрывают необходимую функциональность, можно создать отдельный микросервис — это полноценное Java-приложение на Spring Boot, в котором можно писать собственный код, использовать сторонние библиотеки и реализовывать любую бизнес-логику, выходящую за рамки стандартных возможностей платформы.

Для создания микросервиса воспользуйтесь инструкцией.

Примечание

Для микросервиса созданные артефакты необходимо скопировать в папку src/main/resources/eapps/artifacts

См. статью о приложении, демонстрирующем возможности Citeck.