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

· 10 мин

Содержание

Чтобы установить расширение в 1С:Розница 2.3, откройте Главное меню → Все функции → Стандартные → Управление расширениями конфигурации, нажмите «Добавить из файла…», выберите файл .cfe и перезапустите программу. Типовая конфигурация при этом не меняется и остаётся на поддержке, а расширение начинает работать с нового сеанса.

Если команды «Все функции» в главном меню нет, её включают в Главное меню → Сервис → Параметры флажком «Отображать команду “Все функции”». Для работы с расширениями нужны полные права: под обычным кассиром или продавцом кнопка добавления будет недоступна.

Подготовка: что проверить до установки расширения в Рознице

Расширение пишут под конкретную конфигурацию и диапазон её релизов. Оно «встраивается» в типовые объекты: добавляет реквизиты, меняет формы, перехватывает процедуры. Если в вашей Рознице объекта или процедуры нет либо они устроены иначе, расширение не применится.

Перед установкой соберите четыре факта:

  • 📄 Тип файла. Расширение — это файл .cfe. Файлы .epf и .erf — внешние обработки и отчёты, они подключаются в другом месте (раздел дополнительных отчётов и обработок), а не через список расширений.
  • 🔢 Релиз Розницы. Посмотрите его в Главное меню → Справка → О программе. Сравните с релизом, для которого выпущено расширение: разработчик обычно указывает его в описании или имени файла.
  • 🖥️ Версия платформы. Расширения конфигурации появились в платформе 8.3.6, но современные расширения рассчитаны на номер платформы не ниже того, что требует актуальная Розница. В окне «О программе» номер платформы виден там же.
  • 👥 Кто ещё работает в базе. Расширение подхватывается только новыми сеансами. Если днём на кассах работают продавцы, планируйте установку на конец смены.

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

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

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

Вид доработкиФайлКуда подключаетсяЧто при обновлении Розницы
Расширение конфигурации.cfeСписок расширенийОстаётся в базе, совместимость проверяют заново
Внешняя печатная форма, отчёт или обработка.epf, .erfДополнительные отчёты и обработкиОстаётся, ломается реже: не встраивается в типовой код
Изменение самой конфигурации.cf или правки в КонфигуратореСнятие с поддержки или режим с возможностью измененияКаждое обновление требует ручного сравнения и объединения

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

Откуда брать расширение

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

Установка расширения в режиме 1С:Предприятие

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

Шаг 1. Откройте список расширений

Подойдут два пути:

ПутьКогда удобен
Главное меню → Все функции → Стандартные → Управление расширениями конфигурацииРаботает в любой конфигурации на платформе 8.3, включая Розницу
Раздел Администрирование → Печатные формы, отчеты и обработки → РасширенияПривычная форма БСП с подсказками; в старых релизах ссылка может называться иначе

Обе формы управляют одним и тем же списком. Форма раздела «Администрирование» удобнее: в ней видно, применилось ли расширение, и есть подсказки по безопасному режиму.

Шаг 2. Загрузите файл

  1. Нажмите «Добавить из файла…» (в стандартной форме — «Добавить»).
  2. Выберите файл .cfe на диске.
  3. Если программа предупреждает о загрузке расширения из недоверенного источника, прочитайте текст. Продолжайте, только если знаете автора файла.
  4. Новая строка появится в списке с именем и версией расширения.

Шаг 3. Проверьте флажки

У каждой строки есть несколько свойств. Их смысл:

  • ✅ Активно — расширение подключается при входе. Снятый флажок выключает его без удаления.
  • 🔒 Безопасный режим — код расширения не может работать с файлами, COM-объектами, внешними компонентами и привилегированным режимом. Включён по умолчанию.
  • 🛡️ Защита от опасных действий — перед потенциально опасной операцией программа спросит подтверждение.
  • 🔁 Использовать в распределённой ИБ — расширение передаётся в подчинённые узлы обмена (подробнее ниже).

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

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

Закройте 1С и войдите снова. Без перезапуска текущий сеанс работает со старым набором расширений. Остальных пользователей попросите тоже перезайти: на кассе до перезапуска доработки не появятся.

После входа проверьте то, что обещал разработчик: новую кнопку в документе «Чек ККМ», дополнительный реквизит номенклатуры, новую печатную форму.

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

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

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

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

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

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

Чем отличаются два способа

