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

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

Пользовательский отчёт

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

Парус · Oracle и PostgreSQL

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

Отчёт Парус 8: шаблон, параметры, связи с разделами, формы, все поля и ограничения переноса REP.

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

Парус 8 · Пользовательские отчёты

Отчёт соединяет шаблон печати, серверную процедуру и параметры запуска. Связь с разделом делает его доступным из этого раздела, а собственная форма позволяет оформить ввод параметров.

ИдентификаторREP + Code
Вложенные частиПараметры, связи, формы
Удаление отчётаНе формируется

Пользовательский отчёт в Парусе

Пользовательский отчёт — сохранённое описание того, как получить печатный результат. Например, «Список заявок» использует книгу Excel с именованными ячейками, процедуру, которая заполняет её, и параметр «Заголовок». Подключение к разделу «Заявки» позволяет вызвать этот отчёт из раздела.

Holkas переносит описание отчёта и байты шаблона на Oracle или PostgreSQL. Готовые файлы, историю печати, очередь заданий и сервер печати REP не переносит. Реализующая процедура — отдельный объект БД: при переносе между СУБД её нужно подготовить для приёмника, автоматического перевода кода нет.

Пользовательские отчёты — системный раздел Паруса, который может использоваться вместе с доработками КОР (Конструктора отраслевых расширений). Кнопка отчёта в форме класса ссылается на код REP, но не делает отчёт частью класса. Он выбирается самостоятельно.

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

Ссылки на внешние объекты: процедура БД, пиктограмма, классы и методы их вызова, приложения и дополнительный словарь. Они должны быть в приёмнике либо, где тип поддержан, включены отдельно. Выбор REP сам по себе не включает эти объекты.
Все три ветви принадлежат одному отчёту. Шаблон — его собственное поле TemplateData. Коды REP.Param, REP.Link и REP.VF обозначают команды частей, а не самостоятельные объекты каталога.

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

51 поле · 5 групп

Все задаваемые поля модели отчёта и его частей: 16 у отчёта, 15 у параметра, 3 у связи с разделом, 15 у формы и 2 у назначения. Техническое имя — имя в Git YAML; рядом указано имя в JSON обоих ZIP-транспортов. Вычисляемое поле Identity объяснено в примечании под каталогом.

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

Ключ определяет объект или запись внутри родителя. У назначения заполняют ровно одно из двух полей: Role или User. Сравнивается означает, что различие учитывается в плане, а не что его обязательно можно записать в БД. По элементам — части списка получают собственные команды.

Create — создать, Update — изменить, Delete — удалить. При создании передаются настройки нового объекта; правила Update относятся к существующему. Ограничения процедур Паруса не распространяются на запись описания в Git.

