Правка расширения конфигурации в Конфигураторе 1С 8.3: от запуска до сохранения

Чтобы открыть расширение 1С для редактирования, запустите базу в режиме Конфигуратор, выберите в главном меню Конфигурация → Расширения конфигурации и дважды щёлкните по нужному расширению в списке. Откроется отдельное дерево объектов расширения: его модули, формы и макеты можно менять, а изменения применяются клавишей F7.

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

Подготовка: какой режим запуска и какие права нужны

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

Что нужно до начала работы:

• 🔑 пользователь с правом «Администрирование» (в типовых конфигурациях — роль «Полные права»), иначе Конфигуратор не откроется;
• 💾 свежая резервная копия базы, если вы правите рабочую базу, а не копию;
• 🧩 файл .cfe, если расширение ещё не загружено в базу и есть только у разработчика;
• 👥 договорённость с коллегами: два разработчика не могут одновременно редактировать одно расширение без хранилища.

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

Как запустить Конфигуратор

1. Откройте окно запуска 1С:Предприятия.
2. Выделите нужную информационную базу.
3. Нажмите кнопку Конфигуратор справа от списка.
4. Введите имя и пароль администратора.

Для ярлыка или скрипта подойдёт командная строка:

"C:\Program Files\1cv8\8.3.24.1691\bin\1cv8.exe" DESIGNER /F"D:\Bases\Buh" /N"Администратор" /P"пароль"

Для серверной базы вместо /F укажите /S"имя_сервера\имя_базы". Номер версии в пути замените на установленный у вас.

Где найти расширение и как открыть его дерево объектов

Сразу после запуска Конфигуратор показывает пустое окно. Расширения не видны, пока вы не откроете их список.

1. Откройте основную конфигурацию: Конфигурация → Открыть конфигурацию. Это не обязательно для списка, но без неё неудобно заимствовать объекты.
2. Выберите Конфигурация → Расширения конфигурации. Появится окно со списком всех расширений базы.
3. Дважды щёлкните по строке нужного расширения. Откроется второе дерево — с корнем, носящим имя расширения.

Создать новое расширение вместо открытия старого

Если готового расширения нет, в том же окне списка нажмите кнопку добавления. Платформа создаст пустое расширение с именем вида Расширение1 и префиксом Расш1_. Сразу задайте понятные имя, синоним и префикс в свойствах корня: позже их менять неудобно, префикс уже будет в именах процедур.

В свойстве «Назначение» выберите вариант по задаче: «Исправление» — для срочной правки ошибки типовой, «Адаптация» — для доработок под учёт компании, «Дополнение» — для новой функциональности. От назначения зависит порядок, в котором платформа применяет несколько расширений к одному объекту.

Теперь в Конфигураторе два дерева: основная конфигурация и расширение. Переключайтесь между ними через вкладки окон внизу или меню Окна.

Расширения, загруженные пользователями

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

В типовых конфигурациях на БСП пользовательский список находится по пути Администрирование → Печатные формы, отчеты и обработки → Расширения. Оттуда же удобно выгрузить .cfe, если доступа к Конфигуратору у вас пока нет.

Если расширения нет в списке

• 📦 Оно ещё не загружено. Создайте новое расширение кнопкой добавления в окне списка, откройте его и загрузите файл: Конфигурация → Загрузить конфигурацию из файла, выбрав .cfe. Команда применяется к активному дереву, поэтому сначала щёлкните по дереву расширения.
• 🔄 Список не обновился. Закройте окно расширений и откройте снова.
• 🗂 Вы подключились не к той базе. Проверьте путь к базе в строке заголовка Конфигуратора.

Файлы .cfe, .cf и выгрузка в XML: что с чем путают

У расширения свой формат файла, и его часто путают с файлом основной конфигурации.

Не загружайте .cfe в дерево основной конфигурации. Если активным окном было дерево основной конфигурации, Конфигуратор откажет или предложит не то, что вы ждёте. Перед загрузкой всегда щёлкайте по дереву расширения.

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

