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

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

Дополнительные обработки в 1С: настройка от подключения до проверки

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

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

Механизм доступен в большинстве типовых решений на базе Библиотеки стандартных подсистем (БСП): «Управление торговлей», «ERP», «Комплексная автоматизация», «Бухгалтерия предприятия», «Зарплата и управление персоналом» и других. Если ваша конфигурация построена на БСП, настройка занимает несколько минут и не требует участия программиста — при условии, что сама обработка написана корректно.

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

Что такое дополнительные обработки и когда они нужны

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

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

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

По умолчанию во многих конфигурациях механизм отключен. Чтобы его активировать, откройте раздел «Администрирование» → «Печатные формы, отчеты и обработки» (в некоторых конфигурациях — «НСИ и администрирование» → «Администрирование»). Установите флажок «Дополнительные отчеты и обработки». После этого в интерфейсе появится одноимённый пункт, ведущий к списку подключенных объектов.

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

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

Включение механизма
  1. 1
    Откройте «Администрирование» → «Печатные формы, отчеты и обработки»
  2. 2
    Установите флажок «Дополнительные отчеты и обработки»
  3. 3
    Проверьте настройку безопасного режима — оставьте включённым, если обработке не нужен доступ к файлам
  4. 4
    Откройте появившийся пункт «Дополнительные отчеты и обработки» и убедитесь, что список доступен

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

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

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

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

Настройка прав доступа и публикации

Карточка дополнительной обработки содержит настройку «Публикация» с вариантами: используется, отключена, режим отладки. В режиме отладки обработка видна только администраторам — удобно для проверки перед общим запуском. После успешного теста переключите публикацию в «Используется».

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

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

Запуск по расписанию и в фоновом режиме

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

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

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

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

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

Команда в интерфейсе
Норма

Команда появилась в указанном разделе или в меню «Ещё» формы документа

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

Команды нет — проверьте размещение, публикацию и права пользователя

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

Обработка открывается или выполняется без сообщений об ошибках

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

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

Расписание
Норма

В журнале регистрации есть записи об успешном выполнении фонового задания

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

Задание не запускалось или завершилось с ошибкой — проверьте расписание и текст исключения

Данные после выполнения
Норма

Изменения в данных соответствуют ожиданиям на тестовой копии

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

Данные изменены некорректно — отключите обработку и восстановите копию

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

Самая частая проблема — сообщение о том, что файл не является дополнительной обработкой. Это значит, что в модуле файла нет функции СведенияОВнешнейОбработке() по стандарту БСП: обработка написана как обычная внешняя и открывается только через «Файл → Открыть». Решение — попросить разработчика добавить сведения или открывать файл напрямую.

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

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

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

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

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

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

Полное удаление карточки убирает обработку из базы. Перед удалением убедитесь, что обработка не используется в регламентных заданиях и что её результат (например, заполненные ею данные) больше не потребуется восстановить повторным запуском.

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

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

Нужна разовая операция на тестовых данныхОткройте файл напрямую через «Файл → Открыть», не подключая к справочнику
Обработка нужна постоянно группе пользователейПодключите через справочник, настройте размещение, публикацию и права
Операция должна выполняться регулярно без участия человекаНастройте расписание; для файловой базы обеспечьте постоянно открытый сеанс или перейдите на клиент-серверный режим
Источник файла не вызывает доверияНе подключайте в рабочую базу; протестируйте на копии и покажите код специалисту
Итог

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

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

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

Обработка подключена, но команда не появляется в документе. Что проверить?

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

Можно ли подключить обработку, если в ней нет сведений по стандарту БСП?

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

Безопасно ли отключать безопасный режим для обработки?

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

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

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

Что делать, если после обновления конфигурации обработка выдаёт ошибку?

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

Можно ли ограничить, какие пользователи видят конкретную обработку?

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