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

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

Установка расширения занимает несколько минут, но требует понимания того, откуда взят файл, совместим ли он с вашей версией конфигурации и какие права есть у пользователя. Ошибки на этих этапах — главная причина того, что расширение «не видно» в программе или база перестаёт запускаться.

Ниже разобран полный цикл: подготовка, подключение файла .cfe, настройка безопасного режима, проверка работы, обновление и удаление. Инструкция подходит для типовых конфигураций на управляемых формах — «1С:Бухгалтерия», «1С:Управление торговлей», «1С:Зарплата и управление персоналом» и других на платформе 8.3.

Что такое расширение и когда его стоит использовать

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

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

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

Подготовка: что проверить до установки

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

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

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

Установка расширения через интерфейс программы

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

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

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

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

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

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

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

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

Установка через конфигуратор и командную строку

Альтернативный способ — конфигуратор. Откройте базу в конфигураторе, перейдите в меню «Конфигурация» → «Расширения конфигурации», в окне списка выберите «Добавить» и загрузите файл .cfe. После сохранения (F7 или «Обновить конфигурацию базы данных») расширение станет активным. Этот способ удобен разработчикам и позволяет сразу увидеть состав расширения и возможные конфликты.

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

Способы установки

Через интерфейс программы

Подходит большинству пользователей; не требует конфигуратора и монопольного доступа, но меньше контроля над конфликтами

Через конфигуратор

Для разработчиков и администраторов; видно состав расширения и ошибки применения, но нужен монопольный доступ для обновления

Пакетный режим командной строки

Для массового развёртывания и автоматизации; требует навыков администрирования и тестирования скриптов

Проверка результата и типичные ошибки

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

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

Обновление и удаление расширения

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

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

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

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

Статус в списке расширений

Норма

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

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

Сообщение об ошибке применения или конфликте с конфигурацией

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

Норма

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

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

Кнопки нет, либо при вызове возникает ошибка

Работа других пользователей

Норма

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

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

У части пользователей функции отсутствуют — они не перезапустили сеанс или нет прав

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

Расширение добавлено, но изменений в программе нет. Что делать?

Сначала полностью закройте и заново откройте программу — расширения применяются только при старте сеанса. Если не помогло, проверьте в списке расширений, стоит ли флажок «Используется» и нет ли сообщений об ошибках применения. Также убедитесь, что у вашего пользователя есть права на объекты, добавленные расширением.

Можно ли установить расширение в базовую версию конфигурации?

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

Что произойдёт с расширением при обновлении конфигурации?

Расширение сохранится и останется подключённым. Однако если в новом релизе поставщик изменил объекты, которые задействует расширение, оно может перестать применяться — в списке появится ошибка. В этом случае запросите у разработчика обновлённую версию расширения.

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

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

Опасно ли снимать флажок «Безопасный режим»?

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

Как удалить расширение, если база из-за него не запускается?

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