Обновление расширений в 1С: способы и порядок действий

· 9 мин

Содержание

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

Расширения конфигурации появились в платформе 8.3.6 и с каждым релизом получали больше возможностей. Механизм не зависит от прикладного решения — порядок обновления расширения в Бухгалтерии, ЗУП, УТ и в самописной базе одинаковый. Ниже — все рабочие способы: через Конфигуратор, прямо в режиме «1С:Предприятие», пакетом из командной строки, в среде 1С:EDT и в облаке 1С:Fresh.

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

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

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

Что проверить заранее:

  • 🧩 Откуда взялась новая версия. Файл .cfe должен прийти от разработчика расширения или быть выгружен из эталонной базы. Не редактируйте рабочее расширение «вслепую».
  • 🔢 Режим совместимости. Откройте свойства расширения и посмотрите значение «Режим совместимости». Оно должно быть не выше версии вашей платформы — иначе расширение не подключится.
  • 🏷️ Назначение расширения. «Исправление» (патч), «Дополнение» и «Адаптация» ведут себя по-разному при обновлении типовой конфигурации. Патчи отключаются, когда исправленный объект в типовой меняется.
  • 👥 Монопольный доступ. Применение изменений к базе требует, чтобы в ней никто не работал. Сеансы придётся завершить — согласуйте время с пользователями.
Перед обновлением расширения
Выполнено: 0 / 5

Назначение расширения: от него зависит поведение при обновлении

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

НазначениеДля чегоЧто при обновлении типовой
Исправление (патч)точечно поправить ошибку в типовом объектеотключается, если исправленный объект в типовой изменился
Дополнениедобавить новую функциональность рядом с типовойобычно продолжает работать, конфликт маловероятен
Адаптациязаметно переделать типовое поведение под компаниювозможен конфликт, если переделанные объекты поменялись

Знать назначение полезно до обновления: если вы ставите новую версию патча, а типовую недавно обновляли, велика вероятность, что старый патч уже отключён — и новый нужен именно под текущий релиз.

Обновление через Конфигуратор — базовый способ

Это самый надёжный путь: вы видите, что именно меняется, и платформа сама предупреждает о конфликтах.

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

Если расширение добавляет или меняет реквизиты, платформа предложит реструктуризацию таблиц — это нормально. Дождитесь завершения и запустите базу в режиме «1С:Предприятие» для проверки.

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

Хотите сначала сохранить текущую версию расширения на случай отката — выгрузите её в файл командой Сохранить конфигурацию в файл из того же меню. Получите .cfe со старым содержимым.

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

Обновление в режиме «1С:Предприятие» без Конфигуратора

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

Путь к списку расширений в типовых решениях на БСП:

  • В главном меню (кнопка со стрелкой в левом верхнем углу) откройте Функции для технического специалиста.
  • Выберите пункт Расширения конфигурации.

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

В списке расширений:

  1. Выделите строку с нужным расширением.
  2. Нажмите кнопку загрузки файла и укажите новый .cfe.
  3. Подтвердите перезапуск сеанса — платформа применит расширение при повторном входе.

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

Этот способ закрывает большинство бытовых задач: обновить печатную форму, отчёт или небольшую доработку, которые пришли отдельным файлом.

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

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

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

"C:\Program Files\1cv8\8.3.XX.XXXX\bin\1cv8.exe" DESIGNER ^
  /F "C:\bases\mybase" /N "Администратор" /P "пароль" ^
  /LoadCfg "C:\ext\MyExtension.cfe" -Extension "ИмяРасширения"

Применение изменений к базе данных:

"C:\Program Files\1cv8\8.3.XX.XXXX\bin\1cv8.exe" DESIGNER ^
  /F "C:\bases\mybase" /N "Администратор" /P "пароль" ^
  /UpdateDBCfg -Extension "ИмяРасширения"

Разберём параметры:

КлючЧто делает
DESIGNERзапуск в режиме Конфигуратора без интерфейса
/F или /Sпуть к файловой базе (/F) или адрес серверной (/S)
/N /Pимя и пароль пользователя с правами администратора
/LoadCfgзагрузить конфигурацию из файла
-Extensionимя расширения, к которому относится операция
/UpdateDBCfgприменить изменения к структуре базы

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

