Как добавить расширение конфигурации в 1С: инструкция с примерами и советами

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

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

Материал будет полезен как администраторам, так и разработчикам, которые хотят избежать конфликтов при обновлении конфигураций или нуждаются в гибком способе кастомизации типовых решений. Все инструкции приведены с учётом последних изменений в платформе 1С:Предприятие 8.3.23+, но подходят и для более ранних версий (начиная с 8.3.8, где механизм расширений был впервые внедрён).

1. Подготовка к добавлению расширения

Перед тем как подключать расширение, необходимо убедиться, что ваша конфигурация и платформа 1С:Предприятие поддерживают этот функционал. Механизм расширений доступен начиная с версии платформы 8.3.8, но некоторые возможности (например, расширения для управляемых форм) появились позже. Проверить версию платформы можно в окне запуска 1С или через меню Справка → О программе.

Также важно учитывать режим запуска конфигурации:

• 🔧 Конфигуратор: здесь выполняются все настройки расширений.
• 🖥️ 1С:Предприятие: в этом режиме расширения только применяются (их нельзя редактировать).

Если вы работаете с управляемым приложением, убедитесь, что у вас есть права на изменение конфигурации (обычно требуется роль Администратор или Полные права).

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

2. Способы добавления расширения в конфигурацию

В 1С:Предприятие 8.3 существует два основных способа подключения расширений:

1. Через конфигуратор — стандартный метод для администраторов.
2. Программно — для автоматизации (например, при развёртывании на нескольких базах).

Рассмотрим оба варианта подробно.

2.1. Добавление через конфигуратор

Это самый распространённый способ. Инструкция подходит для большинства типовых конфигураций (Бухгалтерия 3.0, УТ 11, ЗУП 3.1 и др.).

1. Откройте базу в режиме Конфигуратор (для этого при запуске 1С выберите нужную базу и удерживайте клавишу Shift).
2. Перейдите в меню Файл → Открыть... и выберите файл расширения (.cfe или .epf).
3. В окне Расширения конфигурации нажмите Добавить и укажите путь к файлу.
4. После добавления нажмите Применить расширения (или Обновить конфигурацию базы данных, если требуется).

📌 Файл расширения соответствует версии конфигурации

📌 Сделан бэкап информационной базы

📌 В конфигураторе нет незавершённых изменений

📌 Пользователи отключены от базы (для файлового варианта)

-->

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

2.2. Программное добавление расширения

Для автоматизации подключения расширений (например, при массовом развёртывании) можно использовать встроенный язык 1С. Ниже приведён пример кода для добавления расширения из файла:

// Подключение расширения программно
Расширения = Конфигуратор.РасширенияКонфигурации;
НовоеРасширение = Расширения.Добавить();
НовоеРасширение.Имя = "МоёРасширение";
НовоеРасширение.ЗагрузитьИзФайла("C:\Extensions\my_extension.cfe");
НовоеРасширение.Применить();

Этот метод удобен для администраторов, которые управляют несколькими базами, или для разработчиков, внедряющих расширения в автоматизированных системах (например, через CI/CD). Однако программное подключение требует прав на модификацию конфигурации и может быть заблокировано настройками безопасности.

3. Настройка параметров расширения

После добавления расширения в конфигуратор его необходимо настроить перед применением. Основные параметры, на которые стоит обратить внимание:

• 📛 Имя расширения: должно быть уникальным в пределах конфигурации (рекомендуется использовать префиксы, например, Ext_Зарплата_2026).
• 🔗 Связь с базовой конфигурацией: указывает, какие объекты будут модифицированы.
• 🔒 Права доступа: определяет, какие роли могут использовать расширение.
• 📅 Версия: полезно для отслеживания изменений (особенно если расширение обновляется).

Для просмотра и редактирования параметров:

1. В конфигураторе откройте ветку Расширения в дереве объектов.
2. Дважды кликните по нужному расширению.
3. В окне свойств настройте параметры (см. таблицу ниже).

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

4. Применение расширения и обновление конфигурации

После настройки параметров расширение нужно применить к базе данных. Этот процесс может занять от нескольких секунд до минут — в зависимости от размера расширения и объёма изменений.

Алгоритм применения:

1. В конфигураторе нажмите Конфигурация → Применить расширения.
2. Если требуется, выполните Обновление конфигурации базы данных (меню Конфигурация → Обновить конфигурацию БД).
3. Для расширений, изменяющих структуру данных (добавляющих реквизиты), может потребоваться реструктуризация таблиц.
4. Перезапустите 1С:Предприятие в режиме пользователя и проверьте работоспособность.

Если при применении возникают ошибки, проверьте:

• 🔍 Совместимость версий: расширение может быть предназначено для другой версии конфигурации.
• 🔄 Конфликты объектов: если расширение модифицирует объект, который уже изменён в базовой конфигурации.
• 🔑 Права доступа: у текущего пользователя может не хватать прав на изменение конфигурации.

5. Проверка работоспособности расширения

Чтобы убедиться, что расширение работает корректно, выполните следующие шаги:

1. Визуальный осмотр:
   • 👁️ Проверьте, появились ли новые пункты меню, кнопки или реквизиты (если они заявлены в расширении).
   • 📊 Откройте формы документов/справочников, которые должны быть модифицированы.

// Пример отладки обработчика в расширении
Процедура ПриЗаписи(Отказ, РежимЗаписи) Экспорт
ЗаписьЖурналаРегистрации(НСтр("ru = 'Отработка ПриЗаписи в расширении'"), УровеньЖурналаРегистрации.Информация);
// Ваш код здесь
КонецПроцедуры

// Добавляем новый реквизит в форму документа
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
ЭлементыФормы.Добавить("НовыйРеквизит",
Тип("ПолеФормы"),
ЭтотОбъект.РеквизитФормыВЗначение("НовыйРеквизит"));
КонецПроцедуры