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

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

Пиктограмма

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

Парус · Oracle и PostgreSQL

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

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

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

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

Пиктограмма хранит значок в двух размерах. Holkas переносит его код, примечание и оба изображения между базами Паруса на Oracle и PostgreSQL; назначение значка разделу или действию относится к использующему объекту.

ИдентификаторPIC + Code
Состав4 поля · одна команда
Удаление пиктограммыНе формируется

Пиктограмма в КОР

Пиктограмма — запись словаря изображений Паруса. В КОР её можно назначить классу (разделу), методу вызова или действию класса. Например, запись с учебным кодом RequestIcon хранит значок «Заявки», а поле SysImage класса указывает, что раздел должен использовать именно этот код.

Во внешних описаниях может встретиться обозначение PCT: словарь типов Holkas распознаёт его как PIC. В плане и нынешнем ZIP используется PIC.

Словарь содержит малое изображение 16 × 16 и большое 24 × 24. Руководство Паруса предусматривает BMP: меньший рисунок дополняется пустыми ячейками, больший обрезается. Holkas сам не изменяет размер и не преобразует формат — передаёт сохранённые байты. Успех переноса PNG не означает, что его сможет показать клиент Паруса; подробнее — ограничение формата.

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

Один самостоятельный объект без вложенных частей. Изображения — реквизиты пиктограммы; отдельных команд на каждый размер нет.

Выбор PIC RequestIcon не добавляет использующие значок классы, отчёты и действия. И наоборот, раскрытие семейства класса не включает саму PIC: её выбирают отдельно либо добавляют при разборе известных недостающих зависимостей. Назначение значка хранится в использующем объекте. Замена байтов под прежним кодом меняет общий значок для всех его потребителей; новый код сам по себе их не переключает.

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

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

Все поля модели переноса PIC. Имя поля совпадает с Git YAML; имя JSON указано отдельно для S3 и «Файла пакета».

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

Ключ определяет запись в приёмнике. Сравнивается — разница учитывается при построении команды. Для изображений проверяются сами байты; допустимость их отображения — отдельный вопрос.

Пиктограмма · 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.
Пропуск поля, null и пустые байты

Руководство Паруса требует заполнить код, примечание и оба изображения. Модель Holkas допускает null у Note, SmallImage и LargeImage, а при чтении файлов описание можно получить без этих полей. Это не подтверждает допустимость такой записи в базе.

При сравнении Note значения null и пустая строка равны, окончания строк CRLF/LF не создают команды; регистр и пробелы учитываются. Для изображения null и пустой массив — разные значения. Если они отличаются от приёмника, возникает Update PIC. При применении передаются все поля пиктограммы из источника, включая null и пустые байты, а не оставляет прежнюю картинку. Не убирайте неизменившееся изображение из файла ради сокращения: сохраняйте полный экспорт.

Каких реквизитов здесь нет

Внутренний RN и производитель PRODUCER не переносятся. У PIC нет поля папки, полного пути каталога Паруса или операций его поиска и создания. Pictogram/ — только каталог файлов по типу объекта. Два изображения не являются дочерними объектами или списком с командами Delete и SetOrder.

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

У PIC один код команд и два действия. Наведите указатель на пиктограмму действия, перейдите к ней клавишей Tab или нажмите, чтобы прочитать подпись.

PIC
CreateUpdate

Пиктограмма целиком

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 или всех версий Паруса.

Совпавший код может заменить штатный или общий значок

Сопоставление идёт по Code без проверки происхождения записи. Например, учебный экспорт с кодом уже существующей штатной пиктограммы даст Update, если отличаются байты или примечание, и затронет все места её использования. В обследованном Oracle / Парус 27.08.2026 у SYSIMAGES нет признака TECHNOLOGY, защищающего штатную запись.

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

Новый код не переименовывает прежнюю пиктограмму

Замена 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 правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше. Например, сначала нужно создать пиктограмму, затем назначить её классу.

1 · СначалаСоздать пиктограммуCreate PIC · RequestIcon
→
2 · ЗатемНазначить значок классуUpdate CLS · Request
Учебный пример: у существующего класса Request поле SysImage меняется на RequestIcon; пиктограммы с этим кодом в приёмнике ещё нет.

Непосредственно связанные правила · 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

YAML
Pictogram/RequestIcon.yaml

Поля Code, Note, SmallImage и LargeImage. Каждое изображение записано списком чисел-байтов.

При чтении YAML восстанавливаются оба массива байтов. В корне репозитория — .holkas со сведениями о нём.

S3

JSON в ZIP
Pictogram/RequestIcon.json

Поля code, note, smallImage и largeImage. Каждое изображение — строка Base64 в JSON.

ZIP хранится в S3; при чтении состав берётся из manifest.json, а байты восстанавливаются из файла PIC.

Файл пакета

JSON в ZIP
Pictogram/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, схемы и файловые примеры — учебные. Нового переноса в БД и новой проверки клиентов Паруса при подготовке страницы не было.