Парус 8 · Конструктор отраслевых расширений
Запись на закладке «Объекты» класса хранит описание объекта реализации и копию его исходного текста. Например, запись о процедуре сохранения заявки и сама процедура базы переносятся разными типами Holkas.
CLO + Класс|ТИП:ИМЯЗапись реестра в КОР
В классе спецификация «Объекты» перечисляет серверные объекты, реализующие раздел: таблицы, процедуры, представления и другие. У текущей записи есть подчинённый список «Зависимости» — от каких зарегистрированных объектов она зависит. Записи могут появляться при генерации исходных кодов с регистрацией или при загрузке объектов из базы средствами Конструктора.
Парус использует эти тексты в «Генерации сценария раздела» и, при соответствующей настройке, в «Синхронизации метаданных». CLO переносит реестр, а не запускает эти инструменты. Если в тексте записи написано create procedure P_REQUEST_SAVE, применение CLO сохранит эту строку в реестре. Для переноса исполняемой процедуры включите её как процедуру базы.
Реестр не является автоматически полным списком реализации. В прежнем исследовании КОР загрузка объектов добавила восемь записей, но не включила процедуры, которые вызывались только из других процедур. Пустой реестр не означает, что у класса нет физической реализации; он означает отсутствие CLO в его составе.
Что входит в перенос
При выборе CLS раскрывается его семейство, включая CLO. Ссылки из Dependencies позволяют обнаружить недостающие записи-цели; их наличие в выбранном составе или приёмнике проверяется отдельно. Физические объекты не извлекаются из PlsqlText. История изменений, удалённые объекты и состояние захвата для исправления не переносятся. Новые изменения реестра проходят через процедуры Паруса и создают историю уже в приёмнике; чужие авторы и даты источника не копируются. Производителя задаёт лицензия приёмника.
Справочник полей
9 полей · 2 группыШесть реквизитов CLO, список Dependencies и два поля каждого элемента. Слева — имя Git YAML, рядом — имя JSON обоих ZIP. Для UnitCode показаны отдельно класс владельца и класс цели.
Как читать обозначения и правила
Наведите указатель на значок, перейдите к нему клавишей Tab или нажмите его — появится пояснение.
Ключ определяет сопоставляемую запись. Сравниваемые поля могут дать Update. Список проверяется по парам ключей; новые и удалённые зависимости получают отдельные команды.
Наличие поля в файле не отменяет ограничений Паруса. Действия процедур ниже относятся к приёмнику БД; Git сохраняет описание, а оба ZIP-транспорта формируют новый архив.
Запись реестра · CLO7 полей
UnitCodeJSON: unitCodeстрокаЧасть ключаКласс-владелец- Назначение
- Код класса Паруса, например Request. Вместе с ObjectType и Name задаёт адрес записи.
- При переносе:
- Создание записи ждёт создания этого CLS, если класс ещё отсутствует. Смена UnitCode не перемещает существующую запись: её имя и тип могут быть уже заняты в другом классе, и создание откажет с именем владельца.
NameJSON: nameстрокаЧасть ключаИмя объекта реализации- Назначение
- Имя без схемы, например P_REQUEST_SAVE. В обследованном Парусе — до 30 знаков, в верхнем регистре; при добавлении Парус переводит имя в верхний регистр.
- При переносе:
- По имени и типу ищется запись во всей базе, затем проверяется её класс. Другое имя означает новый CLO, прежняя запись в БД остаётся. Holkas не переименовывает запись через Update; при ручной правке файла сохраняйте регистр настоящего экспорта.
ObjectTypeJSON: objectTypeцелоеЧасть ключаТип объекта реестра- Назначение
- Код от 0 до 9: таблица, индекс, триггер и другие виды серверных объектов. Полная таблица кодов и слов адреса — в примечании ниже.
- При переносе:
- Из кода и Name получается ТИП:ИМЯ. Например, 3 и P_REQUEST_SAVE дают PROCEDURE:P_REQUEST_SAVE. Смена типа — другой адрес, а не Update. Не любой новый тип разрешён для уже занятого имени: Парус дополнительно проверяет общий список объектов.
CaptionJSON: captionстрокаСравниваетсяНаименование записи- Назначение
- Понятная подпись, например «Сохранить заявку». В обследованном Парусе обязательна, до 240 знаков и уникальна среди записей одного класса.
- При переносе:
- Изменение даёт Update CLO и передаётся процедуре Паруса. Если наименование переходит к другой записи этого класса, Holkas сначала освобождает его, а обмен по кругу не переносит и называет в плане — см. «Записи меняются наименованиями».
ObjectKindJSON: objectKindцелоеСравниваетсяВид объекта- Назначение
- 0 — базовый, 1 — клиентский, 2 — полный клиентский (словарь TOBJECT_PRIV). Это свойство записи, а не перечень прав SQL.
- При переносе:
- Передаётся при Create и при изменении вида через Update CLO. Holkas этим не создаёт публичный синоним и не выдаёт права физическому объекту. Вид используется инструментами Паруса; при генерации сценария клиентские виды влияют на добавление команд прав.
PlsqlTextJSON: plsqlTextстрокаСравниваетсяКопия исходного текста- Назначение
- Сохранённый текст объекта реализации. Несмотря на имя PlsqlText, поле используется также на PostgreSQL. Это не текст, автоматически прочитанный Holkas из SQL-объекта при записи CLO.
- При переносе:
- Разница даёт Update CLO; план показывает блок «Текст объекта» было/стало. CRLF и LF равны; пробелы и регистр значимы. Пропущенное поле и null читаются как пустой текст: в Парусе текст всегда есть, отсутствие текста хранится пустым. Create сохраняет текст отдельным вызовом лишь когда он непустой; Update передаёт изменившийся текст, в том числе пустой, процедуре сохранения.
DependenciesJSON: dependenciesсписокПо элементамЗависимости записи- Назначение
- Полный список других записей реестра: UnitCode класса цели и ObjectKey вида ТИП:ИМЯ. Цель может принадлежать другому классу.
- При переносе:
- Ключ элемента — пара UnitCode + ObjectKey. Новая пара даёт Create CLO.Dep, отсутствующая — Delete CLO.Dep. [] снимает все зависимости этой записи. Порядок строк не задаёт позиции или порядок SQL. Обе записи и физические объекты при снятии зависимости сохраняются.
Зависимость записи · CLO.Dep2 поля
UnitCodeJSON: unitCodeстрокаЧасть ключаКласс записи-цели- Назначение
- Код класса, которому принадлежит объект из ObjectKey. Это не обязательно UnitCode самой записи CLO.
- При переносе:
- При применении Holkas ищет цель по типу и имени во всей базе и проверяет её класс. Замена класса даёт удаление прежней зависимости и создание новой; автоматического перемещения цели нет.
ObjectKeyJSON: objectKeyстрокаЧасть ключаТип и имя записи-цели- Назначение
- Адрес внутри класса цели, например TABLE:UDO_T_REQUEST или FUNCTION:F_CHECK_REQUEST. Слова типов — заглавными, с подчёркиванием в PACKAGE_BODY и FOREIGN_KEY.
- При переносе:
- Создание зависимости ждёт Create CLO этой цели. Другой ObjectKey — Delete прежней связи и Create новой. Если записи реестра нет, наличие одноимённой физической таблицы или функции её не заменит; неизвестное слово типа или пустое имя отклоняются при разборе адреса.
Команды плана
Два кода охватывают запись и её зависимости. Значки действий имеют подписи по наведению, фокусу клавиатуры и нажатию.
Реестр и его зависимости2 кода
CLOЗапись реестра класса
Создаёт запись с именем, типом, наименованием и видом, затем сохраняет непустой текст. Update меняет отличающиеся наименование/вид и текст через процедуры Паруса. Имя, тип и класс существующей записи не меняет. При правке только Dependencies корневой Update не требуется. SQL из PlsqlText не исполняется.
Ключ: Класс|ТИП:ИМЯ
CLO.DepЗависимость между записями реестра
Добавляет отсутствующую пару UnitCode + ObjectKey либо снимает пару, которой нет в списке из источника. У элемента нет реквизитов вне ключа, поэтому Update не возникает. Delete сохраняет обе записи реестра, их тексты и физические объекты БД.
Ключ: Класс|ТИП:ИМЯ|Класс цели|ТИП:ИМЯ цели
Delete CLO по отсутствию в источнике не строится. У CLO.Dep все поля входят в ключ, поэтому нет Update; позиции у Dependencies нет, поэтому нет SetOrder.
Пример: снять зависимость, сохранив объекты
В приёмнике у Request|PROCEDURE:P_REQUEST_SAVE есть зависимость от Request|TABLE:UDO_T_REQUEST. В полном списке источника этой пары больше нет.
Появится Delete CLO.Dep · Request|PROCEDURE:P_REQUEST_SAVE|Request|TABLE:UDO_T_REQUEST. При неизменных реквизитах Update CLO не нужен. Запись процедуры, запись таблицы, их тексты и сама физическая таблица останутся. Снятие связи в реестре не переписывает код процедуры.
Ограничения и что с ними делать
Текст переносится между Oracle и PostgreSQL
Holkas не переводит PlsqlText на другой SQL-диалект. Когда план для БД сохраняет непустой изменившийся текст, а известные СУБД источника и приёмника различаются, появляется предупреждение. Совпавший текст или неизвестная СУБД такого предупреждения не дают; отсутствие предупреждения не доказывает пригодность кода.
Например, Oracle-текст пакета будет сохранён в реестре PostgreSQL как текст. Перед «Генерацией сценария раздела» или синхронизацией, использующей эти записи, подготовьте реализацию для приёмника и загрузите её текст из его базы средствами КОР. CLO не проверяет синтаксис и не создаёт эту реализацию автоматически.
Имя и тип уже зарегистрированы в другом классе
Если PROCEDURE:P_REQUEST_SAVE числится в Common, Create той же пары в Request откажет и назовёт Common. Смена UnitCode в файле не переносит владение, а смена имени оставит прежнюю запись в БД.
Сначала согласуйте настоящий класс-владелец и исправьте состав или регистрацию средствами КОР. Не удаляйте чужую запись только ради обхода проверки: у неё могут быть зависимости и история.
Запись захвачена для исправления
Чужой захват не позволяет изменить реквизиты или текст: владелец должен закончить либо отменить исправление в КОР. Holkas не снимает захват автоматически.
Если захват принадлежит тому же пользователю, что и подключение Holkas, процедура Паруса может сохранить правку в его черновике. Чтение Holkas берёт основную запись, поэтому повторный план может снова показывать разницу до завершения исправления. Проверьте состояние исправления в КОР, прежде чем повторять перенос. Это известная граница работы реестра, не новый опыт этой страницы.
Записи меняются наименованиями
Caption уникально среди записей класса (C_DMSCLOBJECTS_CAPTION_UK): Парус не даёт занять наименование, пока его держит другая запись.
Цепочка — например, A: «Z1» → «Z2», B: «Z2» → «Z3». Holkas упорядочивает команды сам: сначала B освобождает «Z2», потом его получает A. Новый объект, которому нужно освобождаемое наименование, тоже ждёт. Всё проходит за один перенос, в каком бы порядке объекты ни шли в наборе.
Обмен по кругу — например, A: «Первое» → «Второе», B: «Второе» → «Первое». Без временного наименования его не выполнить, а промежуточные значения Holkas не записывает. План в базу Паруса называет такие записи в предупреждении и оставляет им наименования приёмника; остальные их правки переносятся. В Git и файл обмен записывается как есть. Поменяйте наименования в приёмнике вручную или в три переноса: дайте в источнике одному объекту свободное временное наименование, перенесите, затем верните нужные наименования и перенесите снова.
Оба объекта должны входить в перенос. Если наименование держит объект вне набора или тот, что его не меняет, команда получает отказ «Значение уже занято другой записью приёмника…» с именем ограничения.
Проверено на PostgreSQL и Oracle.
Заголовок и тело пакета принадлежат разным классам
Тело Request|PACKAGE_BODY:PK_REQUEST может числиться в Request, а заголовок Common|PACKAGE:PK_REQUEST — в Common: Парус ищет заголовок по имени во всём реестре. Если заголовок в наборе, тело ждёт именно его создания, в каком бы порядке записи ни шли. Если в набор попал только класс тела, адрес заголовка берётся из перечня источника, и предупреждение о недостающей записи появляется, только когда заголовка нет в приёмнике по этому адресу. Проверено на PostgreSQL и Oracle.
Граница: когда источник — «Файл пакета» с одним телом, класса заголовка не знает никто, и Holkas предполагает класс тела. Если заголовок в приёмнике числится в другом классе, предупреждение о Request будет ложным, а применение пройдёт: Парус найдёт заголовок по имени. Не создавайте дубликат заголовка в Request: имя уже занято.
Рёбра команд
Что такое ребро и где оно видно в Holkas →
Рёбра помогают Holkas сортировать команды перед применением: стрелка означает «раньше». Зависимость реестра — данные списка Dependencies; ребро — порядок команд, которые эти данные записывают. Список не делает Create CLO процедуры зависимым от Create CLO таблицы: команда CLO сохраняет текст, а не исполняет его.
Create CLOЗаписи процедуры и таблицыОбе записи регистрируются после создания класса CLS.
Create CLO.DepЗависимость процедуры от таблицыДобавляется пара Request + TABLE:UDO_T_REQUEST в список процедуры.
Создание записей и зависимостей6 правил
Create CLS→Create CLOКогда: Создаётся запись реестра класса UnitCode.
Сначала создать класс. Update CLO не ждёт Update CLS этим правилом.
Create CLO · PACKAGE→Create CLO · PACKAGE_BODYКогда: Создаётся тело пакета: ObjectType=6. Заголовок с тем же именем числится в классе тела, либо его класс неизвестен ни набору, ни источнику.
Парус регистрирует тело только при зарегистрированном заголовке. Если класс заголовка неизвестен, Holkas предполагает класс тела.
Create CLO · PACKAGE другого класса→Create CLO · PACKAGE_BODYКогда: Создаётся тело пакета, а заголовок с тем же именем числится в другом UnitCode: так его называет набор переноса, а без него — перечень объектов источника.
Парус ищет заголовок по имени во всём реестре, без класса. Тело ждёт заголовок по его настоящему адресу, в каком бы порядке ни шли записи; заголовок вне набора проверяется в приёмнике по этому же адресу.
Create CLO · владелец→Create CLO.DepКогда: Добавляется зависимость в Dependencies.
Сначала должна существовать запись, чей список меняется. Её Update этим правилом не ожидается.
Create CLO · цель→Create CLO.DepКогда: UnitCode и ObjectKey элемента задают запись-цель.
Сначала зарегистрировать цель, в том числе другого класса. Это ожидание создания записи реестра, а не исполнения её текста или создания SQL-объекта.
Update CLO, отдающая Caption→Create / Update CLO, занимающая CaptionКогда: CLO получает непустое Caption, которое в приёмнике держит другая запись того же класса, и в этом же переносе своё Caption меняет. Оба объекта входят в набор. Для обмена по кругу ребро не ставится.
Сначала освободить наименование, потом занять: C_DMSCLOBJECTS_CAPTION_UK не допускает двух одинаковых, и цепочка переименований проходит за один перенос в любом порядке набора. Если наименование держит объект вне набора или тот, что его не меняет, Парус откажет «Значение уже занято».
Скрипты автора2 правила
SCR Before→CLO / CLO.DepКогда: Приёмник исполняет скрипты; область — эта запись, её класс или весь перенос.
Выполнить скрипт перед охватываемыми командами. PlsqlText не является таким скриптом.
CLO / CLO.Dep→SCR AfterКогда: Та же область, время After.
Выполнить скрипт после команд реестра. Скрипт без команд в своей области в плане не остаётся.
Правило без удаления самого объекта1 правило
Delete CLO.Dep→Delete CLO · цельКогда: Снимается зависимость от записи-цели.
Ребро задаёт порядок на случай удаления цели: сначала снимается зависимость. Обычный перенос Delete целого CLO не строит: это ребро не удалит запись и не добавит команду удаления.
Как запись реестра хранится в файлах
Для Request|PROCEDURE:P_REQUEST_SAVE Git вкладывает запись в файл класса. S3 и «Файл пакета» сохраняют одинаковый отдельный JSON. Dependencies во всех случаях находится внутри CLO; сохранённый SQL-текст — строковое поле, а не исполняемый файл .sql.
Git
YAMLClass/Request.yamlСписок Objects содержит CLO: Name, ObjectType, PlsqlText и Dependencies вместе с остальными реквизитами.
S3
JSON в ZIPClassObject/Request%7CPROCEDURE%3AP_REQUEST_SAVE.jsonОтдельная запись CLO с реквизитами и dependencies, как у «Файла пакета». Оглавление указывает CLO и полное имя Request|PROCEDURE:P_REQUEST_SAVE.
Файл пакета
JSON в ZIPClassObject/Request%7CPROCEDURE%3AP_REQUEST_SAVE.jsonОтдельная запись CLO с реквизитами и dependencies. Оглавление указывает CLO и полное имя Request|PROCEDURE:P_REQUEST_SAVE.
ZIP из S3 и «Файла пакета» устроены одинаково, архив одного способа загружается другим. ZIP, записанные в S3 версией Holkas 0.1.30 или более ранней, хранили запись в списке objects внутри Class/Request.json; такие архивы по-прежнему читаются обоими способами.
Полный файл выбранного CLS собирается из выгружаемого семейства заново: отсутствующая запись CLO может уйти из снимка Git; если записей нет, Objects не пишется. Это не Delete CLO при последующей загрузке в БД. При выгрузке одиночных дочерних объектов Git подмешивает существующий файл класса. Новый ZIP содержит только выгружаемый состав.
Физическая процедура, таблица и другие включённые SQL-объекты имеют собственные файлы. Например, PlsqlText записи не заменяет файл ProcedurePostgres или ProcedureOracle. История и захваты исправлений не сохраняются ни в одном из этих представлений. При записи Holkas опускает null-поля, а нули, пустую строку и Dependencies: [] сохраняет.
Пример одной записи в YAML и JSON
Сокращённые учебные фрагменты. Это иллюстрация расположения данных, не готовые файлы для загрузки. Текст процедуры условный и неполный; остальные записи и сведения класса не показаны.
Git — внутри Class/Request.yaml:
UnitCode: Request
Objects:
- UnitCode: Request
Name: P_REQUEST_SAVE
ObjectType: 3
Caption: Сохранить заявку
ObjectKind: 1
PlsqlText: create procedure P_REQUEST_SAVE
Dependencies:
- UnitCode: Request
ObjectKey: TABLE:UDO_T_REQUEST
- UnitCode: Common
ObjectKey: FUNCTION:F_CHECK_REQUEST
S3 или «Файл пакета» — отдельный ClassObject/Request%7CPROCEDURE%3AP_REQUEST_SAVE.json:
{
"unitCode": "Request",
"name": "P_REQUEST_SAVE",
"objectType": 3,
"caption": "Сохранить заявку",
"objectKind": 1,
"plsqlText": "create procedure P_REQUEST_SAVE",
"dependencies": [
{ "unitCode": "Request", "objectKey": "TABLE:UDO_T_REQUEST" },
{ "unitCode": "Common", "objectKey": "FUNCTION:F_CHECK_REQUEST" }
]
}
UnitCode внутри CLO — Request, а UnitCode второй зависимости — Common: это разные владельцы. Не заменяйте полный Dependencies сокращённым списком — пропущенные пары получат Delete CLO.Dep. Необязательный Objects у класса и обязательный Dependencies у самой записи не взаимозаменяемы.
Практические шаги: перенести реестр класса, сохранить в Git, выгрузить и загрузить файл пакета. Оглавление ZIP — в справке о формате пакета.
Основа: руководство КОР Парус 8, издание 2026, с. 115–118; сохранённое исследование инструментов КОР и переноса реестра Oracle / Парус 27.08.2026 от 3 ноября 2026; текущие DTO, читатели, построители, исполнители и файловые адаптеры Holkas 0.1.30. Сверено 8 ноября 2026; хранение в ZIP уточнено по коду 9 ноября 2026. На PostgreSQL 14 / Парус 27.08.2026 прочитаны процедуры, ограничения и словарь видов без записи. Локальные пробы плана и файлов не являются переносом в БД. Новый перенос и проверка клиентов Паруса не выполнялись. Имена и схемы учебные.