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

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

Представление класса

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

Парус · Oracle и PostgreSQL

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

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

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

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

Представление класса объясняет Парусу, какие колонки запроса соответствуют атрибутам раздела. Например, колонка NRN в списке заявок представляет атрибут RN класса «Заявки».

АдресVIW + UnitCode|ViewName
Вложенные частиПараметры и соответствия колонок
Удаление целого представленияНе формируется

Представление в КОР

Представление класса — описание набора атрибутов для работы Паруса. У каждой зарегистрированной колонки есть имя в результате запроса и соответствующий атрибут своего класса. Для поля основной таблицы это физический атрибут; для поля другой таблицы — атрибут «получен по связи»; для вычисляемого значения — логический атрибут. Само соответствие не вычисляет значение и не создаёт атрибут класса.

В учебном примере класс Request описывает заявки. Представление UDO_V_REQUEST возвращает NRN и SCODE: первое соответствует атрибуту RN, второе — CODE. Форма может использовать эти соответствия для отображения данных. В Holkas это VIW · Request|UDO_V_REQUEST.

VIW и представление базы — разные объекты. При CustomQuery=0 описание называет физическое представление по ViewName: например, JVW · PARUS.UDO_V_REQUEST в Oracle или JVP · parus.udo_v_request в PostgreSQL. Его определение, колонки и права переносятся отдельно. При CustomQuery=1 SQL находится прямо в QuerySql у VIW; отдельный объект БД с именем ViewName для этого режима не требуется.

Клиентское представление (Accessibility=1) может использоваться графическим интерфейсом Паруса. Этот признак не выдаёт пользователю права SELECT и не добавляет проверку доступа в запрос. Сам VIW не содержит ни разметку формы, ни строки результата запроса.

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

Реквизиты и QuerySql принадлежат самой VIW. Parameters и AttributesView — вложенные списки; VIW.Param и VIW.Attr — коды команд над их элементами. Домены, атрибуты CLS и физическое представление остаются внешними объектами.

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

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

12 полей · 3 группы

Шесть реквизитов VIW, два списка и по два поля их элементов. Техническое имя совпадает с Git YAML; рядом указано имя JSON для S3 и «Файла пакета».

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

Ключ определяет сопоставляемое представление, параметр или соответствие. Сравниваемые поля могут дать Update. Поэлементные списки дают собственные Create, Update и Delete; порядок строк массива сам по себе не меняет объект.

План показывает различие, а допустимость записи проверяет Парус. Процедуры Паруса относятся к приёмнику БД. Git сохраняет описание; S3 и «Файл пакета» создают новый ZIP.

