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