Импорт конфигурационных пакетов

Импорт конфигурационного пакета и его установка включают следующие этапы:

Загрузка конфигурационного пакета на целевой экземпляр.
Подготовка конфигурационного пакета.
Устранение коллизий (если есть).
Применение изменений из конфигурационного пакета.

Результат внедрения зависит от политики защиты записей VCS в локальном пакете и на целевом экземпляре.

Загрузка конфигурационного пакета на целевой экземпляр

Перед импортом записей для пользовательского приложения, убедитесь, что соответствующее приложение уже существует в целевом экземпляре или что локальный пакет содержит запись VCS приложения.

Если на целевом экземпляре нет соответствующего пользовательского приложения, добавьте его в импортируемый конфигурационный пакет, выполнив следующие шаги:

Перейдите в Конфигурация → Приложения.
Найдите необходимое приложение, используйте поиск по списку или конструктор условий и откройте его запись.
В области Связанные списки откройте вкладку Записи VCS.
Во вкладке Записи VCS, откройте актуальную запись (Актуальная = true).
На форме Записи VCS выберите необходимый локальный пакет в поле Локальный пакет.
Нажмите Сохранить или Сохранить и выйти.

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

Перейдите в Конфигурация → Импортированные пакеты.
Нажмите Создать, чтобы создать новый конфигурационный пакет.
Нажмите на иконку вложений , чтобы загрузить SOP–файл.
При добавлении нескольких SOP-файлов к импортированному пакету будут импортированы только записи из последнего файла. Прикрепленные ранее пакеты будут игнорироваться.
Если во время загрузки был выбран неверный SOP–файл, выполните следующие шаги, чтобы перезагрузить файл в тот же импортированный пакет.
Нажмите на иконку вложений .
Нажмите Загрузите с компьютера и выберите файл на вашем устройстве.
Нажмите Загрузить повторно.
В результате:
Список во вкладке Журнал просмотра VCS больше не содержит ранее загруженные записи.
Все записи из файла загружены.
Нажмите Импортировать обновления, чтобы завершить импорт.
Нажмите Сохранить, чтобы применить изменения.
Нажмите Загрузить пакет, для загрузки записей из приложенного SOP–файла во временную таблицу Извлеченные записи.

Записи Импортированного пакета невозможно редактировать и они доступны для чтения только пользователям с ролью администратора. Они также могут удалить их, если запись Импортированного пакета не находится в состоянии Применен.

Поля формы Импортированный пакет

Поле	Обязательное	Описание
Наименование	Нет	Название импортированного пакета. Это поле заполняется автоматически и соответствует названию вложенного SOP–файла.
Статус	Да	Статус текущего конфигурационного пакета. Возможные значения: Новый Подготовлен Загружен Применен
Создано	Нет	Количество записей в пакете с действием Создание.
Обновлено	Нет	Количество записей в пакете с действием Обновление.
Удалено	Нет	Количество записей в пакете с действием Удаление.
Предупреждений	Нет	Количество записей в Журнале просмотра VCS в статусе Предупреждение.
Пропущено	Нет	Количество записей в Журнале просмотра VCS в статусе Пропущено.
Коллизий	Нет	Количество записей в Журнале просмотра VCS в статусе Коллизия.
Всего	Нет	Общее количество записей.
Описание	Нет	Описание импортированного пакета, взятое из названия вложенного SOP-файла.
Применен в	Нет	Дата и время применения настроек конфигурационного пакета (переведен в статус Применен).
Загружен в	Нет	Дата и время загрузки пакета на экземпляр.

В результате:

Текущая запись импортированного пакета содержит прикрепленный SOP–файл.
Автоматически заполненные поля: Создано, Обновлено, Удалено, Предупреждений, Пропущено, Коллизий.
Статус импортированного пакета установлен как Подготовлен.
В связанном списке отображаются записи VCS из этого пакета.

Подготовка конфигурационного пакета

Таблица Извлеченные записи (sys_vcs_retrieved_record) содержит записи того конфигурационного пакета, который будет импортирован. Извлеченные записи являются временными элементами. В Журнале просмотра VCS отображается информация, вызывает ли запись коллизию.

Невозможно создавать записи в таблице Извлеченные записи (sys_retrieved_record). Только пользователи с ролью администратора могут просматривать и удалять записи в этой таблице, а также редактировать поле Копия записи (JSON).

Когда SOP-файл загружен, вы можете проверить, какие записи будут перенесены на ваш экземпляр. Во вкладке Импортированные записи содержатся все записи, загруженные из конфигурационного пакета.

Для предварительного просмотра конфигурационного пакета выполните следующие шаги:

Убедитесь, что статус импортированного пакета установлен как Подготовлен.
Прокрутите страницу вниз до области Связанные списки.

Нажмите на вкладку Импортированные записи.

