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

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

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

Какие бывают обработки и что выбрать

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

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

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

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

Сразу задайте имя обработки без пробелов и русских символов в имени объекта метаданных — это упростит обращение из кода. Синоним (отображаемое название) можно писать по-русски, он будет виден пользователям при подключении через механизм дополнительных обработок.

Сохраните заготовку через «Файл → Сохранить как» в отдельный каталог проекта. Работайте с копией файла, если обработка уже используется в рабочей базе: случайное сохранение недоделанной версии может прервать работу пользователей.

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

Форма создаётся в дереве обработки: правый клик по объекту → «Добавить форму». В конструкторе формы добавьте реквизиты, которые будут хранить введённые пользователем значения: период отбора, ссылку на организацию, путь к файлу загрузки. Реквизиты формы перетаскиваются в дерево элементов, где для них настраиваются вид поля, заголовок и обязательность.

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

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

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

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

&НаСервере
Процедура ВыполнитьОбработкуНаСервере()
    Запрос = Новый Запрос;
    Запрос.Текст = "ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура ГДЕ ПометкаУдаления = ЛОЖЬ";
    Выборка = Запрос.Выполнить().Выбрать();
    Пока Выборка.Следующий() Цикл
        // действия с объектом
    КонецЦикла;
КонецПроцедуры

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

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

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

Проверяйте результат на копии базы или на тестовом контуре. После выполнения обработки убедитесь, что изменилось ожидаемое количество объектов, движения документов корректны, а связанные отчёты не «развалились».

Подключение обработки к рабочей базе

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

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

Типичные ошибки при разработке обработок

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

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