СпособКто делаетНужен монопольный доступПлюсыМинусы
Режим «Предприятие»Администратор магазина, бухгалтерНетБыстро, без Конфигуратора, есть проверка применимостиНельзя посмотреть и поправить код
КонфигураторПрограммист, администраторТолько при изменении структуры данныхВидно содержимое, можно проверить и доработатьНужны навыки, легко забыть про обновление БД

Права и роли для функций расширения

Расширение часто приносит собственные роли. Пока роль не выдана пользователю, новые команды он не увидит, хотя у администратора всё работает. Это самая частая причина жалоб «у меня есть кнопка, а у кассира нет».

В Рознице права выдаются не по ролям напрямую, а через профили и группы доступа:

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

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

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

Расширения в Рознице с обменом и РИБ

Розница часто работает в связке: центральная база (Управление торговлей или ERP) и базы магазинов. Здесь у расширений свои правила.

  • 🔁 Распределённая база (РИБ). Если магазины — подчинённые узлы одной распределённой базы, установите расширение в главном узле с флажком «Использовать в распределённой ИБ». Оно уйдёт в узлы вместе с изменениями конфигурации при очередном обмене. Ставить его вручную в каждом магазине не нужно.
  • 🔄 Обмен через правила (Розница ↔ УТ). Расширение в одной базе не попадает в другую. Новые реквизиты из расширения сами по себе через обмен не передаются: для этого нужно дорабатывать правила обмена.
  • 🏬 Несколько независимых магазинов. Каждая база получает расширение отдельно. Удобно держать один файл .cfe в общей папке и записывать, в какие базы и когда его ставили.

Что делать, если расширение не применилось

Ошибки здесь бывают двух видов: расширение не загрузилось вовсе или загрузилось, но после перезапуска не работает.

Диагностика: выберите симптом

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

Удалять старое расширение и ставить новое не нужно. Удаление стирает данные, которые расширение хранило в своих реквизитах.

  1. Откройте список расширений.
  2. Выделите строку расширения.
  3. Выберите команду обновления из файла (в форме раздела «Администрирование» она находится в меню строки, в Конфигураторе это повторная загрузка .cfe в то же расширение с последующим F7).
  4. Перезапустите программу.

Порядок при обновлении самой Розницы

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

  • 🔍 До обновления спросите разработчика, совместимо ли расширение с новым релизом.
  • 🧪 Обновите сначала копию базы и проверьте в ней работу расширения.
  • 🚦 Если расширение не применяется, временно снимите флажок «Активно», чтобы магазин мог работать, пока ждёте исправленную версию.

Частые ошибки при установке расширения

  • ❌ Удаляют расширение, чтобы поставить новую версию. Вместе с ним пропадают значения новых реквизитов. Правильно — обновлять поверх.
  • ❌ Ставят сразу в рабочую базу. Если расширение конфликтует с релизом, магазин встаёт посреди дня. Сначала копия.
  • ❌ Снимают безопасный режим «на всякий случай». Это открывает расширению доступ к файлам и внешним ресурсам без нужды.
  • ❌ Путают .cfe и .epf. Внешнюю обработку пытаются добавить в список расширений и получают ошибку формата файла.
  • ❌ Снимают конфигурацию с поддержки ради доработки. Для этого и придумали расширения: правки живут отдельно, а типовая Розница обновляется штатно.

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

Слетит ли расширение при обновлении Розницы?
Нет, расширение остаётся в базе после обновления. Но если новый релиз изменил объекты, на которые оно опирается, оно перестанет применяться, и его нужно обновить у разработчика.
Можно ли поставить несколько расширений в одну базу?
Можно. Они применяются по очереди. Если два расширения меняют одну и ту же форму или процедуру, возможен конфликт: проверяйте такие сочетания на копии базы.
Как временно отключить расширение, не удаляя его?
Снимите флажок «Активно» в списке расширений и перезапустите программу. Данные расширения сохранятся, а при включении флажка всё вернётся.
Нужно ли выгонять кассиров из базы для установки?
Для загрузки в режиме «Предприятие» — нет. Но расширение заработает у каждого только после перезахода, а для изменения структуры данных через Конфигуратор может понадобиться монопольный доступ.
Где посмотреть, какие расширения уже стоят в базе?
В том же списке Все функции → Стандартные → Управление расширениями конфигурации. Там видны имя, версия и состояние каждого расширения.