Отчёт · REP16 полей
CodeJSON: codeстрокаКлючМнемокод отчёта
Назначение
Код, например RequestList; REP адресуется им без префикса схемы БД.
При переносе:
Другой код означает другой отчёт. Если нового кода в приёмнике нет, Holkas создаст отчёт; прежний автоматически не удалится.
NameJSON: nameстрокаСравниваетсяНаименование
Назначение
Название отчёта для человека, например «Список заявок».
При переносе:
Изменение даёт Update REP с новым названием при прежнем коде. Защищённые поля этой же команды должны совпадать с приёмником.
CrnNameJSON: crnNameстрокаСравниваетсяПапка каталога
Назначение
Имя папки раздела «Пользовательские отчёты», в которой лежит отчёт, например «Печать». Это имя самой папки; путь к ней хранится в CrnPath.
При переносе:
Папка ищется по имени в контексте приёмника: в разделе одной организации и версии двух одноимённых папок не бывает. Если её нет, недостающие папки создаются по пути CrnPath. У существующего отчёта смена CrnName даёт Update REP, который перемещает отчёт в эту папку. «Решение/Печать» в CrnName — одно имя, а не путь.
CrnPathJSON: crnPathсписок строк / nullСравниваетсяПуть каталога
Назначение
Имена папок от первого уровня под корнем раздела «Пользовательские отчёты» до папки отчёта включительно, например «Решение», «Печать»; последний элемент равен CrnName. Корень раздела в путь не входит: в приёмнике берётся корень его организации и версии. [] — отчёт лежит прямо в корне; отсутствие поля — путь неизвестен (файл прежней версии Holkas).
При переносе:
В базе Паруса сравнивается только имя папки: одноимённая папка приёмника используется там, где лежит, и не перемещается. Отсутствующую папку Holkas создаёт по пути: имеющиеся уровни использует, недостающие создаёт под предыдущим. В Git, S3 и «Файле пакета» сравнивается весь путь; его изменение даёт Update REP. В плане путь показан как «Решение / Печать», пустой — «(корень)». Путь, который кончается не папкой CrnName, отклоняет план до применения.
ReportTypeJSON: reportTypeцелоеСравниваетсяВид отчёта
Назначение
Код формата отчёта Паруса. На обследованном релизе 1 — Microsoft Excel; полный список приведён в примечании ниже.
При переносе:
Записывается при Create REP. Разница обнаруживается, но Update REP с другим видом отклоняется целиком; автоматического пересоздания нет.
TemplateDataJSON: templateDataбайтыСравниваетсяСодержимое шаблона
Назначение
Байты загруженного шаблона, например книги Excel. Это свойство отчёта, а не отдельная вложенная часть.
При переносе:
Шаблон сравнивается по байтам, отдельно от Checksum. При создании записывается в БД. Замена у существующего отчёта отклоняет Update REP целиком. В Git — список байтов YAML, в ZIP — строка Base64 в JSON.
StoredProcedureJSON: storedProcedureстрока / nullСравниваетсяХранимая процедура
Назначение
Имя серверной процедуры, формирующей отчёт, например P_REQUEST_LIST. Исходный текст самой процедуры сюда не входит.
При переносе:
Задаётся при создании и изменении. Нужная реализация должна быть готова в целевой СУБД. При смене с прежней непустой процедуры в БД Holkas заново записывает аргументы оставшихся параметров, даже если они совпали.
UseHistoryJSON: useHistoryлогическоеСравниваетсяСохранять историю печати
Назначение
Признак сохранения истории формирования отчёта в Парусе.
При переносе:
Create / Update REP передаёт true как 1, false как 0. Сама история печати и сформированные файлы вместе с этим признаком не переносятся.
LockForCreateJSON: lockForCreateлогическоеСравниваетсяБлокировать при формировании
Назначение
Признак «Блокировать при формировании» в настройках Паруса.
При переносе:
Передаётся при Create / Update REP как 1 или 0. Это настройка выполнения отчёта в Парусе, а не блокировка переноса Holkas.
ChecksumJSON: checksumстрока / nullСравниваетсяКонтрольная сумма шаблона
Назначение
Сохранённое в Парусе значение CRC для загруженного файла.
При переносе:
Сравнивается и передаётся при Create / Update REP. Holkas не пересчитывает его из TemplateData и не использует вместо сравнения байтов. Сохраняйте согласованные шаблон и сумму из полного экспорта.
MakePdfJSON: makePdfлогическоеСравниваетсяСоздать PDF
Назначение
Настройка получения PDF при формировании отчёта.
При переносе:
Передаётся через Create / Update REP. Перенос признака не устанавливает в приёмнике средства печати и конвертации.
SysImageJSON: sysImageстрока / nullСравниваетсяПиктограмма
Назначение
Код пиктограммы Паруса; внутренний номер записи не передаётся.
При переносе:
Передаётся через REP. Если код задан, команда ждёт создания PIC. Пиктограмма должна существовать или быть включена отдельно; пустое значение не добавляет зависимость.
FileNameJSON: fileNameстрока / nullСравниваетсяИмя файла шаблона
Назначение
Сохранённое имя файла, например RequestList.xls. Не путь к файлу в Git или ZIP.
При переносе:
Задаётся при создании. Разница у существующего отчёта отклоняет весь Update REP, даже если байты шаблона совпадают. Отличие только в записи — null или пустая строка — изменением не считается. Внешний файл с этим именем для чтения пакета не нужен.
ParametersJSON: parametersсписокПо элементамПараметры отчёта
Назначение
Принадлежащие отчёту входные значения, их источники и умолчания.
При переносе:
Сопоставляются по Name. Создание, изменение и удаление идут отдельными REP.Param. [] задаёт пустой список и может удалить все параметры выбранного отчёта.
LinksClassJSON: linksClassсписокПо элементамСвязи с разделами
Назначение
Подключения отчёта к классам Паруса и их типам документов.
При переносе:
Сопоставляются по UnitCode: REP.Link меняет подключение, REP.Link.DocType — коды типов документов. Удаление связи не удаляет класс или отчёт.
VisualFormsJSON: visualFormsсписокПо элементамВизуальные формы
Назначение
Формы, принадлежащие этому отчёту; каждая может иметь назначения и приложения.
При переносе:
Для REP ключ формы — FormClass. REP.VF меняет форму, REP.VF.Priv и REP.VF.App — её связи. [] может удалить все формы выбранного отчёта. Правило ключа формы CLS сюда не переносится.
Параметры · REP.Param15 полей
NameJSON: nameстрокаКлючИмя параметра
Назначение
Имя внутри отчёта. Оно может отличаться от имени аргумента серверной процедуры.
При переносе:
Смена имени при удалении прежнего из списка даёт Delete прежнего и Create нового REP.Param. Ссылки InitParameter других параметров нужно согласовать отдельно.
NameParameterProcedureJSON: nameParameterProcedureстрока / nullСравниваетсяАргумент хранимой процедуры
Назначение
Имя аргумента процедуры отчёта, в который поступает значение параметра.
При переносе:
Передаётся при Create / Update REP.Param. При непустом имени команда ждёт процедуру и Update REP. План проверяет наличие аргумента вне переноса, но не его тип; несовпадение типа отвергает Парус.
DataTypeJSON: dataTypeцелоеСравниваетсяТип данных параметра
Назначение
В обследованном Парусе: 0 — строка, 1 — число, 2 — валюта, 3 — логический, 4 — дата. Это коды параметра отчёта, а не коды домена.
При переносе:
Передаётся при Create / Update REP.Param. Тип должен подходить аргументу процедуры и привязке. Holkas не подбирает его автоматически.
PromptJSON: promptстрокаСравниваетсяПриглашение к вводу
Назначение
Подпись параметра в окне ввода, например «Заголовок».
При переносе:
Изменяется через REP.Param; имя параметра и имя аргумента от смены подписи не меняются. Если значение переходит от одного элемента к другому, Holkas сначала освобождает его, а обмен по кругу не переносит и называет в плане — см. «Параметры меняются подписями».
SortNumbJSON: sortNumbцелоеСравниваетсяПорядок сортировки
Назначение
Место параметра в списке Паруса.
При переносе:
Передаётся непосредственно в Create / Update REP.Param; отдельной команды SetOrder у отчёта нет. Парус может сдвигать позиции при вставке; не задавайте порядок простой перестановкой элементов JSON.
MandatoryJSON: mandatoryцелоеСравниваетсяОбязательный параметр
Назначение
Признак обязательности: 1 — включён, 0 — выключен.
При переносе:
Записывается через REP.Param. Выключение признака не меняет сигнатуру серверной процедуры и не делает её обязательный аргумент необязательным.
LinkingJSON: linkingцелоеСравниваетсяИсточник значения
Назначение
Код привязки: ввод пользователем, организация, запись раздела или другой источник. Проверенные коды приведены ниже.
При переносе:
Передаётся через REP.Param вместе с полями привязки. Доступность вариантов зависит от DataType. Не выводите код из позиции строки выпадающего списка клиента.
UnitCodeJSON: unitCodeстрока / nullСравниваетсяКод связанного раздела
Назначение
Класс, из которого берётся значение при привязке к разделу.
При переносе:
При записи Holkas находит по коду наименование класса и передаёт его процедуре Паруса. При заданном коде ждёт Create CLS. null или пустая строка не запускают поиск класса.
MethodCodeJSON: methodCodeстрока / nullСравниваетсяМетод вызова раздела
Назначение
Метод открытия указанного UnitCode для выбора значения.
При переносе:
Передаётся через REP.Param. При заданных UnitCode и MethodCode команда ждёт Create MEC с адресом Класс|Метод; этого не заменяет наличие одного класса.
ParameterNameJSON: parameterNameстрока / nullСравниваетсяПараметр вызова раздела
Назначение
Имя параметра указанного метода вызова.
При переносе:
Передаётся через REP.Param. При непустых UnitCode, MethodCode и ParameterName команда ждёт Create MEC.Param. Это не имя другого параметра отчёта.
CodeAdditionalDictionaryJSON: codeAdditionalDictionaryстрока / nullСравниваетсяДополнительный словарь
Назначение
Код дополнительного словаря Паруса для соответствующей привязки.
При переносе:
Передаётся процедуре Паруса кодом; словарь должен быть подготовлен в приёмнике. Автоматического включения словаря и ребра на его создание у REP.Param нет.
DefaultStringJSON: defaultStringстрока / nullСравниваетсяСтроковое значение по умолчанию
Назначение
Начальная строка, например «Заявки за месяц».
При переносе:
Передаётся через REP.Param. null не означает сохранить прежнее умолчание. При сравнении null и пустая строка равны; пробелы и регистр содержимого сохраняются.
DefaultNumJSON: defaultNumдесятичное / nullСравниваетсяЧисловое значение по умолчанию
Назначение
Начальное число или значение для подходящего типа параметра.
При переносе:
Передаётся через REP.Param; 0 и null различаются. Модель допускает дробное число; допустимость для выбранного DataType проверяет Парус.
DefaultDateJSON: defaultDateдата и время / nullСравниваетсяДата по умолчанию
Назначение
Начальная дата, в JSON — строка ISO без часового пояса, например 2026-11-08T00:00:00.
При переносе:
Передаётся через REP.Param. Сравнение учитывает часовую часть; null передаётся как отсутствие умолчания, а не пропуск записи поля.
InitParameterJSON: initParameterстрока / nullСравниваетсяРодительский параметр
Назначение
Имя другого параметра этого же отчёта; Парус допускает родителя при Linking = 2.
При переносе:
Передаётся именем и ждёт создания родителя, если тот включён в план. Старый файл без этого поля может очистить родителя. Для взаимных новых родителей образуется цикл; ссылку на себя нельзя считать поддержанной из отсутствия ребра.
Визуальные формы · REP.VF / REP.VF.Priv / REP.VF.App15 полей
FormClassJSON: formClassстрокаКлючИмя формы
Назначение
Ключ формы внутри отчёта. У REP, в отличие от CLS, для сопоставления используется только это имя.
При переносе:
Смена имени в полном списке даёт Delete прежней и Create новой REP.VF. Две формы одного отчёта с одинаковым FormClass нельзя однозначно сопоставить.
FormNameJSON: formNameстрокаСравниваетсяНаименование формы
Назначение
Подпись формы для человека.
При переносе:
Изменяется через Update REP.VF при сохранении ключа и допустимых настроек. Отдельного переименования ключа этим полем нет.
FormKindJSON: formKindцелоеСравниваетсяВид формы
Назначение
Сохранённый вид формы Паруса. В модель он входит числом, без перевода в другой вид.
При переносе:
Записывается при создании. Смена при прежнем FormClass даёт Update REP.VF, но применение в БД отказывает целиком. Автоматического удаления и пересоздания нет.
ShowMethodJSON: showMethodстрока / nullСравниваетсяМетод вызова формы
Назначение
Метод вызова раздела UserReports, с которым связана форма.
При переносе:
При создании ждёт MEC UserReports|Метод, если код задан. При прежнем FormClass изменение ShowMethod даёт Update REP.VF, который в БД отклоняется целиком; метод показа здесь не часть ключа.
LinkApplicationJSON: linkApplicationцелоеСравниваетсяУчитывать приложения
Назначение
Признак использования списка приложений формы: 1 — включён, 0 — выключен.
При переносе:
Записывается через REP.VF. Сам список Applications переносится даже при выключенном признаке; его наличие не включает признак автоматически.
LinkPrivilegesJSON: linkPrivilegesцелоеСравниваетсяУчитывать назначения
Назначение
Признак использования назначений ролям и пользователям: 1 — включён, 0 — выключен.
При переносе:
Записывается через REP.VF отдельно от списка Privileges. Одна запись роли в списке не гарантирует выбор этой формы для пользователя.
FormActiveJSON: formActiveцелоеСравниваетсяДоступность формы
Назначение
Признак доступности формы в Парусе: 1 — включена, 0 — выключена.
При переносе:
Изменяется через REP.VF. Наличие описания и назначений не отменяет выключенную доступность.
EventsLanguageJSON: eventsLanguageцелое / nullСравниваетсяЯзык обработчиков
Назначение
Код языка обработчиков формы. null — язык не задан; 0 — уже заданное значение.
При переносе:
Из незаданного состояния язык можно установить. Смена или сброс уже заданного языка вызывает предупреждение плана и отказ Update REP.VF до записи этой формы. Для иного языка нужна новая форма.
FormDataJSON: formDataстрока / nullСравниваетсяОписание формы
Назначение
Текст основного описания формы. XML сохраняется как строка внутри записи формы.
При переносе:
Непустой изменяемый XML проверяется на синтаксис, предупреждение не запрещает перенос. null пропускает запись этого тела в БД и сохраняет прежнее; пустая строка передаётся на запись. Полной проверки ссылок внутри формы отчёта нет.
FormEventsJSON: formEventsстрока / nullСравниваетсяОбработчики событий
Назначение
Основной текст обработчиков формы на выбранном языке.
При переносе:
Записывается вместе с REP.VF, если не null. null сохраняет прежний текст в БД. Holkas не переводит обработчики между языками и не доказывает их работоспособность.
FormDataExtJSON: formDataExtстрока / nullСравниваетсяДополнительное описание формы
Назначение
Дополнительное текстовое описание в отдельной колонке Паруса.
При переносе:
Как FormData: синтаксическая проверка изменяемого непустого XML; null пропускает запись в БД. Не считайте перенос основного тела переносом этого поля.
FormEventsExtJSON: formEventsExtстрока / nullСравниваетсяДополнительные обработчики
Назначение
Дополнительный текст обработчиков в отдельной колонке Паруса.
При переносе:
Записывается вместе с REP.VF только при значении, отличном от null. Переносится как текст без автоматической адаптации к другому клиенту.
FormJSON: formстрока / nullСравниваетсяОбщее поле модели формы
Назначение
Поле принадлежности формы действию, используемое у CLS. В выгрузке REP оно не задаётся: владельцем служит сам отчёт.
При переносе:
Для REP сохраняйте null. Поле есть в общей модели и сравнении, но при применении Holkas не использует его для записи владельца. Произвольное значение не создаёт привязку к действию.
PrivilegesJSON: privilegesсписок / nullПо элементамНазначения ролям и пользователям
Назначение
Полный список назначений формы, в том числе при LinkPrivileges = 0.
При переносе:
REP.VF.Priv добавляет и снимает назначения. null или отсутствие списка сохраняет текущие назначения этой формы; [] явно снимает все. Порядок записей не важен. Требуются существующие роли и пользователи Паруса.
ApplicationsJSON: applicationsсписок строк / nullПо элементамПриложения формы
Назначение
Коды приложений APP, в которых используется форма. Это коды, а не наименования приложений.
При переносе:
REP.VF.App добавляет и снимает связи, создание ждёт APP Create. null сохраняет текущие связи этой формы; [] явно снимает все. Порядок и повторения кодов не задают разные связи.
Запись назначения формы · REP.VF.Priv2 поля
RoleJSON: roleстрока / nullКлючРоль Паруса
Назначение
Имя роли из справочника ролей Паруса. В одной записи заполняют либо Role, либо User.
При переносе:
Ключ назначения имеет вид role:Имя. Смена роли — снятие прежнего назначения и добавление нового. Роль должна быть в приёмнике; parusRoleMap позволяет сопоставить разные имена.
UserJSON: userстрока / nullКлючПользователь Паруса
Назначение
Логин AUTHID пользователя. Это не имя пользователя ОС и не учётная запись Holkas.
При переносе:
Ключ назначения имеет вид user:Логин. Смена логина даёт Delete / Create назначения. Пользователь и членство в ролях должны быть подготовлены отдельно. Пустая запись или одновременно Role и User отвергаются.
Виды отчёта, типы данных и привязки: разные перечисления

