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

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

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

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

Подготовка среды и создание файла расширения

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

Для начала работы перейдите в меню Конфигурация и выберите пункт Создать расширение конфигурации. Если этот пункт неактивен, проверьте свойства основной конфигурации: возможно, она сама является расширением или имеет ограничения на модификацию. Система предложит сохранить файл расширения с расширением .cfe. Рекомендуется хранить этот файл в системе контроля версий, например, в Git, отдельно от основной конфигурации.

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

Модификация объектов и работа с формами

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

При добавлении нового реквизита на форму система автоматически создаст связь с объектом метаданных. Если вы добавляете поле в таблицу документа, убедитесь, что тип данных нового реквизита соответствует логике работы документа. Часто разработчики сталкиваются с проблемой, когда новое поле не сохраняется. Это происходит из-за того, что сам реквизит не был добавлен в объект метаданных, а был размещен только на форме.

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

• 🛠️ Добавляйте новые реквизиты в объекты метаданных перед размещением их на формах.
• 👁️ Используйте условное оформление для выделения важных данных на формах.
• 🔒 Проверяйте права доступа к новым полям в ролевой модели безопасности.

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

Подключение обработчиков событий

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

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

Код обработчиков пишется на встроенном языке 1С. Вы имеете доступ к параметрам события, таким как Отказ, Объект или НаборЗаписей. Манипулируя этими параметрами, вы можете отменять стандартные действия или вносить свои коррективы. Например, можно автоматически заполнять новые реквизиты данными из справочников при создании нового элемента.

Процедура СправочникНоменклатураПередЗаписью(Отказ, ТекущийОбъект)
Если ТекущийОбъект.НовыйРеквизит = Неопределено Тогда
ТекущийОбъект.НовыйРеквизит = ПолучитьТекущуюДата();
КонецЕсли;
КонецПроцедуры

Особенности отладки подписок

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

Расширение функционала через общие модули

Для реализации сложной бизнес-логики часто требуется выносить код в общие модули. В расширениях можно создавать свои общие модули или использовать существующие в основной конфигурации. При создании нового общего модуля в расширении необходимо задать область видимости: "Глобальный", "Серверный" или "Клиентский". Это определяет, где именно может быть вызван данный код.

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

При работе с общими модулями важно следить за производительностью. Код, выполняемый на клиенте, не должен содержать тяжелых запросов к базе данных. Все операции с выборкой данных следует переносить на сервер. Платформа 1С автоматически контролирует границу клиент-сервер, но разработчик должен сознательно разделять логику.

Тип модуля	Область выполнения	Пример использования
Общий модуль (Сервер)	Только сервер	Сложные запросы, запись в регистры
Общий модуль (Клиент)	Тонкий клиент	Валидация ввода, работа с интерфейсом
Общий модуль (Глобальный)	Сервер и Клиент	Вспомогательные функции, конвертация типов
Модуль формы	Клиент/Сервер формы	Логика конкретной формы документа

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

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

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

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

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

Диагностика ошибок и отладка

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

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

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

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

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

Влияет ли расширение на скорость обновления типовой конфигурации?

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

Как откатить изменения, внесенные расширением?

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

Можно ли использовать внешние обработки в расширении?

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