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