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

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

План пустой, а Holkas предупреждает о недостающем объекте

Сравнение не нашло отличий, но совпавшая форма ссылается на функцию, которой нет в приёмнике. Разберём, что означает предупреждение, и доставим недостающее одной кнопкой, не перезаписывая саму форму.

На этой странице
  1. 01
    Сравнение

    Ноль команд и предупреждение

  2. 02
    Источник

    Берём недостающую функцию

  3. 03
    Приёмник

    Функция создана, форма не тронута

Учебный прогон на двух базах PostgreSQL с Парусом: класс с формой одинаков в обеих базах, а функция пересчёта формы hksite_v30_recalc есть только в источнике. Первый план содержит ноль команд и предупреждение.

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

В источнике и приёмнике одна и та же форма раздела, и она ссылается на функцию пересчёта. В источнике функция есть, в приёмнике её нет. Сравнение класса завершается без команд, но Holkas предупреждает о недостающей функции. Нужно доставить её в приёмник, не трогая совпавшую форму.

Почему план пуст, а предупреждение есть

План отвечает на вопрос, отличаются ли выбранные объекты. Форма совпадает — команды для неё нет и не появится. Проверка зависимостей отвечает на другой вопрос: есть ли в приёмнике всё, на что эти объекты ссылаются. Она выполняется и для объектов с командами, и для совпавших.

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

Объект есть в источнике или его нет нигде

От этого зависит, что делать дальше.

Где недостающий объектЧто показывает HolkasЧто делать
Есть в источникеКнопка «Добавить в набор и перестроить»Добавить и перестроить план.
Часть есть в источнике, части нетКнопка и приписка «Объектов в источнике нет… Их добавить нельзя, предупреждение о них останется; остальные будут добавлены»Добавить доступное; остальное разобрать как битую ссылку.
Нет и в источникеКнопки нет, причина названа в предупрежденииИсправить ссылку или создать объект в источнике. Перенос здесь ни при чём.
Источник — ZIP-пакетКнопки нетНовый пакет с этим объектом или его отдельный перенос.

Что делает кнопка «Добавить в набор и перестроить»

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

Совпавшие объекты в новом плане по-прежнему без команд. Создаётся только недостающее.

CLS

HKSiteV30

Класс и его форма совпадают в обеих базах. Команд для них нет.

JFP

hksite_v30_recalc

Функция пересчёта, на которую ссылается форма. Есть только в источнике.

0

Ноль команд

Сравнение завершено, но в приёмнике доработка ещё неполна.

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

  • 01

    План, который завершился без команд

    Вы сравнили объекты двух баз, операция получила статус «Завершено без изменений», а над пустым планом осталось жёлтое предупреждение. Если в плане есть команды и предупреждение стоит над ними, порядок действий тот же — он показан на примере с забытым доменом.

  • 02

    Источник, из которого можно дочитать

    Кнопка дополнения состава читает недостающие объекты из того же источника. Загруженный ZIP-пакет так расширить нельзя — для него смотрите «Источник — ZIP-пакет».

  • 03

    Права и копия приёмника

    Для нового плана нужно чтение обеих сторон, для применения — запись в приёмник. Перед записью в рабочую базу подготовьте её резервную копию.

Прочитайте предупреждение над пустым планом

Откройте «Перенести», выберите источник и приёмник, на шаге «Объекты» отметьте только класс HKSiteV30 и нажмите «Запустить план». Операция получит статус «Завершено без изменений», на месте списка команд появится карточка «План без команд». Обычно в ней написано «Расхождений не выявлено, перенос не требуется». Здесь текст другой: «Команд для переноса нет, но совпавшим объектам не хватает объектов в приёмнике, возможны ошибки при последующей работе» — и строка с формой и функцией, которая ей нужна. Над карточкой жёлтое предупреждение: совпавший объект ссылается на объект, которого нет ни в плане, ни в приёмнике.

Пустой план с отсутствующей функцией пересчёта
Ноль команд, но у совпавшей формы найдена недостающая функция.

Смотрите не только на статус и число команд. Статус «Завершено без изменений» одинаков и при полном совпадении, и при недостающем объекте — различает их текст карточки и предупреждение.

Откройте «Недостающие» и проверьте, что именно не найдено

