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

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

Сообщение

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

Парус · Oracle и PostgreSQL

В командной строке: --object MSG:OwnerMissing · как задать состав в CLI

Сообщение КОР Парус 8: код, тип и текст, команды, зависимости, ограничения обновления и хранение в Git и ZIP.

← Все объекты
На этой странице

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

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

ИдентификаторMSG + Code
СоставКод, тип и текст
Удаление сообщенияНе формируется

Сообщение в КОР

Сообщение — именованный текст для пользователя. Например, ограничение «Сумма должна быть положительной» использует сообщение с кодом CheckAmount. Сообщение содержит слова для показа, а условие проверки суммы хранится в самом ограничении.

В КОР различаются два типа: сообщение ограничения для ограничений и связей классов и сообщение исключения для методов класса. В файлах Holkas им соответствуют Kind = 0 и Kind = 1. Название словаря «Сообщения (исключений)» не означает, что все его записи имеют тип 1.

Тип сообщения и технология производства — разные свойства. Технологию «Стандарт» или «Конструктор» задаёт Парус. Holkas переносит код, тип и текст; технология, владелец и производитель исходной записи в описание MSG не входят. Наличие сообщения в приёмнике само по себе не включает проверку и не меняет исполняемый код метода.

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

Один самостоятельный объект без вложенных частей. Три реквизита принадлежат самому сообщению и переносятся одной командой.

Ограничения, связи и методы, использующие этот код, не являются частями сообщения. Выбор MSG CheckAmount не добавляет их в состав переноса. Выбор класса также не включает все его сообщения автоматически: нужные MSG включают отдельно либо добавляют при разборе известных недостающих зависимостей. Holkas хранит сообщение самостоятельно, а не внутри описаний ограничений и связей класса.

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

3 поля · 1 группа

Все поля сообщения в модели переноса. Техническое имя совпадает с Git YAML; рядом указано имя JSON для S3 и «Файла пакета».

Как читать обозначения

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

Сообщение · MSG 3 поля
CodeJSON: codeстрокаКлючМнемокод сообщения
Назначение
Код записи словаря, например CheckAmount. Указывается без схемы PARUS; внутренний номер RN между базами не переносится. В обследованном Oracle / Парус 27.08.2026 длина кода — до 32 знаков.
При переносе:
Нет такого кода в приёмнике — создаётся новое сообщение. Если заменить код на CheckAmountNew, прежнее сообщение CheckAmount сохранится. Ссылки ограничений, связей и исполняемый текст методов автоматически не переписываются.
KindJSON: kindцелое / nullСравниваетсяТип сообщения
Назначение
0 — сообщение ограничения, 1 — сообщение исключения. Ноль — заданный тип, а null — отсутствие значения в описании; они не равны.
При переносе:
При создании передаётся Парусу вместе с кодом и текстом. Смена типа существующего кода, в том числе между 0 и null, даёт предупреждение в плане БД и отказ всей Update MSG. Даже одновременно изменённый Text не запишется. Holkas не подставляет тип по умолчанию и не пересоздаёт сообщение.
TextJSON: textстрока / nullСравниваетсяТекст для пользователя
Назначение
Слова, которые покажет Парус, например «Сумма должна быть положительной». Это не условие ограничения и не программа метода. В обследованном Oracle / Парус 27.08.2026 длина текста — до 1000 знаков.
При переносе:
При прежнем Kind новый текст передаётся в Update MSG. Пробелы и регистр учитываются, различия окончаний строк — нет; null и пустая строка сами по себе не дают различия. При создании или другой правке null передаётся как пустое значение, а не как просьба сохранить старый текст. Допустимость проверяет Парус.
Какие сведения остаются за границей MSG

В модели нет папки каталога, её имени или полного пути. Каталог Message/ в Git и ZIP — место хранения файла, а не папка Паруса, которую нужно искать или создавать в приёмнике. Служебный RN, технология, владелец и производитель не переносятся. Создание выполняется процедурой Паруса для пользовательского сообщения; служебные сведения задаёт приёмник.

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

Один код команды — MSG. Ключ — код сообщения. Отдельных команд для текста и типа нет; Delete и SetOrder не формируются.

MSG
CreateUpdate

Создание сообщения или изменение текста

В БД отсутствие кода даёт Create; отличие Kind или Text — Update, совпадение реквизитов — отсутствие команды. Create вызывает P_DMSMESSAGES_INSERT_ADV с кодом, типом и текстом. Update находит внутренний номер сообщения по коду и вызывает P_DMSMESSAGES_UPDATE с кодом и текстом; смена типа отклоняется до этого вызова.

