Парус 8 · Пользовательские отчёты
Отчёт соединяет шаблон печати, серверную процедуру и параметры запуска. Связь с разделом делает его доступным из этого раздела, а собственная форма позволяет оформить ввод параметров.
REP + CodeПользовательский отчёт в Парусе
Пользовательский отчёт — сохранённое описание того, как получить печатный результат. Например, «Список заявок» использует книгу Excel с именованными ячейками, процедуру, которая заполняет её, и параметр «Заголовок». Подключение к разделу «Заявки» позволяет вызвать этот отчёт из раздела.
Holkas переносит описание отчёта и байты шаблона на Oracle или PostgreSQL. Готовые файлы, историю печати, очередь заданий и сервер печати REP не переносит. Реализующая процедура — отдельный объект БД: при переносе между СУБД её нужно подготовить для приёмника, автоматического перевода кода нет.
Пользовательские отчёты — системный раздел Паруса, который может использоваться вместе с доработками КОР (Конструктора отраслевых расширений). Кнопка отчёта в форме класса ссылается на код REP, но не делает отчёт частью класса. Он выбирается самостоятельно.
Что входит в перенос
REPПользовательский отчётКод, наименование, папка, вид, шаблон, процедура, имя файла и признаки печатиСправочник полей
51 поле · 5 группВсе задаваемые поля модели отчёта и его частей: 16 у отчёта, 15 у параметра, 3 у связи с разделом, 15 у формы и 2 у назначения. Техническое имя — имя в Git YAML; рядом указано имя в JSON обоих ZIP-транспортов. Вычисляемое поле Identity объяснено в примечании под каталогом.
Как читать обозначения и правила
Наведите указатель на значок, перейдите к нему клавишей Tab или нажмите его — появится подпись.
Ключ определяет объект или запись внутри родителя. У назначения заполняют ровно одно из двух полей: 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.Link / REP.Link.DocType3 поля
UnitCodeJSON: unitCodeстрокаКлючКод раздела- Назначение
- Класс, из которого пользователю доступен отчёт.
- При переносе:
- Новая связь ждёт Create REP, а создание и изменение связи — Create CLS. Смена кода в полном списке снимает прежнюю связь и создаёт новую, сохраняя оба класса.
NameJSON: nameстрокаСравниваетсяНаименование привязки- Назначение
- Подпись отчёта для этого раздела; может отличаться от Name самого отчёта.
- При переносе:
- Изменение даёт Update REP.Link. Удаление привязки убирает это подключение; оно не удаляет отчёт и его прочие подключения.
DocTypesJSON: docTypesсписок строк / nullПо элементамТипы документов связи- Назначение
- Коды типов документов, указанные у подключения отчёта к разделу.
- При переносе:
- Состав меняют REP.Link.DocType Create / Delete без Update. null или отсутствующее поле сохраняет текущие типы для сохранённой связи; [] явно снимает все. Порядок кодов не важен. Сами типы и разрешения разделам Holkas не переносит.
Визуальные формы · 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 отвергаются.
Команды плана
Семь кодов охватывают сам отчёт и его части. Create — создание, Update — изменение, Delete — удаление. У пиктограмм доступны подписи по наведению, клавиатурному фокусу и нажатию.
Отчёт и его части7 кодов
REPОтчёт и шаблон
Создаёт отчёт со всеми его собственными реквизитами, включая шаблон. Update передаёт изменяемые настройки, а при смене папки перемещает отчёт в неё. Другие ReportType, TemplateData или FileName отклоняют весь Update в БД. Разница только в частях не требует команды корня.
Ключ: Код отчёта
REP.ParamПараметр отчёта
Добавляет новый параметр, обновляет поля параметра с прежним Name или удаляет отсутствующий. При смене процедуры в БД может заново записать аргумент совпавшего параметра: это восстановление после очистки Парусом. SortNumb передаётся этой же командой.
Ключ: Отчёт|Имя параметра
REP.LinkПодключение к разделу
Добавляет подключение отчёта к классу, меняет его подпись или снимает отсутствующее подключение. Типы документов меняются отдельно. Класс и отчёт от Delete связи сохраняются.
Ключ: Отчёт|Класс
REP.Link.DocTypeТип документа подключения
Добавляет или снимает код типа у связи. Все значимые поля входят в ключ; Update нет. Сами записи справочника типов документов и разрешения разделам не создаются.
Ключ: Отчёт|Класс|Код типа документа
REP.VFВизуальная форма отчёта
Добавляет, меняет или снимает форму по FormClass. Смена FormKind, ShowMethod либо уже заданного EventsLanguage отклоняет Update формы в БД. Четыре текстовых тела записываются, только когда соответствующее поле не null.
Ключ: Отчёт|Имя формы
REP.VF.PrivНазначение формы
Назначает форму роли или пользователю Паруса либо снимает назначение. Update не возникает: другой получатель означает другое назначение. Роль и пользователя эта команда не создаёт.
Ключ: Отчёт|Форма|role:Роль или user:Логин
REP.VF.AppПриложение формы
Подключает форму к приложению или снимает связь. Update не возникает: код приложения входит в ключ. Приложение и сама форма при снятии связи сохраняются.
Ключ: Отчёт|Форма|Код приложения
Delete целого отчёта по отсутствию в выбранном наборе не строится. Отдельного SetOrder нет. Git сохраняет новое описание по исполненным командам; ограничения процедур Паруса относятся к БД. S3 и «Файл пакета» создают новый ZIP, а не меняют прежний архив команда за командой.
Пример: новая процедура, прежний параметр
В приёмнике RequestList вызывает P_REQUEST_OLD; параметр STITLE передаётся в аргумент STITLE. Источник переводит отчёт на P_REQUEST_NEW с тем же аргументом, а поля параметра не меняет.
- Если новая процедура едет в том же переносе, выполняется её Create или Update.
- Update REP записывает P_REQUEST_NEW. Парус при смене процедуры очищает аргументы параметров.
- 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 / JPPCreate / 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
YAMLCustomReport/RequestList.yamlПоля с заглавной буквы: TemplateData, Parameters, LinksClass, VisualForms. Шаблон — список чисел-байтов.
S3
JSON в ZIPCustomReport/RequestList.jsonОдин JSON с templateData, parameters, linksClass и visualForms. Шаблон — строка Base64.
Файл пакета
JSON в ZIPCustomReport/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 и схемы — учебные примеры. Нового переноса в БД и проверки печати при подготовке страницы не выполнялось.