Пакетная работа из командной строки

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

1cv8.exe DESIGNER /F"D:\Bases\Buh" /N"Администратор" /P"" /LoadCfg "D:\ext\Pechat.cfe" -Extension "Печать" /UpdateDBCfg -Extension "Печать" /Out "D:\ext\log.txt"

Обратная операция — /DumpCfg "файл.cfe" -Extension "Имя". Итог проверяйте по файлу лога из /Out: при ошибке окна с сообщением не будет.

Права доступа, хранилище и монопольный режим

Самая частая причина «не могу редактировать» — не права пользователя, а хранилище конфигурации.

Расширение подключено к хранилищу

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

Порядок такой:

1. Щёлкните по дереву расширения, чтобы оно стало активным.
2. Подключитесь к хранилищу: Конфигурация → Хранилище конфигурации → Подключиться к хранилищу. Если вы уже подключены, этот шаг пропустите.
3. Выделите объект и выберите в контекстном меню захват в хранилище. Чтобы взять всё расширение, захватите корень.
4. После правок поместите изменения в хранилище той же командой контекстного меню.

Нужен ли монопольный режим

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

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

Режимы защиты расширения

В свойствах корня расширения есть флаги «Безопасный режим» и «Защита от опасных действий». Они не мешают редактировать код, но в безопасном режиме расширение не может обращаться к файлам, COM-объектам и внешним компонентам. Если код вроде бы правильный, но падает на работе с файлом, проверьте этот флаг в списке расширений.

Правка модулей, форм и отладка

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

Как добавить объект в расширение

1. В дереве основной конфигурации найдите объект, например форму документа.
2. В контекстном меню выберите Добавить в расширение и укажите нужное расширение.
3. Объект появится в дереве расширения как заимствованный.
4. Откройте модуль объекта или формы в дереве расширения и добавьте обработчик.

Какую аннотацию выбрать

Пример для модуля формы — к заголовку добавляется пометка, что форма доработана:

&НаСервере
&После("ПриСозданииНаСервере")
Процедура Расш1_ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
	Заголовок = Заголовок + " (доработано)";
КонецПроцедуры

Префикс Расш1_ берётся из свойства «Префикс имён» расширения. Если префикс другой, переименуйте процедуру, иначе имена могут столкнуться с процедурами основной конфигурации.

Отладка изменений

Отладка работает так же, как для основной конфигурации:

1. Поставьте точку останова в модуле расширения клавишей F9.
2. Запустите Отладка → Начать отладку (F5). Конфигуратор сам предложит применить изменения.
3. Выполните в открывшемся сеансе действие, которое вызывает ваш обработчик.

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

Применение изменений: обновление и сохранение расширения

Правка в дереве ещё не попадает к пользователям. Изменения нужно применить к базе.

Обновить конфигурацию базы данных

1. Щёлкните по дереву расширения, чтобы команды меню относились к нему.
2. Выполните Конфигурация → Обновить конфигурацию базы данных или нажмите F7.
3. Подтвердите изменения в окне, если Конфигуратор его покажет.

Пользователи увидят новую версию после перезапуска сеанса. Если расширение меняет структуру данных, сработает правило о монопольном доступе из раздела выше.

Сохранить расширение в файл

Для переноса в другую базу или в архив:

1. Активируйте дерево расширения.
2. Выберите Конфигурация → Сохранить конфигурацию в файл.
3. Укажите имя файла с расширением .cfe.

Называйте файлы с датой и коротким описанием: Pechat_2026-10-07_dobavlen_shtrihkod.cfe. Через месяц будет ясно, какая версия рабочая.

После обновления основной конфигурации

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

Что делать:

• 🔍 откройте расширение и выполните проверку синтаксиса;
• 🧾 для &ИзменениеИКонтроль сравните старый и новый исходный текст в окне различий;
• ⚙️ после исправлений снова примените изменения клавишей F7.

Типичные сбои при открытии расширения

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