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