Задача / по шагам
План пустой, а Holkas предупреждает о недостающем объекте
Сравнение не нашло отличий, но совпавшая форма ссылается на функцию, которой нет в приёмнике. Разберём, что означает предупреждение, и доставим недостающее одной кнопкой, не перезаписывая саму форму.
На этой странице
- 01Сравнение
Ноль команд и предупреждение
- 02Источник
Берём недостающую функцию
- 03Приёмник
Функция создана, форма не тронута
Учебный прогон на двух базах PostgreSQL с Парусом: класс с формой одинаков в обеих базах, а функция пересчёта формы hksite_v30_recalc есть только в источнике. Первый план содержит ноль команд и предупреждение.
Учебный пример
В источнике и приёмнике одна и та же форма раздела, и она ссылается на функцию пересчёта. В источнике функция есть, в приёмнике её нет. Сравнение класса завершается без команд, но Holkas предупреждает о недостающей функции. Нужно доставить её в приёмник, не трогая совпавшую форму.
Почему план пуст, а предупреждение есть
План отвечает на вопрос, отличаются ли выбранные объекты. Форма совпадает — команды для неё нет и не появится. Проверка зависимостей отвечает на другой вопрос: есть ли в приёмнике всё, на что эти объекты ссылаются. Она выполняется и для объектов с командами, и для совпавших.
Объект, на который ссылаются, Holkas ищет в плане и в приёмнике. Если он уже есть в приёмнике, это обычная ситуация, и предупреждения не будет. Если его нет ни там, ни там, появляется предупреждение о непокрытой зависимости. У совпавшего объекта оно означает: записывать нечего, но в приёмнике доработка может не заработать — например, форма откроется, а пересчёт завершится ошибкой.
Объект есть в источнике или его нет нигде
От этого зависит, что делать дальше.
| Где недостающий объект | Что показывает Holkas | Что делать |
|---|---|---|
| Есть в источнике | Кнопка «Добавить в набор и перестроить» | Добавить и перестроить план. |
| Часть есть в источнике, части нет | Кнопка и приписка «Объектов в источнике нет… Их добавить нельзя, предупреждение о них останется; остальные будут добавлены» | Добавить доступное; остальное разобрать как битую ссылку. |
| Нет и в источнике | Кнопки нет, причина названа в предупреждении | Исправить ссылку или создать объект в источнике. Перенос здесь ни при чём. |
| Источник — ZIP-пакет | Кнопки нет | Новый пакет с этим объектом или его отдельный перенос. |
Что делает кнопка «Добавить в набор и перестроить»
Она берёт исходный набор операции, добавляет к нему недостающие объекты, которые есть в источнике, и строит новый план в новой операции — с теми же источником и приёмником. Прежняя операция остаётся в истории. В приёмник кнопка ничего не записывает: применять новый план или нет, вы решаете после проверки.
Совпавшие объекты в новом плане по-прежнему без команд. Создаётся только недостающее.
HKSiteV30
Класс и его форма совпадают в обеих базах. Команд для них нет.
hksite_v30_recalc
Функция пересчёта, на которую ссылается форма. Есть только в источнике.
Ноль команд
Сравнение завершено, но в приёмнике доработка ещё неполна.
Перед началом
- 01
План, который завершился без команд
Вы сравнили объекты двух баз, операция получила статус «Завершено без изменений», а над пустым планом осталось жёлтое предупреждение. Если в плане есть команды и предупреждение стоит над ними, порядок действий тот же — он показан на примере с забытым доменом.
- 02
Источник, из которого можно дочитать
Кнопка дополнения состава читает недостающие объекты из того же источника. Загруженный ZIP-пакет так расширить нельзя — для него смотрите «Источник — ZIP-пакет».
- 03
Права и копия приёмника
Для нового плана нужно чтение обеих сторон, для применения — запись в приёмник. Перед записью в рабочую базу подготовьте её резервную копию.
Прочитайте предупреждение над пустым планом
Откройте «Перенести», выберите источник и приёмник, на шаге «Объекты» отметьте только класс HKSiteV30 и нажмите «Запустить план». Операция получит статус «Завершено без изменений», на месте списка команд появится карточка «План без команд». Обычно в ней написано «Расхождений не выявлено, перенос не требуется». Здесь текст другой: «Команд для переноса нет, но совпавшим объектам не хватает объектов в приёмнике, возможны ошибки при последующей работе» — и строка с формой и функцией, которая ей нужна. Над карточкой жёлтое предупреждение: совпавший объект ссылается на объект, которого нет ни в плане, ни в приёмнике.
Смотрите не только на статус и число команд. Статус «Завершено без изменений» одинаков и при полном совпадении, и при недостающем объекте — различает их текст карточки и предупреждение.
Откройте «Недостающие» и проверьте, что именно не найдено
В предупреждении нажмите «Недостающие». Список раскроется: сначала строки вида «кто ссылается → что нужно», ниже — недостающие объекты по типам. В примере это одна функция базы PostgreSQL (JFP) parus.hksite_v30_recalc. Если под текстом предупреждения есть приписка «Объектов в источнике нет…», часть списка добавить не получится: этих объектов нет и в источнике. Если кнопки «Добавить в набор и перестроить» нет совсем, причина названа там же — смотрите разбор случаев.
Сверьте тип и полное имя со своей доработкой: действительно ли форма должна вызывать эту функцию. Объект с похожим именем в приёмнике ссылку не закрывает.
Добавьте функцию в набор и перестройте план
Нажмите «Добавить в набор и перестроить». Holkas добавит недостающие объекты к исходному набору и создаст новую операцию с теми же источником и приёмником; в приёмник на этом шаге ничего не пишется. В новом плане одна команда — Create функции. Для класса и формы команд по-прежнему нет. Откройте команду функции и прочитайте её SQL, права и блок «Зависимости».
Проверьте новый план целиком: добавленный объект может сам ссылаться на что-то отсутствующее, и тогда предупреждение появится снова — уже о следующем объекте. Исключения команд из прежней операции в новую не переходят.
Примените новый план
Нажмите «Применить» и подтвердите запуск. В приёмнике создаётся только функция. Форма уже совпадала, команды для неё нет, и она не перезаписывается.
У команды функции должен стоять исход «исполнено». При ошибке откройте «Лог» и разберите исходы прежде, чем повторять.
Сравните расширенный набор ещё раз
Нажмите «Повторить с изменениями» — откроется новый перенос с теми же подключениями и набором из класса и функции. Запустите план. Команд быть не должно, предупреждение о функции должно исчезнуть, карточка покажет «Расхождений не выявлено, перенос не требуется». После этого откройте форму в клиенте Паруса и выполните пересчёт.
Повторный план подтверждает, что функция есть в приёмнике и совпадает с источником. Работает ли пересчёт формы, он не проверяет — это видно только в Парусе.
Недостающий объект создан
Команда Create функции имеет исход «исполнено»; форма и класс не менялись.
Предупреждение ушло
Повторное сравнение класса и функции завершается без команд и без жёлтого блока.
Форма проверена в Парусе
Пересчёт выполняется в том клиенте, где с формой будут работать.
Если что-то пошло не так
Кнопки «Добавить в набор и перестроить» нет
Holkas не предлагает действие, которое ничего не добавит. Причина написана в предупреждении. Либо источник — ZIP-пакет, либо ни одного из недостающих объектов нет в источнике: «В источнике нет части нужных объектов для СУБД приёмника. Подготовьте их и перенесите отдельно, затем постройте план заново».
Недостающего объекта нет и в источнике
Перестроение не может создать определение, которого негде взять. Чаще всего это давняя битая ссылка — форма называет функцию, которую когда-то удалили или переименовали. Она существовала до вашего переноса и им не вызвана. Исправьте ссылку в форме источника или создайте объект в источнике, затем постройте план заново. Если часть списка в источнике есть, кнопка добавит её, а предупреждение об остальном останется.
Источник — ZIP-пакет
Пакет читается целиком, и дополнить его перестроением нельзя. Предупреждение говорит: «В приёмнике нет нужных объектов. Добавьте их в новый пакет или перенесите отдельно». Попросите автора выгрузить пакет вместе с недостающими объектами или перенесите их отдельной операцией.
После перестроения предупреждение появилось снова
Сравните списки «Недостающие» в старой и новой операции. Новое имя означает следующую зависимость уже добавленного объекта — повторите перестроение. То же имя означает, что этого объекта нет в источнике.
Функция в приёмнике есть, но старая
Проверка зависимостей отвечает только на вопрос, существует ли объект. Его текст с источником не сравнивается, пока объекта нет в наборе, поэтому предупреждения не будет. Добавьте функцию в набор сами — план покажет отличия.
Предупреждение говорит о роли, а не об объекте
Роль не переносится этой кнопкой. Задайте соответствие ролей или создайте роль в приёмнике, затем постройте план заново. Для ролей и пользователей Паруса в назначениях форм — отдельный порядок.
В приёмнике PostgreSQL вместо функции настоящая процедура
Ссылку объекта Паруса на процедуру закрывает и функция, и процедура, созданная через CREATE PROCEDURE, с тем же именем. Предупреждения в таком случае нет.
Предупреждений нет, а доработка не работает
Holkas предупреждает о подтверждённых ссылках, известных из метаданных Паруса и каталога базы. Имена, найденные только в тексте SQL, предупреждения не дают — например, таблица, которую читает функция. Такие объекты включайте в набор сами. Чем отличаются подтверждённые связи.