Как добавить внешнюю обработку в 1С через конфигуратор

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

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

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

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

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

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

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

Подготовка: что проверить перед подключением

Перед загрузкой файла убедитесь, что обработка совместима с вашей конфигурацией и версией платформы. Обработка, написанная под «Управление торговлей» ред. 11, может не работать в «Комплексной автоматизации» или устаревшей редакции 10.3, потому что состав объектов метаданных различается. Обычно разработчик указывает совместимость в описании файла или сопроводительной документации.

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

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

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

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

Откройте этот список и нажмите «Добавить из файла» (в ряде версий — «Создать — Загрузить из файла»). Укажите путь к файлу .epf. Программа прочитает сведения из модуля обработки: наименование, версию, вид (заполнение объекта, печатная форма, дополнительный отчет и т.д.) и предложит выбрать размещение — разделы командного интерфейса, где обработка будет доступна пользователям.

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

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

Добавление обработки в конфигурацию через конфигуратор

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

Порядок встраивания такой. Откройте конфигуратор и загрузите конфигурацию базы. В меню выберите «Конфигурация — Открыть конфигурацию». Затем через «Файл — Открыть» откройте файл внешней обработки — появится её структура с формами и макетами. Далее в дереве конфигурации найдите ветку «Обработки», вызовите контекстное меню и выберите «Вставить внешнюю обработку» (в некоторых версиях платформы пункт доступен из окна самой обработки: «Действия — Сохранить в конфигурацию» или через замену при сравнении).

Более универсальный путь — через сравнение и объединение: «Конфигурация — Сравнить, объединить с конфигурацией из файла» подходит только для файлов конфигураций (.cf), поэтому для .epf используют именно вставку внешней обработки в ветку «Обработки». После добавления задайте имя объекта, синоним и при необходимости включите обработку в подсистемы, чтобы она появилась в интерфейсе. Завершите работу обновлением конфигурации базы данных (клавиша F7) и проверьте запуск.

Открытие и редактирование кода обработки в конфигураторе

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

Частая задача — адаптировать чужую обработку под свою конфигурацию: переименовать реквизиты, изменить обращения к объектам метаданных, поправить запросы. После правок сохраните файл (Ctrl+S) и обновите его в списке дополнительных обработок: откройте элемент списка и заново загрузите файл командой «Загрузить из файла», либо просто замените файл, если подключение выполнено по новой версии.

Для отладки обработки запустите отладку из конфигуратора (команда «Отладка — Начать отладку»), затем в открывшемся сеансе предприятия запустите обработку. Точки останова, расставленные в модуле, сработают при выполнении кода. Это удобно, когда обработка ведёт себя непредсказуемо и нужно понять, на каком этапе возникает ошибка.

Проверка результата и типичные ошибки

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

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

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

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

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

Обработка в списке дополнительных

Норма

Элемент записан, указаны вид, версия и размещение

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

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

Запуск под обычным пользователем

Норма

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

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

Пользователь не видит обработку или получает отказ в доступе

Работа на тестовых данных

Норма

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

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

Ошибки «метод не обнаружен» — несовместимость с конфигурацией

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

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

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

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

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

Почему кнопка «Добавить из файла» недоступна?

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

Как обновить уже подключенную обработку до новой версии?

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

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

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

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

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