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

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

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

Ниже разобран полный цикл: от проверки прав и включения механизма до размещения команды в нужном разделе и проверки результата. Инструкция ориентирована на управляемые формы 1С 8.3 с конфигурациями на Библиотеке стандартных подсистем (БСП) — это большинство современных типовых решений: «Управление торговлей», «Бухгалтерия предприятия», «Зарплата и управление персоналом», ERP.

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

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

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

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

Разовый запуск: как просто открыть файл обработки

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

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

Минус разового запуска в том, что после закрытия сеанса обработку придется открывать заново, а другие пользователи её не увидят. Для регулярной работы переходите к регистрации в справочнике.

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

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

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

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

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

Размещение, права доступа и публикация для пользователей

Загруженная обработка по умолчанию не видна никому, кроме добавившего её. Чтобы пользователи получили доступ, заполните две настройки в карточке элемента: «Размещение» — разделы программы, где появится команда (например, «Закупки», «Склад», «Администрирование»), и «Быстрый доступ» — список пользователей, у которых команда отобразится в подменю «Дополнительные обработки» выбранного раздела.

Если быстрый доступ не настроен, пользователь может самостоятельно вывести команду через «Ещё → Изменить форму / Настройка навигации» в нужном разделе, но удобнее сразу назначить доступ централизованно. В базах с профилями групп доступа дополнительно проверьте, что роль «Чтение дополнительных отчетов и обработок» включена в профиль пользователей.

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

Проверка результата и обновление версии обработки

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

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

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

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

Видимость команды

Норма

Команда появилась в указанном разделе у нужных пользователей

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

Команда видна только администратору — не настроен быстрый доступ или права

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

Норма

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

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

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

Запись в справочнике

Норма

Элемент записан, в карточке указаны версия и вид обработки

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

Программа отказала в загрузке файла — обработка не содержит сведений о регистрации

Типичные ошибки и ограничения

Чаще всего регистрация не удается из-за того, что файл написан для обычных форм (1С 8.2 или режим совместимости) либо не содержит экспортной функции СведенияОВнешнейОбработке. Такую обработку можно открывать только через «Файл → Открыть» или доработать в конфигураторе, добавив модуль со сведениями о регистрации.

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

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

Чем внешняя обработка отличается от расширения конфигурации?

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

Можно ли подключить обработку, если кнопки «Добавить из файла» нет?

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

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

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

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

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

Почему обработка открывается через «Файл → Открыть», но не регистрируется в справочнике?

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

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

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