Загрузка файла .cfe в базу 1С 8.3: Конфигуратор, права и обновление БД

Файл .cfe добавляют в Конфигураторе так: Конфигурация → Расширения конфигурации, кнопка «Добавить», затем в меню «Конфигурация» этого окна — «Загрузить конфигурацию из файла …» и выбрать файл. После загрузки обязательно выполните обновление конфигурации базы данных для расширения (F7). Без этого шага расширение лежит в списке, но в базе не работает .

Порядок одинаковый для любой конфигурации на платформе 1С:Предприятие 8.3: Бухгалтерии 3.0, ЗУП 3.1, УТ 11, ERP. Сами расширения появились в платформе 8.3.6, поэтому в более ранних версиях пункта меню нет. Отдельно разберём, какие права дать пользователям на новые объекты и что делать, если расширение не применяется.

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

Расширение не меняет основную конфигурацию и не снимает её с поддержки. Это главное отличие от .cf: типовая остаётся типовой, обновления ставятся как обычно. Но подготовка всё равно нужна.

• 🔑 Права в базе. Войти в Конфигуратор может только пользователь с ролью администратора (в типовых — «Полные права» или «Администратор системы»). Если список пользователей пуст, база пускает любого.
• 🧩 Версия платформы. Номер платформы на компьютере должен быть не ниже того, под который сохранён .cfe. Файл из 8.3.24 может не открыться в 8.3.18.
• 📄 Тот ли это файл. Файл расширения имеет тип .cfe. Файл .cf — это полная конфигурация, .epf — внешняя обработка, .erf — внешний отчёт. Их подключают по-другому.
• 🏷 Для какой конфигурации сделано. Расширение «заимствует» объекты основной конфигурации. Если разработчик делал его под другой релиз, часть заимствованных объектов может не совпасть.
• 💾 Резервная копия. Расширение с собственными данными (новые справочники, регистры) меняет структуру базы. Выгрузите базу в .dt через Администрирование → Выгрузить информационную базу или сделайте копию файла 1Cv8.1CD.

Как добавить CFE через Конфигуратор: пошагово

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

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

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

Шаг 2. Создайте пустое расширение

Нажмите «Добавить». Платформа создаст новую строку с именем вроде Расширение1. Это контейнер, в который вы загрузите содержимое файла.

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

Выделите созданную строку. В командной панели окна откройте меню «Конфигурация» и выберите «Загрузить конфигурацию из файла…». Укажите путь к .cfe.

Платформа заменит пустое расширение содержимым файла. Имя, префикс и назначение подтянутся из файла.

Шаг 4. Обновите конфигурацию базы данных

Откройте дерево расширения (двойной клик по строке) и нажмите F7 или Конфигурация → Обновить конфигурацию базы данных в окне этого расширения. Если расширение добавляет свои таблицы, платформа покажет список изменений структуры. Примите его.

После этого расширение становится частью базы. Пользователи увидят его при следующем входе в программу.

Шаг 5. Проверьте свойства в списке

Вернитесь в окно списка расширений. Там видны флажки, которые решают, как расширение работает:

Снимать «Безопасный режим» у расширения из неизвестного источника нельзя. Без него код получает доступ к файловой системе сервера и может выполнить что угодно.

Шаг 6. Убедитесь, что расширение работает

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

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

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

Обновление базы, сохранение и пакетная загрузка

Когда расширение уже стоит

Если пришёл новый вариант того же .cfe, не добавляйте вторую строку. Выделите существующее расширение и снова выполните «Загрузить конфигурацию из файла…», затем F7. Два расширения с одинаковыми объектами конфликтуют.

Для правок «руками» откройте дерево расширения, измените модуль или форму и сохраните. Пока не выполнено обновление БД, изменения видит только Конфигуратор.

Как выгрузить расширение обратно в файл

Пригодится для переноса в другую базу или как копия перед обновлением. В окне списка выделите расширение, меню «Конфигурация» → «Сохранить конфигурацию в файл…». Получится тот же .cfe.

Загрузка без интерфейса

Когда баз много, расширение ставят из командной строки. Пример для файловой базы:

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F"D:\Bases\Buh" /N"Администратор" /P"" ^
  /LoadCfg "D:\ext\Dorabotka.cfe" -Extension "МоёРасширение" ^
  /UpdateDBCfg -Extension "МоёРасширение" /Out "D:\ext\log.txt"

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

Права пользователей на объекты расширения

Частая ситуация: администратор видит новый отчёт, а бухгалтер — нет. Причина почти всегда в правах. Новые объекты расширения не входят ни в одну роль основной конфигурации.

Как это решает разработчик

Правильно собранное расширение уже содержит права. Есть два стандартных приёма:

1. Заимствованная роль. В расширение заимствуют роль типовой (например, «Полные права» или роль бухгалтера) и в ней ставят права на новые объекты. Тогда все, у кого есть эта роль, получают доступ автоматически.
2. Собственная роль. В расширении создают новую роль. Её нужно назначить пользователям отдельно.

Посмотреть, что внутри, можно в дереве расширения, в ветке «Общие → Роли».

Как назначить роль из расширения

В конфигурациях на БСП (Бухгалтерия 3.0, ЗУП 3.1, УТ 11) роли раздают через профили групп доступа в режиме 1С:Предприятие:

1. Откройте Администрирование → Настройки пользователей и прав.
2. Перейдите в «Группы доступа» → «Профили групп доступа».
3. Скопируйте нужный типовой профиль и в копии отметьте роль из расширения.
4. Назначьте новый профиль группе доступа, куда входят нужные пользователи.

Типовые профили лучше не править: при обновлении конфигурации они вернутся к исходному составу. Копия профиля это переживёт.

Ошибки при загрузке CFE и как их снять

Большая часть проблем видна сразу при F7 или при первом входе пользователя. Ниже — симптом и что с ним делать.

Если расширение «сломалось» после обновления типовой

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

Что делать по порядку:

1. Снимите флажок «Активно», чтобы пользователи работали без ошибок.
2. Сохраните расширение в файл — это ваша копия.
3. Передайте файл и номер нового релиза разработчику.
4. После исправления загрузите новый .cfe поверх старого и выполните F7.

Файловая, клиент-серверная и облачная база: в чём разница

Порядок действий в Конфигураторе один и тот же. Различаются окружение и ограничения.

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

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

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

Облачная база

В облаке Конфигуратора у пользователя нет, поэтому путь только через раздел «Расширения» в программе. Расширения, которым нужен небезопасный режим (работа с файлами, COM-объектами, внешними компонентами), в облаке обычно не подключаются. Некоторые провайдеры дополнительно проверяют расширение перед установкой, это стоит уточнить в поддержке своего сервиса.

Когда Конфигуратор лучше

• 🛠 Нужно посмотреть код расширения или поправить его.
• 🔁 Надо снять галку «Безопасный режим» осознанно и под контролем администратора.
• 📦 Расширение ставят во много баз сразу через пакетный режим.
• 🔍 Нужно разобраться, почему расширение не применяется: окно сообщений Конфигуратора даёт подробности.

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