Как создать расширение конфигурации 1С: Полное руководство

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

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

Подготовка окружения и выбор режима работы

Перед началом разработки необходимо убедиться, что ваша информационная база поддерживает работу с расширениями. Данная функциональность доступна в технологической версии платформы 8.3.10 и выше, однако полноценная поддержка для большинства типовых конфигураций (Бухгалтерия предприятия, Управление торговлей, ЗУП) реализована в релизах начиная с 3.0. Для работы вам потребуется запустить 1С:Предприятие в режиме «Конфигуратор».

Важно проверить свойство самой конфигурации. Откройте окно свойств основной конфигурации и убедитесь, что параметр Расширяемая установлен в значение Истина. Если конфигурация не является расширяемой, создать надстройку стандартным способом не получится, и придется рассматривать альтернативные варианты, такие как внешние обработки или модификация самой конфигурации.

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

⚠️ Внимание: Если вы работаете в многопользовательском режиме, создание расширения может потребовать монопольного доступа к базе данных. Рекомендуется выполнять первоначальную настройку в однопользовательском режиме или в нерабочее время.

Пошаговое создание нового расширения

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

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

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

• 📂 Нажмите правой кнопкой на ветку «Расширения» и выберите создание нового элемента.
• ✍️ Введите уникальное имя расширения латиницей или кириллицей без спецсимволов.
• 🔧 Укажите синоним, который будет виден пользователям в интерфейсе.
• 💾 Сохраните конфигурацию и обновите базу данных для применения изменений.

Добавление реквизитов и изменение форм

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

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

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

Действие	Доступно в расширении	Ограничения
Добавление реквизита	Да	Нельзя менять тип существующего
Изменение формы	Да	Нельзя удалять элементы основной формы
Написание кода	Да	Модуль расширения выполняется после основного
Изменение состава подчиненных	Частично	Зависит от типа объекта метаданных

Что происходит с данными при обновлении расширения?

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

Работа с программным кодом и событиями

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

Важно понимать порядок вызова процедур. Сначала выполняется код основной конфигурации, затем — код расширения. Это позволяет вам корректировать результаты работы типового кода. Например, если типовая процедура устанавливает значение поля в Ложь, вы можете в расширении переопределить это значение на Истина после выполнения основного кода.

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

⚠️ Внимание: При переопределении процедур будьте осторожны с контекстом выполнения. Глобальные переменные основной конфигурации могут быть недоступны или иметь другое значение в момент выполнения кода расширения.

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

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

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

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

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

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

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

Производительность системы может снизиться при использовании большого количества расширений или неоптимизированного кода в них. Каждое расширение добавляет уровень абстракции при обращении к метаданным. Рекомендуется consolidровать доработки в одно расширение вместо создания десятка мелких модулей для разных задач.

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

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

Можно ли удалить расширение после его создания?

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

Совместимы ли расширения с работой в веб-клиенте и мобильных приложениях?

Да, расширения полностью поддерживают работу в тонком и веб-клиенте. Однако для мобильных приложений (1С:Предприятие для iOS/Android) поддержка расширений может быть ограничена и требует проверки совместимости конкретного функционала в документации платформы.

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

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

Можно ли продавать расширения как отдельный продукт?

Технически вы можете выгрузить расширение в файл .cfe и распространять его. Однако для коммерческого распространения необходимо учитывать лицензионную политику фирмы «1С» и права на распространение доработок для конкретных типовых конфигураций.

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

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