Перейти к основному содержимому
Версия: 1.21.3

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

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

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

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

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

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

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

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

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

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

  1. Перейдите в Конфигурация → Импортированные пакеты.

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

  3. Нажмите на иконку вложений , чтобы загрузить SOP–файл.

    примечание

    При добавлении нескольких SOP-файлов к импортированному пакету будут импортированы только записи из последнего файла. Прикрепленные ранее пакеты будут игнорироваться.

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

    1. Нажмите на иконку вложений .
    2. Нажмите Загрузите с компьютера и выберите файл на вашем устройстве.
    3. Нажмите Загрузить повторно. В результате:
      • Список во вкладке Журнал просмотра VCS больше не содержит ранее загруженные записи.
      • Все записи из файла загружены.
    4. Нажмите Импортировать обновления, чтобы завершить импорт.

  4. Нажмите Сохранить, чтобы применить изменения.

  5. Нажмите Загрузить пакет, для загрузки записей из приложенного SOP–файла во временную таблицу Извлеченные записи.

внимание

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

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

ПолеОбязательноеОписание
НаименованиеНетНазвание импортированного пакета. Это поле заполняется автоматически и соответствует названию вложенного SOP–файла.
СтатусДа

Статус текущего конфигурационного пакета. Возможные значения:

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

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

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

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

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

примечание

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

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

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

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

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

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

Доступные типы действий:

  • Создание
  • Обновление
  • Удаление
Импортированный пакетСсылка на импортированный пакет, который содержит эту версию записи.

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

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

внимание

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

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

  1. Откройте запись необходимого импортированного пакета.
  2. В области Связанные списки откройте вкладку Журнал просмотра VCS.
  3. Исключите из списка записи со статусом Норма, используя конструктор условий.
  4. Если в списке остались записи, решите проблемы, которые с ними связаны. При необходимости повторите поиск еще раз до тех пор, пока статус всех записей в Журнале просмотра VCS не сменится на Норма.
подсказка

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

Поля формы Журнал просмотра VCS
ПолеОписание
Локальный пакетНазвание локального пакета, в котором содержится запись.
Импортированный пакетНазвание конфигурационного пакета, в котором содержится запись.
Запись документаДанный ID содержит информацию о названии таблицы и ID целевой записи, для которой создана данная версия.
Политика защиты

Этот атрибут определяет политику защиты записей. Больше информации в статье Конфигурационные пакеты.

Возможные варианты:

  • Открыта
  • Изменена
  • Защищена
Статус

Статус записи в журнале просмотра. Возможные статусы:

  • Норма – запись VCS не вызовет конфликтов при импорте.
  • Пропущено – запись VCS будет пропущена при импорте конфигурационного пакета.
  • Предупреждение – в зависимости от ошибки запись VCS будет либо перенесена на целевой экземпляр, либо пропущена.
  • Коллизия – версия VCS с таким статусом не может быть импортирована из-за критических конфликтов в системе.
  • Разрешено – этот статус аналогичен статусу Норма и присваивается версии после произведения отката.
Действие

Тип действия, при котором была создана запись VCS:

  • Создание
  • Обновление
  • Удаление

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

Наименование таблицыСистемное наименование целевой таблицы.
ЗаписьID целевой записи, к которой было применено действие.
Копия записи (JSON)

Данные версии записи в формате JSON в виде ассоциативного массива. Этот массив хранит объект целевой записи в актуальном статусе.

Копия записи (JSON) содержит массив действий Обновление и Создание. Если было произведено Удаление, поле Копия записи (JSON) будет пустым.

СообщениеТекст ошибки, который отображается в случае коллизии. Поле заполняется, если запись имеет один из следующих статусов: Предупреждение, Пропущено или Коллизия.

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

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

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

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

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

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

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

ПолеЗначение
Название

Приложение Simple {версия платформы} (Миграция)

{версия платформы} соответствует номеру версии, например 1.8.0

ОписаниеЗадается системой
Кем завершенПользователь системы
ПриложениеSimple
СтатусЗавершено