На обследованном Парусе 27.08.2026 виды ReportType: 0 — Crystal Reports, 1 — Microsoft Excel, 2 — Drill Down, 3 — OpenOffice Calc, 4 — двоичные данные. Проверенное формирование результата относится к Excel; наличие числового кода не доказывает работоспособность каждого вида на любом приёмнике.

DataType параметра: 0 — строка, 1 — число, 2 — валюта, 3 — логический, 4 — дата. Проверенные Linking: 0 — нет привязки (ввод), 1 — организация, 2 — документ / учётный регистр / словарь, 4 — идентификатор помеченных записей. Это неполный перечень привязок; остальные выбирайте в Парусе и сохраняйте экспортом, не угадывая код.

Вид формы FormKind — третье самостоятельное перечисление. Его значения нельзя брать из ReportType или из видов формы класса. Выгрузка должна содержать фактические настройки формы отчёта.

null, ноль, пустой список и старые файлы

Обязательные списки Parameters, LinksClass и VisualForms нужно сохранять целиком. [] — явно пустой состав; отсутствующие части могут получить Delete. Загрузка из ZIP (S3 и файл пакета) отклоняет отсутствие или null этих трёх списков. Чтение из Git устроено иначе: не рассчитывайте на такую же защиту неполного YAML.

У DocTypes, Privileges и Applications null означает неизвестные сведения: текущие связи сохранившейся части не сравниваются и сохраняются, о чём план сообщает. [] означает снять связи. У InitParameter другое правило: отсутствующее поле старого файла равно null и может очистить родителя. Для передачи родителя и типов документов выгрузите отчёт заново.

