Подключаем файл .cfe к базе 1С 8.3: из пользовательского режима и через Конфигуратор

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

Второй путь — Конфигуратор, Конфигурация → Расширения конфигурации. Он нужен, когда расширение надо проверить, поправить или подключить без запуска пользовательского режима. Инструкция относится к платформе 1С:Предприятие 8.3 и подходит для любой типовой конфигурации на БСП: Бухгалтерии, ЗУП, УТ и других.

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

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

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

• 🧩 Платформа. Номер версии платформы не ниже того, под которую сделано расширение. Разработчик обычно указывает его в описании. Если у расширения режим совместимости 8.3.20, а база работает на 8.3.18 — подключить не получится.
• 🏷️ Конфигурация и релиз. Расширение пишут под конкретную конфигурацию. Доработка для БП 3.0 не встанет на ЗУП, а иногда и на старый релиз той же БП.
• 🔑 Права. Пользователь должен иметь полные права или роль администратора. Обычному бухгалтеру команда добавления не доступна.
• 📁 Файл. Нужен именно .cfe. Файл .epf — это внешняя обработка, .erf — внешний отчёт, .cf — целая конфигурация. Их загружают в другие места.
• 💾 Резервная копия. Расширение меняет поведение базы: формы, проведение, печать.

Монопольный режим для подключения не нужен. Остальные пользователи продолжают работать, но изменения увидят только после перезапуска своих сеансов.

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

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

Через раздел «Администрирование» (типовые на БСП)

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

В ЗУП 3.1 и УТ 11 путь тот же — раздел «Администрирование» и форма печатных форм, отчётов и обработок. В конфигурациях, где раздела «Администрирование» в верхнем меню нет (например, ERP), откройте список расширений через стандартную функцию платформы, описанную ниже.

Через стандартную функцию платформы

Если конфигурация нетиповая или раздела нет, используйте встроенную форму платформы:

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

3. Установка расширения через Конфигуратор

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

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

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

Пакетный запуск для нескольких баз

Если одно расширение нужно поставить в десяток баз, удобнее командная строка. Пример bat-файла для файловой базы:

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F"D:\Bases\Buh" /N"Администратор" /P"пароль" /LoadCfg "D:\Ext\MyPrint.cfe" -Extension "МояПечать" /UpdateDBCfg -Extension "МояПечать" /Out "D:\Ext\log.txt"

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

4. Свойства расширения: безопасный режим и защита от опасных действий

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

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

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

Назначение расширения и порядок применения

У каждого расширения есть свойство «Назначение». Его задаёт разработчик, но знать его полезно при диагностике. Значений три:

• 🔧 Исправление — срочная правка ошибки типовой конфигурации. Часто такие расширения рассылает сама фирма-разработчик конфигурации до выхода нового релиза.
• 🧭 Адаптация — подстройка под конкретную компанию: свои печатные формы, реквизиты, проверки.
• ➕ Дополнение — новый функционал поверх конфигурации: обмен с сайтом, интеграция с сервисом, дополнительные отчёты.

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

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

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

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

• ❌ Загружают .cfe через «Открыть файл». Расширение так не подключится. Это не внешняя обработка, оно добавляется только через список расширений.
• ❌ Ставят сразу в рабочую базу. Если расширение конфликтует с доработками конфигурации, ошибки увидят все пользователи. Проверяйте на копии.
• ❌ Обновляют конфигурацию и не проверяют расширения. После каждого обновления релиза откройте список расширений: проблемные помечаются, а платформа сообщает об ошибке применения при запуске.
• ❌ Держат расширение без описания. Через год никто не помнит, кто его ставил и зачем. Заполняйте синоним понятно: «Печать счёта с логотипом, ООО Ромашка, от 12.03».

6. Как обновить или удалить расширение 1С

Обновление на новую версию

Разработчик прислал новый .cfe — не удаляйте старое расширение. Удаление стирает данные, которые расширение хранит в своих справочниках и реквизитах.

Правильный порядок:

1. Сделайте копию базы.
2. Откройте список расширений.
3. Выделите нужное расширение и выберите команду обновления из файла. В форме БСП она находится в меню «Ещё» или рядом с «Добавить из файла».
4. Укажите новый .cfe и перезапустите программу.

В Конфигураторе то же самое делается повторной загрузкой: откройте расширение, Конфигурация → Расширение конфигурации → Загрузить из файла…, затем обновите конфигурацию базы данных. Имя расширения в базе и в файле должно совпадать — иначе платформа воспримет его как другое расширение.

Временное отключение

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

Полное удаление

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

7. Как проверить, что расширение установлено правильно

Подключённое расширение ещё не значит работающее. Короткая проверка после установки:

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

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

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