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