Копирование вариантов отчетов между базами

Зачем

Пользовательский вариант отчета в конфигурациях на БСП живет в справочнике «Варианты отчетов»: группировки, отборы, условное оформление, выбранные поля. Штатный путь переноса — из формы отчета «Сохранить вариант в файл» / «Загрузить вариант из файла», по одному варианту.

Когда копий базы несколько (тест и рабочая, филиалы на одной конфигурации, переезд после обновления), вариантов десятки. Открывать каждый отчет руками незачем.

Обработка показывает пользовательские варианты списком, выгружает отмеченные в zip того же формата, что и типовая команда БСП, и загружает эти файлы в другую базу через ВариантыОтчетов.ОбновитьВариантыОтчетовИзФайлов. Файл, снятый обработкой, можно загрузить и без нее — из формы отчета.

Базы должны быть «одинаковыми» в смысле отчетов: совпадают имена объектов метаданных (Отчет.Продажи) или имена внешних отчетов в справочнике дополнительных отчетов и обработок. Ссылки в отборах СКД на конкретные элементы справочников переносятся как есть; если в приемнике другие уникальные идентификаторы, отбор нужно поправить уже после загрузки.

Что переносится и что нет

В выгрузку попадают только пользовательские варианты (Пользовательский = Истина), без пометки удаления. Предопределенные варианты из конфигурации обработка не трогает.

В zip уходит настройка варианта (компоновщик: структура, отбор, оформление). Не уходят:

• права доступа и «поделиться вариантом»;
• пользовательские настройки, которые каждый хранит отдельно от варианта (значения отборов «на этот раз»);
• размещение команды на панелях, если в приемнике вариант создается заново — этим занимается уже БСП при загрузке;
• сами отчеты. Если отчета нет в приемнике, загружать некуда.

Для дополнительного (внешнего) отчета в архив пишется имя вида ВнешнийОтчет.<ИмяОбъекта>. В приемнике этот внешний отчет должен быть подключен с тем же именем объекта.

Форма

На форме одна таблица и флажок «Только мои варианты» внизу слева.

Колонки: пометка; Ссылка; Наименование; ПредставлениеОтчета; КлючВарианта; Автор.

Над таблицей кнопки «Выгрузить в файл» и «Загрузить из файла», рядом типовые иконки обновить / отметить все / снять отметки. Справа строка поиска (Ctrl+F). На таблице можно поставить отбор платформы, на скриншоте включен отбор по автору.

Список заполняется при открытии. Запрос берет Справочник.ВариантыОтчетов, отсекает помеченные на удаление и непредопределенные. Флажок «Только мои варианты» оставляет строки, где автор — текущий пользователь. Представление встроенного отчета берется из метаданных по идентификатору; для дополнительного — наименование из справочника дополнительных отчетов и обработок.

Выгрузка

1. Открыть обработку в базе-источнике.
2. При необходимости включить «Только мои варианты» или найти строки поиском.
3. Отметить нужные строки (или «Отметить все»).
4. «Выгрузить в файл».

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

На сервере для каждой ссылки читаются реквизиты Отчет, КлючВарианта, Представление, Настройки, ТипОтчета. Имя отчета для встроенного варианта — полное имя объекта метаданных. Для дополнительного — ВнешнийОтчет. плюс ИмяОбъекта из карточки внешнего отчета.

Если в хранилище значения настроек пусто, обработка пытается взять настройки из схемы компоновки: для встроенного отчета через ОтчетыСервер.ОтчетОбъект, для внешнего — через ДополнительныеОтчетыИОбработки.ОбъектВнешнейОбработки, затем СхемаКомпоновкиДанных.ВариантыНастроек[КлючВарианта].Настройки. Если и схема не отдала настройки, этот вариант в архив не попадает.

Один отмеченный файл — диалог «Сохранить вариант отчета» с фильтром *.zip. Несколько файлов — диалог выбора каталога. Имена на диске: ВариантОтчета1.zip, ВариантОтчета2.zip и так далее. Содержимое варианта смотрите внутри архива, а не по имени файла.

Если ни один вариант не удалось упаковать, сообщение: «Не удалось сформировать файлы: варианты не содержат настроек.»

Состав zip

Формат совпадает со штатным «сохранением варианта отчета в файл» БСП.

Settings.xml — настройки компоновки, записанные через СериализаторXDTO.

SettingsDescription.xml:

<SettingsDescription ReportName="Отчет.ИмяОтчета">
    <Settings Key="ключ варианта" Presentation="представление варианта"/>
</SettingsDescription>

Для внешнего отчета ReportName выглядит как ВнешнийОтчет.ИмяОбъекта.

Загрузка

1. Открыть обработку в базе-приемнике.
2. «Загрузить из файла».
3. В диалоге выбрать один или несколько *.zip.
4. Дождаться оповещения «Варианты отчетов загружены» с количеством.

Файлы помещаются во временное хранилище и передаются в ВариантыОтчетов.ОбновитьВариантыОтчетовИзФайлов. Поведение поиска существующего варианта, создания нового и назначения автора — типовое для этой функции БСП. После загрузки список на форме обновляется.

Тот же zip можно загрузить из формы отчета типовой командой, если обработка в приемнике не нужна.

Подключение

Вариант 1. «Файл — Открыть» и указать epf.

Вариант 2. Справочник «Дополнительные отчеты и обработки»: создать элемент, загрузить файл, опубликовать. Вид — дополнительная обработка, команда открывает форму. На скриншоте обработка открыта из этого справочника в ERP УХ 3.3. В сведениях для БСП безопасный режим выключен: обработка пишет временные каталоги и zip.

В расширении конфигурации обработка не поставляется.

Требования

• Платформа 8.3, режим совместимости обработки 8.3.27.
• Любая конфигурация на БСП с подсистемой «Варианты отчетов». Проверялась в «1С:ERP. Управление холдингом», ред. 3.3. На УТ, КА, ERP, ЗУП, БП отдельно не гонялась.
• Модули: ВариантыОтчетов, Пользователи, ОбщегоНазначения, ОбщегоНазначенияКлиентСервер, ФайловаяСистема, ФайловаяСистемаКлиент, СтроковыеФункцииКлиентСервер, ОтчетыСервер. Для внешних отчетов — ДополнительныеОтчетыИОбработки.
• Права на справочник «Варианты отчетов» и работу с файлами на клиенте.
• 1С:Фреш и безопасный режим не поддерживаются. Код открытый.

Ограничения

Обработка не сравнивает конфигурации и не мапит ссылки в отборах. Если в варианте отбор по конкретной номенклатуре, в приемнике должна существовать та же ссылка либо отбор нужно поправить.

Имена выгруженных файлов не содержат наименование варианта. При массовой выгрузке ориентируйтесь на SettingsDescription.xml внутри zip.

Одним архивом все варианты не пакуются: один вариант — один zip. Так устроен штатный формат БСП.

История версий

26.08.2026 — первая публичная версия: список пользовательских вариантов, отбор по автору, выгрузка и загрузка zip формата БСП, поддержка встроенных и дополнительных отчетов.