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

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

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

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

Подготовка окружения и запуск Конфигуратора

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

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

⚠️ Внимание: Если пункт меню «Расширение конфигурации» неактивен или отсутствует, проверьте версию платформы 1С. Механизм расширений доступен начиная с версии 8.3.10, однако полная функциональность раскрывается в более свежих релизах (8.3.13 и выше).

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

Настройка свойств и параметров расширения

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

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

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

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

Добавление новых полей и реквизитов

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

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

• 📄 Типы данных: поддерживаются все стандартные типы 1С, включая составные типы, ссылки на объекты и перечисления.
• 🔗 Связи: новые реквизиты можно использовать в запросах, отчетах и печатных формах наравне с обычными полями.
• 🖥️ Интерфейс: для отображения нового поля на форме элемента необходимо добавить его в панель формы через редактор форм.

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

Особенности хранения данных в расширениях

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

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

Модификация форм и интерфейсов пользователя

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

Редактор форм в контексте расширения позволяет манипулировать свойствами элементов основной формы. Например, вы можете установить свойство Видимость для стандартной кнопки в Ложь, тем самым убрав её из интерфейса. Также доступно создание новых команд, которые будут запускать код, написанный в модуле расширения.

Элемент интерфейса	Действие в расширении	Результат
Кнопка «Провести»	Скрытие (Видимость = Ложь)	Кнопка исчезает из формы документа
Поле «Комментарий»	Добавление нового поля рядом	Появляется дополнительное поле ввода
Панель навигации	Добавление новой ссылки	Новый пункт в меню раздела
Табличное поле	Добавление колонки	Отображение доп. реквизита в списке

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

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

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

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

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

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

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

Установка, обновление и удаление расширений

После завершения разработки расширение необходимо выгрузить в файл для последующей установки на рабочие места пользователей или сервер. В режиме Конфигуратора выберите пункт меню Конфигурация -> Расширение конфигурации -> Выгрузить расширение. Файл будет сохранен с расширением .cfu или .cfe в зависимости от настроек.

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

• 🚀 Автоматическое обновление: при загрузке новой версии расширения пользователи получат уведомление о необходимости перезагрузки сеанса.
• 🔒 Безопасный режим: расширения могут работать в защищенном режиме, ограничивая доступ к файловой системе.
• 🗑️ Удаление: при удалении расширения система предложит сохранить или удалить данные, добавленные через него.

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

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

Что происходит при конфликте версий?

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

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

Можно ли изменить стандартный отчет 1С с помощью расширения?

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

Влияет ли использование расширений на скорость работы базы?

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

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

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

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

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

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

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