Представление класса · VIW8 полей
UnitCodeJSON: unitCodeстрокаЧасть ключаКласс-владелец
Назначение
Код класса CLS, которому принадлежит VIW; в примере Request. Не схема базы и не имя таблицы.
При переносе:
Вместе с ViewName задаёт адрес. Смена класса адресует новый объект; прежняя запись автоматически не удаляется. При Create класс ищется в UNITLIST, при Update представление ищется по классу и ViewName.
ViewNameJSON: viewNameстрокаЧасть ключаИмя представления
Назначение
Имя VIW. При CustomQuery=0 одновременно называет физическое представление в схеме PARUS; при CustomQuery=1 служит именем регистрации собственного запроса.
При переносе:
Передаётся при Create / Update. Ключ не переименовывается: новое имя даёт другой объект. В обследованном Парусе имя до 30 символов, уникально по всей базе и при создании приводится к верхнему регистру. Для физического объекта план использует имя PARUS.ИМЯ на Oracle и parus.имя на PostgreSQL.
NoteJSON: noteстрокаСравниваетсяНаименование
Назначение
Читаемое наименование VIW, например «Заявки». Это поле VIEW_NOTE, не SQL-комментарий и не разметка формы.
При переносе:
Разница даёт Update VIW. Передаётся в процедуру при создании и изменении. В обследованной БД обязательно, до 240 символов, уникально среди представлений одного класса. Если наименование переходит к другому представлению этого класса, Holkas сначала освобождает его, а обмен по кругу не переносит и называет в плане — см. «Представления меняются наименованиями». Удаление поля из файла не означает «сохранить прежнее наименование».
AccessibilityJSON: accessibilityцелое / nullСравниваетсяВызывается с клиента
Назначение
0 — не клиентское, 1 — клиентское представление. Клиентский вид может использоваться графическим интерфейсом Паруса.
При переносе:
Сохраняется при Create / Update VIW. Не выдаёт права доступа и не добавляет фильтр записей. В обследованной БД допускаются только 0 и 1, null запрещён; nullable в модели не отменяет этого требования.
CustomQueryJSON: customQueryцелое / nullСравниваетсяЗапрос задаётся вручную
Назначение
0 — используется одноимённое физическое представление; 1 — собственный запрос из QuerySql. Это способ реализации VIW, а не доступность пользователю.
При переносе:
Задаётся при Create. Отличие у существующей VIW даёт Update, который при применении в БД отклоняется целиком до вызова процедуры: изменить этот признак нечем. В обследованной БД допустимы только 0/1, null запрещён. Создавайте новый объект с другим именем, если нужен другой способ реализации.
QuerySqlJSON: querySqlстрока / nullСравниваетсяТекст собственного запроса
Назначение
SQL для CustomQuery=1. Для CustomQuery=0 должен отсутствовать; определение физического JVW/JVP находится в другом объекте.
При переносе:
Отличие текста даёт Update VIW даже при неизменных прочих реквизитах. CRLF и LF равны; null и пустая строка различаются. Текст передаётся процедуре при Create / Update, без исполнения запроса и перевода диалекта. В обследованной БД ограничен 4000 символами; режим 1 требует непустой текст, режим 0 — null.
ParametersJSON: parametersсписокПо элементамПараметры запроса
Назначение
Имена входных значений запроса и коды их доменов. Конкретные значения при вызове здесь не хранятся. Параметры допустимы только для собственного запроса (CustomQuery=1); у обычной VIW список пуст.
При переносе:
Сопоставляется по ParameterName. Новые элементы дают Create VIW.Param, отличающийся Domain — Update, отсутствующие — Delete. [] снимает все параметры выбранного представления. Сам QuerySql не разбирается для заполнения списка; порядок строк несущественен.
AttributesViewJSON: attributesViewсписокПо элементамАтрибуты представления
Назначение
Соответствия колонок результата атрибутам своего класса. Например NRN → RN. Здесь нет собственных подписей, позиций и форматов колонок.
При переносе:
Сопоставляется по ColumnName. Добавления, смена Attribute и удаления дают команды VIW.Attr. [] снимает все соответствия; атрибуты CLS и физические колонки остаются. Порядок массива не задаёт порядок колонок формы; команды SetOrder нет.
Параметр запроса · VIW.Param2 поля
ParameterNameJSON: parameterNameстрокаКлючИмя параметра
Назначение
Имя параметра внутри VIW, например NRN для :NRN в учебном запросе. Это имя входного значения, не имя домена и не значение RN.
При переносе:
Уникально внутри представления; в обследованной БД обязательно, до 30 символов. Парус запрещает добавление параметра при CustomQuery=0. Смена имени даёт Delete прежнего и Create нового параметра. Holkas сам не переименовывает ссылку в QuerySql или настройках вызова.
DomainJSON: domainстрокаСравниваетсяДомен параметра
Назначение
Код DOM, например TRN. Домен определяет тип параметра; его описание и значения перечисления сюда не вложены.
При переносе:
Create и Update VIW.Param разрешают код в номер домена и ждут Create DOM, если такой команды требует набор. Update DOM и его значения этим ребром не ожидаются. Ссылка обязательна в обследованной БД. Удаление параметра не удаляет домен.
Атрибут представления · VIW.Attr2 поля
ColumnNameJSON: columnNameстрокаКлючКолонка результата
Назначение
Имя колонки запроса или физического представления, например NRN. Отличается от Attribute, даже если в конкретной VIW имена совпадают.
При переносе:
Уникально внутри VIW; в обследованной БД обязательно, до 32 символов. Смена даёт Delete старого и Create нового соответствия. Эти команды не выполняют ALTER VIEW, не переименовывают колонку SQL и не исправляют QuerySql.
AttributeJSON: attributeстрокаСравниваетсяАтрибут своего класса
Назначение
ColumnName атрибута CLS, которому соответствует колонка результата. Ищется в классе UnitCode этой VIW. Для поля из другого класса нужен атрибут «получен по связи» своего класса.
При переносе:
При прежнем ColumnName смена даёт Update VIW.Attr. Create и Update ждут Create CLS.Attr нового атрибута. Один атрибут нельзя повторить в нескольких соответствиях одной VIW. Если прежний атрибут удаляется тем же переносом, Update сначала переключает колонку, а Delete CLS.Attr выполняется после него — так же, как при удалении соответствия. Если значение переходит от одного элемента к другому, Holkas сначала освобождает его, а обмен по кругу не переносит и называет в плане — см. «Колонки меняются атрибутами».
Null, ноль и пустой текст

