Разработка и Конфигурация · 11 мин
Как добавить обработку в 1С и подключить её к программе
Как добавить внешнюю обработку в 1С через справочник дополнительных отчетов и обработок, открыть файл epf и решить типичные ошибки подключения.
Внешняя обработка — это файл с расширением .epf, который расширяет возможности 1С без изменения конфигурации: печатные формы, групповая загрузка данных, сверка остатков, очистка базы и сотни других задач. Такие файлы распространяются на профильных ресурсах, поставляются партнёрами 1С или пишутся штатным разработчиком, и уметь их подключать нужно почти в каждой организации.
Существует два принципиально разных способа работы с внешней обработкой. Первый — разовый запуск через меню «Файл → Открыть»: обработка выполняется один раз и нигде не сохраняется. Второй — регистрация в справочнике «Дополнительные отчеты и обработки»: файл подключается к программе постоянно, появляется в интерфейсе, может запускаться по расписанию и с назначенными правами доступа.
Выбор способа зависит от задачи. Для однократной проверки данных достаточно простого открытия файла. Если обработкой будут пользоваться сотрудники регулярно — её нужно зарегистрировать в базе, иначе каждый раз придётся искать файл на диске и объяснять коллегам, где он лежит.
Проверка файла перед подключением
Прежде чем добавлять обработку в базу, убедитесь, что файл действительно подходит. Внешние обработки имеют расширение .epf, внешние отчёты — .erf. Если вам прислали архив, сначала распакуйте его. Файл с другим расширением (например, .cf или .dt) — это не обработка, а конфигурация или выгрузка базы, открывать их описанным способом нельзя.
Второй критический момент — источник файла. Обработка выполняет код на встроенном языке 1С с правами текущего пользователя, поэтому файл из непроверенного источника может удалить данные, изменить документы или отправить информацию наружу. Безопасны только файлы от поставщика конфигурации, официальных партнёров, собственного разработчика или известных библиотек с открытым кодом.
Третий момент — совместимость. Обработка, написанная под обычные формы (режим «обычного приложения»), не откроется в современном интерфейсе «Такси», и наоборот. Если при открытии появляется пустое окно или ошибка — чаще всего дело именно в несовместимости режимов.
Как открыть обработку один раз без регистрации
Разовый запуск подходит для тестирования или единичной операции. В клиентском приложении 1С откройте главное меню (кнопка с оранжевым логотипом или значок меню в левом верхнем углу), выберите «Файл → Открыть» и укажите путь к файлу .epf. Обработка запустится сразу, без сохранения в базе.
У этого способа есть ограничение: в конфигурациях, работающих в режиме управляемого приложения, пункт «Файл → Открыть» доступен всегда, но обработка, написанная под обычные формы, может не отобразиться корректно. Кроме того, при каждом следующем запуске файл придётся искать заново, а другие пользователи его не увидят.
- 1Сохраните файл .epf в доступную папку, например в «Документы»
- 2Откройте 1С в режиме 1С:Предприятие
- 3В главном меню выберите «Файл → Открыть»
- 4Укажите путь к файлу и нажмите «Открыть»
- 5Проверьте, что интерфейс обработки загрузился без ошибок
Включение механизма дополнительных отчетов и обработок
Постоянное подключение работает через механизм Библиотеки стандартных подсистем (БСП), который встроен в большинство типовых конфигураций: «Бухгалтерия предприятия», «Управление торговлей», «Зарплата и управление персоналом», «ERP» и другие. По умолчанию механизм часто выключен, и справочник в интерфейсе не виден.
Чтобы включить его, перейдите в раздел «Администрирование → Печатные формы, отчеты и обработки» (в некоторых конфигурациях путь называется «Настройка → Администрирование → Печатные формы и отчеты»). Установите флажок «Дополнительные отчеты и обработки». После этого в том же разделе появится ссылка на одноимённый справочник.
Если флажка нет — вероятнее всего, конфигурация не содержит БСП (самописная или сильно доработанная) либо у вас недостаточно прав. В первом случае постоянное подключение штатными средствами невозможно, остаётся только разовый запуск или доработка конфигурации. Во втором — запросите у администратора роль «Добавление и изменение дополнительных отчетов и обработок» или полные права.
Регистрация обработки в справочнике
Откройте справочник «Дополнительные отчеты и обработки» и нажмите «Создать». Программа предложит выбрать файл — укажите ваш .epf. 1С прочитает встроенную в обработку регистрационную информацию: наименование, версию, вид, безопасный режим и список команд.
После загрузки проверьте карточку элемента. Поле «Публикация» определяет видимость: «Используется» — обработка доступна пользователям, «Отключена» — скрыта, «Режим отладки» — видна только тем, у кого включён отладочный режим. В табличной части «Команды» указано, как именно запускается обработка: открытием формы, вызовом серверной процедуры или заполнением объекта.
Нажмите «Записать и закрыть». С этого момента обработка хранится внутри информационной базы (исходный файл на диске больше не нужен для работы) и появляется в интерфейсе — в разделе «Дополнительные обработки» соответствующего подраздела или в формах объектов, если это обработка заполнения или печатная форма.
- 1Администрирование → Печатные формы, отчеты и обработки → включить «Дополнительные отчеты и обработки»
- 2Открыть справочник «Дополнительные отчеты и обработки»
- 3Нажать «Создать» и выбрать файл .epf
- 4Проверить наименование, вид и публикацию в карточке
- 5Нажать «Записать и закрыть»
- 6Проверить появление обработки в разделе «Дополнительные обработки»
Настройка доступа, разделов и расписания
После регистрации обработку нужно привязать к месту в интерфейсе. В списке справочника нажмите «Размещение» или откройте команду «Дополнительные обработки» нужного раздела и добавьте туда зарегистрированный элемент. Без этого шага обработка записана в базе, но пользователи её не найдут.
Видимость конкретных команд можно ограничить по пользователям: в карточке обработки или через быстрые настройки раздела укажите, кому команда доступна. Для серверных обработок (вид «Дополнительная обработка» с серверным вызовом) доступен запуск по расписанию через регламентные задания — например, ежедневная загрузка курсов или ночная сверка данных.
Отдельно обратите внимание на флажок «Безопасный режим». В безопасном режиме обработке запрещены операции с файловой системой и COM-объектами. Для обработок из непроверенных источников безопасный режим лучше оставить включённым, но некоторые функции (выгрузка файлов, обмен с оборудованием) в нём работать не будут.
Как выбрать способ подключения
Проверка результата и типичные ошибки
Признак успешного подключения: обработка видна в разделе «Дополнительные обработки» (или в кнопке «Печать» / «Заполнение» формы объекта), открывается у пользователя с ограниченными правами и выполняет свою функцию без сообщений об ошибках. Проверяйте под учётной записью конечного пользователя, а не только под администратором.
Если что-то пошло не так, сначала определите, на каком этапе проблема: файл не загружается в справочник, загружается, но не появляется в интерфейсе, или появляется, но падает при выполнении. У каждого сценария свои причины.
Как проверить результат
Карточка заполнилась наименованием, версией и командами
Ошибка «Невозможно подключить обработку» — файл повреждён, не является обработкой БСП или написан под обычные формы
Обработка есть в разделе «Дополнительные обработки»
Элемент записан, но не виден — проверьте публикацию и размещение по разделам
Обработка открывается и выполняется
Нарушение прав доступа — у пользователя нет прав на данные, с которыми работает обработка
Обновление и удаление подключённой обработки
Когда выходит новая версия обработки, недостаточно заменить файл на диске. Откройте карточку элемента в справочнике «Дополнительные отчеты и обработки» и загрузите новый файл через команду замены (обычно «Загрузить из файла» в меню «Ещё»). Версия в карточке обновится, настройки размещения и доступа сохранятся.
Для удаления установите в карточке публикацию «Отключена» — это безопаснее, чем сразу помечать объект на удаление: при необходимости обработку можно быстро вернуть. Окончательное удаление выполняйте через «Все функции» или стандартное удаление помеченных объектов, убедившись, что на обработку не ссылаются регламентные задания.
Удобно хранить эталонные файлы обработок в общей сетевой папке с указанием версии в имени файла, например «ЗагрузкаПрайса_2.1.epf». Тогда при обновлении легко понять, какая версия загружена в базу, и откатиться к предыдущей, если новая работает с ошибками.
Часто задаваемые вопросы
Чем обработка отличается от расширения конфигурации?
Обработка (.epf) — это самостоятельный файл, который запускается вручную или по расписанию и не меняет структуру программы. Расширение (.cfe) подключается к конфигурации и может изменять формы, роли и модули типовых объектов. Для простых сервисных задач достаточно обработки; для изменения поведения документов и форм нужно расширение.
Почему при загрузке файла появляется ошибка «Невозможно подключить дополнительную обработку»?
Чаще всего файл не содержит регистрационных данных в формате БСП — например, это старая обработка под обычные формы или внешний отчёт без функции СведенияОВнешнейОбработке. Такой файл можно запустить только через «Файл → Открыть» либо попросить разработчика адаптировать его под БСП.
Можно ли добавить обработку в 1С:Фреш (облако)?
Да, механизм дополнительных отчетов и обработок в сервисе работает, но с ограничением: обработки проходят автоматическую проверку и выполняются только в безопасном режиме. Обработки, обращающиеся к файловой системе, COM-объектам или внешним компонентам, в облаке работать не будут.
Кто имеет право добавлять обработки в базу?
По умолчанию — пользователи с полными правами или с ролью «Добавление и изменение дополнительных отчетов и обработок». Обычному пользователю справочник недоступен, и это правильно: подключение произвольного кода — административная операция, влияющая на безопасность всей базы.
Обработка запускается, но ничего не делает или выдаёт ошибку прав. Что проверить?
Сначала запустите её под пользователем, для которого она предназначена, и посмотрите текст ошибки: обычно это нехватка прав на конкретные документы или регистры. Затем проверьте журнал регистрации (Администрирование → Журнал регистрации) — там видно, на каком объекте произошёл отказ. Права настраиваются в профилях групп доступа, а не в самой обработке.
Нужно ли переподключать обработку после обновления конфигурации 1С?
Нет, зарегистрированные обработки хранятся в базе и при обновлении конфигурации сохраняются. Однако после крупного обновления стоит проверить работоспособность: если изменились объекты, с которыми работает обработка, может потребоваться её новая версия от разработчика.
Что важно запомнить
Разовый запуск — через «Файл → Открыть», постоянное подключение — через справочник «Дополнительные отчеты и обработки» после включения одноимённой опции. Перед первым запуском любой обработки делайте резервную копию, используйте файлы только из проверенных источников и не отключайте безопасный режим без необходимости.