Расширение конфигурации 1С: что это такое и как работает

Что такое расширение 1С

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

История механизма по вехам:

• 2015, версия 8.3.6.1977 — базовый механизм расширений.
• Версия 8.3.10 — добавлено свойство «назначение», разграничившее типы по роли.
• К 2025 году — появились функциональные блоки для структурирования расширений в крупных прикладных решениях.

По данным опроса специалистов, опубликованного IBS на Хабре, расширениями активно пользуются около 50% 1С-разработчиков; 25% имели негативный опыт при обновлениях; ещё 25% с механизмом не знакомы. Архитектурные правила работы с расширениями регламентирует стандарт 1С:ИТС.

Виды расширений по назначению

Свойство «назначение» появилось в версии платформы 8.3.10 и управляет очерёдностью применения расширений. Порядок фиксированный: Исправление → Адаптация → Дополнение. Внутри одного назначения приоритет определяется позицией расширения в списке — новое встаёт в конец своего сегмента. Встроенного контроля соответствия назначению нет: ответственность лежит на разработчике.

Исправление, Адаптация и Дополнение — назначения и порядок применения

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

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

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

Создание и подключение расширения 1С

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

Файл .erf — передача расширения без конфигуратора

.erf (Extension Release File) — формат экспорта готового расширения из конфигуратора. Главное преимущество: клиент устанавливает файл самостоятельно без открытия конфигуратора. Путь: Все функции → Стандартные → Управление расширениями конфигурации. Там же просматривается полный список установленных расширений.

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

Режимы расширения кода: аннотации

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

&Вместо и &ИзменениеИКонтроль — ключевые различия

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

&ИзменениеИКонтроль работает иначе: выполняется только первое расширение в списке; остальные получают уведомление в правом нижнем углу интерфейса. ПродолжитьВызов() поднимается сквозь цепочку расширений до исходного кода конфигурации.

Ограничения расширений 1С

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

Нельзя также создать подчинённую подсистему. Безопасный режим включается по умолчанию при добавлении нового расширения.

В файловой версии безопасный режим снимается вручную. В серверной — через профили безопасности кластера.

Преимущества и риски расширений 1С

По данным аналитики IBS на Хабре, обновление 1С:Розница 2 с десятками расширений заняло два месяца работы целого отдела. Стандарт 1С:ИТС рекомендует расширения прежде всего для 1С:Бухгалтерии, 1С:ЗУП и 1С:Торговли; в крупных системах уровня 1С:Розница 2 — с осторожностью.

Расширение 1С в облаке и реальные примеры применения

В 1С:Фреш конфигуратор недоступен. Файл расширения .erf загружается через «Управление расширениями конфигурации» в режиме разделения данных — оптимальный инструмент для мультиарендных облачных проектов.

Три готовых тиражных решения, реализованных как расширение конфигурации 1С:

• Диадок (SKB Kontur) — расширение для электронного документооборота (ЭДО): скачать с сайта вендора и подключить через «Управление расширениями конфигурации».
• СБИС — интеграционное расширение для обмена данными между системами.
• ЭПД (электронные первичные документы) — готовое расширение для работы с электронными подписями и первичными документами.

Хотите разобраться в разработке на 1С глубже — с нуля и с официальным документом? В рамках федерального проекта «Активные меры содействия занятости» доступно бесплатное обучение по IT-направлениям, в том числе программирование в 1С. Смотрите каталог доступных программ.

Часто задаваемые вопросы

Что такое расширение конфигурации 1С?

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

Чем Адаптация отличается от Дополнения в расширении 1С?

Адаптация — постоянные доработки логики под конкретного клиента; назначение по умолчанию при создании; применяется второй. Дополнение — новая функциональность (отчёты, интеграции) с минимальным влиянием на существующий код; применяется последним. Платформа не контролирует правильность выбранного назначения.

В чём разница между &Вместо и &ИзменениеИКонтроль?

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

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

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

Как установить расширение в 1С:Фреш?

В 1С:Фреш конфигуратор недоступен. Файл .erf загружается через интерфейс: Все функции → Стандартные → Управление расширениями конфигурации. Расширения работают в режиме разделения данных — штатный путь для облачных проектов.

Какие объекты нельзя создать в расширении 1С?

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

Почему серверный код расширения не выполняется?

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

Что такое файл .erf и как передать расширение клиенту?

.erf (Extension Release File) — формат экспорта расширения из конфигуратора. Клиент устанавливает его через «Управление расширениями конфигурации» без запуска конфигуратора. В лицензионных поставках .erf может входить в состав программного пакета.

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

Жёсткого ограничения нет. При 5+ расширениях обновление заметно усложняется, при 20+ трудоёмкость возрастает кратно. По данным IBS, обновление 1С:Розница 2 с десятками расширений заняло два месяца работы целого отдела.

Как выбрать назначение расширения — Исправление, Адаптация или Дополнение?

Исправление — для временных патчей с перспективой удаления. Адаптация — для постоянных доработок под клиента. Дополнение — для новой независимой функциональности. Стандарт 1С:ИТС регламентирует правила выбора и архитектурные ограничения.