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