Подключаем файл .cfe к базе 1С 8.3 без снятия с поддержки

Добавить расширение конфигурации в 1С 8.3 проще всего без Конфигуратора: Администрирование → Печатные формы, отчеты и обработки → Расширения → Добавить из файла, выбрать файл .cfe и перезапустить программу. Через Конфигуратор путь другой: Конфигурация → Расширения конфигурации, затем загрузка из файла и обновление конфигурации базы данных.

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

Что подготовить перед добавлением расширения

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

• 📁 Файл расширения с расширением .cfe. Его присылает разработчик или вы выгружаете его из другой базы.
• 🔑 Права. Пользователю нужна роль с правом администрирования расширений конфигурации. В типовых конфигурациях на БСП оно есть у полных прав и у администратора.
• 🧩 Совместимость с релизом. Расширение пишут под конкретную конфигурацию и обычно под определённый диапазон её релизов. Уточните у автора, для какого релиза оно сделано, и сравните с вашим: Справка → О программе (меню-«гамбургер» в левом верхнем углу).
• 🛡️ Доверие к источнику. Расширение — это программный код, который выполняется внутри вашей базы. Файл от неизвестного автора может читать и менять любые данные, к которым у него есть доступ.
• 💾 Резервная копия. Нужна, если расширение добавляет свои справочники или документы. Тогда при его подключении меняется структура базы.

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

Способы добавить расширение в конфигурацию 1С

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

Добавление в пользовательском режиме (БП 3.0, ЗУП 3.1, УТ 11)

1. Откройте раздел Администрирование.
2. Перейдите по ссылке Печатные формы, отчеты и обработки.
3. Включите флажок Расширения, если он выключен, и нажмите на ссылку Расширения.
4. В открывшемся списке нажмите Добавить из файла.
5. Программа покажет предупреждение безопасности о том, что расширение может содержать опасный код. Прочитайте его и продолжите, только если доверяете источнику.
6. Выберите файл .cfe на диске.
7. Расширение появится в списке. Перезапустите программу.

В ЗУП 3.1 и УТ 11 раздел и ссылки называются так же, потому что этот механизм общий для всех конфигураций на Библиотеке стандартных подсистем.

Добавление через «Все функции»

Этот путь пригодится для нетиповой конфигурации, где нет раздела администрирования из БСП.

1. Включите команду: в главном меню (кнопка с тремя полосками) откройте Сервис → Параметры и поставьте флажок Отображать команду "Все функции".
2. Откройте Все функции → Стандартные → Управление расширениями конфигурации.
3. Нажмите Добавить и выберите файл .cfe.
4. Перезапустите программу.

Это стандартная обработка платформы, она есть в любой конфигурации 8.3.

Добавление через Конфигуратор

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

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

Какие параметры расширения проверить после загрузки

У расширения в списке есть несколько флажков. От них зависит, заработает ли оно вообще.

Безопасный режим: когда его снимать

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

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

Роли расширения

Если в расширении есть свои роли, флажок «Использовать основные роли…» можно не включать. Тогда эти роли надо добавить пользователям. В БП 3.0 это делается через профили групп доступа: Администрирование → Настройки пользователей и прав → Профили групп доступа. Новые роли из расширения появятся в списке ролей профиля.

Применение расширения и перезапуск сеансов

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

Что нужно сделать после добавления:

1. Перезапустите свой сеанс и проверьте, что изменения видны.
2. Попросите остальных пользователей закрыть программу и войти заново.
3. В серверной базе посмотрите, кто ещё работает: в БСП это Администрирование → Обслуживание → Активные пользователи.

Расширение и обновление типовой конфигурации

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

В таком случае платформа не применит расширение и сообщит об этом при запуске. Порядок действий:

• 🔄 запросите у разработчика версию расширения под новый релиз;
• 🧪 перед обновлением рабочей базы проверьте связку «новый релиз + расширение» на копии;
• 🗂️ если расширение не критично, временно снимите флажок Активно, чтобы оно не мешало работе.

Как проверить, что расширение работает

Расширение в списке — ещё не гарантия, что оно применилось. Проверьте три вещи.

1. Нет сообщений при запуске. Если расширение не применилось, платформа выдаёт сообщение сразу после входа в программу. Прочитайте его целиком: там указаны имя расширения и объект, на котором возникла проблема.
2. Видны изменения. Откройте форму, отчёт или печатную форму, которую должно было изменить расширение. Новая кнопка, колонка или реквизит должны быть на месте.
3. Проверка применимости в Конфигураторе. В окне Конфигурация → Расширения конфигурации выделите расширение и выполните проверку применимости из меню Действия. Платформа сравнит заимствованные объекты с текущей основной конфигурацией и покажет расхождения.

Ошибки при подключении расширения и как их исправить

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

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

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

Не добавляйте новую версию отдельной строкой рядом со старой. Две копии одного расширения будут конфликтовать.

• В пользовательском режиме: выделите расширение в списке и выберите команду обновления из файла (она в меню Ещё или на панели списка). Укажите новый .cfe.
• В Конфигураторе: выделите расширение, загрузите в него новый файл из меню Действия, затем выполните Обновить конфигурацию базы данных.

После обновления так же перезапустите сеансы.

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

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

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

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

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

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

• 🏷️ Давайте понятные имена. Через год «Расширение1» и «Расширение2» никто не опознает. Хорошее имя называет задачу: «ПечатьСчетаСЛоготипом».
• 📝 Ведите список. Простая таблица: имя расширения, автор, для какого релиза, что делает. Она пригодится при каждом обновлении типовой.
• 🧪 Тестируйте на копии. Новое расширение и новый релиз конфигурации сначала проверяйте на копии рабочей базы.
• 📦 Храните файлы .cfe. Держите копии всех подключённых расширений отдельно от базы. Если что-то пойдёт не так, их можно быстро подключить заново.
• 🔒 Не снимайте безопасный режим «на всякий случай». Делайте это только по требованию разработчика.
• 🧭 Одна задача — одно расширение. Большое расширение «всё в одном» сложнее обновлять и чаще ломается при выходе нового релиза.

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

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