У Note, имён и ссылок сравнение приравнивает null к пустой строке, CRLF к LF. Это не делает обязательное имя или наименование необязательным при записи. Пробелы и регистр содержимого значимы.

QuerySql сравнивается как тело запроса: null и пустая строка различаются; CRLF и LF равны. У CustomQuery=0 в полном экспорте запрос отсутствует (null), у CustomQuery=1 нужен непустой текст. В обследованном Парусе PostgreSQL нельзя записать пустую строку вместо допустимого SQL. Нулевые Accessibility и CustomQuery — настоящие значения признаков, а null не равен нулю.

При выгрузке поля null опускаются, а нули и пустые списки сохраняются. При Create / Update VIW QuerySql передаётся процедуре, в том числе null: это не команда «оставить старый текст».

Оба списка задают полный состав

Parameters: [] снимает все параметры выбранной VIW; AttributesView: [] — все её соответствия колонок. Пустой список не означает «не менять». Сами атрибуты класса, домены, SQL-колонки и представление при этом не удаляются.

При загрузке ZIP из S3 и «Файла пакета» пропущенный список и null вместо него отклоняются. При загрузке из Git пропущенный список может превратиться в null; это не подтверждает допустимость дальнейшего плана. При ручной правке сохраняйте оба явных списка.

Что остаётся за границами модели

RN представления, класса, домена и атрибутов не переносятся: приёмник находит записи по именам. ATTR_KIND вычисляет Парус по атрибуту класса, производителя задаёт приёмник. Папки каталога у VIW нет: класс и ViewName задают её адрес; папки в Парусе не ищутся и не создаются. Class/ и View/ ниже — каталоги файлов.

Колонка PARENT таблицы представлений в Парусе не используется: в руководстве КОР её нет, а в обследованных базах Oracle и PostgreSQL она пуста. Holkas её не читает и не переносит.

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

Три кода охватывают VIW и оба её списка. Подписи значков доступны по наведению, фокусу клавиатуры и нажатию.
Представление и его части3 кода
VIW
CreateUpdate

Описание представления и запрос

Создаёт отсутствующую VIW либо обновляет Note, Accessibility и QuerySql существующей через процедуры Паруса. Отличие только списков не требует Update корня. CustomQuery задаётся при создании; обнаруженное отличие у существующей записи приводит к отказу этой команды в БД. Перенос не исполняет QuerySql и не создаёт одноимённое физическое представление.

Ключ: Класс|Имя представления

VIW.Param
CreateUpdateDelete

Параметр запроса

Добавляет параметр собственного запроса (CustomQuery=1), меняет его домен при прежнем имени или снимает отсутствующий параметр. При Create / Update заново разрешается Domain; Delete удаляет только описание параметра. QuerySql и настройки передачи значений автоматически не исправляются.

Ключ: Класс|Имя представления|ParameterName

VIW.Attr
CreateUpdateDelete

Соответствие колонки атрибуту

Добавляет соответствие, при прежнем имени колонки меняет Attribute либо снимает отсутствующую пару. Атрибут ищется в классе представления. Физические колонки и атрибуты CLS эти команды не создают и не удаляют. Позиции списка не записываются; SetOrder нет.

Ключ: Класс|Имя представления|ColumnName

Delete целой VIW по отсутствию в наборе не формируется. Самостоятельных объектов VIW.Param и VIW.Attr в каталоге нет: это команды над списками выбранной VIW.

Пример: убрать колонку из представления

В приёмнике AttributesView содержит NRN → RN и SCODE → CODE, а в списке источника остаётся только NRN → RN. План даёт Delete VIW.Attr · Request|UDO_V_REQUEST|SCODE. Снимается соответствие: атрибут CODE класса и колонка SCODE физического представления остаются.

