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