В предупреждении нажмите «Недостающие». Список раскроется: сначала строки вида «кто ссылается → что нужно», ниже — недостающие объекты по типам. В примере это одна функция базы PostgreSQL (JFP) parus.hksite_v30_recalc. Если под текстом предупреждения есть приписка «Объектов в источнике нет…», часть списка добавить не получится: этих объектов нет и в источнике. Если кнопки «Добавить в набор и перестроить» нет совсем, причина названа там же — смотрите разбор случаев.

Сверьте тип и полное имя со своей доработкой: действительно ли форма должна вызывать эту функцию. Объект с похожим именем в приёмнике ссылку не закрывает.

Добавьте функцию в набор и перестройте план

Нажмите «Добавить в набор и перестроить». Holkas добавит недостающие объекты к исходному набору и создаст новую операцию с теми же источником и приёмником; в приёмник на этом шаге ничего не пишется. В новом плане одна команда — Create функции. Для класса и формы команд по-прежнему нет. Откройте команду функции и прочитайте её SQL, права и блок «Зависимости».

Команда создания функции после дополнения состава
Карточка новой функции из сохранённого плана. На снимке операция уже применена; SQL расположен перед зависимостями.

Проверьте новый план целиком: добавленный объект может сам ссылаться на что-то отсутствующее, и тогда предупреждение появится снова — уже о следующем объекте. Исключения команд из прежней операции в новую не переходят.

Примените новый план

Нажмите «Применить» и подтвердите запуск. В приёмнике создаётся только функция. Форма уже совпадала, команды для неё нет, и она не перезаписывается.

У команды функции должен стоять исход «исполнено». При ошибке откройте «Лог» и разберите исходы прежде, чем повторять.

Сравните расширенный набор ещё раз

Нажмите «Повторить с изменениями» — откроется новый перенос с теми же подключениями и набором из класса и функции. Запустите план. Команд быть не должно, предупреждение о функции должно исчезнуть, карточка покажет «Расхождений не выявлено, перенос не требуется». После этого откройте форму в клиенте Паруса и выполните пересчёт.

Повторное сравнение класса и функции
После переноса функции нет ни команд, ни предупреждения о её отсутствии.

Повторный план подтверждает, что функция есть в приёмнике и совпадает с источником. Работает ли пересчёт формы, он не проверяет — это видно только в Парусе.

Недостающий объект создан

Команда Create функции имеет исход «исполнено»; форма и класс не менялись.

Предупреждение ушло

Повторное сравнение класса и функции завершается без команд и без жёлтого блока.

Форма проверена в Парусе

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

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

Кнопки «Добавить в набор и перестроить» нет

Holkas не предлагает действие, которое ничего не добавит. Причина написана в предупреждении. Либо источник — ZIP-пакет, либо ни одного из недостающих объектов нет в источнике: «В источнике нет части нужных объектов для СУБД приёмника. Подготовьте их и перенесите отдельно, затем постройте план заново».

Недостающего объекта нет и в источнике

Перестроение не может создать определение, которого негде взять. Чаще всего это давняя битая ссылка — форма называет функцию, которую когда-то удалили или переименовали. Она существовала до вашего переноса и им не вызвана. Исправьте ссылку в форме источника или создайте объект в источнике, затем постройте план заново. Если часть списка в источнике есть, кнопка добавит её, а предупреждение об остальном останется.

Источник — ZIP-пакет

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

После перестроения предупреждение появилось снова

Сравните списки «Недостающие» в старой и новой операции. Новое имя означает следующую зависимость уже добавленного объекта — повторите перестроение. То же имя означает, что этого объекта нет в источнике.

Функция в приёмнике есть, но старая

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

Предупреждение говорит о роли, а не об объекте

Роль не переносится этой кнопкой. Задайте соответствие ролей или создайте роль в приёмнике, затем постройте план заново. Для ролей и пользователей Паруса в назначениях форм — отдельный порядок.

В приёмнике PostgreSQL вместо функции настоящая процедура

Ссылку объекта Паруса на процедуру закрывает и функция, и процедура, созданная через CREATE PROCEDURE, с тем же именем. Предупреждения в таком случае нет.

Предупреждений нет, а доработка не работает

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