Подключаем файл .cfe к базе 1С 8.3 и заставляем его работать

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

Частое заблуждение: «расширение подключают только через Конфигуратор с монопольным доступом». Это не так. В типовых конфигурациях на БСП (Бухгалтерия 3.0, ЗУП 3.1, УТ 11, КА, ERP) его добавляет пользователь с полными правами прямо в режиме Предприятие, не выгоняя коллег из базы. Конфигуратор нужен разработчику или тогда, когда пользовательский режим недоступен. Механизм общий для платформы 8.3, поэтому порядок одинаков во всех этих программах.

Что проверить в базе до подключения расширения

Расширения появились в платформе 8.3.6. Всё, что описано ниже, относится к 8.3 с интерфейсом «Такси».

Перед загрузкой файла пройдите короткий список:

• 🔢 Версия платформы. Посмотрите Справка → О программе. Номер платформы должен быть не ниже того, под который собрано расширение. Разработчик обычно пишет его в описании поставки.
• 📦 Релиз конфигурации. Расширение «цепляется» к конкретным объектам типовой. Если вы на старом релизе, а расширение сделано под новый (или наоборот), оно может не примениться.
• 👤 Права пользователя. Добавлять расширения может пользователь с ролью «Полные права» (или администратор системы). Под обычным бухгалтером команды «Добавить из файла» не будет.
• 🗂️ Режим работы базы. Файловая и клиент-серверная база подключают расширение одинаково. В облаке (1С:Фреш, 1С:Предприятие через интернет) файл загружают через средства самого сервиса, порядок задаёт провайдер.
• 💾 Резервная копия. Расширение с собственными объектами меняет структуру данных. Выгрузите базу в .dt или скопируйте каталог файловой базы.

Загрузка файла .cfe в режиме Предприятие

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

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

Пошагово

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

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

Если пользовательский режим недоступен

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

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

В новых релизах платформы «Все функции» переименованы в «Функции для технического специалиста». Содержимое то же.

Подключение расширения через Конфигуратор

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

Ручная загрузка

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

Шаги 4 и 5 — отдельные действия. Частая ошибка: файл загрузили, а обновление структуры не выполнили. Тогда расширение висит в Конфигураторе, но пользователи его не видят.

Загрузка из командной строки

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

"C:\Program Files\1cv8\8.3.24.1586\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 "сервер\имя_базы". Результат смотрите в файле лога.

Какой способ выбрать

Активация и свойства расширения: флажки, которые решают всё

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

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

После любого изменения флажков снова перезапустите 1С. Без перезапуска текущий сеанс работает со старым набором расширений.

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

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

Иначе обстоит дело, если в расширении есть новые объекты: отчёты, обработки, справочники, документы. На них у пользователей прав нет, пока вы их не дадите. Типичный симптом: администратор видит новый отчёт, а бухгалтер — нет.

Как выдать права в конфигурациях на БСП:

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

В нетиповой конфигурации без БСП роль назначают напрямую в карточке пользователя: в Конфигураторе Администрирование → Пользователи → вкладка «Прочие».

Отдельное право есть и на само управление расширениями — «Администрирование расширений конфигурации». Его выдают, если ставить расширения должен не полный администратор, а, например, сотрудник поддержки.

Расширение не работает: диагностика

Разберите проблему по симптому. Чаще всего причина в несоответствии версий или в незавершённой загрузке.

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

Как обновить подключённое расширение до новой версии

Разработчик прислал исправленный .cfe? Не удаляйте старое расширение и не добавляйте новое рядом. Удаление сотрёт данные расширения, а два одинаковых расширения начнут конфликтовать.

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

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

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

В Конфигураторе то же действие выглядит так: откройте расширение, загрузите в него конфигурацию из нового файла поверх старой и снова выполните обновление конфигурации базы данных (F7).

Как убедиться, что работает нужная версия

• 🏷️ Посмотрите колонку версии в списке расширений. Номер задаёт разработчик в свойствах расширения.
• 🧪 Проверьте конкретную доработку: откройте форму или отчёт, которые изменились в новой версии.
• 👥 Попросите одного пользователя перезайти и повторить проверку под своей учётной записью. Так вы сразу поймёте, хватает ли ему прав.

Отключение и удаление расширения

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

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

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

Этот вариант подходит, когда:

• 🔧 нужно обновить типовую, а расширение под новый релиз ещё не готово;
• 🔍 вы ищете, какая доработка вызывает ошибку;
• ⏸️ функция нужна только в определённый период (например, отчёт под годовую отчётность).

Удалить совсем

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

В Конфигураторе удаление выполняется в окне Конфигурация → Расширения конфигурации командой удаления для выделенного расширения.

Удаление расширения с собственными объектами уничтожает их данные: записи справочников, документы, значения реквизитов. Восстановить их можно только из резервной копии. Если не уверены, что данные больше не нужны, просто отключите расширение.

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