Если также изменён QuerySql, появится Update VIW. Удаление только соответствия не переписывает SQL, а удаление колонки из SQL само не удаляет её описание в AttributesView. Согласуйте оба изменения. Перемещение строк массива без смены ColumnName и Attribute команд не создаёт.

Ограничения и что с ними делать

Нельзя переключить способ задания запроса у существующей VIW

Например, в приёмнике CustomQuery=0, а в источнике 1 с заполненным QuerySql. Holkas видит отличие и строит Update VIW, но при применении в БД отклоняет его: у процедуры изменения нет аргумента CustomQuery. Тот же запрет действует при 1 → 0. Смена флажка в файле не обходит ограничение.

Подготовьте новое представление с другим ViewName и согласуйте его использование в формах и настройках вызова. Старую VIW Holkas по отсутствию в наборе не удалит. Не рассчитывайте, что отказ корня защитит все части: они не ждут Update VIW и в обычном режиме уже выполненные команды не откатываются вместе с ним. Режим одной транзакции останавливает перенос с откатом при отказе.

Имя представления — ключ, а наименование тоже должно быть уникальным

Новый ViewName или UnitCode адресует другой объект; прежняя VIW не переименовывается и не переносится между классами автоматически. В обследованном Парусе имя представления уникально по всей базе, записывается заглавными буквами; наименование Note уникально внутри класса. Например, создание второй VIW с тем же Note «Список заявок» может получить отказ, даже если ViewName новый.

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

Представления меняются наименованиями

Note уникально среди представлений класса (C_DMSCLVIEWS_VIEW_NOTE_UK): Парус не даёт занять наименование, пока его держит другое представление.

Цепочка — например, A: «Z1» → «Z2», B: «Z2» → «Z3». Holkas упорядочивает команды сам: сначала B освобождает «Z2», потом его получает A. Новый объект, которому нужно освобождаемое наименование, тоже ждёт. Всё проходит за один перенос, в каком бы порядке объекты ни шли в наборе.

Обмен по кругу — например, A: «Первое» → «Второе», B: «Второе» → «Первое». Без временного наименования его не выполнить, а промежуточные значения Holkas не записывает. План в базу Паруса называет такие представления в предупреждении и оставляет им наименования приёмника; остальные их правки переносятся. В Git и файл обмен записывается как есть. Поменяйте наименования в приёмнике вручную или в три переноса: дайте в источнике одному объекту свободное временное наименование, перенесите, затем верните нужные наименования и перенесите снова.

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

Проверено на PostgreSQL и Oracle.

Один атрибут нельзя привязать к двум колонкам одной VIW

В Парусе уникальны и имя колонки, и используемый атрибут внутри представления. Если NRN → RN уже существует, добавление ID → RN до снятия прежнего соответствия нарушит уникальность. Простое переименование ColumnName в полном списке даёт Delete старой пары и Create новой; атрибут класса RN остаётся.

Переход атрибута от одной сохранённой колонки к другой и обмен по кругу описаны в «Колонки меняются атрибутами».

Колонки меняются атрибутами

Attribute уникально среди колонок представления (C_DMSCLVIEWSATTRS_PRN_ATTR_UK): Парус не даёт занять значение, пока его держит соседний элемент.

Цепочка — например, NRN → RN, NPRN → PRN сменяются на NRN → PRN, NPRN → CRN. Holkas упорядочивает команды сам: сначала освобождает значение, потом занимает его. Всё проходит за один перенос.

Обмен по кругу — например, NRN: RN → PRN, NPRN: PRN → RN. Без временного значения его не выполнить, а промежуточные значения Holkas не записывает. План в базу Паруса называет такие элементы в предупреждении и оставляет им значения приёмника; остальные правки объекта переносятся. В Git и файл обмен записывается как есть. Поменяйте значения в приёмнике вручную или в три переноса: дайте в источнике одному элементу свободное временное значение, перенесите, затем верните нужные значения и перенесите снова.

Если значение держит элемент, который в этом переносе его не меняет и не удаляется, команда получает отказ «Значение уже занято другой записью приёмника…» с именем ограничения.

Проверено на PostgreSQL и Oracle.

