К статье
Практический материал

Администрирование · 11 мин

Как поставить обработку в 1С: подключение, настройка и проверка

Как подключить внешнюю обработку в 1С через «Дополнительные отчеты и обработки», открыть файл .epf, настроить безопасный режим и проверить работу.

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

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

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

Что такое внешняя обработка и когда она нужна

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

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

Подготовка: права, файл и резервная копия

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

Проверьте сам файл: расширение должно быть .epf (обработка) или .erf (отчет). Файлы .cf, .dt и .cfe — это конфигурации, выгрузки баз и расширения, они подключаются совершенно иначе. Если обработка пришла в архиве, распакуйте её и убедитесь, что внутри именно .epf.

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

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

Самый быстрый способ запустить обработку — меню «Файл» → «Открыть» (или сочетание Ctrl+O) и выбор файла .epf. Обработка откроется в отдельном окне и будет готова к работе. Этот способ не требует никаких настроек и доступен практически любому пользователю.

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

Постоянное подключение через «Дополнительные отчеты и обработки»

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

В справочнике нажмите «Создать», затем укажите файл .epf на диске. Программа прочитает сведения из обработки: наименование, версию, вид (заполнение объекта, печатная форма, дополнительная обработка и т.д.), размещение в разделах. Если обработка написана по стандарту БСП, все поля заполнятся автоматически.

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

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

Настройка после подключения: разделы, права, расписание

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

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

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

Безопасный режим и профили безопасности

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

В клиент-серверных базах с настроенными профилями безопасности кластера вместо отключения безопасного режима правильнее выдать обработке конкретные разрешения: на каталог, COM-объект или интернет-ресурс. Это тонкая настройка, которая выполняется администратором через консоль кластера или функциональность профилей безопасности в БСП.

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

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

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

Типичные ошибки при подключении

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

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

Типичные ошибки
01
Подключение обработки сразу в рабочую базу без теста на копии — некорректный код может изменить данные без возможности отката
02
Отключение безопасного режима «чтобы заработало» без анализа причины — обработка получает полный доступ к системе
03
Попытка открыть файл .erf или .cf как обработку — отчеты и конфигурации подключаются по-другому
04
Забытое размещение по разделам — обработка подключена, но пользователи её не видят
05
Обновление файла обработки путем создания нового элемента справочника вместо замены файла в существующем — в базе копятся дубли и путаются пользователи

Обновление и отключение обработки

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

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

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

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

Обработка в справочнике
Норма

Элемент записан, файл загружен, версия соответствует ожидаемой

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

Ошибка при загрузке файла или пустые сведения об обработке

Видимость в разделе
Норма

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

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

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

Результат выполнения
Норма

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

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

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

FAQ: частые вопросы о подключении обработок

Можно ли поставить обработку в 1С:Бухгалтерию базовой версии?

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

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

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

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

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

Как поставить обработку на автоматическое выполнение по расписанию?

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

Опасно ли открывать обработки, скачанные из интернета?

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

Что делать, если кнопки «Дополнительные обработки» нет в разделе?

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

Итог

Что важно запомнить

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