Установка файла .cfe в базу 1С 8.3: из программы и через Конфигуратор

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

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

Что проверить до установки расширения

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

📋 Что выяснить у разработчика или в описании расширения:

• 📌 Для какой конфигурации и с какого релиза оно сделано. Расширение под БП 3.0 в ЗУП не встанет.
• 📌 Нужен ли ему небезопасный режим (работа с файлами, внешними компонентами, интернетом).
• 📌 Добавляет ли оно свои справочники, документы или реквизиты. Такие расширения меняют структуру данных, и их удаление стирает эти данные.
• 📌 Есть ли в нём свои роли и кому их выдавать.

🖥 Что проверить в базе:

• Версию платформы: Справка → О программе (или значок «i» в правом верхнем углу). Номер должен быть не ниже того, на котором собран файл.
• Режим совместимости конфигурации. Если расширение собрано с режимом совместимости выше, чем у вашей конфигурации, платформа его не примет.
• Свои права. Добавлять расширения может пользователь с полными правами (роль администратора) или с правом администрирования расширений конфигурации.

Расширение, которое только меняет печатные формы или поведение кнопок, данных не создаёт. Для него копия желательна, но откат делается простым отключением.

Проверка на копии базы

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

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

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

Шаг 1. Включите использование расширений

В БП 3.0 откройте Администрирование → Печатные формы, отчеты и обработки. Если в форме есть флажок Расширения, установите его. Рядом появится одноимённая ссылка.

В ЗУП 3.1 и УТ 11 раздел и путь те же: Администрирование → Печатные формы, отчеты и обработки → Расширения.

Шаг 2. Добавьте файл

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

Шаг 3. Перезапустите программу

Изменения применяются к новым сеансам. Закройте 1С и откройте снова. Другим пользователям тоже придётся перезайти: у тех, кто работал во время установки, расширение заработает только после перезапуска.

💡 Если в базе одновременно работает 20 человек, ставьте расширение в начале дня или в обед и попросите всех перезайти разом. Иначе часть людей будет видеть старое поведение, часть — новое.

Если раздела «Расширения» нет в меню

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

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

Способ нужен программистам и тем, кто хочет управлять всеми свойствами расширения.

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

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

Свойства, которые стоит проверить в карточке

Установка в несколько баз командной строкой

Для пакетной установки подходит Конфигуратор в пакетном режиме. Пример для файловой базы:

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Админ" /P "пароль" /LoadCfg "D:\ext\Pechat.cfe" -Extension "Pechat" /UpdateDBCfg -Extension "Pechat" /Out "D:\ext\log.txt"

Номер платформы в пути замените на свой. Для серверной базы вместо /F используйте /S "сервер\имя_базы". Результат смотрите в файле, указанном в /Out.

Права пользователей и безопасный режим

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

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

Если в расширении есть свои роли, их нужно выдать. В типовых конфигурациях на БСП это делается через группы доступа:

1. Администрирование → Пользователи и права → Группы доступа (или профили групп доступа).
2. Откройте профиль, который используют нужные сотрудники.
3. В списке ролей найдите роли расширения и отметьте их.
4. Сохраните и попросите пользователей перезайти.

Если в расширении ролей нет, оно работает в рамках прав основной конфигурации. Тогда отдельная настройка не нужна.

Безопасный режим

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

• 🚫 читать и писать файлы на диске;
• 🚫 подключать внешние компоненты и COM-объекты;
• 🚫 обращаться к интернет-ресурсам без разрешения.

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

Когда расширение не встаёт: диагностика

Сообщения платформы различаются по версиям, но причины повторяются. Ищите в тексте ошибки ключевые слова.

Порядок проверки

1. Откройте список расширений и посмотрите, отмечено ли оно как активное.
2. Перезапустите сеанс и проверьте снова.
3. Если рядом с расширением есть пометка об ошибке, нажмите на неё или откройте карточку — там будет текст причины.
4. Сравните релиз конфигурации (Справка → О программе) с релизом, под который делалось расширение.
5. Проверьте роли пользователя, как описано выше.

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

Обновление расширения и удаление

Как обновить расширение на новую версию

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

В Конфигураторе откройте окно Расширения конфигурации, выделите расширение, снова загрузите в него файл и выполните Обновить конфигурацию базы данных.

Командной строкой — та же связка /LoadCfg … -Extension и /UpdateDBCfg -Extension, что и при первой установке.

Как временно отключить

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

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

1. Откройте список расширений.
2. Выделите строку и нажмите Удалить.
3. Подтвердите и перезапустите программу.

Типичные промахи при установке

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