Загрузка файла .cfe в информационную базу 1С 8.3: от копии до проверки

Чтобы подключить расширение в 1С через конфигуратор, откройте базу в режиме Конфигуратор, выберите Конфигурация → Расширения конфигурации, добавьте строку и загрузите в неё файл .cfe, затем обновите конфигурацию базы данных клавишей F7. Пользователи увидят расширение после перезапуска своих сеансов. Механизм общий для платформы 8.3 и не зависит от конфигурации: шаги одинаковы для Бухгалтерии 3.0, ЗУП 3.1, УТ 11 и самописных баз.

Ниже — полная инструкция: как подготовиться, что проверить в файле, как настроить свойства и что делать, если расширение не применяется.

Подготовка базы перед подключением расширения

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

1. 💾 Сделайте резервную копию: Администрирование → Выгрузить информационную базу в Конфигураторе (файл .dt) или штатный бэкап СУБД для серверной базы.
2. 🔢 Узнайте версию платформы: в Конфигураторе Справка → О программе. Расширения появились в 8.3.6, но заимствование многих объектов и собственные данные расширений стали доступны позже. Если расширение собрано на более новой платформе, на старой оно может не загрузиться.
3. 📄 Посмотрите режим совместимости основной конфигурации: откройте дерево конфигурации, свойства корня, поле «Режим совместимости».
4. 👤 Проверьте права: войти в Конфигуратор может только пользователь с административными правами.
5. 🧪 Если расширение новое и непроверенное, сначала подключите его в копию базы .

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

Где взять файл .cfe и как его проверить до загрузки

Файл расширения имеет формат .cfe. Источники обычно такие:

• 🏢 разработчик или франчайзи прислал готовое расширение под вашу задачу;
• 🛒 тиражное решение с маркетплейса или сайта вендора (обмены, печатные формы, интеграции);
• 🔄 вы сами сохранили расширение из другой базы: в списке расширений правой кнопкой по строке → Конфигурация → Сохранить конфигурацию в файл.

Что выяснить у поставщика до подключения:

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

Как подключить расширение через конфигуратор: пошагово

Шаг 1. Открыть список расширений

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

Если пункта нет в меню, сначала откройте конфигурацию: Конфигурация → Открыть конфигурацию.

Шаг 2. Добавить пустое расширение

Нажмите кнопку «Добавить» в командной панели окна. В списке появится строка вида Расширение1. Пока это пустая заготовка, её имя заменится при загрузке файла.

Шаг 3. Загрузить файл .cfe

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

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

Шаг 4. Применить расширение к базе

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

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

Шаг 5. Проверить в пользовательском режиме

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

Строка вашего расширения должна быть без значка ошибки, а новая команда, форма или отчёт — на месте.

Альтернатива: без Конфигуратора

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

Свойства подключённого расширения: что включить

В списке расширений у каждой строки есть флажки. Их можно менять прямо в окне Конфигуратора.

• ✅ Активно — расширение применяется. Снимите флажок, чтобы временно отключить его без удаления.
• 🛡️ Безопасный режим — код расширения не может обращаться к файлам, внешним компонентам и COM. Для печатных форм и отчётов обычно хватает безопасного режима. Для обменов и интеграций его приходится снимать.
• 🚧 Защита от опасных действий — пользователь получает предупреждение при попытке опасной операции из кода.
• 🌐 Используется в распределённой ИБ — расширение передаётся в подчинённые узлы РИБ. Без этого флажка в узлах его придётся подключать вручную.

Свойство «Назначение» задаётся в свойствах корня самого расширения. Варианты: «Исправление», «Адаптация», «Дополнение». От назначения зависит очередность применения.

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

Самые частые ситуации и что с ними делать:

Детальное описание ошибки всегда смотрите в окне сообщений Конфигуратора после F7: там перечислены конкретные объекты и свойства, из-за которых расширение не применилось.

Несколько расширений в одной базе: порядок и конфликты

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

Порядок применения:

1. Расширения с назначением «Исправление».
2. Затем «Адаптация».
3. Затем «Дополнение».

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

Где возникают конфликты:

• 🔁 два расширения перехватывают одну и ту же процедуру модуля через &Перед или &Вместо. Срабатывают оба, но порядок вызова зависит от очередности применения;
• 🧩 оба добавляют элемент на одну форму с одинаковым именем;
• ⛔ одно расширение использует &Вместо, полностью заменяя процедуру, и второе расширение до неё не доходит.

Как разбираться:

1. Отключите все расширения, кроме одного, снимая флажок «Активно».
2. Проверьте поведение после перезапуска сеанса.
3. Включайте по одному, пока не найдёте пару, которая ломает работу.

💡 Если у вас несколько мелких доработок от одного разработчика, попросите собрать их в одно расширение. Чем меньше слоёв, тем проще обновлять типовую конфигурацию.

Обновление и удаление расширения в конфигураторе

Как обновить расширение до новой версии

Новую версию не нужно подключать отдельной строкой — иначе получите два одинаковых расширения и конфликты.

1. В списке расширений выделите существующую строку.
2. Правой кнопкой → Конфигурация → Загрузить конфигурацию из файла... и укажите новый .cfe.
3. Откройте дерево расширения и нажмите F7.
4. Попросите пользователей перезапустить 1С.

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

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

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

1. Сделайте резервную копию, если у расширения есть свои данные.
2. В списке расширений выделите строку и нажмите «Удалить».
3. Подтвердите удаление.

Своё расширение за десять минут: минимальный пример

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

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

Чтобы изменить поведение типового объекта, заимствуйте его модуль и используйте аннотации перед процедурами. Пример перехвата записи документа:

&После("ПередЗаписью")
Процедура МоиОтчеты_ПередЗаписью(Отказ, РежимЗаписи, РежимПроведения)
	Если Не ЗначениеЗаполнено(Комментарий) Тогда
		Комментарий = "Создан " + Формат(ТекущаяДатаСеанса(), "ДФ=dd.MM.yyyy");
	КонецЕсли;
КонецПроцедуры

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

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