Как запустить дополнительные процедуры обработки данных в 1С

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

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

Главный риск при работе с внешними обработками — необратимое изменение данных. Обработка, которая групповым образом перезаписывает реквизиты или удаляет документы, не спрашивает подтверждения «как в Excel»: отменить её действие можно только восстановлением из резервной копии. Поэтому перед первым запуском любой новой обработки обязательно делайте копию базы или тестируйте её на копии.

Что такое дополнительные отчёты и обработки и когда они нужны

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

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

Включение механизма дополнительных отчётов и обработок

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

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

1. 1
   Откройте «Администрирование» — «Печатные формы, отчеты и обработки» и включите флаг «Дополнительные отчеты и обработки».
2. 2
   Перейдите в справочник «Дополнительные отчеты и обработки» и нажмите «Добавить из файла».
3. 3
   Выберите файл .epf или .erf и подтвердите загрузку.
4. 4
   Проверьте автоматически заполненные сведения: имя, версию, тип обработки, безопасный режим.
5. 5
   Настройте размещение — разделы программы, в которых обработка будет видна пользователям.
6. 6
   Нажмите «Записать и закрыть», затем откройте обработку из списка и выполните тестовый запуск на копии базы.

Разовый запуск внешней обработки без подключения

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

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

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

Регистрация в справочнике — правильный способ для обработок, которыми пользуются регулярно. При добавлении файла система считывает сведения из модуля обработки: наименование, версию, вид, команды. Если обработка написана по стандарту БСП, всё заполнится автоматически; если это «самописная» обработка без функции СведенияОВнешнейОбработке, система всё равно позволит её добавить, но как произвольную.

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

Обратите внимание на флаг «Безопасный режим» в карточке обработки. В безопасном режиме код обработки выполняется с ограничениями: запрещены операции с файловой системой, COM-объектами и некоторыми другими возможностями. Для обработок, которые только читают данные и строят отчёты, безопасный режим подходит; для обработок загрузки из файлов его придётся отключить — и это ещё один аргумент в пользу предварительной проверки на копии.

Автоматический запуск по расписанию

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

В карточке дополнительной обработки откройте вкладку «Расписание» (или одноимённую команду) и задайте периодичность: ежедневно, по дням недели, в конкретное время. В файловой базе фоновые задания выполняются только пока запущен сеанс с включённым выполнением регламентных заданий; в клиент-серверном варианте их выполняет сервер 1С независимо от пользователей.

Способы запуска обработки

Открытие файла вручную

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

Справочник дополнительных обработок

Основной способ для регулярной работы пользователей. Централизованные права, размещение по разделам, контроль версий. Требует включённой подсистемы.

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

Для автоматического выполнения по расписанию. Требует серверной команды в обработке и работающего механизма фоновых заданий.

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

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

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

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

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

Обработка появилась в разделе

Норма

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

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

Обработки нет в списке — проверьте настройку размещения в её карточке

Данные после выполнения

Норма

Изменены только целевые объекты, значения корректны

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

Затронуты лишние документы или значения пустые — восстановите копию и разберитесь с настройками

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

Норма

В журнале регистрации событие выполнено без ошибок

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

Ошибка выполнения — смотрите текст в журнале регистрации

Типичные ошибки и ограничения

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

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

Ограничения и границы самостоятельной работы

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

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

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

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

Чаще всего не включён механизм: проверьте флаг «Дополнительные отчеты и обработки» в разделе «Администрирование» — «Печатные формы, отчеты и обработки». Если флаг включён, проверьте размещение конкретной обработки в её карточке и права пользователя на соответствующий раздел.

Можно ли запустить обработку в файловой базе по расписанию?

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

Что делать, если обработка выдаёт ошибку «Поле объекта не обнаружено»?

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

Безопасно ли отключать безопасный режим у обработки?

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

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

Штатной кнопки «отменить» для внешних обработок нет. Единственный надёжный способ — восстановить базу из резервной копии, сделанной до запуска. Если копии нет, данные придётся исправлять вручную или другой обработкой, что существенно сложнее. Именно поэтому резервная копия перед массовыми операциями обязательна.