К статье
Практический материал

Администрирование · 9 мин

Как установить расширение в 1С УТ 11

Пошаговая инструкция по подключению расширения в 1С Управление торговлей 11: подготовка файла CFE, установка, проверка, отключение и типичные ошибки.

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

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

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

Что нужно подготовить перед установкой

Расширение распространяется в виде файла с расширением .cfe. Такой файл создаётся в конфигураторе через пункт «Конфигурация → Расширения конфигурации → Сохранить в файл» или поставляется разработчиком доработки. Если у вас на руках только внешняя обработка (.epf) или отчёт (.erf), это не расширение — они подключаются через другой механизм, «Дополнительные отчеты и обработки».

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

Где находится управление расширениями в УТ 11

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

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

Пошаговая установка файла расширения

Процедура установки одинакова для файлового и клиент-серверного варианта работы. Выполняйте действия под учётной записью с полными правами.

Порядок действий
  1. 1
    Откройте «НСИ и администрирование» → «Печатные формы, отчеты и обработки» → «Расширения».
  2. 2
    Нажмите кнопку «Добавить из файла» и выберите файл с расширением .cfe.
  3. 3
    Дождитесь загрузки: расширение появится в списке. При необходимости снимите флажок «Безопасный режим», если доработке требуется доступ к файловой системе или внешним компонентам.
  4. 4
    Перезапустите программу (завершите сеанс и войдите снова) — без этого расширение не применится.
  5. 5
    Проверьте работу добавленной функциональности на тестовом документе или отчёте.

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

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

Безопасный режим и профили безопасности

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

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

Маршрут решения

Как выбрать действие

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

Проверка результата после установки

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

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

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

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

Статус расширения в списке
Норма

Флажок использования установлен, ошибок в колонке состояния нет

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

Расширение отключено или помечено как несовместимое

Новая функциональность
Норма

Кнопка, печатная форма или отчёт доступны и работают

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

Элемент отсутствует или вызывает ошибку при открытии

Типовые операции
Норма

Документы проводятся, отчёты формируются без ошибок

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

После установки появились ошибки в ранее работавших механизмах

Как отключить или удалить расширение

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

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

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

Типичные ошибки
01
Установка без перезапуска сеанса — пользователь не видит результат и считает, что расширение не работает. Решение: всегда перезапускайте программу после добавления.
02
Попытка подключить внешнюю обработку .epf как расширение — файл не загружается. Решение: используйте механизм «Дополнительные отчеты и обработки».
03
Игнорирование несовместимости версий — после обновления УТ расширение отключается или вызывает ошибки. Решение: перед обновлением конфигурации проверяйте совместимость всех установленных расширений.
04
Снятие защиты от опасных действий для файлов из непроверенных источников — риск выполнения вредоносного кода с правами пользователя базы.
05
Установка сразу в рабочую базу без тестирования — конфликт доработки с типовым кодом обнаруживается уже на реальных данных.

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

Итог

Что важно запомнить

Установка расширения в УТ 11 выполняется через «НСИ и администрирование» → «Печатные формы, отчеты и обработки» → «Расширения» и требует перезапуска сеанса. Перед установкой проверьте совместимость с версией конфигурации, сделайте резервную копию и сначала протестируйте доработку на копии базы.

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

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

Нет. Добавление, изменение и удаление расширений доступно только пользователям с правами администратора (роль «Администратор системы» / полные права). Обычный пользователь может лишь работать с уже установленной функциональностью.

Чем расширение отличается от внешней обработки?

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

Пропадёт ли расширение при обновлении УТ 11?

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

Почему расширение не применяется после установки?

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

Снимает ли расширение конфигурацию с поддержки?

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

Можно ли установить несколько расширений одновременно?

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