Как загрузить обработку в 1С

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

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

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

Что проверить перед загрузкой обработки

Сначала убедитесь, что файл подходит вашей конфигурации. Обработки бывают двух видов: для обычного приложения (старые версии 1С:Предприятие 8.2 и ранее) и для управляемого приложения (современные конфигурации на платформе 8.3). Файл, написанный под обычные формы, в управляемом интерфейсе либо не откроется, либо откроется без формы и выполнить нужные действия будет невозможно.

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

Третий момент — источник файла. Безопаснее всего брать обработки с официального портала 1С, из поставки самой конфигурации (каталог ExtFiles шаблона) или от франчайзи-разработчика, с которым у вас есть договор. Файлы с форумов и файлообменников требуют проверки антивирусом и, в идеале, просмотра кода в конфигураторе.

Как открыть обработку разово через меню «Файл»

Самый быстрый способ — открыть файл напрямую в режиме «Предприятие». Запустите программу, войдите в нужную базу под пользователем с достаточными правами (обычно требуются полные права или права администратора). Затем нажмите кнопку меню в левом верхнем углу, выберите «Файл» → «Открыть» или используйте сочетание клавиш Ctrl+O.

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

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

1. 1
   Войдите в базу в режиме «Предприятие» под пользователем с достаточными правами
2. 2
   Нажмите Ctrl+O или выберите Файл → Открыть
3. 3
   Укажите файл обработки с расширением .epf
4. 4
   Проверьте, что форма открылась и команды выполняются без ошибок
5. 5
   После работы закройте обработку — в базе она не сохраняется

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

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

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

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

Если обработка не регистрируется

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

Как загрузить обработку через конфигуратор

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

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

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

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

Как проверить, что обработка загрузилась и работает

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

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

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

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

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

Открытие файла

Норма

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

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

Сообщение «Ошибка при вызове метода» или пустое окно

Регистрация в базе

Норма

Обработка есть в списке и доступна в выбранных разделах

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

Элемент создан, но команда не появляется в разделе

Работа с данными

Норма

Тестовые объекты изменены корректно

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

Записались неверные значения или появились дубли

Типичные ошибки и их причины

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

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

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

FAQ

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

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

Чем отличается файл .epf от .erf?

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

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

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

Как удалить подключенную обработку из базы?

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

Почему после обновления конфигурации обработка перестала работать?

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