Внешние обработки, печатные формы и расширения в Управлении торговлей 11: подключение без доработки конфигурации
Содержание
Чтобы установить обработку в 1С УТ 11, включите флажок «Дополнительные отчеты и обработки» в НСИ и администрирование → Печатные формы, отчеты и обработки, затем перейдите по одноимённой ссылке и нажмите «Добавить из файла…». Выберите файл .epf (обработка) или .erf (отчёт), укажите разделы и пользователей, сохраните карточку. Файл расширения .cfe подключают в том же разделе по ссылке «Расширения».
Типичная ситуация: программист прислал загрузку прайса из Excel или новую печатную форму счёта, а менеджер не знает, куда её «вставить». В Управлении торговлей 11 конфигурацию снимать с поддержки для этого не нужно. Ниже — три рабочих способа, права, ошибки и порядок замены файла на новую версию.
Что прислали и какой способ установки выбрать
Сначала посмотрите на расширение файла. От него зависит способ подключения.
| Файл | Что это | Как подключать в УТ 11 |
|---|---|---|
.epf | внешняя обработка, в том числе печатная форма или заполнение табличной части | регистрация в справочнике дополнительных обработок или разовое открытие через меню «Файл» |
.erf | внешний отчёт | так же, как .epf, только вид в карточке будет «Отчет» или «Дополнительный отчет» |
.cfe | расширение конфигурации | ссылка «Расширения» в том же разделе администрирования |
.cf | полная конфигурация | это не обработка; такой файл загружают в Конфигураторе, к теме он не относится |
Внутри .epf бывает два типа обработок:
- ✅ Под регистрацию. Обработку писали под Библиотеку стандартных подсистем (БСП), в её модуле есть функция
СведенияОВнешнейОбработке(). Такие файлы встают в справочник, появляются в нужном разделе или на кнопке «Печать». - ⚠️ Без регистрации. Обычная обработка «для одного раза». Её можно только открыть через меню «Файл». При попытке добавить в справочник программа сообщит, что обработка не поддерживает подключение к подсистеме дополнительных отчетов и обработок.
Если не знаете, какой у вас вариант, спросите автора. Или просто попробуйте добавить файл в справочник: ничего не сломается, программа сама откажет.
Что проверить до установки
- 🔒 Пользователь, под которым вы работаете, входит в группу доступа «Администраторы» или имеет право добавлять дополнительные обработки.
- 🧩 Обработка написана под Управление торговлей 11 и под вашу редакцию (11.4 или 11.5). Печатная форма от Бухгалтерии 3.0 в УТ не заработает: у документов другие реквизиты.
- 🖥️ Версия платформы у вас не ниже той, в которой сохраняли файл. Номер платформы виден в
меню ☰ → Справка → О программе. - 🛡️ Источник файла известен. Внешняя обработка выполняет произвольный код с правами пользователя. Файл «из интернета» сначала откройте в тестовой копии базы.
Способ 1. Регистрация обработки в справочнике дополнительных обработок
Это основной способ установки обработки в 1С УТ 11. Обработка хранится внутри базы, доступна всем нужным пользователям и не теряется при обновлении конфигурации.
Шаг 1. Включите механизм дополнительных обработок
- Откройте раздел
НСИ и администрирование. - В группе «Администрирование» перейдите по ссылке
Печатные формы, отчеты и обработки. - Установите флажок «Дополнительные отчеты и обработки».
После этого рядом с флажком станет активна одноимённая ссылка. Флажок включается один раз на всю базу.
Шаг 2. Добавьте файл
- Перейдите по ссылке «Дополнительные отчеты и обработки». Откроется список.
- Нажмите «Добавить из файла…».
- Программа покажет предупреждение безопасности: подключать стоит только файлы из надёжных источников. Нажмите «Продолжить».
- Выберите
.epfили.erfна диске.
Карточка заполнится сама: наименование, вид, версия и список команд берутся из модуля обработки.
Шаг 3. Настройте карточку
Ключевые поля карточки:
| Поле | Что выбрать |
|---|---|
| Вид | заполняется автоматически: «Дополнительная обработка», «Печатная форма», «Заполнение объекта», «Создание связанных объектов», «Дополнительный отчет» и т. д. |
| Публикация | «Используется» — рабочий режим; «Режим отладки» — видна только администраторам; «Отключена» — скрыта у всех |
| Размещение | для обработок и отчётов — разделы, где появится команда (например, «Продажи», «Закупки», «Склад и доставка») |
| Назначение | для печатных форм и заполнения — документы или справочники, к которым они привязаны; список задан автором |
| Команды | список действий обработки; в колонке «Быстрый доступ» укажите пользователей, у которых команда будет под рукой |
Нажмите «Записать и закрыть».
Шаг 4. Найдите обработку в программе
Где искать результат, зависит от вида:
- 📂 Дополнительная обработка — в разделе, выбранном в «Размещении», на панели навигации появляется ссылка «Дополнительные обработки». Внутри — ваша команда.
- 📊 Дополнительный отчет — там же, по ссылке «Дополнительные отчеты».
- 🖨️ Печатная форма — в форме документа и в его списке, под кнопкой «Печать».
- ✏️ Заполнение объекта — в форме документа, кнопка «Заполнить» или меню команд объекта.
Если пункт «Дополнительные обработки» не виден в разделе, откройте настройки панели навигации раздела (шестерёнка или меню «Ещё» → «Настройка навигации») и перенесите ссылку в видимые команды.
Способ 2. Подключение расширения конфигурации
Расширение (.cfe) меняет поведение самой конфигурации: добавляет реквизиты, правит формы, перехватывает процедуры. Механизм появился в платформе 8.3.6, а в УТ 11 его можно подключить прямо из пользовательского режима.
- Откройте
НСИ и администрирование → Печатные формы, отчеты и обработки. - Перейдите по ссылке «Расширения».
- Нажмите «Добавить из файла…» и выберите
.cfe. - Проверьте флажки в строке расширения: «Активно» должно быть включено. Флажок «Безопасный режим» оставьте, если автор не сказал обратное.
- Перезапустите программу. Расширение начинает работать только в новом сеансе.
Если расширение добавляет свои реквизиты или справочники, при подключении меняется структура данных. В клиент-серверной базе это делайте после окончания рабочего дня и после резервной копии: у пользователей, которые работают в программе, поведение изменится только после перезапуска, а при конфликте база потребует обновления конфигурации.
Когда без Конфигуратора не обойтись
- 🛠️ Расширение требует отключить безопасный режим, а у вас ограничены права в пользовательском режиме.
- 🛠️ Нужно поменять порядок применения нескольких расширений.
- 🛠️ Расширение отказывается применяться и пишет, что не совпадает с конфигурацией: тогда автор должен адаптировать его под ваш релиз.
В Конфигураторе расширения подключают через Конфигурация → Расширения конфигурации. Загрузка файла и обновление конфигурации
базы данных — два отдельных шага, второй нельзя пропускать.
Способ 3. Разовый запуск обработки без установки
Если обработка нужна один раз (поправить данные, выгрузить список), регистрировать её незачем.
- Откройте главное меню программы (значок
☰в левом верхнем углу). - Выберите
Файл → Открыть…. - Укажите файл
.epfили.erf. - Подтвердите предупреждение безопасности.
Обработка откроется в отдельном окне. После закрытия программы она нигде не сохранится.
У этого способа есть ограничения:
- ❌ Обычному пользователю меню «Файл → Открыть» для внешних обработок недоступно, нужна отдельная роль.
- ❌ Печатная форма так не встанет на кнопку «Печать».
- ❌ В веб-клиенте и тонком клиенте через интернет файл сначала загружается на сервер, и часть обработок, рассчитанных на работу с локальными файлами, может не отработать.
Сравнение способов
| Способ | Когда подходит | Риски |
|---|---|---|
| Справочник дополнительных обработок | регулярная работа, печатные формы, несколько пользователей | почти нет: при сбое обработку можно отключить флагом публикации |
Расширение .cfe | нужна доработка форм, реквизитов, логики документов | при обновлении УТ расширение может перестать применяться |
Файл → Открыть | разовая задача администратора | нет контроля, кто и что запускал |
Права доступа для дополнительных обработок
Администратор видит всё. Остальным пользователям доступ даётся двумя уровнями.
Кто может устанавливать обработки
Добавлять и менять карточки в справочнике может пользователь, у которого есть право на добавление и изменение дополнительных отчетов и обработок. В типовой УТ 11 оно входит в профиль «Администратор». Отдельному сотруднику (например, ведущему менеджеру) лучше не выдавать его: через новую обработку можно выполнить любой код.
Кто может запускать установленную обработку
- Откройте
НСИ и администрирование → Настройки пользователей и прав → Группы доступа. - Найдите группу, в которую входят нужные сотрудники.
- Проверьте, что её профиль даёт право пользоваться дополнительными отчетами и обработками.
- В карточке самой обработки, в табличной части «Команды», отметьте пользователей в колонке «Быстрый доступ», если команда должна сразу появиться у них в разделе.
Для запуска чужих .epf через Файл → Открыть в профиль добавляют роль «Интерактивное открытие внешних отчетов и обработок». Типовой профиль менять не стоит: скопируйте его, добавьте роль в копию и назначьте копию группе доступа.
Если права настроены верно, а команда не видна, проверьте «Публикацию». В режиме «Режим отладки» обработку видят только администраторы.
Защита от опасных действий
Начиная с платформы 8.3.9 у пользователя есть флажок «Защита от опасных действий». Пока он включён, при открытии внешнего файла платформа каждый раз показывает предупреждение. Флажок находится в карточке пользователя в Конфигураторе (Администрирование → Пользователи). Снимать его стоит только опытным сотрудникам, которые сами отвечают за запускаемые файлы.
Ошибки при установке обработки и их решение
Если не помогло
- 🧪 Подключите тот же файл в свежей копии базы. Работает там — проблема в правах или настройках вашей базы.
- 📝 Откройте журнал регистрации:
НСИ и администрирование → Обслуживание → Журнал регистрации, отбор по пользователю и времени. Полный текст ошибки там подробнее, чем во всплывающем окне. - 📨 Отправьте автору файла: номер релиза УТ (из окна «О программе»), номер платформы и полный текст ошибки. Без этих трёх данных разработчик не сможет воспроизвести сбой.
Обновление и сопровождение установленных обработок
Новую версию обработки не нужно добавлять второй карточкой. Иначе в разделе появятся две одинаковые команды, а печатная форма задвоится на кнопке «Печать».
Как заменить файл на новую версию
- Откройте список
НСИ и администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки. - Откройте карточку нужной обработки.
- В командной панели карточки найдите команду загрузки из файла и выберите новый
.epf. - Проверьте поле «Версия»: номер должен смениться.
- Нажмите «Записать и закрыть».
Настройки размещения и пользователей при такой замене сохраняются.
Перед заменой выгрузите текущую версию в файл командой выгрузки из той же карточки. Если новая версия окажется с ошибкой, откатитесь за минуту.
Что делать после обновления УТ 11
Обновление конфигурации не удаляет обработки из справочника и расширения из списка. Но после перехода на новый релиз:
- 🔄 Расширения проверяют первыми. Если расширение перехватывает изменённую процедуру, оно перестанет применяться, и программа сообщит об этом при запуске.
- 🔄 Печатные формы проверяют на одном-двух документах: в новом релизе могут переименовать реквизит.
- 🔄 Обработки загрузки проверяют на тестовом файле, а не сразу на рабочем прайсе.
Удобно держать короткий список: какие обработки установлены, кто автор, где лежит исходный файл. При смене подрядчика этот список экономит много часов.
Как отключить или удалить обработку
Отключение безопаснее удаления. Установите «Публикация» = «Отключена»: команда исчезнет у всех, а карточка останется. Удалять стоит только то, что точно не понадобится. Для этого карточку помечают на удаление, а окончательно удаляют через НСИ и администрирование → Обслуживание → Удаление помеченных объектов.
Расширение отключают снятием флажка «Активно» в списке расширений, затем перезапускают программу. Если расширение добавляло реквизиты и в них уже есть данные, при удалении расширения эти данные будут потеряны.