Парус 8 · Конструктор отраслевых расширений
Сообщение хранит текст, который Парус показывает при нарушении ограничения, связи классов или при выполнении метода. Перенос текста и перенос использующего его правила — отдельные действия.
MSG + CodeСообщение в КОР
Сообщение — именованный текст для пользователя. Например, ограничение «Сумма должна быть положительной» использует сообщение с кодом CheckAmount. Сообщение содержит слова для показа, а условие проверки суммы хранится в самом ограничении.
В КОР различаются два типа: сообщение ограничения для ограничений и связей классов и сообщение исключения для методов класса. В файлах Holkas им соответствуют Kind = 0 и Kind = 1. Название словаря «Сообщения (исключений)» не означает, что все его записи имеют тип 1.
Тип сообщения и технология производства — разные свойства. Технологию «Стандарт» или «Конструктор» задаёт Парус. Holkas переносит код, тип и текст; технология, владелец и производитель исходной записи в описание MSG не входят. Наличие сообщения в приёмнике само по себе не включает проверку и не меняет исполняемый код метода.
Что входит в перенос
Ограничения, связи и методы, использующие этот код, не являются частями сообщения. Выбор MSG CheckAmount не добавляет их в состав переноса. Выбор класса также не включает все его сообщения автоматически: нужные MSG включают отдельно либо добавляют при разборе известных недостающих зависимостей. Holkas хранит сообщение самостоятельно, а не внутри описаний ограничений и связей класса.
Справочник полей
3 поля · 1 группаВсе поля сообщения в модели переноса. Техническое имя совпадает с Git YAML; рядом указано имя JSON для S3 и «Файла пакета».
Как читать обозначения
Наведите указатель на значок, перейдите клавишей Tab или нажмите, чтобы прочитать пояснение.
Ключ определяет, какое сообщение 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. Ключ — код сообщения. Отдельных команд для текста и типа нет; Delete и SetOrder не формируются.
MSGСоздание сообщения или изменение текста
В БД отсутствие кода даёт 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 правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше. Например, сначала нужно создать сообщение, затем — ограничение, которое использует его код.
Create MSG · CheckAmountCreate CNS · Request|PositiveAmountНепосредственно связанные правила · 5
Само MSG не объявляет зависимостей от других объектов. Ниже — ссылки на него из ограничений, связей и строк наборов данных, а также два общих правила скриптов. Это число правил, а не число рёбер в каждом плане.
Ограничения, связи и наборы данных3 правила
Create MSG→Create / Update CNSКогда: MessageCode ограничения содержит код сообщения. Сначала создать сообщение, затем записать ссылающееся на него ограничение.
Create MSG→Create / Update LNKКогда: у новой связи заданы MessageCode1 и/или MessageCode2, а у существующей один из этих кодов меняется. Для каждого кода объявляется своя зависимость. Сообщения нужны до записи связи.
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 как зависимости само не включает его в состав. Известная ссылка проверяется по приёмнику и при отсутствии сообщения даёт предупреждение; такая проверка возможна и у совпавшего ограничения или связи. Как дополнить состав — в разборе недостающих зависимостей. Правила и ограничения скриптов разобраны отдельно.
Пример: существующая связь переходит на новое сообщение
Create MSG · OwnerMissingUpdate LNK · Request|OwnerLinkВ источнике у связи Request|OwnerLink новый MessageCode1 — OwnerMissing, которого в приёмнике ещё нет. Изменение связи ждёт создания этого сообщения. MessageCode2 проверяется отдельно: ребро появляется, только если меняется и он.
Порядок не зависит от того, в какой последовательности объекты выбраны в наборе. Если создание снято с плана или завершилось ошибкой, изменение связи тоже не выполняется, и связь остаётся с прежней ссылкой. Связь с прежними кодами сообщений этих рёбер не объявляет.
Как сообщение хранится в файлах
Начните с каталога Message/. Для учебного кода CheckAmount все три реквизита находятся в одном файле; вложенных объектов и файлов на каждый реквизит нет.
Git
YAMLMessage/CheckAmount.yamlОдин файл с полями Code, Kind и Text. В корне репозитория — .holkas со сведениями о нём.
S3
JSON в ZIPMessage/CheckAmount.jsonВнутри ZIP — один JSON с полями code, kind и text. Архив хранится в S3.
При чтении состав берётся из manifest.json, затем читается указанный файл сообщения.Файл пакета
JSON в ZIPMessage/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 и схемы — учебные примеры. Новый перенос в БД не выполнялся.