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

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

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

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

Когда расширение подходит, а когда нужна доработка конфигурации

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

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

Подготовка: что проверить перед созданием расширения

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

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

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

Создание расширения в конфигураторе: пошагово

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

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

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

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

Доработка форм и модулей: заимствование и аннотации

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

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

Пример дополнения обработчика проведения документа:

&После("ОбработкаПроведения")
Процедура Преф_ОбработкаПроведения(Отказ, РежимПроведения)
// собственная логика: проверки, записи в регистры
КонецПроцедуры

&После("ОбработкаПроведения")
Процедура Преф_ОбработкаПроведения(Отказ, РежимПроведения)
    Если Отказ Тогда
        Возврат;
    КонецЕсли;
    // собственная логика
КонецПроцедуры

Подключение расширения в режиме предприятия

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

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

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

Типичные ошибки и ограничения механизма

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

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

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

Обновление конфигурации при подключённых расширениях

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

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

Частые вопросы о расширениях 1С