Обновление расширений конфигурации 1С: из файла, из Конфигуратора и из командной строки

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

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

Что нужно сделать до обновления расширения

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

1. Сделайте копию базы . Файловую базу копируйте целиком (папка с 1Cv8.1CD), серверную выгружайте в .dt через Конфигуратор: Администрирование → Выгрузить информационную базу.
2. Выгрузите текущее расширение в файл. Это ваша точка отката. В списке расширений Конфигуратора выберите его и нажмите Выгрузить в файл.
3. Убедитесь, что в базе никто не работает . Для серверной базы включите блокировку начала сеансов: Администрирование → Поддержка и обслуживание → Блокировка работы пользователей.
4. Проверьте, под какой версией основной конфигурации собран новый .cfe. Её указывает разработчик расширения в описании или имени файла.
5. Откройте базу в режиме Конфигуратора под пользователем с ролью «Администратор» (полные права).

Обновление расширения из файла в режиме 1С:Предприятие

Подходит, если у вас типовая конфигурация на БСП (Бухгалтерия, ЗУП, УТ, ERP) и есть администратор без доступа к Конфигуратору.

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

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

Что означают галочки у расширения

Обновление через Конфигуратор

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

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

Если расширение добавляет реквизиты или справочники, шаг 4 обязателен. Иначе при входе будут ошибки обращения к полям, которых ещё нет в таблицах.

Обновление в файловой базе

В файловом варианте базу открывает одна программа, нужен монопольный доступ. Закройте всех пользователей и проверьте, что в папке с базой нет файла 1Cv8.cdn: он остаётся, пока сеанс не закрыт.

Шаги те же, что выше. Особенности:

• 🔒 Монопольный режим включается автоматически при входе в Конфигуратор.
• 📁 Копия базы — простое копирование папки. Занимает минуты.
• ⚡ Откат — подмена папки на копию. Выгружать .dt необязательно.

Обновление в клиент-серверной базе

Здесь надо следить за тем, что работает на сервере.

1. Заблокируйте сеансы в консоли администрирования серверов 1С или в самой базе.
2. Завершите все сеансы, включая фоновые задания и сеансы обмена.
3. Загрузите расширение и обновите конфигурацию БД.
4. Снимите блокировку.

Расширения лежат в самой информационной базе, а не на диске сервера. Обновлять файл на сервере не нужно: достаточно загрузить его через Конфигуратор или БСП.

Обновление из командной строки и по расписанию

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

"C:\Program Files\1cv8\8.3.24.1445\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Админ" /P "пароль" ^
 /LoadCfg "D:\Ext\МоёРасширение.cfe" -Extension "МоёРасширение" ^
 /UpdateDBCfg -Extension "МоёРасширение" ^
 /DisableStartupDialogs /Out "D:\Logs\ext.log"

Для серверной базы вместо /F укажите /S "сервер\имя_базы". Пароль в самом скрипте хранить не стоит: берите его из защищённой переменной или файла с ограниченными правами.

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

• 📄 В файле лога из /Out нет слов «Ошибка» и «Не удалось».
• 🔢 Версия расширения в списке изменилась.
• 🖥️ База открывается обычным пользователем.

Версии и совместимость расширения

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

Порядок проверки:

1. Откройте карточку расширения. Посмотрите версию и поле «Режим совместимости».
2. Сравните с версией основной конфигурации: Справка → О программе.
3. Если разработчик расширения выпустил новую сборку под ваш релиз, ставьте её.
4. Если сборки нет, а расширение критично, отключите его (Активно = снят) и сообщите разработчику.

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

Для сверки номеров релизов используйте таблицу выше: она обновляется автоматически.

Веб-клиент и тонкий клиент

Расширения хранятся в базе, поэтому и тонкий, и веб-клиент берут их оттуда. Но поведение после обновления отличается.

Если после обновления пользователи видят старые формы, очистите кэш клиентских данных 1С. Папки кэша лежат в профиле: %LOCALAPPDATA%\1C\1cv8 и %APPDATA%\1C\1cv8. Закройте 1С и удалите в них папки с длинными именами-идентификаторами. Либо запустите клиент с параметром /ClearCache.

Для веб-сервера (Apache или IIS) после смены расширения публикацию перезапускать не требуется, если файл default.vrd не менялся.

Проверка расширения после обновления

Не ограничивайтесь тем, что база открылась.

Права пользователей на расширение

Часто расширение «обновилось», но у пользователей нет нужных кнопок или отчётов. Причина — права.

Если расширение добавило новые роли, они появляются в Администрирование → Настройки пользователей и прав → Группы доступа (в простых базах — через профиль пользователя). Присвойте роль нужным группам. Можно найти её по названию расширения в списке профилей.

Новые объекты расширения (справочники, отчёты, команды) не видны, пока:

• роль не включена в профиль доступа;
• пользователь не перезапустил сеанс;
• объект не добавлен в панель действий или в «Мои команды» (настройка интерфейса ).

Что делать, если обновление не прошло

Не угадывайте причину: сначала найдите текст ошибки.

Как откатить расширение на прежнюю версию

Если новая сборка сломала проведение или формы, вернуть старую можно за несколько минут. Для этого и нужна выгрузка, сделанная до обновления.

1. Заблокируйте вход пользователей, как при обычном обновлении.
2. Откройте Конфигурация → Расширения конфигурации в Конфигураторе.
3. Загрузите сохранённый старый .cfe поверх текущего.
4. Выполните обновление конфигурации БД для расширения.
5. Перезапустите сеансы и проверьте тестовый документ.

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

Частые ошибки и как их избежать

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

Как не ломать расширения при каждом релизе

Заведите короткий регламент и держите его рядом с инструкцией по релизам.

1. Перед обновлением основной конфигурации: список всех расширений с версиями.
2. После обновления: запрос новых сборок у разработчиков.
3. Сначала тестовая копия, потом рабочая база.
4. Хранение всех выгрузок .cfe по папкам с датой.
5. Запись в журнал: кто, когда и какую версию загрузил.

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