Как вызвать обработку в 1С: пошаговая инструкция для пользователя и разработчика

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

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

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

Открытие внешней обработки через меню «Файл»

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

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

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

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

Вызов обработки через «Все функции»

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

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

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

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

Когда обработка нужна регулярно, открывать файл каждый раз неудобно. В типовых конфигурациях на платформе 8.3 есть подсистема «Дополнительные отчеты и обработки» (библиотека стандартных подсистем). Она позволяет зарегистрировать внешнюю обработку в базе и вызывать её из интерфейса как штатную команду.

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

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

Открытие обработки в конфигураторе

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

Из конфигуратора обработку можно сразу запустить на выполнение в режиме отладки: «Отладка» → «Начать отладку» (или F5). Платформа откроет сеанс 1С:Предприятия, и обработка запустится под отладчиком — можно ставить точки останова и смотреть значения переменных. Это основной способ поиска ошибок во внешних обработках.

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

Программный вызов обработки из кода

Обработку можно вызвать не интерактивно, а из встроенного языка 1С — например, из другой обработки, регламентного задания или расширения. Для внешней обработки используется менеджер «ВнешниеОбработки»:

Обработка = ВнешниеОбработки.Создать("C:\Обработки\Загрузка.epf", Ложь);
Обработка.ВыполнитьЗагрузку(ПараметрыЗагрузки);

Метод «Создать» возвращает объект обработки, после чего можно вызывать её экспортные процедуры и функции. Второй параметр определяет безопасный режим: если передать «Истина», код обработки выполнится с ограничениями безопасного режима.

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

Обработка = ВнешниеОбработки.Создать("C:\Обработки\Загрузка.epf", Ложь);
Обработка.ВыполнитьЗагрузку();

Частые ошибки и их устранение

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

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

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

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

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

Для массовых операций полезно сначала выполнить обработку в тестовом режиме, если он предусмотрен, либо на одном-двух объектах. Журнал регистрации («Администрирование» → «Обслуживание» → «Журнал регистрации») поможет отследить ошибки, которые не вывелись на экран.

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