Смена привязки и удаление прежнего атрибута одним планом

Пусть NRN меняет Attribute с RN на ALT_RN, а RN одновременно удаляется из класса. План выстраивает команды так: Create CLS.Attr ALT_RN, затем Update VIW.Attr NRN, затем Delete CLS.Attr RN. Порядок объектов во входном списке на это не влияет.

Если пользователь снимет команду Update VIW.Attr или она завершится ошибкой, Delete CLS.Attr RN тоже не выполнится: колонка всё ещё ссылается на RN.

Наличие физического представления не подтверждает его колонки и права

Для CustomQuery=0 Holkas проверяет зависимость по имени JVW/JVP, но не доказывает, что у него есть каждая колонка AttributesView с нужным типом. Например, существующее udo_v_request без SCODE закрывает ссылку по имени, но не обеспечивает работу отображения SCODE. Так задумано: сам Парус при записи представления класса колонки тоже не проверяет, а показывает расхождения только в предупреждениях класса. Holkas переносит описание как в источнике, а физическое представление — отдельный объект: в одной СУБД его переносят в том же наборе, при переносе между СУБД его готовят вручную.

Сверьте физические колонки с ColumnName и доменами атрибутов, доступность представления пользователю и предупреждения класса в Парусе. Для клиентского запроса по руководству КОР нужны поля первичного ключа и применимых делений, каталогов и master-раздела; одна запись исходной таблицы не должна дублироваться. Accessibility=1 этих условий не создаёт.

Собственный QuerySql сохраняется без проверки выполнения и перевода SQL

Команда VIW сохраняет текст в метаданных; она не выполняет его как скрипт, не переводит Oracle SQL в PostgreSQL и не создаёт таблицы или функции из запроса. Например, после переноса запроса с Oracle-функцией её реализация для PostgreSQL сама не появится.

Подготовьте совместимый текст и его внешние объекты отдельно. Параметры допустимы только при CustomQuery=1: Парус запрещает добавление VIW.Param в обычное физическое представление. Parameters описывает имена и домены, но не хранит пользовательские значения и не сканирует текст для автоматического восстановления списка. Убедитесь, что имена параметров и псевдонимы колонок согласованы с запросом и настройками его вызова.

Рёбра команд

Что такое ребро и где оно видно в Holkas →

Ребро задаёт порядок выполнения команд. Связь «колонка соответствует атрибуту» сама по себе не заменяет этот порядок.

СначалаCreate CLS.AttrАтрибут Request.RN

Класс и сама VIW также должны существовать.

→
ЗатемCreate VIW.AttrКолонка NRN → атрибут RN

Добавляется описание соответствия в представлении.

Для обычной VIW сначала готовится также физическое JVW/JVP. Для собственного QuerySql отдельного ребра на таблицы и функции внутри SQL нет.
Само представление3 правила
Create CLS · UnitCode→Create VIW

Когда: Создаётся представление класса.

Сначала нужен класс-владелец. Update класса этим ребром не ожидается.

Create / Update JVW или JVP→Create / Update VIW

Когда: CustomQuery не равен 1.

Цель — PARUS.ViewName на Oracle, parus.viewname на PostgreSQL. Для приёмника без СУБД тип выбирается по перечню источника и набору переноса; при отсутствии Oracle-кандидата — JVP. Для QuerySql при CustomQuery=1 этого ребра нет.

Update VIW, отдающий Note→Create / Update VIW, занимающий Note

Когда: VIW получает непустое Note, которое в приёмнике держит другое представление того же класса, и в этом же переносе своё Note меняет. Оба объекта входят в набор. Для обмена по кругу ребро не ставится.

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

Параметры запроса5 правил
Create VIW→Create VIW.Param

Когда: Добавляется новый ParameterName.

Подготовить запись представления. Update VIW этим правилом не ожидается.

Create DOM · Domain→Create / Update VIW.Param

Когда: Параметр создаётся либо меняется.

Домен заново разрешается и при Update. Ожидания Update DOM и DOM.Val нет.

Create / Update JVW или JVP→Create / Update VIW.Param

Когда: CustomQuery не равен 1 и в плане нет Create VIW.

