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