Как подключить внешнюю обработку в 1С:Розница

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

Подключение выполняется через стандартный механизм «Дополнительные отчеты и обработки», который входит в состав библиотеки стандартных подсистем и присутствует в 1С:Розница 2.2, 2.3 и 3.0. Для работы понадобятся права администратора и сам файл обработки в формате .epf (для управляемого приложения) или .erf для внешних отчётов.

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

Что понадобится перед подключением

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

Пользователь, выполняющий подключение, должен обладать правами администратора или как минимум правом «Добавление и изменение дополнительных отчетов и обработок». В файловой базе достаточно полных прав, в клиент-серверной — проверьте роли через раздел «Администрирование» → «Пользователи и права».

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

Включение механизма дополнительных отчетов и обработок

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

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

В файловой базе дополнительно проверьте настройку «Использовать профили безопасности» — она влияет на то, как обработки получают доступ к файловой системе. В большинстве случаев для локальной базы достаточно стандартных настроек.

Регистрация внешней обработки в базе

Откройте список «Дополнительные отчеты и обработки» и нажмите «Создать» либо «Добавить из файла» — название кнопки зависит от версии. Укажите путь к файлу .epf или .erf. Программа считает сведения из самой обработки: наименование, версию, вид и безопасный режим.

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

Обратите внимание на флажок «Безопасный режим». В безопасном режиме обработке запрещены операции с файловой системой сервера, COM-объекты и внешние компоненты. Для обработок, которым нужно читать файлы Excel или работать с оборудованием, безопасный режим придётся снять — делайте это осознанно.

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

Настройка размещения и прав доступа

После загрузки файла откройте вкладку или команду «Размещение» в карточке обработки. Здесь выбираются разделы программы, в которых появится команда запуска: «Продажи», «Закупки», «Склад», «Администрирование» и другие. Без указания размещения обработка будет доступна только через общий список дополнительных обработок.

Для печатных форм и обработок заполнения размещение определяется иначе — указываются типы объектов (например, документ «Реализация товаров» или «Поступление товаров»). Тогда команда появится в меню «Печать» или «Заполнить» конкретного документа.

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

Альтернативные способы запуска

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

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

Сравнение вариантов

Регистрация в справочнике дополнительных обработок

Подходит для постоянного использования: команда в разделах, права, расписание. Требует прав администратора.

Открытие через Файл → Открыть

Подходит для разового запуска и теста. Не сохраняется в интерфейсе, права не настраиваются.

Встраивание в расширение конфигурации

Подходит для сложных доработок с формами и ролями. Требует навыков разработки, но надёжнее для массового внедрения.

Проверка результата и типичные ошибки

После записи карточки обработки перейдите в раздел, указанный в размещении, и откройте меню «Дополнительные обработки» (обычно в командной панели раздела или через «Ещё»). Команда с заданным наименованием должна присутствовать в списке и запускаться без ошибок.

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

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

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

Команда в разделе

Норма

Команда видна в меню «Дополнительные обработки» нужного раздела

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

Команды нет — проверьте размещение и права пользователя

Запуск

Норма

Форма открывается, обработка выполняет действие без ошибок

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

Ошибка «Метод объекта не обнаружен» — обработка несовместима с версией БСП

Печатная форма

Норма

Форма есть в меню «Печать» документа и формирует документ

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

Формы нет — неверно указан вид обработки или тип объекта размещения

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

Ограничения и безопасная работа

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

Перед массовыми операциями (перенумерация, групповое изменение реквизитов, загрузка данных) сделайте резервную копию базы. В файловом варианте достаточно скопировать файл 1Cv8.1CD при закрытых сеансах, в клиент-серверном — выполнить выгрузку через конфигуратор или средствами СУБД.

Частые вопросы

Почему обработка не появляется в разделе после подключения?

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

Можно ли подключить обработку от 1С:Управление торговлей к Рознице?

Только если она не обращается к объектам, которых нет в Рознице (например, к документам «Заказ клиента» в некоторых редакциях или специфическим регистрам). Универсальные обработки — загрузка из Excel, консоль запросов — обычно работают в обеих конфигурациях, но тестировать нужно на копии базы.

Что делать при ошибке «Метод объекта не обнаружен» при запуске?

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

Как удалить подключённую обработку?

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

Влияют ли внешние обработки на обновление конфигурации?

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

Можно ли запускать обработку автоматически по расписанию?

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