Такое ребро появляется для противоречивого описания: Парус запрещает добавлять параметры при CustomQuery=0, а при допустимом CustomQuery=1 этого физического ребра нет. Не используйте его как разрешение параметризовать обычное представление.

Delete VIW.Param→Delete VIW

Когда: Снимается параметр представления.

Ребро к удалению корня предусмотрено, но обычный перенос Delete VIW не формирует. Это не добавляет такую команду в план.

Delete VIW.Param→Delete DOM · прежний Domain

Когда: Снимается параметр со ссылкой на домен.

Ребро предусматривает освобождение домена; Delete DOM Holkas сейчас не формирует. Сам домен от удаления параметра не исчезает.

Соответствия атрибутов6 правил
Create VIW→Create VIW.Attr

Когда: Добавляется новый ColumnName.

Сначала должна существовать запись представления. Update VIW не ожидается.

Create CLS.Attr · UnitCode|Attribute→Create / Update VIW.Attr

Когда: Создаётся соответствие или меняется его Attribute.

Подготовить атрибут в своём классе. Update CLS.Attr этим ребром не ожидается.

Create / Update JVW или JVP→Create / Update VIW.Attr

Когда: CustomQuery не равен 1 и нет Create VIW.

Существующий корень может не меняться; часть всё равно ссылается на физическое представление. Это не проверка наличия конкретной колонки.

Delete VIW.Attr→Delete VIW

Когда: Снимается соответствие.

Ребро к удалению корня предусмотрено, но Delete целой VIW обычным переносом не формируется.

Delete / Update VIW.Attr→Delete CLS.Attr · UnitCode|прежний Attribute

Когда: Пара отсутствует в AttributesView источника или её Attribute сменился.

Освободить атрибут до его удаления: Парус держит ссылку внешним ключом, пока на атрибут указывает колонка представления.

Update VIW.Attr, отдающий Attribute→Update VIW.Attr, занимающий Attribute

Когда: Колонка переключается на атрибут, к которому в приёмнике привязана другая колонка этой VIW, и та в этом же переносе свой Attribute меняет. Для обмена по кругу ребро не ставится.

Сначала освободить значение, потом занять: цепочка проходит за один перенос.

Формы и методы вызова, использующие представление2 правила
Create / Update VIW→Create / Update CLS.VF

Когда: В FormData либо FormDataExt формы класса распознано <form class="Класс" view="Представление">.

Форма заполнения ждёт названную VIW.

Create / Update VIW→Create / Update MEC

Когда: В Settings метода вызова источник DataSource, TreeSource или CrossSource (в том числе внутри Details) называет UnitCode и ViewName.

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

Общие правила4 правила
Create / Update объекта из Dependencies→VIW / VIW.Param / VIW.Attr

Когда: Команда ждёт JVW; его описание из источника есть в переносимом наборе, но своей корневой команды Create / Update у него нет.

Holkas добавляет сохранённые зависимости неизменённого JVW, включая их цепочку. Это данные каталога Oracle физического объекта, не анализ QuerySql у VIW.

Create / Update JTB.Col→VIW / VIW.Param / VIW.Attr

Когда: Унаследованная зависимость указывает JTB, а в плане есть создаваемые или изменяемые колонки этой таблицы.

Ждать реальные команды колонок, а не только корень таблицы. Само это ребро команд JTB.Col не создаёт.

SCR Before→VIW / VIW.Param / VIW.Attr

Когда: Приёмник исполняет скрипты; область охватывает VIW, её класс или весь перенос.

Скрипт должен завершиться до соответствующих команд. QuerySql таким скриптом не является.

VIW / VIW.Param / VIW.Attr→SCR After

Когда: Та же область при времени After.

Скрипт выполняется после охватываемых команд. Без таких команд скрипт из плана убирается.

Что эти рёбра обеспечивают

Каталог охватывает 19 правил, а не 19 рёбер в каждом плане. Три правила ведут к неформируемым Delete VIW / DOM. Ветвь параметра к физическому JVW/JVP относится к противоречивому описанию: допустимые параметры принадлежат собственному запросу. При CustomQuery=1 имена таблиц и функций внутри QuerySql не дают рёбер; ссылка строки набора данных DAT на представление класса не даёт ребра к команде VIW. Параметры и атрибуты не имеют команд SetOrder.

