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

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

Типичная ситуация: программист прислал файл Доработки_печати.cfe, бухгалтер ждёт новую печатную форму к вечеру. Загрузка занимает пять минут. Остальное время уходит на мелочи: не те права, безопасный режим, несовпадение режима совместимости.

Подготовка: что проверить до загрузки .cfe

Расширения конфигурации появились в платформе 8.3.6. Назначение «Исправление / Адаптация / Дополнение» и собственные объекты с данными добавлялись в следующих версиях, поэтому на старой платформе современный .cfe может не загрузиться вовсе.

Перед началом проверьте пять вещей:

• 🧩 Версия платформы. Номер должен быть не ниже того, на котором разработчик собирал расширение. Номер своей платформы видно в Справка → О программе.
• 🔐 Права пользователя. Входить в Конфигуратор нужно пользователем с правом «Администрирование» или «Администрирование расширений конфигурации». Обычному бухгалтеру Конфигуратор не откроется.
• 🔓 Состояние основной конфигурации. Если основная конфигурация на поддержке, это не мешает: расширение для того и придумано, чтобы не снимать её с поддержки.
• 🗂 Режим совместимости. У расширения он не может быть выше, чем у основной конфигурации. Посмотреть его можно в свойствах корня основной конфигурации.
• 💾 Резервная копия. Администрирование → Выгрузить информационную базу в файл .dt. Для расширения, которое меняет только формы и печать, это перестраховка. Для расширения с собственными справочниками и регистрами — обязательный шаг.

Кому из пользователей нужны права

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

Загрузка расширения из файла: пошагово

Порядок одинаковый для файловой и клиент-серверной базы.

1. Запустите 1С в режиме Конфигуратора и откройте базу.
2. Если дерево основной конфигурации закрыто, откройте его: Конфигурация → Открыть конфигурацию. Без этого пункт с расширениями будет недоступен.
3. Выберите Конфигурация → Расширения конфигурации. Откроется список расширений.
4. Нажмите Добавить. В списке появится пустое расширение с именем вида Расширение1.
5. Выделите его. В командной панели окна откройте меню Конфигурация и выберите Загрузить конфигурацию из файла....
6. Укажите файл .cfe. Платформа спросит, заменить ли содержимое расширения, — подтвердите.
7. Имя, синоним и префикс подтянутся из файла. Пустое Расширение1 превратится в нужное.
8. Там же, в меню Конфигурация окна расширений, выполните Обновить конфигурацию базы данных. Или откройте дерево расширения и нажмите F7.
9. Если платформа покажет список изменений — нажмите Принять.

Шаг 8 часто пропускают. Загруженное, но не применённое расширение отображается в списке и даже открывается в дереве. В режиме 1С:Предприятия его нет.

Пакетная загрузка из командной строки

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

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F"D:\Bases\Buh" /N"Администратор" /P"пароль" /LoadCfg "D:\cfe\Doprabotki.cfe" -Extension "Доработки" /UpdateDBCfg -Extension "Доработки" /Out "D:\log\cfe.txt"

Для клиент-серверной базы вместо /F укажите /S"сервер\имя_базы". Путь к 1cv8.exe замените на свою версию платформы. Результат смотрите в файле из параметра /Out: при ошибке там будет текст платформы.

Безопасный режим, защита от опасных действий и область действия

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

Чем рискуете, снимая безопасный режим

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

Назначение расширения

В свойствах расширения есть поле «Назначение»:

• 🛠 Исправление — правка ошибок в типовой конфигурации. Применяется раньше остальных.
• 🔧 Адаптация — доработка под учёт конкретной компании.
• ➕ Дополнение — новые возможности: отчёты, обработки, интеграции.

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

Запуск: как убедиться, что расширение работает в клиенте

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

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

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

Роли из расширения

Выдать права на свои объекты расширение может двумя способами:

• Заимствовать роль основной конфигурации и добавить в неё права на свои объекты. Тогда пользователи с этой ролью получат доступ автоматически.
• Создать собственную роль. Её нужно назначить пользователям. В Конфигураторе это делается в Администрирование → Пользователи, на закладке «Прочие» карточки пользователя: там есть и роли расширений.

В типовых конфигурациях на БСП пользователями управляют из режима 1С:Предприятия, через группы доступа. Если роль расширения не появилась в профилях групп доступа, уточните у разработчика, как он задумал выдачу прав.

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

В БП 3.0, ЗУП 3.1, УТ 11 расширение можно подключить и в пользовательском режиме: Администрирование → Печатные формы, отчеты и обработки → Расширения. Там расширение по умолчанию добавляется с включённым безопасным режимом. Этот путь удобен, когда доступа к Конфигуратору нет, а права администратора в программе есть.

Обновление и версии расширений

Разработчик прислал новую версию файла. Есть два способа её поставить.

Способ 1. Полная замена

1. Сохраните текущее расширение в файл — это ваша точка возврата.
2. Выделите расширение в списке и загрузите новый .cfe из файла.
3. Обновите конфигурацию базы данных.

Быстро и надёжно, если вы сами расширение не правили.

Способ 2. Сравнение и объединение

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

Где смотреть версию

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

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

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

Ошибки подключения и отладка кода расширения

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

Отладка модулей расширения

Код расширения отлаживается тем же отладчиком, что и основная конфигурация.

1. Откройте дерево расширения и найдите нужный модуль.
2. Поставьте точку останова (F9) на строке.
3. Запустите Отладка → Начать отладку (F5). Откроется клиент 1С:Предприятия.
4. Выполните действие, которое вызывает этот код. Отладчик остановится на точке.

В клиент-серверной базе для отладки серверного кода на сервере 1С должна быть включена отладка. Это делает администратор сервера; без этого точки останова в серверных процедурах не срабатывают.

Как временно исключить расширение из подозреваемых

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

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