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

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

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

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

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

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

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

Плагин IntelliJ IDEA для 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	Имя приложения

Например:

id: 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.