Разработка и Конфигурация · 10 мин
Как обновить расширение конфигурации 1С через конфигуратор
Пошаговая инструкция по обновлению расширения конфигурации 1С через конфигуратор: загрузка из файла, сравнение, проверка применимости и типичные ошибки.
Расширение конфигурации — механизм платформы 1С:Предприятие, позволяющий добавлять и изменять объекты, формы и код без снятия основной конфигурации с поддержки. Когда выходит новая версия расширения от разработчика или исправляется ошибка в собственной доработке, расширение нужно обновить, не затронув остальные доработки и данные.
Обновление через конфигуратор — самый контролируемый способ: вы видите, какая версия загружена, можете сравнить объекты и проверить применимость до перезапуска сеансов. Ниже разобран полный цикл: от подготовки файла до проверки результата, а также типичные ошибки, из-за которых расширение отключается или перестаёт работать.
Инструкция применима к файловым и клиент-серверным базам на платформе 8.3. Для работы потребуется файл расширения с расширением .cfe и права на администрирование информационной базы.
Что подготовить перед обновлением расширения
Главное правило — до обновления иметь возможность откатиться. Сделайте выгрузку информационной базы через «Администрирование → Выгрузить информационную базу» либо, как минимум, сохраните текущую версию расширения: в списке расширений выделите его и нажмите «Сохранить в файл». Файл .cfe позволит вернуть прежнюю версию за пару минут.
Проверьте, что файл новой версии действительно относится к нужному расширению. У расширения есть имя и значение свойства «Безопасный режим», а также уникальный идентификатор. При загрузке платформа сопоставляет расширение по имени: если в базе уже есть расширение с таким именем, оно будет обновлено; если нет — будет создано новое, и старое останется активным параллельно.
Убедитесь, что версия основной конфигурации совместима с новой версией расширения. Если расширение дорабатывает объекты, которые изменились после обновления самой конфигурации, при проверке применимости появятся ошибки, и расширение будет отключено автоматически.
Как открыть список расширений в конфигураторе
Запустите конфигуратор и откройте нужную информационную базу. В меню выберите «Конфигурация → Расширения конфигурации». Откроется окно со списком всех расширений, подключённых к базе, с колонками: имя, версия, безопасный режим, защита от опасных действий, использование в основных ролях.
Если пункт меню неактивен, сначала откройте конфигурацию («Конфигурация → Открыть конфигурацию»). В файловой базе при активных сеансах пользователей часть операций будет недоступна — об этом ниже.
Обратите внимание на колонку «Активно»: расширение может присутствовать в списке, но быть отключённым из-за ошибок применимости. Перед обновлением полезно зафиксировать текущую версию, чтобы после загрузки убедиться, что она действительно изменилась.
Загрузка новой версии расширения из файла
Выделите в списке обновляемое расширение и нажмите кнопку «Загрузить из файла» (или одноимённый пункт контекстного меню). Укажите путь к файлу .cfe с новой версией. Платформа загрузит содержимое и заменит текущую версию расширения в конфигурации базы данных — пока только в памяти конфигуратора, изменения ещё не применены.
Если имя загружаемого расширения совпадает с существующим, платформа выполнит именно обновление. Если имена отличаются — появится второе расширение, что часто приводит к конфликтам: две версии одной доработки начинают перекрывать объекты друг друга. Поэтому перед загрузкой сверьте имя в файле с именем в списке.
- 1Сделайте выгрузку базы или сохраните текущее расширение в файл .cfe
- 2Откройте конфигуратор и перейдите в «Конфигурация → Расширения конфигурации»
- 3Выделите нужное расширение и нажмите «Загрузить из файла», укажите новый .cfe
- 4Выполните «Обновить конфигурацию базы данных» (F7), при необходимости примите изменения
- 5Перезапустите сеансы пользователей и проверьте работу доработанного функционала
Обновление конфигурации базы данных и проверка применимости
После загрузки файла нажмите F7 или выберите «Конфигурация → Обновить конфигурацию базы данных». Если расширение изменяет структуру данных (добавляет реквизиты, регистры), платформа покажет окно реструктуризации — подтвердите изменения кнопкой «Принять». На больших таблицах реструктуризация может занять заметное время, поэтому выполняйте её вне пиковой нагрузки.
Платформа автоматически проверяет применимость расширения: контролируется, что изменяемые объекты существуют в основной конфигурации и их структура совместима с доработками. Если проверка не пройдена, расширение останется в списке, но будет отключено — в колонке «Активно» появится признак ошибки, а в свойствах — диагностика.
Чтобы посмотреть детали проблемы, откройте свойства расширения двойным щелчком и проверьте сообщения в окне служебных сообщений. Типичная причина — расхождение версий: расширение рассчитано на другой релиз конфигурации, где объект или реквизит называется иначе либо отсутствует.
Как проверить результат
Отображается новая версия, признак «Активно» установлен
Версия старая или расширение отключено с ошибкой применимости
Новые кнопки, формы или алгоритмы работают как заявлено
Изменения не видны — возможно, сеанс не перезапущен или расширение не активно
Нет ошибок, связанных с расширением, после обновления
Ошибки применимости или обращения к отсутствующим объектам
Особенности для клиент-серверных баз и активных сеансов
В файловой базе обновление конфигурации БД потребует монопольного доступа: все пользователи должны завершить работу. Если сеансы активны, платформа сообщит об этом и предложит завершить их принудительно — делайте это осознанно, предупредив сотрудников.
В клиент-серверном варианте монопольный режим не всегда обязателен, но изменения расширения применяются к сеансам только после их перезапуска. Пользователи, продолжающие работать в старых сеансах, будут видеть прежнюю логику до перезахода в программу.
Альтернатива конфигуратору для серверных баз — обновление расширения через «Администрирование → Печатные формы, отчеты и обработки → Расширения» в режиме 1С:Предприятие (если функциональность включена) или через кластер с параметром отключения безопасного режима. Однако конфигуратор даёт больше контроля: сравнение версий, диагностику и возможность сохранить файл.
Сравнение вариантов
Полный контроль: сравнение, диагностика, сохранение версии в файл. Требует доступа к конфигуратору и часто монопольного режима.
Удобно без установки конфигуратора, но меньше диагностики; доступно только если разрешено использование расширений в настройках базы.
Подходит для автоматизации обновления на нескольких базах; требует аккуратной подготовки скриптов и тестирования на копии.
Типичные ошибки при обновлении расширения
Самая частая проблема — загрузка расширения как нового вместо обновления существующего из-за несовпадения имени. В списке появляются два похожих расширения, которые конфликтуют при перекрытии одних и тех же объектов. Решение: удалить лишнее и загрузить файл повторно в нужное расширение.
Вторая распространённая ситуация — расширение загружено, конфигурация БД обновлена, но в режиме предприятия ничего не изменилось. Причины: сеанс не перезапущен, расширение неактивно из-за ошибки применимости, либо у пользователя недостаточно прав на новые объекты — роли расширения нужно добавить в профили доступа.
Третья группа ошибок связана с безопасным режимом и профилями безопасности в клиент-серверном варианте: расширение, выполняющее файловые операции или обращения к внешним ресурсам, может блокироваться. Проверьте флажки «Безопасный режим» и «Защита от опасных действий» в свойствах расширения.
Как откатить обновление, если что-то пошло не так
Если перед обновлением вы сохранили расширение в файл, откат занимает минуты: загрузите старый .cfe тем же способом через «Загрузить из файла» и обновите конфигурацию базы данных. Если делалась выгрузка всей базы, можно восстановить её целиком через «Администрирование → Загрузить информационную базу» — но это вернёт и данные к моменту выгрузки.
Когда новая версия вызывает ошибки, но разбираться с ними некогда, временное решение — снять флажок «Активно» у расширения в списке. Доработки перестанут применяться, а само расширение останется в базе до исправления.
Что важно запомнить
Обновление расширения через конфигуратор — это загрузка файла .cfe в существующее расширение с последующим обновлением конфигурации базы данных. Перед началом сохраните прежнюю версию, после загрузки проверьте применимость и активность, а пользователям дайте перезапустить сеансы.
Частые вопросы
Можно ли обновить расширение без конфигуратора?
Да, если в настройках базы разрешено использование расширений, это делается в режиме 1С:Предприятие через раздел администрирования. Однако диагностика ошибок там ограничена, поэтому для проблемных обновлений конфигуратор предпочтительнее.
Почему после загрузки файла в списке появилось второе расширение?
Имя расширения в файле не совпало с именем существующего. Платформа восприняла загрузку как новое расширение. Удалите дубликат и загрузите файл в исходное расширение, либо переименуйте его заранее.
Расширение обновлено, но пользователи не видят изменений. Что делать?
Проверьте три вещи: активно ли расширение в списке, перезапустили ли пользователи сеанс и есть ли у них права на новые объекты расширения. Чаще всего помогает перезаход в программу.
Что означает «расширение не прошло проверку применимости»?
Платформа обнаружила, что объекты, которые изменяет расширение, отсутствуют или изменились в основной конфигурации — обычно после обновления релиза конфигурации. Расширение автоматически отключается; нужна его адаптация под текущую версию конфигурации.
Нужно ли снимать конфигурацию с поддержки для работы с расширениями?
Нет. В этом и смысл механизма: расширения работают поверх конфигурации на полной поддержке и не мешают её штатному обновлению. Снимать замок поддержки требуется только при прямом изменении основной конфигурации.
Как перенести расширение на другую базу?
Сохраните расширение в файл .cfe через кнопку «Сохранить в файл» в списке расширений, затем на целевой базе загрузите его через «Загрузить из файла» и обновите конфигурацию БД. Убедитесь, что версии основных конфигураций совместимы.