Как обновить внешнюю обработку 1С

Внешняя обработка в 1С — это файл с расширением .epf (или .erf для отчётов), который подключается к базе без изменения конфигурации. Обновление такой обработки требуется, когда разработчик выпустил новую версию с исправлениями, когда обработка перестала работать после обновления платформы или конфигурации, либо когда нужно заменить устаревший функционал. Сама процедура занимает несколько минут, но ошибка при замене может привести к тому, что пользователи потеряют рабочий инструмент или получат версию с дефектом.

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

Перед любыми действиями сохраните копию текущей версии обработки. Если новая версия окажется нерабочей, откат займёт минуту — при условии, что старый файл не был безвозвратно перезаписан.

Как определить, как именно подключена обработка

Прежде чем что-то менять, выясните способ подключения. Если обработка запускается из раздела «Дополнительные отчеты и обработки» внутри интерфейса 1С — она хранится в базе, в справочнике дополнительных обработок, и обновляется заменой файла в элементе справочника. Если пользователь открывает её через «Файл → Открыть» — обработка лежит на диске или в сетевой папке, и обновление сводится к замене самого файла.

Третий вариант — обработка встроена в расширение конфигурации или вызывается из другого механизма. В этом случае её обновляет разработчик расширения, и самостоятельная замена файла ничего не даст. Признак такой ситуации: обработка есть в списке дополнительных, но колонка «Публикация» или источник указывает на расширение.

Подготовка: резервная копия и проверка совместимости

Сохраните текущую версию обработки до замены. В элементе справочника дополнительных обработок есть команда выгрузки файла на диск — выгрузите старый .epf в отдельную папку с понятным именем, например «Обработка_старая_версия». Если обработка лежит на диске, просто скопируйте файл. Это займёт меньше минуты, но избавит от ситуации, когда откатить нерабочее обновление нечем.

Проверьте совместимость новой версии с вашей конфигурацией и платформой. Если обработка получена от стороннего разработчика, уточните, для каких версий конфигурации она предназначена. Обработка, написанная под старую редакцию конфигурации, может обращаться к переименованным объектам метаданных и падать с ошибкой «Поле объекта не обнаружено».

Обновление через справочник «Дополнительные отчеты и обработки»

Это основной сценарий для типовых конфигураций на БСП (Управление торговлей, ERP, Бухгалтерия, ЗУП и другие). Путь к справочнику обычно такой: «Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки». Если пункт не виден, проверьте, что включён функциональный опцион «Дополнительные отчеты и обработки» в том же разделе настроек.

Найдите нужную обработку в списке — удобно пользоваться поиском по наименованию. Откройте элемент и выполните команду загрузки нового файла: в зависимости от версии БСП это кнопка «Загрузить из файла», «Заменить файл» или команда в меню «Ещё». Укажите новый .epf-файл, подтвердите замену и запишите элемент.

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

1. 1
   Выгрузите текущую версию обработки из справочника на диск как резервную копию
2. 2
   Откройте «Администрирование → Дополнительные отчеты и обработки» и найдите нужный элемент
3. 3
   Выполните команду «Загрузить из файла» / «Заменить» и укажите новый .epf
4. 4
   Запишите элемент справочника
5. 5
   Запустите обработку из списка и проверьте работу на тестовых данных
6. 6
   Сообщите пользователям о необходимости перезапустить сеанс или переоткрыть обработку

Обновление обработки, открываемой с диска

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

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

Как проверить, что обновление прошло успешно

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

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

Контрольные точки

Как проверить результат

Запуск обработки

Норма

Форма открывается, ошибок нет

Тревожный признак

Ошибка компиляции или «Поле объекта не обнаружено»

Версия в элементе справочника

Норма

Совпадает с версией нового файла

Тревожный признак

Показана старая версия — файл не заменился

Основная операция

Норма

Печать/загрузка/отчёт выполняются корректно

Тревожный признак

Ошибка на этапе выполнения или неверный результат

Работа у других пользователей

Норма

После перезапуска сеанса обработка работает

Тревожный признак

У пользователей открывается старая версия из кэша

Типичные ошибки и их последствия

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

Вторая ошибка — обновление без учёта кэша. Платформа 1С кэширует метаданные и внешние компоненты сеанса: пользователь, у которого обработка была открыта, может продолжать видеть старую версию до перезапуска. Это нормальное поведение, а не признак неудачного обновления.

Третья группа проблем — права доступа. Если после обновления пользователи не видят обработку в списке, проверьте настройки «Быстрый доступ» и права на справочник дополнительных обработок: замена файла права не меняет, но если элемент пересоздавался, настройки доступа могли сброситься.

Откат к предыдущей версии

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

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

Маршрут решения

Как выбрать действие

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

Обработка работает, но у части пользователей ошибкиПроверьте права доступа и попросите пользователей перезапустить сеанс для очистки кэша

После замены пропала кнопка печати в документахПроверьте, что обновляли существующий элемент справочника, а не создали новый; восстановите привязку в настройках элемента

FAQ

Нужно ли останавливать работу пользователей для обновления обработки?

Блокировать базу не требуется — замена файла в справочнике выполняется в обычном режиме. Но пользователям, у которых обработка открыта, нужно закрыть и заново открыть её, чтобы загрузилась новая версия. Критичные обработки лучше обновлять в нерабочее время.

Чем отличается файл .epf от .erf?

EPF — это внешняя обработка, ERF — внешний отчёт. Технически они устроены схоже, но в справочнике дополнительных отчетов и обработок учитываются как разные виды. Загружать файл нужно в элемент соответствующего вида, иначе при публикации возникнут ошибки.

После обновления конфигурации внешняя обработка перестала работать. Что делать?

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

Можно ли хранить несколько версий одной обработки в базе?

Да, можно создать отдельные элементы справочника с разными файлами и разными наименованиями, например «Загрузка прайса (старая)» и «Загрузка прайса (новая)». Это удобно на период тестирования. После проверки старую версию лучше снять с публикации, чтобы пользователи не путались.

Почему в справочнике нет кнопки загрузки файла?

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

Безопасно ли загружать обработки из непроверенных источников?

Нет. Внешняя обработка — это исполняемый код с доступом к данным базы. При открытии файла платформа показывает предупреждение о безопасности — не игнорируйте его. Загружайте обработки только от разработчиков, которым доверяете, а сомнительные файлы сначала проверяйте на копии базы.