Как запустить обработку в 1С:Документооборот

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

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

Что понадобится перед запуском

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

Минимальные права: у пользователя должно быть право «Интерактивное открытие внешних обработок» (для запуска через «Файл → Открыть») или право на добавление элементов справочника «Дополнительные отчеты и обработки» (для подключения). В типовой поставке первым правом обычно обладают администраторы и разработчики, вторым — администраторы. Если нужной роли нет, запросите её у администратора базы.

Способ 1: разовый запуск через «Файл → Открыть»

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

Если обработка написана под управляемые формы (обычный случай для Документооборота 2.x и 8.x), она откроется сразу. Обработка под обычные формы в тонком клиенте не запустится — потребуется толстый клиент либо адаптация кода. Далее заполните параметры на форме обработки (период, вид документов, организацию) и нажмите основную команду — «Выполнить», «Сформировать» или аналогичную.

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

Способ 2: подключение как дополнительной обработки

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

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

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

Безопасный режим и профили безопасности

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

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

Запуск обработки по расписанию

Если обработка должна выполняться автоматически — например, ночная свертка или рассылка — её можно связать с регламентным заданием. В карточке дополнительной обработки вида, поддерживающего выполнение по расписанию, настройте расписание на закладке соответствующей команды. Задание выполнится под служебным пользователем, указанным в настройках регламентных заданий.

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

Сравнение способов запуска

Файл → Открыть

Подходит для разовых задач и тестирования. Не требует настройки, но доступен только пользователям с правом интерактивного открытия.

Дополнительные обработки

Для постоянной работы пользователей: размещение в разделах, права, расписание. Требует функции СведенияОВнешнейОбработке в коде.

Регламентное задание

Для автоматического выполнения по расписанию. Требует настройки прав служебного пользователя и контроля журнала регистрации.

Проверка результата и типичные ошибки

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

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

Контрольные точки

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

Форма обработки открылась

Норма

Форма отображается, параметры доступны для заполнения

Тревожный признак

Ошибка при открытии или сообщение о несовместимости режима

Выполнение завершено

Норма

Сообщение об успешном завершении, данные изменились как ожидалось

Тревожный признак

Ошибка в сообщениях, часть объектов не обработана

Команда в разделе

Норма

Обработка видна в меню «Дополнительные обработки» нужного раздела

Тревожный признак

Команды нет — проверьте размещение и быстрый доступ в карточке

Часто задаваемые вопросы

Где взять epf-файл, если его нет?

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

Почему обработка не загружается в справочник дополнительных обработок?

Наиболее вероятная причина — в модуле обработки нет экспортной функции СведенияОВнешнейОбработке, которая описывает вид, версию и команды. Такой файл можно открыть только через «Файл → Открыть» либо нужно попросить разработчика добавить описание по стандарту БСП.

Можно ли запустить обработку, если нет прав администратора?

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

Обработка требует доступ к папке на диске, но выдаёт ошибку. Что делать?

Скорее всего, она выполняется в безопасном режиме или на сервере, где путь недоступен. Проверьте, где исполняется код (клиент/сервер), укажите сетевой путь, доступный с сервера, и при необходимости настройте профиль безопасности вместо полного отключения безопасного режима.

Как отменить изменения, если обработка отработала неправильно?

Штатной кнопки «откатить» нет. Варианты: восстановление из резервной копии (поэтому её делают до запуска), обратная обработка от разработчика или ручное исправление по журналу регистрации, где видно, какие объекты изменялись.

Можно ли запускать одну обработку нескольким пользователям одновременно?

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