Загрузка файла .cfe в базу: расширение конфигурации от создания до применения

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

Есть и второй путь — без Конфигуратора, из пользовательского режима, через список расширений в разделе администрирования. Он удобнее бухгалтеру, но Конфигуратор даёт больше: видно содержимое расширения, можно проверить его до применения, поменять свойства безопасности и разобрать ошибку. Ниже — порядок для платформы 8.3 (интерфейс «Такси», актуальные версии 8.3.2x). Механизм общий для всех типовых конфигураций: БП 3.0, ЗУП 3.1, УТ 11 и других.

Что подготовить до загрузки .cfe

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

Перед загрузкой проверьте пять вещей:

1. 📁 Формат файла. Нужен файл с расширением .cfe. Файл .cf — это вся конфигурация целиком, .epf и .erf — внешние обработки и отчёты. Их через список расширений не подключают.
2. 🔢 Версия платформы. Расширения появились в 8.3.6, но современные расширения пишут под свежий режим совместимости. Если разработчик собирал его на 8.3.24, а у вас 8.3.18, файл может не загрузиться. Спросите у автора минимальный номер платформы.
3. 🧩 Релиз конфигурации. Расширение заимствует объекты основной конфигурации: документы, формы, модули. Если оно написано под другой релиз БП или ЗУП, какой-то заимствованный объект может не совпасть.
4. 🔑 Права. Нужна роль с административными правами и пароль пользователя для входа в Конфигуратор.
5. 💾 Резервная копия. Перед загрузкой сделайте выгрузку базы в .dt или копию каталога файловой базы. Расширение с ошибкой в обработчиках может мешать проведению документов.

💡 Если расширение пришло архивом с инструкцией, сначала прочтите её. Часто там указан нужный релиз, порядок загрузки нескольких расширений и права, которые нужно выдать пользователям.

Как открыть Конфигуратор и окно со списком расширений

Запустите 1С, в списке баз выделите нужную и нажмите Конфигуратор. Введите пользователя с правами администратора.

Если основная конфигурация ещё не открыта, откройте её: Конфигурация → Открыть конфигурацию. Для работы с расширениями это не обязательно, но так видно дерево основной конфигурации и удобно сверять заимствованные объекты.

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

Конфигурация → Расширения конфигурации

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

Монопольный режим для самой загрузки расширения не нужен. Пользователи могут продолжать работу. Изменения они увидят только после перезапуска сеанса.

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

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

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

• Имя — латиница или кириллица без пробелов, например ПечатьСчетовПоставщика;
• Синоним — понятное название для людей;
• Префикс — добавляется к именам новых объектов, например Расш1_;
• Назначение — Исправление, Адаптация или Дополнение.

На этом шаге можно не стараться: при загрузке файла эти свойства перезапишутся теми, что сохранены в .cfe.

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

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

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

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

Двойной щелчок по строке откроет дерево расширения. Его корень называется по имени расширения. Внутри — заимствованные объекты основной конфигурации (помечены особым значком) и собственные объекты расширения.

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

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

Сделайте окно дерева расширения активным и выполните два действия по очереди:

1. Сохранить расширение — Ctrl+S.
2. Обновить конфигурацию базы данных — F7.

Это отдельные шаги. Сохранение записывает расширение в конфигурацию, а обновление применяет его к базе данных. Без F7 пользователи расширения не получат.

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

Если вместо .cfe прислали папку с XML

Программисты, которые хранят код в Git или EDT, иногда передают расширение не одним файлом, а каталогом с файлами .xml и .bsl. Его тоже можно загрузить: в том же меню Конфигурация окна расширений выберите загрузку конфигурации из файлов и укажите каталог с выгрузкой.

Дальше всё так же: сохранить, затем F7. Если не хочется возиться с каталогом, попросите разработчика сохранить расширение в .cfe — это одна команда в его Конфигураторе, а у вас загрузка станет проще и надёжнее.

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

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

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

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

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

Проверка перед тем, как пустить пользователей

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

Затем проверьте работу вживую:

1. Запустите 1С:Предприятие из Конфигуратора (F5) или обычным входом под пользователем.
2. Откройте ту форму, документ или отчёт, которые меняет расширение.
3. Проведите тестовый документ и посмотрите движения, если расширение касается проведения.
4. Войдите под рядовым пользователем, а не под администратором: так видно, хватает ли ролей.

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

Массовая загрузка из командной строки

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

"C:\Program Files\1cv8\8.3.24.1691\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "пароль" /LoadCfg "D:\Ext\PechatSchetov.cfe" -Extension "ПечатьСчетовПоставщика" /UpdateDBCfg -Extension "ПечатьСчетовПоставщика" /Out "D:\Ext\log.txt"

Подставьте свой путь к платформе, каталог базы (для серверной — /S "сервер\база") и имя расширения. Лог в файле из /Out покажет, загрузилось ли расширение и прошло ли обновление.

Обновление и удаление уже загруженного расширения

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

Сохранить текущую версию себе можно через Конфигурация → Сохранить конфигурацию в файл... в том же окне. Получится .cfe, к которому легко откатиться.

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

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

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

💡 Текст ошибки копируйте целиком, вместе с именем модуля и номером строки. По нему разработчик найдёт причину за минуты, а по фразе «что-то не работает» — нет.

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