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

Справочник / часть объекта

Объект реестра класса

Тип объекта в Holkas: CLO

Парус · Oracle и PostgreSQL

В командной строке: --object CLO:Request|PROCEDURE:P_REQUEST_SAVE · как задать состав в CLI. Для файла пакета в наборе должен быть и сам объект «Класс»; в Git часть запишется, если его файл там уже есть

Запись «Объекты» КОР Парус 8: описание, копия исходного текста, зависимости, все поля и команды, хранение в Git, S3 и файле пакета.

← К составу: Класс
На этой странице

Парус 8 · Конструктор отраслевых расширений

Запись на закладке «Объекты» класса хранит описание объекта реализации и копию его исходного текста. Например, запись о процедуре сохранения заявки и сама процедура базы переносятся разными типами Holkas.

АдресCLO + Класс|ТИП:ИМЯ
Вложенная частьЗависимости записей
Удаление целой записиНе формируется

Запись реестра в КОР

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

Парус использует эти тексты в «Генерации сценария раздела» и, при соответствующей настройке, в «Синхронизации метаданных». CLO переносит реестр, а не запускает эти инструменты. Если в тексте записи написано create procedure P_REQUEST_SAVE, применение CLO сохранит эту строку в реестре. Для переноса исполняемой процедуры включите её как процедуру базы.

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

Что входит в перенос

Запись принадлежит классу; её Dependencies — вложенная коллекция. Записи-цели могут быть в других классах и не становятся вложенными объектами этой записи. CLO.Dep — команда над элементом списка, а не самостоятельный файл.

При выборе CLS раскрывается его семейство, включая CLO. Ссылки из Dependencies позволяют обнаружить недостающие записи-цели; их наличие в выбранном составе или приёмнике проверяется отдельно. Физические объекты не извлекаются из PlsqlText. История изменений, удалённые объекты и состояние захвата для исправления не переносятся. Новые изменения реестра проходят через процедуры Паруса и создают историю уже в приёмнике; чужие авторы и даты источника не копируются. Производителя задаёт лицензия приёмника.

Справочник полей

9 полей · 2 группы

Шесть реквизитов CLO, список Dependencies и два поля каждого элемента. Слева — имя Git YAML, рядом — имя JSON обоих ZIP. Для UnitCode показаны отдельно класс владельца и класс цели.

Как читать обозначения и правила

Ключ определяет сопоставляемую запись. Сравниваемые поля могут дать 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 новой. Если записи реестра нет, наличие одноимённой физической таблицы или функции её не заменит; неизвестное слово типа или пустое имя отклоняются при разборе адреса.
Тип объекта: код, слово в адресе и значение
ObjectType · слово в адресеЧто зарегистрировано
0 · TABLEТаблица
1 · INDEXИндекс
2 · TRIGGERТриггер
3 · PROCEDUREПроцедура
4 · FUNCTIONФункция
5 · PACKAGEЗаголовок пакета
6 · PACKAGE_BODYТело пакета
7 · VIEWПредставление
8 · SEQUENCEПоследовательность
9 · FOREIGN_KEYВнешний ключ

Это коды реестра КОР, общие для CLO на Oracle и PostgreSQL. Например, тип «Представление» здесь — 7; не подставляйте код из другого словаря Паруса. Код не доказывает, что соответствующий физический объект поддерживается вашей СУБД или переносится Holkas самостоятельно.

Имя и тип: ключ Holkas и дополнительная проверка Паруса

Адрес Holkas содержит класс, тип и имя. Пара «имя, тип» уникальна во всём реестре базы. Кроме того, обследованный Парус не допускает одно имя у разных типов, за исключением отдельного пространства имён индексов и тела пакета. Поэтому замена TABLE:X на PROCEDURE:X может быть отклонена, хотя адрес Holkas получился другим. Заголовок PACKAGE:X и тело PACKAGE_BODY:X, напротив, имеют общее имя и разные записи.

Пустой текст: пропуск, null и пустая строка равны

Парус хранит отсутствие текста пустым: колонка текста обязательна. Поэтому Holkas читает пропущенное PlsqlText и null из файла как пустой текст, и такой файл сходится с пустым текстом базы. Запись без текста создаётся без отдельного сохранения, а очистка текста в файле любым из трёх способов даёт один Update и затем пустой план.

Полный экспорт пишет пустой текст как PlsqlText: '' в YAML и "plsqlText": "" в JSON. Не очищайте Dependencies ради очистки текста: это другой список и другие команды.

Dependencies обязателен, Objects файла класса — нет

В обоих ZIP пропуск Dependencies и null отклоняются; [] задаёт снятие всех зависимостей этой записи. При чтении YAML пропущенный список может превратиться в null; это не обещание работоспособного плана. Сохраняйте настоящий список из полного экспорта.

Необязательный список Objects самого файла класса — другое поле: старый файл без него читается как класс без записей реестра. Отсутствие CLO в этом снимке не удалит целую запись из БД.

Команды плана

Два кода охватывают запись и её зависимости. Значки действий имеют подписи по наведению, фокусу клавиатуры и нажатию.

Реестр и его зависимости2 кода
CLO
CreateUpdate

Запись реестра класса

Создаёт запись с именем, типом, наименованием и видом, затем сохраняет непустой текст. Update меняет отличающиеся наименование/вид и текст через процедуры Паруса. Имя, тип и класс существующей записи не меняет. При правке только Dependencies корневой Update не требуется. SQL из PlsqlText не исполняется.

Ключ: Класс|ТИП:ИМЯ

CLO.Dep
CreateDelete

Зависимость между записями реестра

Добавляет отсутствующую пару 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 в список процедуры.

Текст процедуры может быть сохранён раньше записи таблицы: DDL не запускается. Стрелка здесь связывает создание записей с добавлением связи между ними.
Создание записей и зависимостей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

YAML
Class/Request.yaml

Список Objects содержит CLO: Name, ObjectType, PlsqlText и Dependencies вместе с остальными реквизитами.

Holkas читает файл класса и выделяет CLO по его адресу. Одиночная запись объединяется с существующим классом репозитория; если класса и его создания нет, запись отклоняется. В корне репозитория — .holkas.

S3

JSON в ZIP
ClassObject/Request%7CPROCEDURE%3AP_REQUEST_SAVE.json

Отдельная запись CLO с реквизитами и dependencies, как у «Файла пакета». Оглавление указывает CLO и полное имя Request|PROCEDURE:P_REQUEST_SAVE.

Одиночная запись CLO без CLS сохраняется и читается обратно.

Файл пакета

JSON в ZIP
ClassObject/Request%7CPROCEDURE%3AP_REQUEST_SAVE.json

Отдельная запись CLO с реквизитами и dependencies. Оглавление указывает CLO и полное имя Request|PROCEDURE:P_REQUEST_SAVE.

Holkas берёт JSON по типу и имени из оглавления; CLS может лежать отдельно. В имени файла | заменён на %7C, а : — на %3A. Внутри данных разделители остаются обычными символами.

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 прочитаны процедуры, ограничения и словарь видов без записи. Локальные пробы плана и файлов не являются переносом в БД. Новый перенос и проверка клиентов Паруса не выполнялись. Имена и схемы учебные.