Подключаем файл .cfe к базе и проверяем, что доработка заработала

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

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

1. Подготовка: версия платформы, режим совместимости и копия базы

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

Перед установкой проверьте три вещи.

• 🧩 Версия платформы. Номер платформы в базе должен быть не ниже того, на котором сохранён файл .cfe. Если расширение выгружено на 8.3.24, а у вас 8.3.18, загрузка закончится ошибкой о несовместимом формате. Номер своей платформы смотрите в Справка → О программе.
• ⚙️ Режим совместимости. У расширения есть свой режим совместимости. Он не может быть новее, чем режим совместимости основной конфигурации. Разработчики обычно указывают в описании, под какой режим собрано расширение.
• 📦 Релиз конфигурации. Расширение «заимствует» объекты основной конфигурации: документы, формы, модули. Если разработчик собирал его под БП 3.0 одного релиза, а у вас релиз на год старше или новее, части заимствованных объектов может не оказаться. Сверьте релиз в Справка → О программе с требованиями из описания.

Перед первой установкой незнакомого расширения в рабочую базу сделайте резервную копию. Самый простой вариант — выгрузка .dt из Конфигуратора (Администрирование → Выгрузить информационную базу) или копия файла 1Cv8.1CD для файловой базы при закрытой программе. Ещё лучше — сначала применить расширение на копии базы и прогнать сценарий, ради которого его ставят.

2. Как применить расширение в режиме Предприятия

Это основной путь для бухгалтера или администратора базы без доступа в Конфигуратор. Он работает в конфигурациях на Библиотеке стандартных подсистем: БП 3.0, ЗУП 3.1, УТ 11, КА 2, ERP.

Пошагово

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

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

Если в конфигурации нет формы «Расширения»

В нетиповых и старых самописных конфигурациях раздела может не оказаться. Тогда используйте платформенную обработку: Главное меню (☰) → Функции для технического специалиста → Стандартные → Управление расширениями конфигурации.

Если пункта «Функции для технического специалиста» нет в меню, включите его отображение в параметрах программы: Главное меню → Сервис → Параметры.

Безопасный режим и защита от опасных действий

При установке из режима Предприятия у расширения по умолчанию стоят два флажка.

• 🔒 Безопасный режим. Код расширения не может работать с файлами на сервере, запускать внешние программы, обращаться к COM-объектам и внешним компонентам. Для печатной формы этого достаточно.
• 🛡️ Защита от опасных действий. Программа будет предупреждать пользователя, если код попытается сделать что-то потенциально опасное.

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

3. Загрузка файла расширения через Конфигуратор

В Конфигураторе видно, что именно меняет расширение, и есть все сообщения об ошибках. Этот способ работает в любой базе на 8.3, даже без БСП.

Шаги

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

После загрузки в дереве появятся заимствованные объекты (помечены значком «заимствован») и собственные объекты расширения.

Свойства расширения, которые стоит проверить

Откройте палитру свойств корня расширения. Там заданы:

• Имя и синоним — имя видно в списке, синоним видят пользователи;
• Версия — строка, которую задаёт разработчик; по ней потом сверяют обновления;
• Назначение — «Исправление», «Адаптация» или «Дополнение»; от него зависит порядок применения нескольких расширений;
• Режим совместимости — должен соответствовать основной конфигурации;
• Безопасный режим и Защита от опасных действий — в окне «Расширения конфигурации» это колонки-флажки.

4. Обновление конфигурации базы данных для расширения

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

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

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

Проверка, что расширение применилось

• ✅ В режиме Предприятия в форме «Расширения» у строки стоит флажок «Активно» и нет пометки об ошибке.
• ✅ Появилась ожидаемая доработка: новая команда печати, реквизит, пункт меню, исправленный расчёт.
• ✅ Для клиент-серверной базы — проверьте под другим пользователем с другого компьютера, а не только у себя.

5. Пакетная установка расширения скриптом

Когда расширение одно, а баз много (типично для франчайзи и холдингов), удобнее командная строка. Платформа поддерживает параметр -Extension для команд загрузки и обновления.

"C:\Program Files\1cv8\8.3.24.1691\bin\1cv8.exe" DESIGNER /S "srv1c\buh_main" /N "Администратор" /P "пароль" /LoadCfg "D:\ext\Pechat.cfe" -Extension "Pechat" /Out "D:\ext\load.log"

"C:\Program Files\1cv8\8.3.24.1691\bin\1cv8.exe" DESIGNER /S "srv1c\buh_main" /N "Администратор" /P "пароль" /UpdateDBCfg -Extension "Pechat" /Out "D:\ext\update.log"

Для файловой базы вместо /S "сервер\база" пишут /F "D:\Bases\Buh". Номер платформы в пути замените на свой.

Что важно в скрипте:

• 📝 Ключ /Out пишет журнал. Без него вы не узнаете, почему обновление не прошло.
• 🔑 Пароль в bat-файле — плохая практика. Храните его в переменной окружения или используйте отдельную учётную запись только для обслуживания.
• 🔁 Запускайте обновление в нерабочее время, если расширение меняет структуру данных.

6. Ошибки при применении расширения и что с ними делать

Большинство проблем возникает на шаге обновления БД или при первом запуске после него. Платформа пишет причину в окно сообщений Конфигуратора или в диалог при входе.

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

7. Обновление расширения на новую версию и контроль версий

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

Как заменить расширение новой версией

• В режиме Предприятия. В форме «Расширения» выделите строку и выберите команду обновления из файла (она есть в меню «Ещё» и в контекстном меню строки). Новое расширение встанет на место старого с тем же именем, данные его таблиц сохранятся, если разработчик не менял их структуру несовместимо.
• В Конфигураторе. Откройте дерево расширения и снова выполните Конфигурация → Загрузить конфигурацию из файла…, затем F7. Если в расширение вносили свои правки, используйте Конфигурация → Сравнить, объединить с конфигурацией из файла…, чтобы не затереть их.

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

Порядок при обновлении типовой конфигурации

1. На копии базы обновите конфигурацию до нового релиза.
2. Выполните обновление БД и посмотрите, применились ли расширения.
3. Если какое-то расширение отвалилось — запросите у разработчика версию под новый релиз.
4. Только после этого обновляйте рабочую базу.

Расширения и хранилище конфигурации

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

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

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