Нули и false — настоящие значения. DefaultNum = 0 не равен null. Строковое сравнение приравнивает null к пустой строке и CRLF к LF, но не исправляет пробелы или регистр содержимого. Для четырёх текстовых тел формы null отдельно означает пропустить запись в БД. Это правило не относится к умолчаниям параметра.

Какие сведения не являются полями переноса

RN, PRN, CRN и внутренние номера ссылок восстанавливаются в приёмнике. Организация не является полем REP: используется контекст приёмника и найденного отчёта. Если при создании папки подходит несколько корней организаций, а организация не выбрана, Holkas требует указать её.

Путь папки хранится в CrnPath именами папок, без корня раздела. В JSON форм дополнительно записывается вычисляемое поле identity: строка FormClass|FormKind|ShowMethod|Form. Например, Params|4|main|. Оно не задаётся отдельно при чтении и не является ключом REP.VF: у отчёта ключ — FormClass. В Git YAML Identity не записывается. Не редактируйте эту строку как самостоятельную настройку. История печати, готовые документы, очередь и сервер печати не входят в REP.

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

Семь кодов охватывают сам отчёт и его части. Create — создание, Update — изменение, Delete — удаление. У пиктограмм доступны подписи по наведению, клавиатурному фокусу и нажатию.

Отчёт и его части7 кодов
REP
CreateUpdate

