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