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

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

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

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

Запуск внешней обработки через меню «Файл → Открыть»

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

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

1. 1
   Сделайте резервную копию базы или убедитесь в её наличии
2. 2
   Запустите 1С в режиме предприятия под пользователем с достаточными правами
3. 3
   Откройте меню «Файл → Открыть» и выберите файл .epf
4. 4
   Заполните параметры на форме обработки
5. 5
   Нажмите кнопку выполнения и дождитесь завершения
6. 6
   Проверьте результат по сообщениям и данным в базе

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

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

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

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

Выполнение произвольного кода через консоль кода

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

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

Запрос = Новый Запрос("ВЫБРАТЬ Ссылка ИЗ Документ.РеализацияТоваровУслуг ГДЕ Дата >= &Дата");
Запрос.УстановитьПараметр("Дата", НачалоМесяца(ТекущаяДатаСеанса()));
Выборка = Запрос.Выполнить().Выбрать();
Сообщить("Найдено документов: " + Выборка.Количество());

Код из консоли выполняется на сервере в контексте текущего сеанса. Это значит, что недоступны клиентские конструкции (ОткрытьФорму, диалоги выбора файла), если консоль не предусматривает раздельное выполнение на клиенте и сервере.

Запуск и отладка обработки в конфигураторе

Разработчику, который дорабатывает обработку, удобнее запускать её из конфигуратора с отладкой. Откройте файл обработки в конфигураторе («Файл → Открыть»), затем запустите отладку через «Отладка → Начать отладку» или клавишу F5. Платформа запустит сеанс предприятия, подключённый к отладчику.

Далее в запущенном сеансе откройте обработку через «Файл → Открыть» — выполнение остановится на установленных точках останова. Вы сможете пошагово проходить код (F10 — шаг через, F11 — шаг внутрь), смотреть значения переменных в табло (Shift+F9) и изменять их на лету для проверки гипотез.

Запуск кода обработки программно — из другого кода

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

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

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

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

Ошибка «Нарушение прав доступа» при открытии говорит о том, что у пользователя нет права «Интерактивное открытие внешних отчетов и обработок». Это право задаётся в ролях конфигурации; обратитесь к администратору, чтобы его включили, либо запускайте обработку под пользователем с полными правами — но только в тестовой базе.

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

Как проверить, что код выполнился корректно

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

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

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