Отчёт и шаблон

Создаёт отчёт со всеми его собственными реквизитами, включая шаблон. Update передаёт изменяемые настройки, а при смене папки перемещает отчёт в неё. Другие ReportType, TemplateData или FileName отклоняют весь Update в БД. Разница только в частях не требует команды корня.

Ключ: Код отчёта

REP.Param
CreateUpdateDelete

Параметр отчёта

Добавляет новый параметр, обновляет поля параметра с прежним Name или удаляет отсутствующий. При смене процедуры в БД может заново записать аргумент совпавшего параметра: это восстановление после очистки Парусом. SortNumb передаётся этой же командой.

Ключ: Отчёт|Имя параметра

REP.VF
CreateUpdateDelete

Визуальная форма отчёта

Добавляет, меняет или снимает форму по FormClass. Смена FormKind, ShowMethod либо уже заданного EventsLanguage отклоняет Update формы в БД. Четыре текстовых тела записываются, только когда соответствующее поле не null.

Ключ: Отчёт|Имя формы

REP.VF.Priv
CreateDelete

Назначение формы

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

Ключ: Отчёт|Форма|role:Роль или user:Логин

REP.VF.App
CreateDelete

Приложение формы

Подключает форму к приложению или снимает связь. Update не возникает: код приложения входит в ключ. Приложение и сама форма при снятии связи сохраняются.

Ключ: Отчёт|Форма|Код приложения

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

Пример: новая процедура, прежний параметр

В приёмнике RequestList вызывает P_REQUEST_OLD; параметр STITLE передаётся в аргумент STITLE. Источник переводит отчёт на P_REQUEST_NEW с тем же аргументом, а поля параметра не меняет.

  1. Если новая процедура едет в том же переносе, выполняется её Create или Update.
  2. Update REP записывает P_REQUEST_NEW. Парус при смене процедуры очищает аргументы параметров.
  3. Update REP.Param · RequestList|STITLE записывает STITLE заново. В плане есть заметка о причине этой команды, хотя значения параметра совпадают.

Это поведение для приёмника БД и смены с прежней непустой процедуры. Для Git такой триггер отсутствует, поэтому дополнительная команда совпавшего параметра не нужна.

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

