Как создать внешнюю обработку в 1С: пошаговое руководство

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

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

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

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

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

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

Создание файла обработки в конфигураторе

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

1. 1
   Откройте конфигуратор и выполните: Файл → Новый (Ctrl+N).
2. 2
   В списке типов выберите «Внешняя обработка» и нажмите «Готово».
3. 3
   В палитре свойств задайте имя, например ЗагрузкаНоменклатуры — синоним подтянется автоматически.
4. 4
   Добавьте основную форму: правый клик по обработке → «Добавить» → «Форма», тип — «Форма обработки».
5. 5
   Сохраните файл: Файл → Сохранить как, укажите имя файла .epf.

После создания формы откроется редактор с тремя областями: дерево элементов формы, список реквизитов и команд, модуль формы. Реквизиты формы — это поля ввода (например, путь к файлу, период, ссылка на документ). Команды — это кнопки, которые запускают процедуры.

Построение формы: реквизиты, команды, кнопки

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

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

Написание кода: клиентские и серверные процедуры

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

&НаКлиенте
Процедура Загрузить(Команда)
	ЗагрузитьНаСервере(ПутьКФайлу);
	ПоказатьПредупреждение(, "Загрузка завершена");
КонецПроцедуры

&НаСервереБезКонтекста
Процедура ЗагрузитьНаСервере(Путь)
	// Запросы и запись данных — только здесь
КонецПроцедуры

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

Проверка и запуск обработки

Быстрая проверка без публикации: откройте базу в режиме предприятия, выполните Файл → Открыть и выберите сохранённый .epf. Обработка запустится с правами текущего пользователя. Проверьте сценарий на копии базы или на тестовых данных: убедитесь, что создаются именно те объекты, что задумано, и не появляются дубли при повторном запуске.

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

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

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

Альтернативы и ограничения

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

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