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

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

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

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

Когда расширение подходит, а когда нет

Расширение оправдано, когда нужно: добавить печатную форму или отчёт, изменить форму документа, дописать обработчики событий, добавить роли и подсистемы, переопределить отдельные процедуры модулей через аннотации &ИзменениеИКонтроль, &Вместо, &Перед, &После. Это типовые сценарии адаптации под бизнес-процессы конкретной компании.

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

Маршрут решения

Как выбрать действие

Нужна новая печатная форма, отчёт или небольшая доработка формыИспользуйте расширение — обновления останутся простыми

Требуется глубокая переработка логики учёта и структуры данныхРассмотрите доработку основной конфигурации с частичным снятием с поддержки

Нужен внешний отчёт без изменения объектовДостаточно внешней обработки (*.epf/erf) через «Дополнительные отчеты и обработки»

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

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

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

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

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

Как подключить готовое расширение из файла

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

В режиме Предприятия подключение обычно доступно по пути «НСИ и администрирование → Печатные формы, отчеты и обработки → Расширения» (в разных конфигурациях раздел может называться «Расширения» или находиться в «Администрирование → Обслуживание»). Там же можно временно отключить расширение, не удаляя его, — это удобно при диагностике.

Добавление объектов и изменение кода в расширении

Формы изменяются через заимствование формы объекта и добавление на неё новых элементов, команд и обработчиков. Модули изменяются через аннотации: &Перед и &После выполняют ваш код до или после типовой процедуры, &Вместо полностью подменяет её, &ИзменениеИКонтроль копирует текст типовой процедуры с контролем при обновлении — если вендор изменит оригинал, платформа сообщит о расхождении.

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

Проверка результата и поведение после обновления

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

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

Контрольные точки

Как проверить результат

Статус расширения в списке

Норма

Расширение активно, без пометок о несовместимости

Тревожный признак

Красный маркер или сообщение о несовместимости с конфигурацией

Поведение форм и команд

Норма

Изменения видны пользователям с нужными правами

Тревожный признак

Форма открывается в типовом виде — проверьте обновление БД и перезапуск сеанса

Журнал регистрации

Норма

Нет ошибок при старте и при вызове доработанных процедур

Тревожный признак

Ошибки компиляции модулей расширения или отсутствующие объекты

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

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

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

Можно ли добавить расширение без конфигуратора?

Да, если у вас есть готовый файл .cfe. В режиме Предприятия откройте «НСИ и администрирование → Печатные формы, отчеты и обработки → Расширения» и загрузите файл. Создавать и редактировать расширение без конфигуратора нельзя.

Что произойдёт с расширением при обновлении конфигурации?

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

Почему расширение подключено, но изменений не видно?

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

Можно ли временно отключить расширение без удаления?

Да. В списке расширений (и в конфигураторе, и в режиме Предприятия) снимите флаг активности — расширение перестанет применяться, но останется в базе и его можно включить обратно.

Чем расширение отличается от внешней обработки?

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

Сколько расширений можно подключить к одной базе?

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