Как добавить расширение из файла в 1С

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

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

Что понадобится перед загрузкой расширения

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

Обязательно сделайте резервную копию. Для файловой базы достаточно скопировать файл 1Cv8.1CD в отдельную папку, для клиент-серверной — выполнить выгрузку через конфигуратор (Администрирование → Выгрузить информационную базу) или средствами СУБД. Расширение изменяет поведение прикладного решения, и если оно содержит ошибки, откат без копии будет затруднён.

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

Способ 1: загрузка через конфигуратор

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

В окне расширений нажмите кнопку Добавить из файла (в некоторых версиях платформы — пункт меню или кнопка с аналогичным названием) и укажите путь к файлу .cfe. Платформа загрузит расширение и покажет его в списке. После этого необходимо обновить конфигурацию базы данных: нажмите F7 или выберите Конфигурация → Обновить конфигурацию базы данных. Только после этого расширение начнёт действовать.

1. 1
   Сделайте резервную копию базы
2. 2
   Откройте базу в конфигураторе с монопольным доступом
3. 3
   Перейдите: Конфигурация → Расширения конфигурации
4. 4
   Нажмите «Добавить из файла» и выберите файл .cfe
5. 5
   Убедитесь, что расширение появилось в списке и активно
6. 6
   Обновите конфигурацию базы данных (F7)
7. 7
   Запустите режим предприятия и проверьте работу доработки

Если кнопка добавления недоступна

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

Способ 2: загрузка в режиме 1С:Предприятие

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

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

Проверка результата после подключения

Подключённое расширение должно отображаться в списке расширений как активное и не иметь признаков ошибок применения. В конфигураторе об этом сигнализирует отсутствие предупреждений в окне расширений; в режиме предприятия — статус подключения и отсутствие сообщений об ошибках при запуске сеанса.

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

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

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

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

Норма

Расширение активно, ошибок применения нет

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

Расширение отключено или помечено как неприменённое

Запуск сеанса предприятия

Норма

База открывается без сообщений об ошибках расширений

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

При старте появляются ошибки контроля применимости

Работа доработанного объекта

Норма

Новая функциональность работает на тестовых данных

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

Форма не открывается, кнопки или реквизиты отсутствуют

Типичные ошибки и как их исправить

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

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

Как отключить или удалить расширение

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

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

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

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

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

Чем файл CFE отличается от файла CF?

Файл CF содержит полную конфигурацию целиком, а CFE — только расширение: набор изменений, накладываемых поверх основной конфигурации. Загружать CF вместо обновления на рабочую базу нельзя — это заменит всю конфигурацию и может привести к потере доработок.

Почему после обновления типовой конфигурации расширение перестало работать?

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

Нужен ли монопольный доступ для загрузки расширения?

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

Безопасно ли подключать расширения из интернета?

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