Подключаем файл .cfe к Рознице 2.3 без снятия с поддержки
Содержание
Чтобы установить расширение
в 1С:Розница 2.3, откройте Главное меню → Все функции → Стандартные → Управление расширениями конфигурации, нажмите «Добавить из файла…», выберите файл .cfe и перезапустите программу. Типовая конфигурация при этом не меняется и остаётся на поддержке, а расширение начинает работать с нового сеанса.
Если команды «Все функции» в главном меню нет, её включают в Главное меню → Сервис → Параметры флажком «Отображать команду “Все функции”». Для работы с расширениями нужны полные права: под обычным кассиром или продавцом кнопка добавления будет недоступна.
Подготовка: что проверить до установки расширения в Рознице
Расширение пишут под конкретную конфигурацию и диапазон её релизов. Оно «встраивается» в типовые объекты: добавляет реквизиты, меняет формы, перехватывает процедуры. Если в вашей Рознице объекта или процедуры нет либо они устроены иначе, расширение не применится.
Перед установкой соберите четыре факта:
- 📄 Тип файла. Расширение — это файл
.cfe. Файлы.epfи.erf— внешние обработки и отчёты, они подключаются в другом месте (раздел дополнительных отчётов и обработок), а не через список расширений. - 🔢 Релиз Розницы. Посмотрите его в
Главное меню → Справка → О программе. Сравните с релизом, для которого выпущено расширение: разработчик обычно указывает его в описании или имени файла. - 🖥️ Версия платформы. Расширения конфигурации появились в платформе 8.3.6, но современные расширения рассчитаны на номер платформы не ниже того, что требует актуальная Розница. В окне «О программе» номер платформы виден там же.
- 👥 Кто ещё работает в базе. Расширение подхватывается только новыми сеансами. Если днём на кассах работают продавцы, планируйте установку на конец смены.
Перед установкой сделайте резервную копию базы: выгрузку .dt через Конфигуратор или копию каталога файловой базы при закрытой программе. Расширение с ошибкой в коде может сломать проведение чеков или закрытие кассовой смены, и откат из копии будет самым быстрым выходом.
Расширение, внешняя обработка или правка конфигурации
Разработчики дорабатывают Розницу тремя способами. От способа зависит, как ставить доработку и что с ней будет при обновлении.
| Вид доработки | Файл | Куда подключается | Что при обновлении Розницы |
|---|---|---|---|
| Расширение конфигурации | .cfe | Список расширений | Остаётся в базе, совместимость проверяют заново |
| Внешняя печатная форма, отчёт или обработка | .epf, .erf | Дополнительные отчёты и обработки | Остаётся, ломается реже: не встраивается в типовой код |
| Изменение самой конфигурации | .cf или правки в Конфигураторе | Снятие с поддержки или режим с возможностью изменения | Каждое обновление требует ручного сравнения и объединения |
Для магазина третий вариант самый дорогой в сопровождении. Если подрядчик предлагает «снять с поддержки и поправить», спросите, нельзя ли сделать то же расширением: новую кнопку в чеке, реквизит товара, печатную форму ценника и проверку при проведении расширение закрывает без вмешательства в типовую Розницу.
Откуда брать расширение
Безопасные источники три: свой программист, франчайзи или разработчик, у которого вы купили доработку, и проверенный каталог решений. Файл из чата или форума без автора лучше не ставить в рабочую базу. Расширение исполняет код с правами пользователя, и при отключённом безопасном режиме может обращаться к файлам и внешним ресурсам.
Установка расширения в режиме 1С:Предприятие
Это основной способ для бухгалтера и администратора магазина. Конфигуратор не нужен, монопольный доступ к базе тоже не нужен.
Шаг 1. Откройте список расширений
Подойдут два пути:
| Путь | Когда удобен |
|---|---|
Главное меню → Все функции → Стандартные → Управление расширениями конфигурации | Работает в любой конфигурации на платформе 8.3, включая Розницу |
Раздел Администрирование → Печатные формы, отчеты и обработки → Расширения | Привычная форма БСП с подсказками; в старых релизах ссылка может называться иначе |
Обе формы управляют одним и тем же списком. Форма раздела «Администрирование» удобнее: в ней видно, применилось ли расширение, и есть подсказки по безопасному режиму.
Шаг 2. Загрузите файл
- Нажмите «Добавить из файла…» (в стандартной форме — «Добавить»).
- Выберите файл
.cfeна диске. - Если программа предупреждает о загрузке расширения из недоверенного источника, прочитайте текст. Продолжайте, только если знаете автора файла.
- Новая строка появится в списке с именем и версией расширения.
Шаг 3. Проверьте флажки
У каждой строки есть несколько свойств. Их смысл:
- ✅ Активно — расширение подключается при входе. Снятый флажок выключает его без удаления.
- 🔒 Безопасный режим — код расширения не может работать с файлами, COM-объектами, внешними компонентами и привилегированным режимом. Включён по умолчанию.
- 🛡️ Защита от опасных действий — перед потенциально опасной операцией программа спросит подтверждение.
- 🔁 Использовать в распределённой ИБ — расширение передаётся в подчинённые узлы обмена (подробнее ниже).
Снимать безопасный режим стоит только если разработчик прямо пишет, что без этого расширение не работает . Типичный пример — доработки, которые сохраняют файлы на диск, работают с оборудованием через внешнюю компоненту или ходят на сторонний сайт.
Шаг 4. Перезапустите программу
Закройте 1С и войдите снова. Без перезапуска текущий сеанс работает со старым набором расширений. Остальных пользователей попросите тоже перезайти: на кассе до перезапуска доработки не появятся.
После входа проверьте то, что обещал разработчик: новую кнопку в документе «Чек ККМ», дополнительный реквизит номенклатуры, новую печатную форму.
Проверку лучше делать на тестовом документе, а не на реальном чеке. Создайте чек или поступление в копии базы либо в рабочей базе с пометкой на удаление, проведите его и посмотрите, что изменилось. Если расширение затрагивает кассу, проверяйте сценарий на рабочем месте без подключённой ККТ: настоящий чек уйдёт в налоговую, и его придётся сторнировать чеком коррекции или возврата.
Установка расширения через Конфигуратор
Конфигуратор нужен программисту, который будет дорабатывать расширение, и администратору, если пользовательский режим недоступен (например, база не открывается из-за самого расширения).
- Запустите базу в режиме «Конфигуратор» под пользователем с полными правами.
- Откройте
Конфигурация → Расширения конфигурации. - Добавьте новое расширение кнопкой «Добавить». Имя и префикс можно оставить предложенными: при загрузке из файла они заменятся свойствами из
.cfe. - Выделите добавленную строку и в меню «Конфигурация» этого окна выберите загрузку конфигурации из файла. Укажите файл
.cfe. - Откройте конфигурацию расширения и выполните «Обновить конфигурацию
базы данных» (
F7).
Загрузка .cfe и обновление конфигурации
базы данных — два отдельных шага. Если ограничиться загрузкой, расширение останется в редактируемом состоянии и в пользовательском режиме не применится.
Если расширение добавляет новые реквизиты (поля в справочниках или документах), для обновления структуры данных может потребоваться монопольный доступ. Если расширение меняет только формы и код, база обновится без выгона пользователей.
Чем отличаются два способа
| Способ | Кто делает | Нужен монопольный доступ | Плюсы | Минусы |
|---|---|---|---|---|
| Режим «Предприятие» | Администратор магазина, бухгалтер | Нет | Быстро, без Конфигуратора, есть проверка применимости | Нельзя посмотреть и поправить код |
| Конфигуратор | Программист, администратор | Только при изменении структуры данных | Видно содержимое, можно проверить и доработать | Нужны навыки, легко забыть про обновление БД |
Права и роли для функций расширения
Расширение часто приносит собственные роли. Пока роль не выдана пользователю, новые команды он не увидит, хотя у администратора всё работает. Это самая частая причина жалоб «у меня есть кнопка, а у кассира нет».
В Рознице права выдаются не по ролям напрямую, а через профили и группы доступа:
- Откройте
Администрирование → Настройки пользователей и прав → Профили групп доступа. - Откройте профиль, которым пользуются нужные сотрудники (например, профиль кассира или менеджера магазина).
- В списке ролей найдите роли расширения. Их проще искать по префиксу или имени, которое указал разработчик.
- Отметьте нужные роли и запишите профиль.
- Попросите пользователей перезайти в программу.
Не меняйте поставляемые профили (с пометкой о том, что профиль поставляемый). Скопируйте профиль, добавьте роль в копию и привяжите к ней группу доступа. Иначе изменения могут потеряться при обновлении Розницы.
Если пользователь работает с полными правами, роли расширения ему не нужны: роль «Полные права» и так открывает всё. Но выдавать полные права кассиру ради одной кнопки нельзя: он получит доступ к настройкам, удалению документов и самим расширениям.
Расширения в Рознице с обменом и РИБ
Розница часто работает в связке: центральная база (Управление торговлей или ERP) и базы магазинов. Здесь у расширений свои правила.
- 🔁 Распределённая база (РИБ). Если магазины — подчинённые узлы одной распределённой базы, установите расширение в главном узле с флажком «Использовать в распределённой ИБ». Оно уйдёт в узлы вместе с изменениями конфигурации при очередном обмене. Ставить его вручную в каждом магазине не нужно.
- 🔄 Обмен через правила (Розница ↔ УТ). Расширение в одной базе не попадает в другую. Новые реквизиты из расширения сами по себе через обмен не передаются: для этого нужно дорабатывать правила обмена.
- 🏬 Несколько независимых магазинов. Каждая база получает расширение отдельно. Удобно держать один файл
.cfeв общей папке и записывать, в какие базы и когда его ставили.
Что делать, если расширение не применилось
Ошибки здесь бывают двух видов: расширение не загрузилось вовсе или загрузилось, но после перезапуска не работает.
Как обновить расширение на новую версию
Удалять старое расширение и ставить новое не нужно. Удаление стирает данные, которые расширение хранило в своих реквизитах.
- Откройте список расширений.
- Выделите строку расширения.
- Выберите команду обновления из файла (в форме раздела «Администрирование» она находится в меню строки, в Конфигураторе это повторная загрузка
.cfeв то же расширение с последующимF7). - Перезапустите программу.
Порядок при обновлении самой Розницы
Расширение надо проверять после каждого обновления типовой конфигурации:
- 🔍 До обновления спросите разработчика, совместимо ли расширение с новым релизом.
- 🧪 Обновите сначала копию базы и проверьте в ней работу расширения.
- 🚦 Если расширение не применяется, временно снимите флажок «Активно», чтобы магазин мог работать, пока ждёте исправленную версию.
Частые ошибки при установке расширения
- ❌ Удаляют расширение, чтобы поставить новую версию. Вместе с ним пропадают значения новых реквизитов. Правильно — обновлять поверх.
- ❌ Ставят сразу в рабочую базу. Если расширение конфликтует с релизом, магазин встаёт посреди дня. Сначала копия.
- ❌ Снимают безопасный режим «на всякий случай». Это открывает расширению доступ к файлам и внешним ресурсам без нужды.
- ❌ Путают
.cfeи.epf. Внешнюю обработку пытаются добавить в список расширений и получают ошибку формата файла. - ❌ Снимают конфигурацию с поддержки ради доработки. Для этого и придумали расширения: правки живут отдельно, а типовая Розница обновляется штатно.
Частые вопросы
Слетит ли расширение при обновлении Розницы?
Можно ли поставить несколько расширений в одну базу?
Как временно отключить расширение, не удаляя его?
Нужно ли выгонять кассиров из базы для установки?
Где посмотреть, какие расширения уже стоят в базе?
Все функции → Стандартные → Управление расширениями конфигурации. Там видны имя, версия и состояние каждого расширения.