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