Поля формы Извлеченные записи

Поле	Описание
Наименование таблицы	Наименование целевой системной таблицы, для которой создана данная версия записи.
Запись	ID целевой записи, для которой создана данная версия.
Кем создано	Имя пользователя, который создал первую версию записи.
Копия записи (JSON)	Версия записи в формате JSON.
Игнорировать флаг Protected	Если флажок установлен, то текущая запись будет перезаписана поверх существующей версии после импорта.
Действие	Доступные типы действий: Создание Обновление Удаление
Импортированный пакет	Ссылка на импортированный пакет, который содержит эту версию записи.

Журнал просмотра VCS

После загрузки SOP–файла в запись импортируемого пакета некоторые записи VCS могут провоцировать ошибки. Например, в случае, если записи в таблице на целевом экземпляре имеют другой набор колонок.

Невозможно создавать записи в таблице Журнал просмотра VCS (sys_vcs_preview_log). Только пользователи с ролью администратора могут просматривать и удалять записи в этой таблице, а также редактировать поле Статус.

Для проверки возможных коллизий выполните следующие шаги:

Откройте запись необходимого импортированного пакета.
В области Связанные списки откройте вкладку Журнал просмотра VCS.
Исключите из списка записи со статусом Норма.

Если в списке остались записи, решите проблемы, которые с ними связаны. При необходимости повторите поиск еще раз до тех пор, пока статус всех записей в Журнале просмотра VCS не сменится на Норма.

Если в пакете содержатся записи, которые не должны быть импортированы, выберите Пропущен в поле Статус.

Поля формы Журнал просмотра VCS

Поле	Описание
Локальный пакет	Название локального пакета, в котором содержится запись.
Импортированный пакет	Название конфигурационного пакета, в котором содержится запись.
Запись документа	Данный ID содержит информацию о названии таблицы и ID целевой записи, для которой создана данная версия.
Политика защиты	Этот атрибут определяет политику защиты записей. Больше информации в статье Конфигурационные пакеты. Возможные варианты: Открыта Изменена Защищена
Статус	Статус записи в журнале просмотра. Возможные статусы: Норма – запись VCS не вызовет конфликтов при импорте. Пропущено – запись VCS будет пропущена при импорте конфигурационного пакета. Предупреждение – зависимости от ошибки запись VCS будет либо перенесена на целевой экземпляр, либо пропущена. Коллизия – версия VCS с таким статусом не может быть импортирована из-за критических конфликтов в системе. Разрешено – этот статус аналогичен статусу Норма и присваивается версии после произведения отката.
Действие	Тип действия, при котором была создана запись VCS: Создание Обновление Удаление Если на целевом экземпляре отсутствует запись, которая была обновлена, то она будет импортирована в него со статусом Создана.
Наименование таблицы	Системное наименование целевой таблицы.
Запись	ID целевой записи, к которой было применено действие.
Копия записи (JSON)	Данные версии записи в формате JSON в виде ассоциативного массива. Этот массив хранит объект целевой записи в актуальном статусе. Копия записи (JSON) содержит массив действий Обновление и Создание. Если было произведено Удаление, поле Копия записи (JSON) будет пустым.
Сообщение	Текст ошибки, который отображается в случае коллизии. Поле заполняется, если запись имеет один из следующих статусов: Предупреждение, Пропущено или Коллизия.

Установка конфигурационного пакета

Чтобы применить настройки конфигурационного пакета на целевом экземпляре, выполните следующий действия:

Внимательно проверьте статусы записей в связанном списке Журнал просмотра VCS.
- записи со статусами Норма и Предупреждение будут импортированы.
- записи со статусами Коллизия и Пропущено будут проигнорированы системой.
Нажмите Импортировать обновления.

В результате импорта:

На целевом экземпляре создана новая запись локального пакета.
Записи VCS со статусами Норма или Предупреждение будут скопированы из импортированного пакета в созданный локальный пакет.
Все записи в этом локальном пакете отмечены как Актуальные.
Все записи в этом локальном пакете созданы на целевом экземпляре в соответствующих таблицах.
Временные записи из таблицы Извлеченные записи удалены (связанный список на форме Импортированный пакет).
Статус записи Импортированного пакета изменился на Применен.
Дата и время этой операции отображены в поле Применен в на форме импортированного пакета.

Обновление платформы

При обновлении версии платформы SimpleOne система создает мгновенный снимок записей, созданных во время миграции обновления. Эти записи хранятся в отдельном локальном пакете. Его поля заполняются автоматически:

Поле	Значение
Название	Приложение Simple {версия платформы} (Миграция) {версия платформы} соответствует номеру версии, например 1.8.0
Описание	Задается системой
Кем завершен	Пользователь системы
Приложение	Simple
Статус	Завершено

Page tree