К статье
Практический материал

Администрирование · 10 мин

Как обновить расширение в 1С

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

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

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

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

Подготовка к обновлению: что проверить заранее

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

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

Третий шаг — сделать выгрузку информационной базы (Администрирование → Выгрузить информационную базу в конфигураторе) или штатную резервную копию средствами СУБД для клиент-серверного варианта. Это страховка на случай, если обновление пройдёт некорректно.

Обновление расширения через конфигуратор

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

Выделите нужное расширение и нажмите кнопку «Загрузить из файла» (иконка со стрелкой) или используйте команду контекстного меню. Укажите путь к файлу новой версии .cfe. Платформа загрузит расширение и заменит текущую версию, сохранив имя и настройки безопасного режима.

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

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

Обновление расширения в режиме предприятия

Если у вас нет доступа к конфигуратору (например, работа ведётся через веб-клиент или права ограничены), обновление можно выполнить в режиме предприятия. Перейдите в раздел «Администрирование → Печатные формы, отчеты и обработки → Расширения конфигурации» (в разных конфигурациях путь может отличаться, например «НСИ и администрирование → Расширения»).

В списке расширений выделите нужное и нажмите «Загрузить из файла», выбрав новую версию .cfe. Платформа заменит расширение. В некоторых конфигурациях для загрузки расширений требуется отключить защиту от опасных действий и иметь роль администратора.

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

Обновление расширения после обновления конфигурации

Частая ситуация: вы обновили основную конфигурацию (например, «1С:Бухгалтерию» или «Управление торговлей»), и подключённые расширения перестали работать или платформа сообщает о несовместимости. Это происходит потому, что расширение ссылается на объекты конфигурации, которые были переименованы, изменены или удалены в новом релизе.

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

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

Маршрут решения

Как выбрать действие

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

Проверка результата после обновления

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

Проверьте журнал регистрации (Администрирование → Журнал регистрации) на наличие ошибок, связанных с расширением. Ошибки вида «Метод объекта не обнаружен» или «Поле объекта не обнаружено» — признак несовместимости версий.

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

Контрольные точки

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

Версия в списке расширений
Норма

Совпадает с версией загруженного файла

Тревожный признак

Осталась старая версия — загрузка не применилась

Запуск режима предприятия
Норма

База открывается без ошибок

Тревожный признак

Ошибки при запуске, ссылки на расширение в тексте ошибки

Работа изменённых форм и отчётов
Норма

Функции расширения доступны и выполняются

Тревожный признак

Кнопки пропали, отчёты падают с ошибкой

Журнал регистрации
Норма

Нет новых ошибок после обновления

Тревожный признак

Ошибки «Метод не обнаружен», «Поле не обнаружено»

Типичные ошибки и их решение

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

Ошибка «Нарушение прав доступа» при загрузке в режиме предприятия означает, что у пользователя нет права «Администрирование расширений конфигурации». Нужно выдать право или выполнить обновление под администратором.

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

Типичные ошибки
01
Обновление без резервной копии — при сбое откатить изменения будет нечем
02
Загрузка старого файла вместо нового — проверяйте версию и дату файла .cfe перед загрузкой
03
Игнорирование обновления конфигурации базы данных — расширение с новыми объектами не заработает
04
Обновление в рабочее время на продуктивной базе — пользователи получат ошибки и сбои сеансов
05
Забытый флаг активности — расширение загружено, но не работает

Особенности обновления в клиент-серверном варианте и в облаке

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

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

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

Храните все версии файлов .cfe в отдельной папке с указанием версии и даты в имени файла. Если новая версия окажется нерабочей, вы сможете быстро откатиться, загрузив предыдущий файл — это займёт пару минут вместо долгого восстановления из копии базы.
ПЗ
Практическое замечание

Часто задаваемые вопросы

Можно ли обновить расширение без конфигуратора?

Да, если расширение не добавляет собственные объекты с данными. Используйте режим предприятия: раздел «Администрирование → Расширения конфигурации», кнопка «Загрузить из файла». Потребуются права администратора и, возможно, отключение защиты от опасных действий.

Что делать, если после обновления 1С не запускается?

Запустите конфигуратор, откройте список расширений и отключите проблемное расширение (снимите флаг активности) или удалите его. Затем восстановите предыдущую версию из сохранённого файла .cfe или вернитесь к резервной копии базы.

Пропадут ли данные при обновлении расширения?

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

Как узнать, какая версия расширения установлена?

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

Почему расширение перестало работать после обновления конфигурации?

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

Можно ли откатить расширение на предыдущую версию?

Да, если у вас сохранился файл .cfe предыдущей версии — просто загрузите его поверх текущей тем же способом. Если файла нет, восстановление возможно только из резервной копии базы, сделанной до обновления.

Итог

Что важно запомнить

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