Расширение 1С: как сделать и настроить самостоятельно

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

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

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

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

Прежде чем приступить к написанию кода или добавлению реквизитов, необходимо убедиться, что ваша информационная база поддерживает работу с расширениями. Механизм доступен в платформах версии 8.3.10 и выше, однако для полноценной работы в режиме «Тонкий клиент» и веб-клиенте требуются определенные настройки сервера. Если вы работаете в файловом варианте базы, процесс упрощается, но в клиент-серверном варианте администратор должен убедиться, что у пользователей есть права на использование расширений.

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

Для старта откройте вашу базу в режиме 1С:Предприятие. В меню «Администрирование» найдите пункт «Расширения». Если список пуст, система предложит создать новое расширение. Нажмите кнопку «Добавить» и дайте ему понятное имя, например, МоиДоработкиБухгалтерии. Важно сразу определить, будет ли это расширение доступно всем пользователям или только вам, так как это влияет на права доступа.

⚠️ Внимание: При создании расширения в клиент-серверной базе убедитесь, что у вашей учетной записи есть роль «Полные права» или специализированная роль на администрирование расширений. Без этих прав кнопка добавления может быть неактивна.

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

Создание расширения через режим предприятия

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

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

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

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

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

Разработка в конфигураторе: структура и объекты

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

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

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

Процедура ОбработкаПроведения(Источник, Отказ, Режим)
// Здесь код, который выполнится при проведении любого документа
// в рамках подписки на событие
КонецПроцедуры

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

⚠️ Внимание: Никогда не пытайтесь дублировать имена общих модулей из основной конфигурации в расширении. Это приведет к конфликту имен и ошибке загрузки. Используйте префиксы для всех своих объектов.

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

Расширение реквизитов и табличных частей

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

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

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

Характеристика	Основная конфигурация	Расширение конфигурации
Хранение данных	Основные таблицы БД	Отдельные таблицы расширения
Влияние на обновление	Требует слияния кода	Не требует слияния (изолировано)
Доступность	Всем объектам базы	Только при активном расширении
Изменение типа	Возможно (с конвертацией)	Ограничено или невозможно

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

Техническая деталь хранения данных

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

Подписки на события и перехват логики

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

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

Внутри процедуры-обработчика вы получаете ссылку на объект события. Это позволяет читать и менять данные документа перед его записью. Например, можно автоматически заполнять новый реквизит «Ответственный менеджер» на основе группы пользователей, к которой принадлежит текущий сотрудник.

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

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

Управление расширениями и обновление типовых конфигураций

Главное преимущество, ради которого создавались расширения — это бесшовное обновление. Когда фирма «1С» выпускает новый релиз, вы просто загружаете файл обновления (.cfu) в свою базу в режиме конфигуратора. Система обновляет основную конфигурацию, а расширение остается нетронутым.

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

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

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

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

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

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

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

Что произойдет с данными, если удалить расширение?

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

Работают ли расширения в мобильном приложении 1С?

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

Как передать расширение другому разработчику?

Необходимо выгрузить расширение в файл .cfe через меню «Конфигурация» -> «Расширения» -> «Выгрузить расширение». Этот файл можно передать коллеге, и он загрузит его у себя. Для передачи исходного кода внутри команды также удобно использовать системы контроля версий (Git), выгружая расширение как обычный объект конфигурации.

Есть ли ограничения на количество расширений в одной базе?

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