Администрирование · 10 мин
Как запустить обработчик в 1С
Как запустить внешнюю обработку в 1С: открытие через Файл — Открыть, подключение в дополнительные отчеты и обработки, запуск из конфигуратора и решение типичных ошибок.
Обработчик (обработка) в 1С — это программный модуль, который выполняет определённое действие: загружает данные из Excel, групповое изменение реквизитов, выгрузку в банк, проверку контрагентов и т.п. Обработки бывают встроенными (входят в конфигурацию) и внешними (файлы с расширением .epf, которые открываются отдельно). Способ запуска зависит от того, какой у вас тип обработки и какая роль назначена пользователю.
Чаще всего вопрос «как запустить обработчик» возникает, когда бухгалтер или администратор получил файл .epf от разработчика или скачал обработку из интернета и не понимает, как её открыть. Ниже разобраны все рабочие способы: от простого открытия файла до регистрации обработки в справочнике дополнительных отчетов и обработок и запуска через конфигуратор.
Перед запуском любой внешней обработки, особенно полученной из непроверенного источника, убедитесь, что у вас есть актуальная резервная копия базы. Обработка может изменять данные напрямую, и отменить её действия кнопкой «Отменить» обычно нельзя.
Определяем тип обработки перед запуском
Первый шаг — понять, что именно вы хотите запустить. От этого зависит весь дальнейший порядок действий. Внешняя обработка — это отдельный файл, обычно с расширением .epf (управляемые формы) или реже .erf. Встроенная обработка — часть конфигурации, у неё нет отдельного файла, она вызывается из интерфейса программы.
Быстрый признак: если вам передали файл, который нужно «положить в папку» или «открыть в 1С» — это внешняя обработка. Если в инструкции написано «зайдите в раздел Администрирование и найдите пункт…» — речь о встроенной обработке или штатном механизме конфигурации.
Открывается через Файл → Открыть или подключается в дополнительные обработки
Ищите в разделах Администрирование, Сервис, НСИ
Открывается так же, но предназначен для вывода данных, а не их изменения
Запуск внешней обработки через меню «Файл — Открыть»
Самый быстрый способ разового запуска — открыть файл обработки напрямую. Запустите 1С в режиме «1С:Предприятие», войдите в нужную базу, затем нажмите кнопку меню (значок в левом верхнем углу) или используйте пункт Файл → Открыть. В диалоге выбора укажите файл .epf и подтвердите открытие.
После открытия обработка появится в интерфейсе как обычная форма. Далее действуйте по её логике: заполните параметры (период, организация, файл загрузки) и нажмите кнопку выполнения — обычно она называется «Выполнить», «Загрузить» или «Сформировать». Дождитесь окончания работы и проверьте результат в самой базе.
Учтите: в веб-клиенте и тонком клиенте при работе через веб-сервер открытие файла может потребовать передачи файла на сервер. Если кнопка «Открыть» недоступна или файл не выбирается, проверьте права пользователя и настройки безопасности.
Подключение обработки через «Дополнительные отчеты и обработки»
Если обработка нужна регулярно, открывать файл каждый раз неудобно. В типовых конфигурациях на платформе 8.3 есть механизм дополнительных отчетов и обработок (подсистема БСП). Перейдите в Администрирование → Печатные формы, отчеты и обработки, включите флажок «Дополнительные отчеты и обработки», затем перейдите по одноимённой ссылке.
Нажмите «Добавить из файла», выберите файл .epf и сохраните элемент справочника. После этого обработка появится в списке и будет доступна всем пользователям, которым выдадут право на её использование. Некоторые обработки дополнительно регистрируются в конкретных разделах командного интерфейса.
Важное ограничение: чтобы обработка корректно зарегистрировалась, она должна содержать функцию СведенияОВнешнейОбработке() в модуле объекта. Если её нет, система выдаст сообщение, что файл не является дополнительной обработкой, — такой файл можно открывать только через «Файл → Открыть».
Запуск обработки из конфигуратора
Разработчики и администраторы часто запускают обработки прямо из конфигуратора — так удобнее отлаживать код. Откройте конфигуратор, выберите Файл → Открыть, укажите файл .epf. Обработка откроется в дереве как объект, и вы сможете посмотреть её модуль, формы и макеты.
Для выполнения нажмите Сервис → 1С:Предприятие (или клавишу F5 для отладки) — обработка запустится в отладочном сеансе. Это позволяет ставить точки останова и смотреть значения переменных. Способ безопасен для просмотра кода, но само выполнение обработки влияет на данные так же, как и обычный запуск.
Через конфигуратор также удобно проверить, что делает обработка, до её запуска в рабочей базе: откройте модуль объекта и формы, найдите процедуры записи данных (методы Записать(), Провести(), запросы с ИЗМЕНЕНИЕ в тексте запроса).
Запуск встроенных обработок и типовых сервисов
Многие задачи не требуют внешних файлов: нужный обработчик уже есть в конфигурации. Например, групповое изменение реквизитов в типовых решениях находится в разделе Администрирование → Обслуживание → Корректировка данных → Групповое изменение реквизитов. Загрузка данных из табличного документа, поиск и удаление дублей, удаление помеченных объектов — тоже штатные обработки раздела «Администрирование».
Если вы не находите нужный пункт в меню, воспользуйтесь поиском по командному интерфейсу (лупа в правом верхнем углу) или функцией «Все функции» (Shift + F11 в некоторых конфигурациях или через меню). В списке «Все функции» встроенные обработки отображаются в ветке «Обработки» и запускаются двойным щелчком.
Способы запуска обработки
Подходит для разового запуска любого файла .epf; не требует прав администратора, но обработку нужно открывать каждый раз вручную
Для регулярной работы всей команды; требует прав администратора и наличия СведенияОВнешнейОбработке в файле
Для разработчика: просмотр кода, отладка, проверка безопасности; требует права на запуск конфигуратора
Штатные сервисы конфигурации; самый безопасный вариант, если подходящая функция уже есть в программе
Решение типичных проблем при запуске
Частая ситуация — при открытии файла появляется ошибка «Ошибка формата потока» или «Файл не является внешней обработкой». Обычно это означает, что файл повреждён при скачивании, это не обработка (например, переименованный архив) или обработка создана в несовместимой версии платформы. Попробуйте скачать файл заново и проверить его размер.
Другая проблема — обработка открывается, но кнопки не работают или выдаётся ошибка «Метод объекта не обнаружен». Такое бывает, когда обработка писалась под конкретную конфигурацию (например, под «Управление торговлей»), а её запускают в «Бухгалтерии», где нет нужных объектов метаданных. Уточните, для какой конфигурации предназначен файл.
Если обработка запускается в файловой базе, но не работает в клиент-серверной, причина обычно в том, что код выполняется на клиенте и обращается к локальным файлам, которых нет на сервере. В этом случае нужна доработка обработки разработчиком.
Проверка результата после выполнения
После того как обработка отработала, не ограничивайтесь сообщением «Выполнено». Откройте несколько объектов, которые должны были измениться: документы, элементы справочников, регистры. Сравните значения с ожидаемыми. Если обработка загружала данные, проверьте количество созданных объектов и корректность ключевых полей — сумм, дат, контрагентов.
Если результат не соответствует ожиданиям, не запускайте обработку повторно «на всякий случай»: многие обработки при повторном запуске создают дубли. Сначала разберитесь, что именно было сделано, и при необходимости восстановите данные из копии.
Как проверить результат
Совпадает с количеством строк в исходном файле или задании
Объектов больше или меньше — возможны дубли или пропуски
Значения соответствуют исходным данным
Пустые поля, неверные даты, сбитые суммы
Обработка сообщает о дублях или корректно обновляет данные
При повторном запуске создаются новые копии тех же объектов
Частые вопросы
Чем открыть файл .epf, если 1С не установлена?
Никак — формат .epf является внутренним форматом платформы 1С, сторонние программы его не открывают. Нужна установленная платформа 1С:Предприятие подходящей версии и доступ к информационной базе.
Почему при открытии обработки появляется окно «Предупреждение безопасности»?
Платформа предупреждает, что файл может содержать потенциально опасный код. Если файл получен из надёжного источника (ваш разработчик, официальный дистрибутив), можно разрешить открытие. Если источник неизвестен — откажитесь и сначала проверьте код в конфигураторе на копии базы.
Можно ли запустить обработку по расписанию автоматически?
Да, если обработка зарегистрирована как дополнительная и поддерживает выполнение по расписанию — в карточке дополнительной обработки настраивается расписание регламентного задания. Произвольный файл .epf без регистрации по расписанию запустить штатно нельзя.
Обработка просит файл загрузки, но не видит его на диске. Что делать?
В клиент-серверном режиме обработка может искать файл на сервере, а не на вашем компьютере. Проверьте, есть ли в обработке кнопка выбора файла с клиента, или положите файл в сетевую папку, доступную серверу 1С.
Как отменить действия обработки, если она изменила данные ошибочно?
Штатной кнопки отката нет. Варианты: восстановить базу из резервной копии, сделанной до запуска, или написать (заказать) обратную обработку, отменяющую изменения. Поэтому резервная копия перед запуском — обязательное условие.
Что важно запомнить
Разовый запуск внешней обработки — через Файл → Открыть в режиме Предприятие, постоянное использование — через Дополнительные отчеты и обработки. Перед запуском всегда делайте резервную копию, а обработки из непроверенных источников сначала тестируйте на копии базы. После выполнения проверяйте результат по реальным данным.