Git сохраняет файл и допускает смену Kind. S3 и «Файл пакета» создают новый ZIP без сравнения с прежним архивом. Сохранение описания с другим типом не снимает запрет при последующей установке в БД.

Ключ: Код сообщения · пример: CheckAmount

Ограничения и решения

Нужно изменить тип существующего сообщения

У CheckAmount в приёмнике Kind = 0, а в источнике Kind = 1 и новый текст. План БД оставит Update MSG и предупредит: не перенесутся ни тип, ни новый текст. Команда автоматически не исключается; если оставить её на выполнение, она получит отказ. Исполняемый SQL для неё в превью не показывается.

Если нужно только исправить текст, сохраните прежний тип в источнике и постройте план заново. Для другого назначения создайте сообщение с новым кодом и отдельно перенастройте использующие его ограничения, связи или код методов. Holkas не удаляет и не пересоздаёт сообщение под тем же кодом. Старый сохранённый план нужно перестроить, чтобы увидеть предупреждение, добавленное в 0.1.27.

Парус запрещает изменение штатного сообщения

Штатное сообщение можно использовать в доработке, но Парус защищает запись стандартной технологии от исправления. Если такой запрет сработает при Update MSG, текст в приёмнике останется прежним. В обычном режиме Holkas помечает распознанный отказ «не лечится»; сама операция от него не становится неуспешной. Завершённая операция не означает, что этот текст изменился: причина указана у команды и в журнале.

В режиме одной транзакции на PostgreSQL такой отказ останавливает перенос и откатывает предыдущие команды этой транзакции. Подробнее о режиме одной транзакции.

Например, вместо попытки переписать штатное сообщение создайте собственное с новым кодом и измените ссылку нужного ограничения. Технология и производитель исходной записи в MSG не входят; перенос не предназначен для воспроизведения принадлежности записи поставщику.

В файле нет типа или текста

Поля Kind и Text допускают null в модели, но это не обещание, что Парус разрешит создать такую запись. Holkas передаёт их процедуре без подстановки осмысленного типа или текста; ограничения приёмника могут отказать. Используйте полный экспорт с нужным типом и непустым текстом.

Замена непустого Text на null отличается от оставления записи неизменной: это попытка передать пустой текст. А замена только null на пустую строку, как и только LF на CRLF, команды не создаёт. Такую правку нельзя использовать как способ принудительно перезаписать сообщение.

Код переименован или сообщение исчезло из источника

CheckAmountNew и CheckAmount — разные адреса. Если нового кода в приёмнике нет, появится Create MSG; прежний код и ссылки на него сохранятся. Сначала перенесите новое сообщение и нужные ссылки. Удаление прежней записи требует отдельного решения в Парусе.

Отсутствие сообщения в выбранном наборе не создаёт Delete. Если в наборе явно запрошен код, которого уже нет в источнике БД, Holkas сообщит, что объект не найден; это не команда удалить его из приёмника.

Рёбра команд сообщения

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

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

1 · СначалаСоздать сообщениеCreate MSG · CheckAmount
→
2 · ЗатемСоздать ограничениеCreate CNS · Request|PositiveAmount
Учебный пример: MessageCode ограничения равен CheckAmount. Если сообщение уже существует и создавать его не нужно, команды Create MSG и этого ребра в плане не будет.

Непосредственно связанные правила · 5

Само MSG не объявляет зависимостей от других объектов. Ниже — ссылки на него из ограничений, связей и строк наборов данных, а также два общих правила скриптов. Это число правил, а не число рёбер в каждом плане.

Ограничения, связи и наборы данных3 правила
Create MSG→Create / Update CNS

Когда: MessageCode ограничения содержит код сообщения. Сначала создать сообщение, затем записать ссылающееся на него ограничение.

Create / Update MSG→Create / Update DAT.Row

Когда: внешняя адресная ссылка строки набора ведёт в DMSMESSAGES по CODE. Ссылка должна быть внешней для самого набора. Подготовить сообщение до записи строки, которая его использует; содержимое этой строки не становится частью MSG.

Скрипты автора при работе с БД2 правила
Create SCR · Before→Create / Update MSG

Когда: скрипт выполняется до всего переноса либо до этого сообщения. Он должен завершиться до записи сообщения. Без подходящих команд скрипт из плана убирается.