Нужно заменить шаблон, имя файла или вид

Например, источник содержит новую книгу RequestList.xls и новое наименование отчёта. План обнаружит оба изменения и создаст Update REP. Перед записью в БД при применении Holkas проверит байты TemplateData и откажет всей команде: новое наименование тоже не запишется.

В этом пути обновления защищены ReportType, TemplateData и FileName. Папку Update REP меняет: отчёт перемещается в другую папку, как домен и пользовательская процедура. Повтор Update не заменит шаблон. Подготовьте изменение штатными средствами Паруса либо отдельный отчёт с новым кодом и нужными подключениями; затем обновите источник и повторно сравните. Holkas сам не удаляет и не пересоздаёт существующий отчёт.

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

Параметры меняются подписями

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

Цепочка — например, PFROM: «Дата» → «Дата с», PTO: «Дата с» → «Дата по». Holkas упорядочивает команды сам: сначала освобождает значение, потом занимает его. Всё проходит за один перенос.

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

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

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

Нужно сохранить дерево папок

Для отчёта из «Пользовательские отчёты → Решение → Печать» в файл попадут CrnName = «Печать» и CrnPath «Решение», «Печать». Корень раздела не записывается: в приёмнике используется корень его организации и, если применимо, версии.

Holkas ищет папку «Печать» по имени в разделе UserReports. Если её нет, проходит путь: найденную «Решение» использует как есть, «Печать» создаёт под ней; отсутствующую «Решение» тоже создаёт. Папки готовятся внутри команды REP, отдельных строк плана для них нет. Существующий отчёт с другой папкой Update REP перемещает в неё.

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

В файле прежней версии Holkas пути нет. При совпадающем имени папки путь берётся у приёмника и команд нет; иначе папка ищется по имени и при отсутствии создаётся под корнем, о чём план предупреждает. Выгрузите отчёт заново, чтобы описание получило путь; в Git, S3 и «Файле пакета» старый файл без пути получит Update REP.

Нет аргумента процедуры или не совпадает его тип

При NameParameterProcedure = STITLE процедура должна иметь аргумент STITLE подходящего типа. Если процедура вне переноса и такого аргумента в приёмнике нет, план предупреждает. Если она включена, рёбра ставят её раньше параметра.

Проверка плана сверяет наличие имени, а не тип и направление аргумента. Например, наличие числового STITLE не подтверждает пригодность строкового параметра отчёта: запись может отклонить Парус. Подготовьте согласованные процедуру и параметры. Имя вида ПАКЕТ.ПРОЦЕДУРА эти проверки аргументов не разбирают.

PostgreSQL: у процедуры несколько перегрузок

Парус не принимает Create / Update REP, когда у указанного имени в схеме parus несколько функций или процедур. При этом Update наименования тоже может отказать. План заранее называет перегруженное имя, но не запрещает перенос.

У REP.Param с аргументом предупреждение появляется, если этот аргумент есть в нескольких перегрузках. Оставьте у вызываемого имени одну подходящую реализацию и постройте план заново; не удаляйте нужные другим объектам реализации без подготовки их использования. Имена вида ПАКЕТ.ПРОЦЕДУРА не проверяются.

Тип документа отсутствует или не разрешён разделу

Это два разных случая. Если самого кода типа нет в версии приёмника, добавление REP.Link.DocType завершится отказом. Заведите тип штатными средствами Паруса: Holkas не переносит определения DOCTYPES.

Если тип есть, но не разрешён разделу в DOCPARAMS, запись связи может пройти, однако выбрать такой тип в редакторе связи нельзя. Разрешите тип нужному разделу. Обе причины план называет до применения, предупреждение не снимает команду автоматически.

Нужно изменить способ открытия или язык формы

У REP ключ формы — только FormClass. Поэтому смена FormKind или ShowMethod при прежнем имени создаёт Update REP.VF, который отклоняется целиком. Для смены способа открытия подготовьте новую форму с другим именем, её назначения и связи; Holkas не пересоздаёт форму автоматически.

Уже заданный EventsLanguage, в том числе 0, нельзя сменить или сбросить. План предупреждает, при применении Holkas отказывает до записи этой формы. При незаданном языке допустима первоначальная установка. Это отдельное ограничение языка, не требование переписать XML.

XML корректен, но форма ссылается на неподготовленные объекты

Изменяемый непустой FormData и FormDataExt проверяются на синтаксис XML; ошибка даёт предупреждение и оставляет команду в плане. Исправьте текст в источнике и постройте план заново.

Поиск ссылок внутри XML сейчас работает для CLS.VF, а не для REP.VF. Поэтому отсутствие предупреждения у формы отчёта не доказывает наличие всех объектов её кнопок и словарей. Такие ссылки подготовьте отдельно. При null в теле формы прежний текст в БД сохраняется.

Форма перенесена, но пользователь её не получает

Сверьте FormActive, LinkPrivileges, LinkApplication, списки назначений и приложений, контекст вызова. Роли, пользователи и членство не создаются назначением формы. План называет отсутствующих получателей; для разных имён ролей есть parusRoleMap. Перенос назначений форм.

Описание отчёта перенесено, но печать не готова

