Выгрузка дополнительных отчетов и обработок из справочника в файлы

Зачем

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

Достать файл можно по одному: открыть элемент справочника, нажать «Выгрузить в файл». Когда доработок десятки (собственные обработки, дополнительные отчеты, печатные формы, заполнение объекта), это превращается в ручную работу, которую легко забыть сделать перед обновлением.

Обработка показывает все элементы справочника одной таблицей, отмечает нужные и сохраняет их файлами в выбранный каталог — за одно действие и под штатными именами.

Форма

На форме одна таблица и поле «Объект назначения» над ней.

Колонки:

• пометка;
• Ссылка;
• Наименование;
• ИмяФайла;
• Вид.

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

Список заполняется при открытии формы. Все строки сразу отмечены — если нужны не все, снимите отметки кнопкой и отметьте нужные, либо отфильтруйте таблицу поиском.

Что попадает в список

Запрос идёт по справочнику «Дополнительные отчеты и обработки» и отсекает:

• элементы, помеченные на удаление;
• группы;
• всё, кроме дополнительных обработок и дополнительных отчетов по реквизиту «Вид». Печатные формы и заполнение объекта в список не попадают.

Если поле «Объект назначения» заполнено, в список останутся только те элементы, у которых этот объект указан в табличной части «Назначение». Это удобно, когда нужно забрать доработки одного документа: выбираете документ — видите только его обработки. Пустое поле — весь справочник.

Выгрузка

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

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

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

Если не удалось получить данные ни по одному элементу, выводится сообщение «Не удалось получить данные дополнительных отчетов и обработок».

Имена файлов

Имя берётся из реквизита «ИмяФайла» карточки — как правило, это имя файла, из которого обработка когда-то загружалась.

Если реквизит пуст, имя собирается из «ИмяОбъекта» и расширения: .erf для дополнительного отчёта, .epf для дополнительной обработки.

Элементы, у которых в хранилище нет данных, пропускаются молча — счётчика «сохранено N из M» обработка не показывает, ориентируйтесь на количество файлов в каталоге.

Подключение

Вариант 1. «Файл — Открыть» и указать epf. Подходит, чтобы разово снять копию доработок.

Вариант 2. Справочник «Дополнительные отчеты и обработки»: создать элемент, загрузить файл, указать вид «Дополнительная обработка», команда — открытие формы. Безопасный режим при этом нужно выключить: обработка обращается к файловой системе клиента через ФайловаяСистемаКлиент, в безопасном режиме диалог выбора каталога не отработает.

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

Требования

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

Ограничения, о которых лучше знать заранее

Обработка не распаковывает и не анализирует содержимое файлов — она просто отдаёт двоичные данные из хранилища. Проверить, что за обработка внутри, по имени файла не всегда возможно: «ИмяФайла» заполнено далеко не у всех элементов справочника.

Печатные формы и заполнение объекта в список не попадают: отбор по виду оставлен только для дополнительных отчетов и обработок. Если нужно снять и их, измените список видов в ЗаполнитьСписокЭлементов (запрос собирает его в массив Виды).

Порядок сохранения — по наименованию, отдельного «сохранить в подкаталоги по видам» нет: все файлы падают в один выбранный каталог.

Про версию

Текущая версия обработки — 280826; она же указана в карточке файла при публикации.

В комментарии к метаданным обработки маркер %Версия=…% не проставлен, поэтому штатная функция ПолучитьВерсиюОбработки() в списке дополнительных обработок версию не покажет — ориентируйтесь на номер, указанный здесь. Если понадобится, версия добавляется в комментарий объекта одной строкой, и тогда её подхватит штатный механизм.