Создаваемые части ждут Create VIW, но не её Update. Поэтому изменение текста корня и изменение состава списков не образуют единую цепочку ожидания. Внутри каждого списка удаления выпускаются с конца текущего списка, затем изменения и создания. Это исходная очередность готовых команд, а не дополнительные рёбра между всеми парами.

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

Как представление класса хранится в файлах

Учебные пути ниже относятся к VIW · Request|UDO_V_REQUEST. Вложенные Parameters и AttributesView сохраняются вместе с описанием VIW; отдельных файлов на параметр и соответствие нет.

Git

YAML класса
Class/Request.yaml

Представление находится в Views. Внутри — реквизиты, Parameters и AttributesView с именами полей с большой буквы.

Holkas читает файл класса и раскладывает описание на CLS и самостоятельные части семейства. В корне репозитория — .holkas.

S3

Отдельный JSON в ZIP
View/Request%7CUDO_V_REQUEST.json

Файл устроен так же, как у «Файла пакета»: сама VIW и оба списка. В manifest.json есть запись VIW с именем Request|UDO_V_REQUEST.

Архив хранится в S3. Одиночная VIW без CLS сохраняется и читается обратно.

Файл пакета

Отдельный JSON в ZIP
View/Request%7CUDO_V_REQUEST.json

Файл содержит саму VIW и оба списка. В manifest.json есть запись VIW с именем Request|UDO_V_REQUEST.

Holkas берёт VIW по её собственному пути, а не ищет её в JSON класса.

При выгрузке в Git без выбранного CLS Holkas добавляет VIW в существующий файл класса. Если класса в репозитории нет, запись отказывает — добавьте CLS. При выбранном CLS файл класса собирается заново из выгружаемого семейства; отсутствующая VIW может исчезнуть из полного файла. Последующая загрузка такого файла в БД не означает Delete VIW.

ZIP из S3 и «Файла пакета» устроены одинаково, архив одного способа загружается другим. В манифесте: {"typeCode":"VIW","name":"Request|UDO_V_REQUEST"}. ZIP, записанные в S3 версией Holkas 0.1.30 или более ранней, хранили VIW в массиве views внутри Class/Request.json; такие архивы по-прежнему читаются обоими способами. Сведения о версии формата и СУБД — в справке о пакете.

Символ | в пути файла кодируется как %7C, / — как %2F; внутри ViewName и записи манифеста имя остаётся обычным. Кодирование пути не создаёт папок Паруса. Не переименовывайте файл отдельно от адреса объекта.

Одно представление в YAML класса и отдельном JSON

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

Git — фрагмент Class/Request.yaml

Views:
- UnitCode: Request
  ViewName: UDO_V_REQUEST
  CustomQuery: 1
  QuerySql: select RN as NRN, CODE as SCODE from UDO_T_REQUEST where RN = :NRN
  Parameters:
  - ParameterName: NRN
    Domain: TRN
  AttributesView:
  - ColumnName: NRN
    Attribute: RN

S3 или «Файл пакета» — фрагмент View/Request%7CUDO_V_REQUEST.json

{
  "unitCode": "Request",
  "viewName": "UDO_V_REQUEST",
  "customQuery": 1,
  "querySql": "select RN as NRN, CODE as SCODE from UDO_T_REQUEST where RN = :NRN",
  "parameters": [{"parameterName": "NRN", "domain": "TRN"}],
  "attributesView": [{"columnName": "NRN", "attribute": "RN"}]
}

Не заменяйте полные списки сокращёнными фрагментами: отсутствующие элементы приёмника могут получить команды Delete.

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

Основа справки: руководство «ПАРУС-Бюджет 8. Конструктор отраслевых расширений», издание 2026, с. 90–92; сохранённые опыты настройки разделов на Oracle и PostgreSQL / Парус 27.08.2026; текущая модель, читатели, писатели и команды Holkas 0.1.30. Сверено 8 ноября 2026; хранение в ZIP уточнено 9 ноября 2026. Размеры и ограничения таблиц уточнены по определениям PostgreSQL 27.08.2026, без записи данных. Request и UDO_V_REQUEST — учебные примеры. Перенос класса с VIW из S3 через «Файл пакета» проверен на PostgreSQL и Oracle; остальные разделы новым переносом в БД не проверялись, клиенты Паруса не запускались.