Установка файла .cfe в Розницу: из программы и через Конфигуратор
Содержание
Расширение в 1С:Розница добавляют прямо из программы: Администрирование → Печатные формы, отчеты и обработки → Расширения, кнопка Добавить из файла, выбрать файл .cfe, затем перезапустить программу. Конфигуратор нужен, только если расширение меняет структуру данных, его надо отладить или в программе не хватает прав на снятие безопасного режима.
Первый способ подходит бухгалтеру или администратору магазина с правами полного доступа: занимает пару минут и не снимает конфигурацию с поддержки. Второй выбирает программист или администратор, который сопровождает базу и узлы обмена. Оба способа работают в Рознице 2.3 на платформе 8.3 — механизм расширений общий для всех типовых конфигураций, отличается только путь в меню.
Подготовка к установке расширения в 1С Розница
Расширение — это отдельный файл, который «надевается» поверх типовой конфигурации. Саму конфигурацию оно не трогает, поэтому обновления Розницы ставятся как обычно. Но есть условия, без которых файл не загрузится или загрузится и не заработает.
Что проверить заранее:
- 🧩 Версия платформы. Механизм расширений появился в 8.3.6. На актуальной Рознице 2.3 платформа заведомо новее, но поставщик расширения может требовать номер не ниже определённого — сверьте с его описанием.
- 📦 Версия Розницы. Расширение собирают под конкретный релиз конфигурации. Если оно перехватывает типовые формы и модули, а в вашем релизе их переименовали, расширение не применится.
- 👤 Права. Нужно платформенное право «Администрирование расширений конфигурации». В типовой Рознице оно есть у пользователей с профилем «Администратор». У кассира и продавца его нет.
- 🔐 Режим работы базы. Файловая база или клиент-серверная — неважно, но после загрузки расширения всем пользователям придётся перезайти.
- 🏪 Распределённая база. Если у вас центральная база и узлы магазинов, решите заранее, где расширение должно работать: только в офисе или во всех узлах.
Перед первой установкой незнакомого расширения сделайте резервную копию базы: Администрирование → Обслуживание → Резервное копирование и восстановление или выгрузку .dt из Конфигуратора. Расширение с собственными объектами пишет данные в базу, и откатить их простым удалением файла не получится.
Проверить права текущего пользователя просто: если раздел Администрирование → Печатные формы, отчеты и обработки открывается, а в нём доступна ссылка Расширения с активной кнопкой добавления — прав хватает.
Где взять файл расширения и как его проверить
Файл расширения имеет формат .cfe. Его выдаёт разработчик доработки, интегратор, поставщик торгового оборудования или сервиса (например, для связки с онлайн-кассой, программой лояльности, маркетплейсом).
Перед загрузкой задайте поставщику три вопроса:
- Под какой релиз Розницы и какую минимальную платформу собрано расширение.
- Нужно ли снимать флаг «Безопасный режим» и почему.
- Добавляет ли расширение собственные справочники, документы или регистры. Если да — это расширение с данными, его удаление сотрёт эти данные.
💡 Храните полученные .cfe в отдельной папке с датой и номером версии в имени, например loyalty_2.4.1_2026-10.cfe. Когда после обновления Розницы что-то сломается, вы быстро поймёте, какая версия стояла и что просить у разработчика.
Не загружайте файлы, скачанные с форумов и файлообменников без понятного автора. Расширение исполняет свой код с правами пользователя, а при снятом безопасном режиме — с доступом к файлам и внешним программам на компьютере.
Способ 1: добавить расширение в Розницу из режима Предприятия
Это основной путь для пользователя, который не открывает Конфигуратор.
- Запустите Розницу под пользователем с профилем «Администратор».
- Откройте
Администрирование → Печатные формы, отчеты и обработки. - Перейдите по ссылке Расширения. Откроется список установленных расширений — в новой базе он пустой.
- Нажмите Добавить из файла и выберите
.cfeна диске. - Программа покажет предупреждение о безопасности: расширение получит доступ к данным базы. Подтвердите, если доверяете источнику.
- Расширение появится в списке. Проверьте флаги в строке (о них — ниже).
- Закройте программу и запустите заново. Изменения применяются только к новым сеансам.
Флаги в списке расширений
| Флаг | Что делает | Когда менять |
|---|---|---|
| Активно | Включает или отключает расширение без удаления | Снять, чтобы временно выключить доработку и проверить, не она ли причина сбоя |
| Безопасный режим | Запрещает коду расширения работу с файлами, COM-объектами, внешними компонентами | Снимать только если поставщик прямо этого требует |
| Защита от опасных действий | Показывает предупреждения при опасных операциях кода | Обычно оставляют по умолчанию |
| Передавать в подчиненные узлы РИБ | Расширение уедет в узлы магазинов с обменом | Включить, если доработка нужна на кассах в магазинах |
Снятый безопасный режим даёт расширению те же возможности, что у любой программы на компьютере. Для обработок обмена с оборудованием и файлами это нормально, для «расширения печатной формы» — подозрительно.
Как заменить расширение новой версией
Не удаляйте старое расширение перед установкой новой версии, если в нём есть данные. Выделите строку в списке и выберите команду обновления из файла (она находится в меню Ещё или в контекстном меню строки). Программа заменит файл, а данные расширения останутся.
Способ 2: загрузить расширение через Конфигуратор
Конфигуратор нужен, когда расширение меняет структуру данных, когда его надо доработать или когда в режиме Предприятия загрузка не проходит из-за прав.
- Запустите базу в режиме Конфигуратор под администратором.
- Откройте
Конфигурация → Расширения конфигурации. - В открывшемся окне нажмите Добавить. Появится новое пустое расширение с именем вроде
Расширение1. - Выделите его и откройте дерево расширения (кнопка Конфигурация в этом же окне).
- В меню дерева расширения выберите
Конфигурация → Загрузить конфигурацию из файла…и укажите.cfe. Имя и свойства подтянутся из файла. - Выполните
Конфигурация → Обновить конфигурацию базы данных(F7) для расширения. - Откройте свойства расширения и проверьте флаги «Безопасный режим», «Защита от опасных действий» и признак передачи в узлы РИБ.
- Запустите Розницу в режиме Предприятия и проверьте работу.
Шаг 6 обязателен. Загрузка файла и обновление конфигурации базы данных — разные действия. Без обновления расширение висит в дереве, но в программе его нет.
Монопольный доступ
Если расширение добавляет свои справочники, документы или реквизиты, при обновлении конфигурации базы данных может понадобиться монопольный доступ. Тогда пользователей придётся выпустить из базы.
Принудительное завершение сеансов оборвёт работу кассиров: незакрытые чеки и смены останутся в неопределённом состоянии. Ставьте такие расширения после закрытия магазина или в окно между сменами.
Чем отличаются способы
| Критерий | Из режима Предприятия | Через Конфигуратор |
|---|---|---|
| Кто делает | Администратор программы | Программист, системный администратор |
| Нужен ли Конфигуратор | Нет | Да |
| Расширения с данными | Ставятся, структура обновляется автоматически | Ставятся с явным обновлением БД |
| Отладка и правка кода | Нет | Да |
| Риск ошибиться | Минимальный | Выше: можно забыть F7 или загрузить в основную конфигурацию |
💡 Частая ошибка в Конфигураторе — открыть меню Конфигурация основной конфигурации вместо меню в дереве расширения. Перед загрузкой файла посмотрите на заголовок окна: в нём должно стоять имя расширения, а не имя Розницы. Так вы не перепутаете, куда грузите файл.
Ещё один момент: пока база открыта в Конфигураторе, проверяйте расширение в отдельном сеансе Предприятия. Сеанс, запущенный до загрузки, изменений не увидит.
Расширение в распределённой базе магазинов
Розницу часто разворачивают как распределённую информационную базу: центральный офис плюс узлы в магазинах. Здесь расширение ведёт себя иначе, чем в одиночной базе.
Как правильно:
- 🏢 Устанавливайте расширение в центральном узле.
- ✅ Включите признак передачи в подчинённые узлы РИБ.
- 🔄 Дождитесь очередного сеанса обмена. Расширение придёт в магазин вместе с данными.
- 🔁 В магазине пользователь получит запрос на перезапуск или обновление — после него доработка заработает.
Если признак передачи не включён, расширение останется только в офисе. Тогда в магазине не будет, например, новой печатной формы этикетки или новой кнопки на рабочем месте кассира.
Расширение с собственными объектами данных, установленное только в центре, а в узлах отсутствующее, может ломать обмен: узел получит данные, для которых у него нет объектов. Поэтому для расширений с данными передача в узлы обязательна.
Устанавливать одно и то же расширение отдельно в каждом магазине вручную не стоит: получатся расширения-дубли, и при следующем обмене возможны конфликты.
Включение функций расширения после установки
Загрузить файл мало. Часть расширений после установки молчит, пока их не настроить.
Роли и профили доступа
Расширение может принести собственные роли. Чтобы кассир или товаровед увидел новую команду, роль нужно включить в профиль его группы доступа: Администрирование → Настройки пользователей и прав → Профили групп доступа. Откройте профиль, найдите роли расширения в списке ролей (обычно в их названии есть имя разработки) и отметьте их.
Пользователь с профилем «Администратор» видит всё сразу. Поэтому классическая ситуация: «у меня работает, а у продавца нет кнопки». Причина почти всегда в профиле.
Где искать настройки
Расширение встраивается туда, куда его задумал разработчик: новая ссылка в разделе, команда в форме документа, вкладка в карточке номенклатуры, кнопка на рабочем месте кассира. Описание мест должно быть в инструкции поставщика. Если её нет — после перезапуска пройдите по разделам и ищите новые пункты, но надёжнее спросить разработчика.
💡 Если расширение заменяет печатную форму (ценник, этикетку, товарный чек ), новая форма появляется в меню Печать соответствующего документа. Старая типовая обычно остаётся рядом — выберите нужную и при необходимости уберите лишнюю через настройку списка печатных форм.
Почему расширение не устанавливается или не работает
Ниже — симптомы, которые встречаются после загрузки .cfe в Розницу, и что с ними делать.
Если не помогло
Отключите все расширения флагом «Активно» и перезапустите программу. Если проблема ушла — включайте по одному, пока не найдёте виновника. Если не ушла — дело не в расширениях, ищите причину в самой базе или в обновлении.
Когда расширение мешает запуску и база не открывается вовсе, запустите Конфигуратор, откройте Конфигурация → Расширения конфигурации и снимите флаг «Активно» в свойствах проблемного расширения. Удалять сразу не нужно: если в нём есть данные, удаление их сотрёт.
Частые вопросы
Снимает ли расширение Розницу с поддержки?
Можно ли поставить несколько расширений одновременно?
Что будет с данными, если удалить расширение?
Можно ли ставить расширение в облачной Рознице?
Чем расширение отличается от внешней обработки?
.epf) — отдельная форма, которую запускают командой. Расширение (.cfe) встраивается в саму конфигурацию: меняет типовые формы, добавляет реквизиты, документы и роли.