Парус 8 · Конструктор отраслевых расширений
Пиктограмма хранит значок в двух размерах. Holkas переносит его код, примечание и оба изображения между базами Паруса на Oracle и PostgreSQL; назначение значка разделу или действию относится к использующему объекту.
PIC + CodeПиктограмма в КОР
Пиктограмма — запись словаря изображений Паруса. В КОР её можно назначить классу (разделу), методу вызова или действию класса. Например, запись с учебным кодом RequestIcon хранит значок «Заявки», а поле SysImage класса указывает, что раздел должен использовать именно этот код.
Во внешних описаниях может встретиться обозначение PCT: словарь типов Holkas распознаёт его как PIC. В плане и нынешнем ZIP используется PIC.
Словарь содержит малое изображение 16 × 16 и большое 24 × 24. Руководство Паруса предусматривает BMP: меньший рисунок дополняется пустыми ячейками, больший обрезается. Holkas сам не изменяет размер и не преобразует формат — передаёт сохранённые байты. Успех переноса PNG не означает, что его сможет показать клиент Паруса; подробнее — ограничение формата.
Что входит в перенос
Выбор PIC RequestIcon не добавляет использующие значок классы, отчёты и действия. И наоборот, раскрытие семейства класса не включает саму PIC: её выбирают отдельно либо добавляют при разборе известных недостающих зависимостей. Назначение значка хранится в использующем объекте. Замена байтов под прежним кодом меняет общий значок для всех его потребителей; новый код сам по себе их не переключает.
Справочник полей
4 поля · 1 группаВсе поля модели переноса PIC. Имя поля совпадает с Git YAML; имя JSON указано отдельно для S3 и «Файла пакета».
Как читать обозначения
Наведите указатель на значок, перейдите клавишей Tab или нажмите, чтобы прочитать пояснение.
Ключ определяет запись в приёмнике. Сравнивается — разница учитывается при построении команды. Для изображений проверяются сами байты; допустимость их отображения — отдельный вопрос.
Пиктограмма · PIC 4 поля
CodeJSON: codeстрокаКлючМнемокод пиктограммы- Назначение
- Уникальный код записи словаря, например RequestIcon; без схемы PARUS. В обследованном Oracle / Парус 27.08.2026 длина — до 20 знаков.
- При переносе:
- Если Code отсутствует в приёмнике, Holkas создаёт новую PIC. При совпадении кода сравнивает её содержимое. Изменение RequestIcon на RequestIconNew не переименовывает старую запись и не переключает её потребителей.
NoteJSON: noteстрока или nullСравниваетсяПримечание- Назначение
- Произвольное пояснение к значку. Это не текст, который автоматически станет названием раздела. В обследованном Oracle / Парус 27.08.2026 длина — до 240 знаков.
- При переносе:
- При прежнем Code изменение «Значок заявок» на «Заявки: новая версия» даёт Update PIC, даже если изображения прежние. При создании примечание передаётся вместе с кодом и картинками.
SmallImageJSON: smallImageбайты или nullСравниваетсяМалое изображение · 16 × 16- Назначение
- Содержимое файла малого значка. Для клиента Паруса предусмотрен BMP 16 × 16. Это не путь к файлу и не код другой пиктограммы.
- При переносе:
- Все байты передаются в малое изображение: BLOB на Oracle, bytea на PostgreSQL. Замена только этого массива даёт одну Update PIC; большое изображение записывается из того же описания пиктограммы в источнике. В Git YAML это список чисел, в JSON обоих ZIP — Base64.
LargeImageJSON: largeImageбайты или nullСравниваетсяБольшое изображение · 24 × 24- Назначение
- Содержимое файла большого значка. Для клиента Паруса предусмотрен BMP 24 × 24. Holkas не строит его автоматически из малого.
- При переносе:
- Байты записываются в большое изображение без преобразования. Разница только здесь тоже даёт Update PIC. При совпадении байтов новый массив в памяти не считается новым изображением. В Git YAML это список чисел, в JSON обоих ZIP — Base64.
Команды плана
У PIC один код команд и два действия. Наведите указатель на пиктограмму действия, перейдите к ней клавишей Tab или нажмите, чтобы прочитать подпись.
PICПиктограмма целиком
Create создаёт запись, если нужного Code нет в приёмнике. Update появляется при изменении Note или байтов любого изображения и записывает все четыре поля пиктограммы из источника. Например, замена только малого значка при прежних примечании и большом изображении даёт одну Update PIC. При совпадении полей команды нет.
В БД Create вызывает P_SYSIMAGES_INSERT. Update находит RN по Code и вызывает P_SYSIMAGES_UPDATE; исчезнувшая из базы запись не превращается этим поиском в новую. Отдельных команд для SmallImage и LargeImage, удаления PIC и установки порядка нет.
Ключ: Код пиктограммы
В Git команда изменяет сохраняемое описание; процедуры Паруса относятся к приёмнику БД. Выгрузка в S3 или «Файл пакета» создаёт новый ZIP. В различиях полей изображение представлено числом байтов и SHA-256, а не длинным перечнем изменённых байтов; в SQL-предпросмотре показан размер двоичного аргумента.
Ограничения и что с ними делать
Байты перенеслись, но значок не отображается
Holkas не проверяет формат и размеры рисунка и не конвертирует PNG в BMP. Используйте BMP 16 × 16 и 24 × 24 согласно руководству Паруса. Например, файл PNG может успешно сохраниться в SYSIMAGES и даже показаться в редакторе словаря, но после назначения действию класса Windows-клиент сообщит «Bitmap image is not valid».
Это наблюдалось на Oracle / Парус 27.08.2026 и Holkas 0.1.26: сохранение PNG проверено в словаре, а ошибка — при открытии использующего его раздела. Web-клиент в том опыте не показывал такой ошибки. Это граница прежней проверки клиентов, а не новый прогон PostgreSQL или всех версий Паруса.
Новый код не переименовывает прежнюю пиктограмму
Замена RequestIcon на RequestIconNew описывает другую запись. Если такого кода нет, появится Create PIC; RequestIcon останется. Чтобы класс использовал новый значок, отдельно измените его SysImage на RequestIconNew. Отсутствие старой PIC в наборе не удаляет её из базы.
Новая пиктограмма для действия, метода вызова или процедуры
ACT.SysImage, MEC.SysImage и PCE.SystemImage передаются Парусу кодом, и их команды ждут Create PIC так же, как класс и отчёт. Если действие и новая RequestIcon входят в один план, RequestIcon запишется раньше действия.
Если пиктограмма не выбрана и её нет в приёмнике, план называет её недостающей зависимостью — добавьте её в набор. Без неё Парус отказывает в записи: «Пиктограмма … не определена».
Привязка записана, а клиент показывает прежний значок
Руководство Паруса предусматривает действие «Начать сеанс» для значков разделов и методов вызова, а для действий — перезапуск Системы. Например, после записи PIC под прежним кодом уже открытое меню может продолжать показывать старое изображение.
В прежней проверке Windows и Web на Oracle / Парус 27.08.2026 стандартные действия Web использовали собственные значки и игнорировали назначенную пиктограмму; меню Web также кэшировалось. Перенос байтов не меняет правила отображения клиента. Пересоздайте сеанс и проверяйте конкретное место использования, учитывая версию клиента.
Рёбра команд пиктограммы
Что такое ребро и где оно видно в Holkas →
Рёбра помогают Holkas правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше. Например, сначала нужно создать пиктограмму, затем назначить её классу.
Create PIC · RequestIconUpdate CLS · RequestНепосредственно связанные правила · 5
Сама PIC не объявляет зависимостей от других объектов. Здесь перечислены внешние потребители и общие правила; восемь строк не означают восемь рёбер в каждом плане.
Использующие объекты и наборы данных6 правил
Create PIC→Create / Update CLSКогда: у создаваемого или изменяемого класса задан SysImage. Сначала создать значок, затем записать класс с его кодом. Ребро ожидает Create PIC, но не Update уже существующей пиктограммы.
Create PIC→Create / Update REPКогда: у создаваемого или изменяемого пользовательского отчёта задан SysImage. Подготовить запись словаря до отчёта, который на неё ссылается. Update PIC это правило тоже не ожидает.
Create PIC→Create / Update ACTКогда: у создаваемого или изменяемого действия задан SysImage. Сначала создать значок, затем записать действие.
Create PIC→Create / Update MECКогда: у создаваемого или изменяемого метода вызова задан SysImage. Сначала создать значок, затем записать вызов.
Create PIC→Create / Update PCEКогда: у создаваемой или изменяемой пользовательской процедуры задан SystemImage. Сначала создать значок, затем записать процедуру.
Create / Update PIC→Create / Update DAT.RowКогда: внешняя адресная ссылка строки набора ведёт в SYSIMAGES по CODE. Она должна быть внешней для самого набора. Подготовить пиктограмму перед записью использующей её строки; строка не становится частью PIC.
Скрипты автора при работе с БД2 правила
Create SCR · Before→Create / Update PICКогда: скрипт запускается до всего переноса либо до этой пиктограммы. Он должен завершиться до записи PIC. Без подходящих команд скрипт из плана убирается.
Create / Update PIC→Create SCR · AfterКогда: скрипт запускается после всего переноса либо после этой пиктограммы. Сначала записать PIC, затем исполнить скрипт.
Что означает наличие ссылки и отсутствие ребра
Если значок с нужным кодом уже существует и не меняется, команды PIC не будет. Проверка известных недостающих зависимостей может обнаружить ссылку даже у совпавшего класса или отчёта; это не добавляет лишнюю команду записи. Обычные зависимости влияют на выбор и на выполнение при отказе предшественника: снятие Create новой PIC затрагивает ожидающие её команды. Подробнее — разбор недостающих зависимостей.
Неизвестный код Парус не принимает: запись использующего объекта без пиктограммы получит отказ «Пиктограмма … не определена». Поэтому все пять потребителей — CLS, REP, ACT, MEC и PCE — ждут Create PIC. Подробности — новая пиктограмма у потребителя.
Как пиктограмма хранится в файлах
Начните с каталога Pictogram/. Внутри одного файла находятся код, примечание и оба изображения. Отдельные BMP/PNG-файлы или файлы на каждый размер при экспорте не создаются.
Git
YAMLPictogram/RequestIcon.yamlПоля Code, Note, SmallImage и LargeImage. Каждое изображение записано списком чисел-байтов.
При чтении YAML восстанавливаются оба массива байтов. В корне репозитория — .holkas со сведениями о нём.S3
JSON в ZIPPictogram/RequestIcon.jsonПоля code, note, smallImage и largeImage. Каждое изображение — строка Base64 в JSON.
ZIP хранится в S3; при чтении состав берётся из manifest.json, а байты восстанавливаются из файла PIC.Файл пакета
JSON в ZIPPictogram/RequestIcon.jsonТакие же четыре поля с маленькой буквы и Base64. Одна PIC — одна запись оглавления.
Загруженный ZIP при чтении сверяется с manifest.json; оба изображения входят в описание пиктограммы.Для PIC оба вида ZIP (S3 и «Файл пакета») устроены одинаково при записи и при чтении. Это проверено именно для пиктограммы, а не для всех объектов Holkas. Использующий класс, отчёт или действие сохраняется по своим правилам, если включён в выгрузку; внутри PIC их описаний нет.
В manifest.json пиктограмма обозначена как {"typeCode":"PIC","name":"RequestIcon"}. Там же находятся версия формата, СУБД и сведения об экспорте; подробнее — справка о пакете. Небезопасные символы имени файла кодируются: например, / заменяется на %2F; Code внутри файла не меняется. Не переименовывайте файл отдельно от адреса объекта.
Одни и те же байты в YAML и JSON
Синтетические примеры показывают все четыре поля и одинаковые последовательности байтов: малое изображение — 66, 77, 0, 255, большое — 66, 77, 1, 128. Это условные байты, не рабочие BMP и не готовая пиктограмма для Паруса. Для переноса берите полный экспорт настоящих изображений.
Git — Pictogram/RequestIcon.yaml
Code: RequestIcon
Note: Значок заявок
SmallImage:
- 66
- 77
- 0
- 255
LargeImage:
- 66
- 77
- 1
- 128
S3 и «Файл пакета» — Pictogram/RequestIcon.json
{
"code": "RequestIcon",
"note": "Значок заявок",
"smallImage": "Qk0A/w==",
"largeImage": "Qk0BgA=="
}
Поля с null при записи опускаются. Пустое изображение сохраняется как [] в YAML и "" в JSON; это ноль байтов, а не пропуск неизменившейся картинки. Оба варианта отличаются от null при сравнении. У прежней реализации изображения были строками чисел через запятую; этот старый формат не следует переносить в нынешние файлы.
Практические шаги: сохранить доработку в Git, выгрузить и загрузить файл пакета.
Основа справки: руководство «ПАРУС-Бюджет 8. Конструктор отраслевых расширений», издание 2026, гл. 1, с. 10–11; сохранённые опыты словаря и назначения пиктограмм на Oracle / Парус 27.08.2026 и Holkas 0.1.26; модель, читатели, писатели и команды Holkas 0.1.30. Сверено 8 ноября 2026. RequestIcon, схемы и файловые примеры — учебные. Нового переноса в БД и новой проверки клиентов Паруса при подготовке страницы не было.