Настройки REP не устанавливают Excel, средства конвертации, сервер печати или его конфигурацию. В сохранённом опыте Паруса 27.08.2026 Excel-результат проверен в Windows; web-клиент без сервера печати дошёл только до очереди. Это граница прежнего эксперимента, не новый тест этой страницы.

Кнопка отчёта в форме и запуск из раздела могут передавать разный контекст. В обследованном случае кнопка передавала текущую запись, а запуск из раздела — помеченные. Linking = 4 сам по себе не обещает, что любой вызывающий экран передаст одинаковый набор.

Рёбра команд

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

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

Обновить процедуруUpdate JPR / JFP / JPP
Записать параметрCreate / Update REP.Param

Например, параметр STITLE нельзя записать раньше, чем у процедуры отчёта появится аргумент STITLE. Если отчёт одновременно меняет процедуру, между этими действиями должно выполниться и Update REP.

Ниже все непосредственные правила для REP и его частей, входящая ссылка из формы класса, общие правила скриптов и сохранённых зависимостей Oracle. Число правил не равно числу рёбер каждого плана. Процедура, класс или приложение, уже существующие в приёмнике, не требуют отдельной команды создания.

Собственные части и внешние ссылки21 правило
Create PICCreate / Update REP

Когда: SysImage задан. Зачем: Пиктограмма нужна при записи отчёта.

Create / Update JPR; на PostgreSQL JFP или JPPCreate / Update REP

Когда: StoredProcedure задан. Зачем: Отчёт ссылается на реализацию для целевой СУБД.

Create REPCreate REP.Param

Когда: Новый отчёт и параметр. Зачем: Сначала нужна запись владельца.

Create CLSCreate / Update REP.Param

Когда: UnitCode задан. Зачем: Парусу нужен существующий раздел параметра.

Create REP.Param родителяCreate / Update REP.Param дочернего

Когда: InitParameter непустой и не равен Name. Зачем: Парус ищет родителя по имени в том же отчёте.

Create / Update JPR; на PostgreSQL JFP или JPPCreate / Update REP.Param

Когда: NameParameterProcedure задан; StoredProcedure непустой. Зачем: У процедуры уже должен существовать нужный аргумент.

Update REPCreate / Update REP.Param

Когда: NameParameterProcedure задан. Зачем: При записи параметра Парус сверяет процедуру, уже указанную у отчёта.

Create MECCreate / Update REP.Param

Когда: UnitCode и MethodCode заданы. Зачем: Нужен метод вызова указанного раздела.

Create MEC.ParamCreate / Update REP.Param

Когда: UnitCode, MethodCode и ParameterName заданы. Зачем: Нужен параметр указанного метода вызова.

Create REPCreate REP.Link

Когда: Новый отчёт и связь. Зачем: Связь подключается к существующему отчёту.

Create CLSCreate / Update REP.Link

Когда: Класс назван в UnitCode. Зачем: Связь подключает существующий раздел.

Create REP.LinkCreate REP.Link.DocType

Когда: Тип добавляется к связи. Зачем: Сначала нужна сама связь.

Delete REP.Link.DocTypeDelete REP.Link

Когда: Удаляется связь с типами. Зачем: Типы снимаются раньше удаления владельца.

Create REPCreate REP.VF

Когда: Новый отчёт и форма. Зачем: Форма получает владельца — отчёт.

Create MECCreate / Update REP.VF

Когда: ShowMethod задан; адрес UserReports|Метод. Зачем: Это метод вызова раздела отчётов, а не связанного прикладного класса.

Create REP.VFCreate REP.VF.Priv

Когда: Создаётся назначение формы. Зачем: Назначение требует существующей формы.

Create REP.VFCreate REP.VF.App

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

Create APPCreate REP.VF.App

Когда: Приложение названо кодом. Зачем: Приложение должно существовать в приёмнике.

Delete REP.VF.PrivDelete REP.VF

Когда: Удаляется назначенная форма. Зачем: Сначала снимается назначение.

Delete REP.VF.AppDelete REP.VF

Когда: Удаляется форма со связями приложений. Зачем: Сначала снимаются связи приложений.

Update REP.Param, отдающий PromptUpdate REP.Param, занимающий Prompt

Когда: Параметр получает непустой Prompt, который в приёмнике держит другой параметр этого отчёта, и тот в этом же переносе свой Prompt меняет; для обмена по кругу ребра нет. Зачем: Сначала освободить значение, потом занять: цепочка проходит за один перенос.

Входящая ссылка на отчёт1 правило
Create / Update REPCreate / Update CLS.VF

Когда: XML формы класса содержит UserReportCode. Зачем: Отчёт готовится раньше использующей его кнопки. Это входящее правило CLS.VF, а не поиск ссылок в формах REP.

Скрипты и зависимости Oracle3 правила
SCR доКоманды REP и его частей

Когда: Исполняемый скрипт относится к отчёту или всему переносу. Зачем: Подготовка выполняется раньше охваченных команд.

Команды REP и его частейSCR после

Когда: Исполняемый скрипт относится к отчёту или всему переносу. Зачем: Завершение ждёт охваченные команды.

Create / Update зависимого объекта; команды JTB.ColCreate / Update REP или REP.Param

