Как добавить CFE-расширение в 1С через конфигуратор

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

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

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

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

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

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

Загрузка CFE через конфигуратор: пошагово

Основной сценарий выполняется в конфигураторе. Последовательность одинакова для большинства актуальных версий платформы 1С:Предприятие 8.3.

1. 1
   Откройте конфигуратор и авторизуйтесь под пользователем с правами администратора.
2. 2
   Перейдите в меню «Конфигурация → Расширения конфигурации».
3. 3
   В открывшемся окне нажмите кнопку «Добавить» — появится пустое расширение.
4. 4
   Выделите новое расширение и выберите «Конфигурация → Загрузить из файла…», укажите CFE-файл.
5. 5
   Задайте понятное имя и префикс расширения, при необходимости снимите флажки «Безопасный режим» и «Защита от опасных действий» только если доверяете источнику.
6. 6
   Нажмите F7 или «Конфигурация → Обновить конфигурацию базы данных» и подтвердите обновление.

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

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

Альтернатива: загрузка через режим «1С:Предприятие»

Если конфигурация построена на Библиотеке стандартных подсистем (это большинство типовых решений: «Управление торговлей», «Бухгалтерия предприятия», «Зарплата и управление персоналом»), расширение удобнее подключить без конфигуратора. Путь: «Администрирование → Печатные формы, отчеты и обработки → Расширения» либо «НСИ и администрирование → Расширения» — точное расположение зависит от конфигурации.

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

Сравнение вариантов

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

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

Через режим Предприятие

Быстрее и проще для типовых конфигураций на БСП. Меньше настроек, диагностика ошибок ограничена.

Проверка применимости и типичные ошибки

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

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

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

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

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

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

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

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

Норма

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

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

Сообщение об ошибках применения или снятый флажок

Работа в режиме Предприятие

Норма

Новые объекты и изменённые механизмы работают как заявлено

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

Объекты отсутствуют или выдают ошибки при открытии

Журнал регистрации

Норма

Нет ошибок, связанных с расширением

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

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

Ограничения и безопасность

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

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

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

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

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

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

Можно ли загрузить CFE без конфигуратора?

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

Почему расширение загружено, но не работает?

Проверьте три вещи: установлен ли флажок «Активно», выполнялось ли обновление конфигурации базы данных после загрузки, нет ли ошибок применимости в колонке состояния. Чаще всего причина в одном из этих пунктов.

Что будет с данными при удалении расширения?

Данные типовых объектов не пострадают. Но объекты, добавленные самим расширением (новые справочники, документы, регистры), удаляются вместе с ним, и накопленные в них данные теряются. Перед удалением выгрузите нужные сведения.

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

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