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