После выбора архива выполняется его предварительная валидация. На этом этапе могут возникнуть ошибки:

Ошибка возникает в случае, когда в архиве присутствует файл объекта, для которого не объявлены или пусты секции, соответствующие обязательным параметрам объекта (например, есть файл реестра, для которого не указано наименование).

После предварительной проверки архива отображается дерево выбора объектов, которые необходимо импортировать:

Рисунок 3.99. Импорт объектов приложения

В этом дереве:

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

После выбора всех нужных объектов требуется выполнить проверку целостности конфигурации, которая будет получена в случае импорта. Для этого нужно нажать на кнопку «Проверить».

На этом этапе проверяется, что для всех объектов определены объекты, от которых они зависят. Возможные ошибки:

Если валидация была завершена успешно, можно вернуться к выбору импортируемых объектов для того, чтобы выбрать что-то дополнительно или, наоборот, снять выделение с объекта и снова проверить целостность приложения. Также можно начать непосредственно импорт выбранных объектов, нажав на кнопку «Импортировать».

Импорт увеличивает номер ревизии приложения, а в мониторинге будет добавлено новое событие конфигуратора «Импорт приложения».

В результате импорта могут быть изменены свойства объекта, его состояние (активный/скрытый), и могут быть добавлены новые объекты или удалены существующие:

Папки, не содержащие объектов (кроме других папок), не импортируются.

URL метода: rest/api/app/export

Тип метода: GET

Метод принимает один параметр: app_code - код экспортируемого архива.

В случае успеха возвращает архив 7z со всеми объектами приложения.

В случае ошибки возвращается json со следующими полями:

Альтернативный поток 1. Не найдено приложение с кодом <app_code>. Сервер возвращает ошибку 400 с сообщением:

   {
        "errorCode": 904, 
        "errorMessage": "Не найдено приложение <app_code>"
    }

Альтернативный поток 2. Пользователь не авторизован, или у авторизованного пользователя недостаточно прав для экспорта. Сервер возвращает ошибку 403 с сообщением:

   {
        "errorCode": 2, 
        "errorMessage": "Пользователь не авторизован, или у пользователя недостаточно прав для экспорта"
    }

Альтернативный поток 3. Экспорт приложения завершен с ошибками. Сервер возвращает ошибку 400 с сообщением:

   {
        "errorCode": 3, 
        "errorMessage": "%текст_первой_полученной_ошибки%"
    }

URL метода: rest/api/app/import

Тип метода: POST

Параметры:

Метод возвращает json со следующими полями:

Код приложения для импорта выделяется из архива data. Если экземпляр Synergy не содержит приложения с таким кодом, то в случае успешного импорта оно будет создано.

Альтернативный поток 1. Не передан параметр data. Сервер возвращает ошибку 400 с сообщением:

   {
        "errorCode": 3, 
        "errorMessage": "Не передан параметр data"
    }

Альтернативный поток 2. Передан невалидный параметр data. Сервер возвращает ошибку 400 с сообщением:

   {
        "errorCode": 3, 
        "errorMessage": "Ошибка при чтении архива data"
    }

Альтернативный поток 3. Пользователь не авторизован, или у авторизованного пользователя недостаточно прав для импорта.Сервер возвращает ошибку 403 с сообщением:

   {
        "errorCode": 2, 
        "errorMessage": "Пользователь не авторизован, или у пользователя недостаточно прав для импорта"
    }

Альтернативный поток 4. Валидация архива завершена с ошибками. Сервер возвращает ошибку 400 с сообщением:

   {
        "errorCode": 3, 
        "errorMessage": "Чтение архива произошло с ошибками"
        "messages": [
            /*логи импорта*/
        ]
    }

Альтернативный поток 5. В случае других ошибок сервер возвращает ошибку HTTP 500.