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