Обновление расширений в 1С: способы и порядок действий
Содержание
Обновить расширение конфигурации
— это загрузить новый файл .cfe поверх старого и отдельной командой применить изменения к базе данных. Два шага, а не один: пока вы не выполнили «Обновить конфигурацию
базы данных», новая версия расширения в работе не появится. Это самая частая причина, по которой «обновил, а ничего не поменялось».
Расширения конфигурации
появились в платформе 8.3.6 и с каждым релизом получали больше возможностей. Механизм не зависит от прикладного решения — порядок обновления расширения в Бухгалтерии, ЗУП, УТ и в самописной базе одинаковый. Ниже — все рабочие способы: через Конфигуратор, прямо в режиме «1С:Предприятие», пакетом из командной строки, в среде 1С:EDT и в облаке 1С:Fresh.
Что нужно сделать до обновления
Расширение может конфликтовать с основной конфигурацией, если её тоже недавно обновляли. Поэтому перед заменой .cfe стоит потратить пять минут на подготовку.
Перед обновлением сделайте резервную копию информационной базы (Администрирование → Выгрузить информационную базу в Конфигураторе или через меню обслуживания). Откат расширения не всегда проходит чисто, а копия базы возвращает всё за одну операцию.
Что проверить заранее:
- 🧩 Откуда взялась новая версия. Файл
.cfeдолжен прийти от разработчика расширения или быть выгружен из эталонной базы. Не редактируйте рабочее расширение «вслепую». - 🔢 Режим совместимости. Откройте свойства расширения и посмотрите значение «Режим совместимости». Оно должно быть не выше версии вашей платформы — иначе расширение не подключится.
- 🏷️ Назначение расширения. «Исправление» (патч), «Дополнение» и «Адаптация» ведут себя по-разному при обновлении типовой конфигурации. Патчи отключаются, когда исправленный объект в типовой меняется.
- 👥 Монопольный доступ. Применение изменений к базе требует, чтобы в ней никто не работал. Сеансы придётся завершить — согласуйте время с пользователями.
Назначение расширения: от него зависит поведение при обновлении
У каждого расширения в свойствах задано назначение. Оно определяет не только то, что расширение умеет менять, но и как оно переживёт обновление основной конфигурации.
| Назначение | Для чего | Что при обновлении типовой |
|---|---|---|
| Исправление (патч) | точечно поправить ошибку в типовом объекте | отключается, если исправленный объект в типовой изменился |
| Дополнение | добавить новую функциональность рядом с типовой | обычно продолжает работать, конфликт маловероятен |
| Адаптация | заметно переделать типовое поведение под компанию | возможен конфликт, если переделанные объекты поменялись |
Знать назначение полезно до обновления: если вы ставите новую версию патча, а типовую недавно обновляли, велика вероятность, что старый патч уже отключён — и новый нужен именно под текущий релиз.
Обновление через Конфигуратор — базовый способ
Это самый надёжный путь: вы видите, что именно меняется, и платформа сама предупреждает о конфликтах.
- Запустите базу в режиме
Конфигуратор. - Откройте меню
Конфигурация → Расширения конфигурации. В списке выберите нужное расширение. - Нажмите
Загрузить конфигурацию из файлаи укажите новый файл.cfe. Платформа заменит содержимое расширения. - Выполните
Конфигурация → Обновить конфигурацию базы данных(горячая клавишаF7). - В окне принятия изменений посмотрите список реорганизуемых объектов и подтвердите.
Если расширение добавляет или меняет реквизиты, платформа предложит реструктуризацию таблиц — это нормально. Дождитесь завершения и запустите базу в режиме «1С:Предприятие» для проверки.
Когда в окне принятия изменений платформа показывает предупреждения о заимствованных объектах или конфликтах с основной конфигурацией, не закрывайте его бездумно. Прочитайте список: именно здесь видно, что расширение не согласовано с текущей версией типовой. Если предупреждений нет и реорганизация прошла — обновление корректно легло на базу.
Хотите сначала сохранить текущую версию расширения на случай отката — выгрузите её в файл командой Сохранить конфигурацию в файл из того же меню. Получите .cfe со старым содержимым.
Отдельно редактировать объекты расширения в Конфигураторе тоже можно: открыть дерево расширения, внести правку и нажать F7. Но при обновлении готовой версии правильнее именно загружать файл целиком — так вы не смешаете чужие изменения со своими.
Обновление в режиме «1С:Предприятие» без Конфигуратора
Начиная с платформы 8.3.11 расширение можно заменить прямо в пользовательском режиме — Конфигуратор не нужен. Это удобно, когда доступа к Конфигуратору нет, а файл .cfe на руках.
Путь к списку расширений в типовых решениях на БСП:
- В главном меню (кнопка со стрелкой в левом верхнем углу) откройте
Функции для технического специалиста. - Выберите пункт
Расширения конфигурации.
Название раздела у некоторых конфигураций может отличаться, но ведёт он к одному и тому же списку расширений. Если пункт не виден, режим технического специалиста включается в настройках программы администратором.
В списке расширений:
- Выделите строку с нужным расширением.
- Нажмите кнопку загрузки файла и укажите новый
.cfe. - Подтвердите перезапуск сеанса — платформа применит расширение при повторном входе.
В этом режиме изменения структуры данных применяются при перезапуске сеанса. Если расширение добавляет реквизиты, фоновое обновление базы всё равно потребует монопольного доступа — делайте это, когда в базе никого нет.
Этот способ закрывает большинство бытовых задач: обновить печатную форму, отчёт или небольшую доработку, которые пришли отдельным файлом.
Пакетное обновление из командной строки
Когда баз много или обновление нужно встроить в скрипт, расширение обновляют в пакетном режиме. Платформа запускается без интерфейса и делает всё по ключам.
Загрузка нового файла расширения:
"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С:Предприятие» под обычным пользователем, а не только администратором.
- Доработка работает. Запустите именно ту операцию, ради которой расширение существует: откройте доработанную печатную форму, сформируйте отчёт, проведите тестовый документ в копии базы.
- Журнал регистрации чист. В
Администрирование → Журнал регистрацииотфильтруйте события по важности «Ошибка» за время после обновления.
Проверочный документ проводите в копии базы или сразу пометьте на удаление: тестовое проведение в рабочей базе создаёт реальные движения.
Если расширение добавляло реквизиты или движения, отдельно убедитесь, что старые данные на месте и новые поля заполняются.
Что чаще всего ломается при обновлении
Ошибки при обновлении расширений почти всегда сводятся к нескольким сценариям. Вот как их распознать и что делать.
Отдельно про монопольный доступ: команда «Обновить конфигурацию базы данных» требует, чтобы в базе никто не работал. Если платформа пишет, что база занята, завершите активные сеансы (в клиент-серверном варианте — через консоль администрирования или Администрирование → Активные пользователи). Делайте это, предупредив людей: их несохранённая работа прервётся.
Частые вопросы
Чем обновление расширения отличается от обновления конфигурации?
.cfe. Вы обновляете только его, не трогая типовую конфигурацию и её поддержку поставщиком.Нужно ли снимать конфигурацию с поддержки, чтобы обновить расширение?
Можно ли обновить расширение, пока в базе работают пользователи?
Как откатить расширение на старую версию?
.cfe со старой версией и примените изменения. Если копии нет — восстановите базу из резервной копии, сделанной до обновления.