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

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

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

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

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

Проверьте заранее:

• 📄 Формат файла. Расширение поставляется как .cfe. Если вам прислали .cf, это целая конфигурация, а не расширение, и грузить её так же нельзя.
• 🧩 Назначение. Выясните у автора, для какой конфигурации и какого релиза сделано расширение. Если разработчик указал минимальную версию платформы, сверьтесь с ней: номер вашей платформы должен быть не ниже указанного.
• 💾 Копия базы. Сделайте выгрузку в .dt (Администрирование → Выгрузить информационную базу в Конфигураторе) и сохраните её отдельно.
• 👥 Доступ. Нужна учётная запись с правом администратора, иначе пункт «Расширения конфигурации » в Конфигураторе будет недоступен.
• 🧪 Тестовая база. Сначала загрузите расширение в копию, потом в рабочую.

Загрузка расширения через Конфигуратор

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

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

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

Шаг 2. Добавьте и загрузите файл

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

Шаг 3. Проверьте признаки

В окне списка у расширения есть флажки и свойства. Для запуска важен флажок Активно: если он снят, расширение лежит в базе, но не работает . Остальные флажки разберём в следующем разделе.

Шаг 4. Примените изменения

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

Конфигуратор закройте. Следующий шаг делается уже в пользовательском режиме.

Запуск расширения в режиме Предприятия

Загруженное расширение подхватывается при следующем старте клиента. Уже открытые сеансы продолжают работать без него.

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

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

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

Запуск под отдельным пользователем

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

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

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

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

Практический порядок для чужого расширения:

1. Загрузить в тестовую копию.
2. Оставить включёнными безопасный режим и защиту.
3. Походить по сценариям, ради которых оно нужно.
4. Если что-то не работает из-за запретов, обсудить с автором, зачем нужны эти права. Не снимайте защиту «чтобы заработало».

Права доступа к самим данным настраиваются отдельно, через роли и профили пользователей. Безопасный режим эти роли не заменяет.

Расширение не запускается: диагностика

Если после перезапуска ничего не изменилось, идите по цепочке от простого к сложному.

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

Как читать текст ошибки

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

Веб-клиент, тонкий клиент и мобильный доступ

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

Что отличается:

• 🌐 Веб-клиент. Часть возможностей платформы в браузере недоступна (работа с файлами, внешние компоненты, некоторые обращения к оборудованию). Если расширение опирается на них, в браузере оно может работать неполностью или выдавать ошибку.
• 🖥️ Тонкий клиент. Поддерживает максимум возможностей, подходит для проверки.
• 📱 Мобильный доступ. Через браузер или мобильный клиент к опубликованной базе действуют ограничения, как у веб-клиента, и дополнительно удобство форм: слишком широкие формы расширения на телефоне читаются плохо.
• 🔄 Публикация. Если вы работаете через веб-сервер, после загрузки расширения полезно обновить страницу с полной очисткой кэша браузера. Сервер подхватывает расширение, но клиент может показывать устаревшую форму.

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

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

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

1. В Конфигураторе откройте Конфигурация → Расширения конфигурации.
2. Снимите флажок Активно, перезапустите клиент и проверьте работу базы.
3. Если всё в порядке, удалите расширение из списка.
4. Обновите конфигурацию базы данных, если расширение добавляло реквизиты или объекты.

Не удаляйте расширение сразу. Сначала отключите, поработайте день-два и убедитесь, что ничего не сломалось: данные, которые ссылались на объекты расширения, могут стать недоступны.

Загрузка из командной строки для нескольких баз

Когда расширение нужно поставить в десяток баз, ходить в Конфигуратор каждой неудобно. Платформа умеет загружать расширение пакетно, запуском 1cv8 в режиме DESIGNER.

Схема команды:

"C:\Program Files\1cv8\<версия>\bin\1cv8.exe" DESIGNER /F "D:\Bases\Test" /N "Администратор" /LoadCfg "D:\Ext\MyExt.cfe" -Extension "МоёРасширение" /UpdateDBCfg -Extension "МоёРасширение" /Out "D:\Ext\log.txt"

Что здесь важно:

• /F — путь к файловой базе, для серверной используют /S и имя сервера с базой.
• -Extension — имя расширения. Если такого нет в базе, оно создаётся при загрузке.
• /UpdateDBCfg — применяет изменения к структуре базы, аналог F7.
• /Out — файл журнала, в нём видно причину, если загрузка не прошла.

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

Что проверить после запуска

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

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

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

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