Как встроить обработку в 1С

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

Выбор способа зависит от задачи. Разовые сервисные инструменты — групповое изменение реквизитов, загрузка данных из Excel, тестирование запросов — удобнее держать внешними. Обработки, которыми пользователи работают ежедневно и которые ссылаются на объекты конфигурации, логичнее встроить в метаданные, чтобы они обновлялись централизованно и не терялись при переносе базы.

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

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

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

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

Сравнение вариантов

Внешняя обработка через БСП

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

Встраивание в конфигурацию

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

Открытие файла напрямую

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

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

В типовых конфигурациях на Библиотеке стандартных подсистем (УТ, ERP, БП, ЗУП) есть встроенный механизм подключения внешних файлов. Сначала проверьте, что он включен: перейдите в «НСИ и администрирование» (или «Администрирование») → «Печатные формы, отчеты и обработки» и установите флаг «Дополнительные отчеты и обработки».

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

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

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

Встройте обработку в конфигурацию через конфигуратор

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

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

После добавления задайте обработке осмысленное имя и синоним, включите ее в нужную подсистему (свойство «Подсистемы» объекта) — тогда команда появится в панели разделов. Проверьте роли: у пользователей должно быть право «Просмотр» и «Использование» на новый объект.

Настройте команду и права доступа

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

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

Проверьте результат после встраивания

После подключения или встраивания проверьте обработку под учетной записью обычного пользователя, а не администратора. У администратора полные права, поэтому проблемы с доступом у него не проявляются.

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

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

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

Видимость команды

Норма

Команда есть в разделе у пользователя с целевой ролью

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

Команда видна только администратору — не настроены права или подсистема

Запуск

Норма

Форма открывается, нет сообщений об ошибках компиляции

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

Ошибка «Метод не обнаружен» — обработка ссылается на объекты, которых нет в конфигурации

Работа с данными

Норма

Записанные данные корректны, движения документов не нарушены

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

Ошибки прав при обращении к объектам или некорректные изменения в данных

Типичные ошибки и ограничения

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

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

Часто задаваемые вопросы

Можно ли встроить обработку, не снимая конфигурацию с поддержки?

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

Чем отличается файл .epf от .erf?

.epf — готовая внешняя обработка, которую можно подключить и запустить. .erf — формат выгрузки обработки в XML-файлы для хранения в системах контроля версий. Для подключения в базу нужен именно .epf; из .erf обработку собирают в конфигураторе.

Почему обработка не появляется в меню после добавления в конфигурацию?

Объект метаданных сам по себе не создает команду в интерфейсе. Проверьте, что обработка включена в состав хотя бы одной подсистемы, у роли пользователя есть права на объект, а конфигурация базы данных обновлена (F7 в конфигураторе).

Безопасно ли подключать внешние обработки, скачанные из интернета?

Нет гарантий безопасности: код обработки выполняется в базе и может читать или изменять данные. Открывайте файл в конфигураторе и просматривайте модуль перед подключением, используйте безопасный режим БСП и запускайте незнакомые обработки сначала на копии базы.

Что делать, если в конфигурации нет пункта «Дополнительные отчеты и обработки»?

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