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