Create / Update MSG→Create SCR · After

Когда: та же область действия скрипта, но запуск после объектов. Сначала записать сообщение, затем выполнить скрипт.

Это зависимости выполнения: снятие создания MSG снимает зависимую команду, а ошибка создания блокирует её. Рёбра ограничений и связей ждут именно Create MSG, а не обновление текста существующего сообщения. Строка DAT.Row ждёт и создания, и обновления MSG. Универсального ребра от метода к сообщению, упомянутому в его исполняемом тексте, нет.

Указание MSG как зависимости само не включает его в состав. Известная ссылка проверяется по приёмнику и при отсутствии сообщения даёт предупреждение; такая проверка возможна и у совпавшего ограничения или связи. Как дополнить состав — в разборе недостающих зависимостей. Правила и ограничения скриптов разобраны отдельно.

Пример: существующая связь переходит на новое сообщение
1 · СначалаСоздать сообщениеCreate MSG · OwnerMissing
→
2 · ЗатемИзменить связьUpdate LNK · Request|OwnerLink

В источнике у связи Request|OwnerLink новый MessageCode1 — OwnerMissing, которого в приёмнике ещё нет. Изменение связи ждёт создания этого сообщения. MessageCode2 проверяется отдельно: ребро появляется, только если меняется и он.

Порядок не зависит от того, в какой последовательности объекты выбраны в наборе. Если создание снято с плана или завершилось ошибкой, изменение связи тоже не выполняется, и связь остаётся с прежней ссылкой. Связь с прежними кодами сообщений этих рёбер не объявляет.

Как сообщение хранится в файлах

Начните с каталога Message/. Для учебного кода CheckAmount все три реквизита находятся в одном файле; вложенных объектов и файлов на каждый реквизит нет.

Git

YAML
Message/CheckAmount.yaml

Один файл с полями Code, Kind и Text. В корне репозитория — .holkas со сведениями о нём.

Holkas сохраняет описание сообщения в этот файл и при чтении восстанавливает MSG из него.

S3

JSON в ZIP
Message/CheckAmount.json

Внутри ZIP — один JSON с полями code, kind и text. Архив хранится в S3.

При чтении состав берётся из manifest.json, затем читается указанный файл сообщения.

Файл пакета

JSON в ZIP
Message/CheckAmount.json

Скачиваемый ZIP содержит такой же JSON сообщения. В оглавлении оно указано один раз.

После загрузки ZIP при чтении восстанавливается MSG по manifest.json и файлу Message/…json.

Для MSG оба вида ZIP (S3 и «Файл пакета») сохраняют одинаковые поля и при чтении дают одно описание. Это проверено для сообщения и не означает одинаковой раскладки всех других типов. Использующие его ограничения, связи и методы хранятся по собственным правилам, только если включены в выгрузку; MSG не вкладывается в их JSON.

В manifest.json запись имеет вид {"typeCode":"MSG","name":"CheckAmount"}. Там же находятся версия формата, СУБД и сведения об экспорте; подробнее — в справке о пакете. Имя файла кодируется безопасно: например, / в имени заменяется на %2F, само поле Code от этого не меняется. Сохраняйте согласованность кода, адреса в оглавлении и имени файла.

Полное учебное описание в YAML и JSON

Эти примеры содержат все три поля одного сообщения и прошли обратное чтение средствами Holkas из файлов. Это учебные данные; новый перенос в Парус при подготовке страницы не выполнялся.

Git — Message/CheckAmount.yaml

Code: CheckAmount
Kind: 0
Text: Сумма должна быть положительной

S3 и «Файл пакета» — Message/CheckAmount.json

{
  "code": "CheckAmount",
  "kind": 0,
  "text": "Сумма должна быть положительной"
}

При записи поля с null опускаются; 0 сохраняется как число и означает тип «Сообщение ограничения». Обратное чтение файла с пропущенными Kind и Text даёт null, а не тип 0 или текст по умолчанию. Успешное чтение такого файла не доказывает возможность его установки в БД.

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

Основа справки: руководство «ПАРУС-Бюджет 8. Конструктор отраслевых расширений», издание 2026, гл. 1, с. 9–10 и гл. 2, с. 28; сохранённое исследование сообщений на Oracle / Парус 27.08.2026; модель, команды, применение и файловые читатели и писатели Holkas 0.1.30. Сверено 8 ноября 2026. CheckAmount, класс Request и схемы — учебные примеры. Новый перенос в БД не выполнялся.