Для серверной базы вместо /F используют ключ /S с адресом вида сервер\имя_базы. Две команды — загрузку и применение — обычно запускают подряд одним скриптом: сначала .cfe ложится в расширение, затем изменения уходят в структуру базы. Если у вас десятки баз, такой скрипт перебирает их списком и обновляет расширение в каждой без ручных кликов — ради этого пакетный режим и существует.

Запускайте пакетные команды от имени пользователя, у которого есть полные права. Код завершения процесса 0 означает успех; ненулевой — смотрите файл журнала, его путь можно задать ключом /Out.

Разработка и выгрузка расширения в 1С:EDT

1С:EDT — среда разработки на базе Eclipse. В ней расширение не «обновляют» в чужой базе, а ведут как проект: правят, тестируют и выгружают готовый файл .cfe, который потом применяют одним из способов выше.

Порядок для разработчика короткий:

  • Внесите изменения в проект расширения в 1С:EDT.
  • Экспортируйте расширение в файл .cfe через меню экспорта конфигурации.
  • Передайте файл администратору или загрузите в базу сами — через Конфигуратор, режим «Предприятие» или командную строку.

Отдельного механизма «обновить расширение в рабочей базе прямо из EDT» для промышленной эксплуатации нет: EDT — инструмент разработки, а установка в боевую базу идёт штатными средствами платформы. Поэтому если задача — просто обновить готовое расширение, EDT вам не нужен, достаточно файла .cfe.

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

Обновление расширений в облаке 1С:Fresh

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

Если провайдер разрешил абонентам управлять расширениями, порядок тот же, что в режиме «1С:Предприятие»: через Функции для технического специалиста → Расширения конфигурации замените файл .cfe. Изменения применятся при перезапуске сеанса.

Когда загрузка расширений в вашем тарифе закрыта, вариантов два:

  • обратиться к провайдеру сервиса (менеджеру) с файлом .cfe и просьбой обновить расширение;
  • проверить в личном кабинете сервиса раздел управления приложением — у части провайдеров есть форма загрузки расширений для администратора абонента.

В облаке действуют ограничения безопасного режима. Расширение с кодом, который выполняет «опасные» действия (работа с файлами, запуск внешних компонент), в 1С:Fresh без разрешения провайдера не подключится.

Как проверить расширение после обновления

Обновление без проверки — половина работы. После применения файла пройдитесь по короткому списку.

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

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

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

Что чаще всего ломается при обновлении

Ошибки при обновлении расширений почти всегда сводятся к нескольким сценариям. Вот как их распознать и что делать.

Диагностика: выберите симптом

Отдельно про монопольный доступ: команда «Обновить конфигурацию базы данных» требует, чтобы в базе никто не работал. Если платформа пишет, что база занята, завершите активные сеансы (в клиент-серверном варианте — через консоль администрирования или Администрирование → Активные пользователи). Делайте это, предупредив людей: их несохранённая работа прервётся.

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

Чем обновление расширения отличается от обновления конфигурации?
Расширение — это отдельный слой поверх основной конфигурации, со своим файлом .cfe. Вы обновляете только его, не трогая типовую конфигурацию и её поддержку поставщиком.
Нужно ли снимать конфигурацию с поддержки, чтобы обновить расширение?
Нет. Расширения для того и придуманы, чтобы дорабатывать типовое решение, не снимая его с поддержки и не мешая будущим обновлениям от вендора.
Можно ли обновить расширение, пока в базе работают пользователи?
Сам файл загрузить можно, но применение изменений к структуре базы требует монопольного доступа. Если расширение меняет данные, сеансы придётся завершить.
Как откатить расширение на старую версию?
Загрузите обратно сохранённый ранее файл .cfe со старой версией и примените изменения. Если копии нет — восстановите базу из резервной копии, сделанной до обновления.
Почему после обновления типовой конфигурации расширение перестало работать?
Чаще всего менялись объекты, которые расширение дорабатывало. Патчи-исправления отключаются автоматически, адаптации могут дать конфликт. Нужна версия расширения под новую типовую.