Как обновить расширения конфигурации 1С

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

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

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

Когда расширение требует обновления

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

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

Подготовка: резервная копия и анализ ошибок

Перед любыми манипуляциями с расширениями создайте резервную копию информационной базы. Для файловой базы достаточно выгрузки через «Администрирование — Выгрузить информационную базу» в конфигураторе; для клиент-серверной — штатными средствами СУБД. Без копии откатить неудачное применение расширения будет затруднительно, особенно если оно изменяет данные.

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

Обновление расширения из файла .cfe

Если разработчик расширения выпустил новую версию, обновление выполняется заменой файла. Порядок действий в конфигураторе: откройте «Конфигурация — Расширения конфигурации», выделите нужное расширение, нажмите кнопку «Заменить» (или удалите старое и добавьте новое через «Добавить»), укажите файл .cfe. После загрузки платформа выполнит проверку применимости.

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

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

Исправление ошибок совместимости вручную

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

Типовые проблемы и способы их устранения:

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

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

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

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

Где выполнять обновление

Конфигуратор

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

Режим «Предприятие»

Только загрузка готового .cfe, включение и отключение. Подходит для простых случаев и экстренного отключения

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

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

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

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

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

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

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

Статус расширения в списке

Норма

Флажок «Активно» установлен, ошибок применимости нет

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

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

Работа доработанных объектов

Норма

Формы открываются, печатные формы формируются корректно

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

Ошибки при открытии форм, пустые или некорректные печатные формы

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

Норма

Нет новых ошибок, связанных с объектами расширения

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

Повторяющиеся ошибки в фоновых заданиях или обработчиках

Типичные ошибки и как их избежать

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

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

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

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

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

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

Что произойдёт с данными, если удалить расширение?

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

Почему расширение активно, но доработки не видны пользователям?

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

Как временно отключить расширение, если база не запускается?

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

Нужно ли обновлять расширения при обновлении платформы 1С?

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

Чем расширение лучше прямой доработки конфигурации?

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