Как изменить расширение конфигурации в 1С 8.3

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

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

Ниже разобраны практические шаги: как открыть расширение на изменение, какие доработки доступны, как обновить базу данных, как перенести расширение между базами и что делать при ошибках совместимости.

Что такое расширение и когда его нужно изменять

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

Изменение расширения не затрагивает типовую конфигурацию — все правки живут внутри самого расширения. Это главное преимущество механизма: обновление релиза поставщика не затирает ваши доработки, хотя и может потребовать их адаптации.

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

Подготовка: резервная копия и проверка текущего состояния

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

Дополнительно выгрузите само расширение в файл: в списке расширений нажмите «Сохранить в файл» и укажите имя с датой, например Dorabotka_2026.cfe. Это позволит быстро откатиться к прежней версии, загрузив файл обратно.

Проверьте текущее состояние: откройте список расширений и убедитесь, что нужное расширение активно (флажок установлен) и в колонке «Применимость» нет предупреждений. Если расширение уже помечено как несовместимое, сначала устраните причину, иначе правки будут вноситься в нерабочий объект.

Как открыть расширение на изменение в конфигураторе

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

1. 1
   Откройте конфигуратор с правами администратора
2. 2
   Перейдите в меню «Конфигурация — Расширения конфигурации»
3. 3
   Выделите нужное расширение и откройте его двойным щелчком
4. 4
   Дождитесь загрузки дерева объектов расширения
5. 5
   Внесите правки и сохраните (Ctrl+S)
6. 6
   Обновите конфигурацию базы данных клавишей F7

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

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

Какие изменения можно вносить в расширение

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

Изменение форм

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

Изменение модулей и обработчиков

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

&ИзменениеИКонтроль("ПриЗаписи")
Процедура Расш1_ПриЗаписи(Отказ, РежимЗаписи, РежимПроведения)
	// ПродолжитьВызов() выполняет типовой код
	ПродолжитьВызов(Отказ, РежимЗаписи, РежимПроведения);
	// Ваша доработка после типовой логики
КонецПроцедуры

Добавление собственных объектов

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

Обновление конфигурации базы данных и проверка применимости

После сохранения правок нажмите F7 («Обновить конфигурацию базы данных») или выберите соответствующий пункт в меню «Конфигурация». Если изменения затрагивают только модули и формы, обновление пройдёт быстро. Если добавлены собственные объекты с данными — потребуется реструктуризация, и пользователям придётся выйти из базы.

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

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

Перенос изменённого расширения в другую базу

Типовой сценарий: доработка выполняется и тестируется на копии, затем переносится в рабочую базу. Для этого в списке расширений нажмите «Сохранить в файл» — получится файл с расширением .cfe. В целевой базе откройте список расширений, выберите «Загрузить из файла» и укажите сохранённый файл.

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

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

Типичные ошибки при изменении расширений

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

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

Когда расширение не подходит и нужны другие инструменты

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

Частые вопросы