Автоматизация · 8 мин
Как загрузить внешнюю обработку в 1С:Управление торговлей
Как подключить и загрузить внешнюю обработку (epf) в 1С:Управление торговлей: через меню Файл, справочник дополнительных отчетов и обработок, проверка безопасности.
Внешние обработки (файлы с расширением .epf) позволяют расширить функциональность 1С:Управление торговлей без изменения конфигурации: загрузить прайсы поставщиков, выгрузить данные, заполнить табличную часть документа или выполнить групповое изменение реквизитов. Подключить такой файл можно двумя способами: разово открыть через меню «Файл» или зарегистрировать в справочнике дополнительных отчетов и обработок, чтобы обработка была доступна всем пользователям постоянно.
Выбор способа зависит от задачи. Для одноразовых операций достаточно простого открытия файла. Если обработкой будут пользоваться регулярно или она должна появиться в интерфейсе документов и справочников, её нужно зарегистрировать через механизм БСП (Библиотека стандартных подсистем), который встроен в УТ 11.
Перед подключением любого файла из внешнего источника убедитесь, что он получен из доверенного места. Внешняя обработка выполняет код с правами текущего пользователя и может изменить данные информационной базы.
Что такое внешняя обработка и когда она нужна
Внешняя обработка — это файл формата .epf, который содержит программный код и формы, но не входит в состав конфигурации. Он запускается поверх существующей базы и работает с её данными: справочниками, документами, регистрами.
Типовые сценарии использования в УТ: загрузка номенклатуры и цен из Excel, обмен данными с поставщиками, групповая установка скидок, конвертация данных при переходе с других программ, печатные формы, не входящие в типовую поставку.
Отличие внешней обработки от расширения конфигурации: обработка не меняет структуру метаданных и не требует монопольного доступа, но и не может добавлять новые объекты в базу. Для простых пользовательских задач это самый безопасный способ доработки.
Способ 1: разовое открытие через меню «Файл»
Это самый быстрый способ, подходящий для проверки обработки или одноразового запуска. Файл никуда не сохраняется в базе — после закрытия сеанса его придётся открывать заново.
- 1Откройте 1С:Управление торговлей под пользователем с достаточными правами
- 2В главном меню выберите «Файл → Открыть» (или сочетание Ctrl+O)
- 3Укажите путь к файлу с расширением .epf и нажмите «Открыть»
- 4Если появится предупреждение о безопасности, подтвердите запуск только для доверенного файла
- 5Выполните нужные действия в открывшейся форме обработки
Если вместо формы обработки появляется сообщение об ошибке компиляции, файл, скорее всего, написан под другую версию платформы или режим совместимости. В этом случае понадобится доработка кода разработчиком.
Учтите: в веб-клиенте и при работе через тонкий клиент с ограничениями безопасности открытие произвольных файлов может быть запрещено администратором. Тогда используйте второй способ.
Способ 2: регистрация в дополнительных отчетах и обработках
Механизм дополнительных отчетов и обработок из состава БСП позволяет хранить файл прямо в базе, назначать права доступа, размещать команды обработки в разделах программы и даже настраивать выполнение по расписанию.
Сначала включите саму возможность. Перейдите в раздел «НСИ и администрирование → Печатные формы, отчеты и обработки» и установите флажок «Дополнительные отчеты и обработки». После этого появится ссылка на одноимённый справочник.
Откройте справочник «Дополнительные отчеты и обработки» и нажмите «Создать». В форме элемента нажмите кнопку загрузки из файла, выберите .epf-файл. Программа попытается прочитать сведения из самой обработки: название, версию, вид, безопасный режим.
После загрузки проверьте и при необходимости скорректируйте поля: наименование, вид обработки, размещение (в каких разделах интерфейса появится команда), быстрый доступ (каким пользователям доступна). Затем нажмите «Записать и закрыть».
Виды дополнительных обработок и их размещение
От вида обработки зависит, где она появится в интерфейсе УТ. При регистрации вид определяется автоматически из сведений файла, но его можно изменить вручную.
| Вид обработки | Где появляется | Типовое применение |
|---|---|---|
| Дополнительная обработка | Разделы программы, пункт «Дополнительные обработки» | Загрузка данных, сервисные операции |
| Заполнение объекта | Кнопка «Заполнить» в формах документов и справочников | Заполнение табличных частей |
| Создание связанных объектов | Кнопка «Создать на основании» | Ввод документов на основании |
| Печатная форма | Кнопка «Печать» в документах | Нетиповые печатные формы |
| Дополнительный отчет | Разделы программы, пункт «Дополнительные отчеты» | Собственные отчеты на СКД |
Для видов, привязанных к объектам (заполнение, печать, создание на основании), обязательно укажите перечень назначений — типы документов и справочников, для которых команда будет доступна. Если назначение не задано, кнопка в формах не появится.
Безопасный режим и профили безопасности
По умолчанию дополнительные обработки выполняются в безопасном режиме: им запрещены операции с файловой системой сервера, COM-объектами и внешними компонентами. Для большинства пользовательских задач этого достаточно, и снимать безопасный режим не нужно.
Если обработка требует доступа к файлам или внешним ресурсам, при регистрации появится запрос разрешений. Выдавайте их осознанно: каждое разрешение расширяет возможности кода, который выполняется с данными вашей базы.
Проверка результата и типичные ошибки
После регистрации откройте раздел, в котором размещена обработка, и убедитесь, что команда появилась и запускается без ошибок. Для обработок заполнения проверьте работу на тестовом документе, не проводя его.
Если обработка выдаёт ошибку при выполнении, текст ошибки обычно указывает причину: отсутствие объекта метаданных (обработка писалась под другую конфигурацию), недоступность операции в безопасном режиме или устаревшую версию платформы.
Обновление и удаление подключенной обработки
Чтобы обновить обработку до новой версии, откройте её элемент в справочнике дополнительных отчетов и обработок и снова загрузите файл — старая версия заменится новой, настройки размещения и прав сохранятся. Поле «Версия» помогает отслеживать, какая редакция загружена.
Удаление выполняется стандартной пометкой на удаление элемента справочника. Данные, которые обработка уже записала в базу, при этом не удаляются — удаляется только сам файл и его команды из интерфейса.
Что важно запомнить
Разовый запуск — через «Файл → Открыть», постоянная работа — через справочник дополнительных отчетов и обработок с включенной опцией в настройках. Проверяйте источник файла, не отключайте безопасный режим без необходимости и тестируйте новые обработки на копии базы.
Частые вопросы
Чем отличается файл .epf от .erf?
.epf — это внешняя обработка, предназначенная для выполнения действий (заполнение, загрузка, изменение данных). .erf — внешний отчет, предназначенный для вывода информации. При регистрации в справочнике для .erf выбирается вид «Дополнительный отчет», для .epf — один из видов обработок.
Почему кнопка обработки не появилась в документе?
Наиболее частые причины: не заполнен список назначений (типов объектов) в карточке обработки, у пользователя нет права на использование дополнительных обработок, либо выбран неверный вид обработки. Проверьте эти три пункта в карточке элемента справочника.
Можно ли запускать обработку автоматически по расписанию?
Да, если обработка поддерживает выполнение в фоновом режиме: в карточке дополнительной обработки для команды можно настроить расписание регламентного задания. Обработка должна корректно работать без интерактивных действий пользователя.
Обработка от УТ 10.3 подойдёт для УТ 11?
Как правило, нет. УТ 10.3 работает в режиме обычного приложения, а УТ 11 — управляемого, у них разные модели форм и состав метаданных. Обработку потребуется переписать или найти версию, адаптированную под УТ 11.
Безопасно ли снимать безопасный режим?
Только если вы доверяете источнику обработки и понимаете, какие операции она выполняет. Безопасный режим ограничивает доступ кода к файловой системе и внешним компонентам; его отключение снимает эту защиту. При сомнениях протестируйте обработку на копии базы.