Holkas
Написать в поддержку Поддержка

Задача / по шагам

Передать доработку Паруса через ZIP-пакет

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

На этой странице
  1. 01
    Разработка

    Выбираем состав

  2. 02
    ZIP-пакет

    Передаём снимок

  3. 03
    Приёмка

    Сравниваем и применяем

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

Учебный пример

Когда прямого доступа к базе заказчика нет, доработку можно передать отдельным файлом. На стороне разработки Holkas собирает ZIP; на стороне получателя этот ZIP становится источником нового переноса.

Исходное состояние: в разработке лежит учебная доработка договоров версии 1.1 — класс, таблица и функция. В приёмке класс и таблица такие же, а функция прежняя: сумма может быть равна нулю. Сохраним версию 1.1 в файл, доставим её в приёмку и проверим результат.

Устройство архива, оглавление и скачиваемый учебный ZIP — в справочнике Пакет доработок.

На шаге «Параметры» можно записать в ZIP обязательное требование полной установки одной транзакцией PostgreSQL. Пример и ограничения.

CLS

Класс договоров

HolkasSiteContracts и его дочерние объекты.

TBP

Таблица договоров

parus.hksite_contracts — структура учебной таблицы.

JFP

Проверка суммы

parus.f_hksite_contract_check — правило версии 1.1: сумма больше нуля.

Перед началом

  • 01

    Holkas с обеих сторон

    В исходном контуре нужен доступ на чтение базы, у получателя — Holkas с доступом к его базе. Подключения к одной сети не требуется.

  • 02

    Понятный состав

    Возьмите состав из первого переноса или своего манифеста. Пакет содержит выбранные объекты, а не копию всей базы.

  • 03

    Подготовленная приёмка

    Проверьте совместимость объектов и права на изменения. Перед рабочим переносом подготовьте резервную копию.

Выберите базу и файл назначения

В разделе «Перенести» выберите базу источником, «Файл пакета» — приёмником. Задайте имя contracts-1.1.zip. На шаге «Объекты» выберите класс, таблицу и функцию, заполните основание и перейдите на шаг «Параметры». Для обычной выгрузки оставьте «Перенести одной транзакцией» по умолчанию, затем нажмите «Выгрузить пакет».

Выбранные класс, таблица и функция для выгрузки в contracts-1.1.zip
После выбора объектов есть шаг «Параметры». На нём кнопка «Выгрузить пакет» создаёт ZIP без сравнения с базой.

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

Скачайте и передайте пакет

Дождитесь завершения. Кнопка «Скачать contracts-1.1.zip» выдаёт результат операции. Передайте файл получателю согласованным способом и сообщите, для какой доработки и версии он подготовлен.

Завершённая выгрузка с кнопкой скачивания contracts-1.1.zip
Файл создан. На этом работа в исходном контуре закончена; в базе получателя ещё ничего не менялось.

ZIP хранит снимок объектов на момент выгрузки. Последующие правки исходной базы в этот файл не попадут; для новой версии нужна новая выгрузка.

Загрузите ZIP у получателя

В Holkas получателя откройте новый перенос. Источником выберите «Файл пакета» и загрузите полученный ZIP. Нажмите «Выбрать», затем укажите базу назначения.

ZIP загружен как источник нового переноса
В учебном прогоне загружен скачанный contracts-1.1.zip. Holkas показывает имя и размер файла до выбора приёмника.

Пакет читается целиком — повторного выбора объектов в нём нет. Проверьте имя файла, приёмник и организацию. Выбор отдельных команд возможен позже, в плане.

Разберите план для этой базы

Нажмите «Запустить план». В нашей приёмке класс и таблица уже совпадают с пакетом, а функция ещё принимает нулевую сумму. Поэтому план содержит одну команду Update. Откройте её и проверьте diff.

План доставки пакета в приёмку — одна команда Update функции
Три исходных объекта не означают три изменения. Holkas сравнил содержимое пакета с текущей приёмкой.

Один пакет может дать разные планы для разных баз. Не переносите выводы из чужого плана на свою приёмку. После проверки нажмите «Применить» и дождитесь результата.

Повторите сравнение с тем же файлом

Создайте ещё один перенос: снова загрузите тот же contracts-1.1.zip и выберите ту же приёмку. Постройте план. В нашем прогоне он пустой: функция, класс и таблица больше не требуют переноса.

Повторное сравнение приёмки с ZIP завершено без изменений
Пакет действительно применён: повторная проверка не создаёт команд.

Для новой операции файл загружается заново. Пустой план подтверждает совпадение выбранного состава по правилам Holkas; работу доработки проверьте отдельно в Парусе.

Файл получен

У получателя есть нужная версия ZIP.

План исполнен

Разобраны исходы команд и журнал.

Результат проверен

Повторное сравнение и проверка в Парусе.

Если что-то пошло не так

После выгрузки источник изменился

Пакет не обновляется сам. Выгрузите новую версию и сообщите получателю, какой файл использовать.

Нужен только один объект из большого пакета

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

У получателя другая СУБД

Логические объекты Паруса поддерживают перенос между Oracle и PostgreSQL, но SQL функции из этого примера автоматически не переводится. См. ограничения маршрутов.