Когда: Процедура Oracle включена в состав с сохранёнными зависимостями и сама не меняется. Зачем: Общий проход переносит её зависимости на ожидающую команду. Для зависимости от таблицы он также ждёт реальные команды добавления и изменения её колонок.

Правила без команды удаления5 правил
Delete REP.ParamDelete REP

Когда: Правило задано для удаления параметра. Зачем: Delete целого REP сейчас не формируется.

Delete REP.ParamDelete CLS

Когда: UnitCode удаляемого параметра задан. Зачем: Delete целого CLS сейчас не формируется.

Delete REP.ParamDelete MEC

Когда: UnitCode и MethodCode удаляемого параметра заданы. Зачем: Delete целого MEC сейчас не формируется.

Delete REP.LinkDelete REP

Когда: Правило задано для удаления связи. Зачем: Delete целого REP сейчас не формируется.

Delete REP.LinkDelete CLS

Когда: Класс удаляемой связи. Зачем: Delete целого CLS сейчас не формируется.

Как читать условия и отсутствие ребра

Для процедуры объявляются ожидания Create и Update. На Oracle выбирается JPR; на PostgreSQL подходят JFP и JPP. Без БД-приёмника тип выводится по источнику или составу; при отсутствии сведений используется JFP. Это не переводит Oracle-процедуру в PostgreSQL.

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

Общий проход Oracle может дополнить рёбра зависимостями неизменяющейся процедуры, если её описание включено в состав. Это использование сохранённых связей, а не произвольный разбор текста самого отчёта.

Нет общего ребра «Update REP → все части». Такое ожидание есть у параметров с аргументом процедуры. Назначения ждут Create формы, но не её Update; формы REP не получают рёбер по ссылкам внутри XML, какие есть у CLS.VF. Папка готовится внутри Create или Update REP и не имеет собственной команды или ребра.

Удаления внутри коллекции строятся раньше изменений и созданий, с конца текущего списка. Это исходная очередность среди готовых команд, а не дополнительные рёбра. Не приписывайте SortNumb управление очередью исполнения.

Как отчёт хранится в файлах

Начните с каталога CustomReport/. В каждом из трёх способов один файл содержит сам отчёт, шаблон и все вложенные части. Отдельного файла TemplateData, REP.Param или формы нет.

Git

YAML
CustomReport/RequestList.yaml

Поля с заглавной буквы: TemplateData, Parameters, LinksClass, VisualForms. Шаблон — список чисел-байтов.

Holkas восстанавливает отчёт из YAML. Метаданные репозитория — в .holkas.

S3

JSON в ZIP
CustomReport/RequestList.json

Один JSON с templateData, parameters, linksClass и visualForms. Шаблон — строка Base64.

ZIP хранится в S3; состав берётся из manifest.json, отчёт восстанавливается вместе с частями.

Файл пакета

JSON в ZIP
CustomReport/RequestList.json

Скачиваемый ZIP содержит такое же вложенное описание отчёта. Шаблон также записан строкой Base64.

При загрузке состав сверяется с manifest.json; отдельной записи манифеста на каждую часть нет.

Для REP запись в оба ZIP (S3 и файл пакета) и загрузка из них сохраняют и восстанавливают отчёт целиком. Это проверка устройства отчёта, а не обещание одинаковой раскладки всех типов. В manifest.json запись отчёта — {"typeCode":"REP","name":"RequestList"}; подробнее — формат пакета. Небезопасные символы имени кодируются: / становится %2F, содержимое Code от этого не меняется.

Внутри формы находятся её тексты, Privileges / privileges и Applications / applications; у связи с разделом — DocTypes / docTypes. Ссылающиеся классы, процедура и пиктограмма имеют собственные файлы, если включены в выгрузку. FileName — реквизит отчёта, а не путь, по которому Holkas ищет шаблон на диске.

Те же байты в Git YAML и JSON обоих ZIP

Сокращённые учебные фрагменты показывают имя отчёта и три условных байта, а не настоящий шаблон Excel. Остальные поля и списки опущены. Это иллюстрация чтения, не файлы для загрузки.

Git — CustomReport/RequestList.yaml

Code: RequestList
TemplateData:
  - 0
  - 1
  - 2

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

{
  "code": "RequestList",
  "templateData": "AAEC"
}

Оба фрагмента описывают байты 0, 1, 2. Не вставляйте Base64-строку вместо списка TemplateData в Git по аналогии с JSON. Для правки используйте полный экспорт: сохраните все части, реальные байты шаблона и согласованную контрольную сумму. null при записи опускается; false, нули и пустые списки сохраняются.

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

Основа: сохранённые исследования пользовательских отчётов на Парусе 27.08.2026 и Holkas 0.1.26 (Oracle / PostgreSQL, Windows и web в указанных границах); руководство КОР 2026, с. 69–71, 75–76 — кнопки вызова отчёта; текущие модель, команды, применение, читатели и писатели Holkas 0.1.30. Сам раздел пользовательских отчётов в руководстве КОР не описан. Сверено 9 ноября 2026. RequestList и схемы — учебные примеры. Нового переноса в БД и проверки печати при подготовке страницы не выполнялось.