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

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

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

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

Когда нужна обработка, а когда — доработка конфигурации

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

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

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

Откройте конфигуратор той базы, для которой пишется обработка. Выберите меню «Файл → Новый» (или Ctrl+N), в списке типов объектов укажите «Внешняя обработка» и подтвердите. Откроется окно нового объекта с пустой структурой: у обработки есть модуль объекта, формы, макеты и реквизиты.

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

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

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

Проектирование формы и интерфейса

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

Типовой минимум для рабочей обработки: реквизиты для ввода параметров (например, «Организация», «ПериодНачало», «ПериодКонец», «ПутьКФайлу»), команда «Выполнить» и кнопка, связанная с этой командой. Для реквизита-ссылки выберите тип через конструктор: например, «СправочникСсылка.Организации» — тогда поле получит стандартный выбор из справочника.

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

Написание кода: клиент, сервер и модуль объекта

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

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

&НаСервере
Процедура СоздатьНоменклатуруНаСервере()
НовыйЭлемент = Справочники.Номенклатура.СоздатьЭлемент();
НовыйЭлемент.Наименование = Наименование;
НовыйЭлемент.Записать();
КонецПроцедуры

При записи нескольких объектов оборачивайте операцию в транзакцию (НачатьТранзакцию / ЗафиксироватьТранзакцию / ОтменитьТранзакцию): если на сотой записи произойдёт ошибка, база не останется в полузаписанном состоянии. Для массовых операций выводите прогресс через ДлительныеОперации или хотя бы сообщайте пользователю счётчик обработанных строк.

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

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

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

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

Функция СведенияОВнешнейОбработке() Экспорт
    Параметры = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке();
    Параметры.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработкиДополнительнаяОбработка();
    Параметры.Версия = "1.0";
    Возврат Параметры;
КонецФункции

Проверка результата и отладка

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

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

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

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

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

FAQ: частые вопросы о создании обработок