Как установить расширение в 1С 8.3 в формате CFE

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

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

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

Что такое расширение CFE и когда его применяют

Файл .cfe — это сохранённое расширение конфигурации. Внутри него находятся объекты метаданных: новые справочники, документы, отчёты, обработки, роли, а также заимствованные из основной конфигурации объекты с изменениями (добавленные реквизиты, переопределённые обработчики событий, доработанные формы).

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

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

Подготовка: что проверить перед установкой

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

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

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

Установка расширения через конфигуратор

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

Нажмите кнопку «Добавить» (или «Создать»), затем через команду «Загрузить из файла» укажите путь к файлу .cfe. Задайте понятное имя расширения — оно будет отображаться в списке и в сообщениях об ошибках. Префикс можно оставить предложенным или задать свой, он используется для имён добавляемых объектов.

После загрузки убедитесь, что у расширения установлен флажок активности. Далее выполните обновление конфигурации базы данных: клавиша F7 или «Конфигурация → Обновить конфигурацию базы данных». Если расширение добавляет реквизиты или объекты, платформа выполнит реструктуризацию — примите изменения в диалоге.

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

Установка через режим «Предприятие»

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

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

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

Сравнение способов установки

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

Универсальный способ, работает всегда. Требует монопольного доступа для обновления конфигурации БД, если расширение меняет структуру данных. Подходит для любых расширений.

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

Не требует остановки работы пользователей и прав на конфигуратор. Доступен только в конфигурациях с соответствующей функциональностью и при отсутствии ограничений профиля безопасности.

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

Сразу после установки откройте список расширений и убедитесь, что у расширения стоит флажок активности и нет значков ошибок. Если в колонке состояния есть отметка о проблеме — дважды щёлкните по строке, платформа покажет причину (несовместимость, конфликт объектов).

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

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

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

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

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

Норма

Флажок активности установлен, ошибок нет

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

Значок ошибки или расширение неактивно

Новая функциональность

Норма

Команды, отчёты или элементы появились и работают

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

Изменений нет или возникают ошибки при вызове

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

Норма

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

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

Ошибки «метод не обнаружен», «поле не обнаружено»

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

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

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

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

Обновление, отключение и удаление расширения

Для обновления расширения до новой версии откройте список расширений, выделите нужное и снова выполните «Загрузить из файла», указав обновлённый .cfe. После загрузки обновите конфигурацию базы данных (F7). Старые данные добавленных реквизитов сохраняются, если структура не изменилась несовместимо.

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

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

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

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

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

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

Чем файл CFE отличается от внешней обработки EPF?

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

Расширение установлено, но изменений не видно. Что делать?

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

Удалятся ли данные при отключении расширения?

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

Можно ли установить несколько расширений одновременно?

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

Как перенести расширение на другую базу?

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