Как подключить дополнительные реквизиты к справочнику или документу в БСП

БСП 2.3Опубликовано Обновлено

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

Пошаговое подключение подсистемы «Свойства»

1) В нашем объекте добавляем табличную часть "ДополнительныеРеквизиты", а точнее копируем ее из другого существующего справочника или документа, например, из справочника Пользователи, который изначально находится в составе конфигурации БСП.
2) На форме элемента нашего объекта добавляем группу с наименованием "ГруппаДополнительныеРеквизиты". Именно в этой группе и будет отображаться интерфейс дополнительных реквизитов.
3) В справочнике "НаборыДополнительныхРеквизитовИСведений" добавляем новый предопределенный элемент по шаблону - Справочник_Склады (если наш объект это справочник и называется он "Склады"). То есть смотрим на существующие предопределенные элементы и добавляем необходимый аналогичным образом.
4) В Плане видов характеристик "ДополнительныеРеквизитыИСведения" добавляем тип нашего объекта, если необходим такой тип для создания дополнительных реквизитов.
5) В модуле формы элемента нашего объекта размещаем следующие куски кода:

    В процедуре ПриСозданииНаСервере добавляем:

Пример кода
    // Обработчик подсистемы "Свойства"
    ДополнительныеПараметры = Новый Структура;
    ДополнительныеПараметры.Вставить("Объект", Объект);
    ДополнительныеПараметры.Вставить("ИмяЭлементаДляРазмещения", "ГруппаДополнительныеРеквизиты");
    УправлениеСвойствами.ПриСозданииНаСервере(ЭтотОбъект, ДополнительныеПараметры);

    // Конец СтандартныеПодсистемы.Свойства

    В процедуре ПриЧтенииНаСервере добавляем:

Пример кода
    // СтандартныеПодсистемы.Свойства
    УправлениеСвойствами.ПриЧтенииНаСервере(ЭтаФорма, ТекущийОбъект);   
    // Конец СтандартныеПодсистемы.Свойства    

     В процедуре ОбработкаПроверкиЗаполненияНаСервере добавляем:

Пример кода
    // СтандартныеПодсистемы.Свойства
    УправлениеСвойствами.ОбработкаПроверкиЗаполнения(ЭтаФорма, Отказ, ПроверяемыеРеквизиты, Объект);
    // Конец СтандартныеПодсистемы.Свойства

     В процедуре ПередЗаписьюНаСервере  добавляем:

Пример кода
    // СтандартныеПодсистемы.Свойства
    УправлениеСвойствами.ПередЗаписьюНаСервере(ЭтаФорма, ТекущийОбъект);
    // Конец СтандартныеПодсистемы.Свойства

    Добавляем следующие процедуры:

Пример кода
    // ПРОЦЕДУРЫ ПОДСИСТЕМЫ "СВОЙСТВ"
    &НаКлиенте
    Процедура Подключаемый_РедактироватьСоставСвойств()
        УправлениеСвойствамиКлиент.РедактироватьСоставСвойств(ЭтаФорма, Объект.Ссылка);
    КонецПроцедуры
Пример кода
    &НаСервере
    Процедура ОбновитьЭлементыДополнительныхРеквизитов()
        УправлениеСвойствами.ОбновитьЭлементыДополнительныхРеквизитов(ЭтаФорма, РеквизитФормыВЗначение("Объект"));
    КонецПроцедуры

6) И еще один важный момент: у справочника "НаборыДополнительныхРеквизитовИСведений" есть реквизит "Используется". Для нашего созданного предопределенного элемента (см. пункт 3) необходимо установить значение Истина для этого реквизита. Но в пользовательском режиме 1С:Предприятие это не получится сделать, потому что этого реквизита нет на форме. Но можно воспользоваться стандартной обработкой "Групповое изменение реквизитов", где выбрать справочник "НаборыДополнительныхРеквизитовИСведений", сделать отбор по нашему созданному предопределенному элементу и установить значение Истина для реквизита "Используется". Примечание: если в обработке "Групповое изменение реквизитов" нет для выбора справочника "НаборыДополнительныхРеквизитовИСведений", то необходимо в настройке "Дополнительные параметры" включить галку "Показывать служебные реквизиты".

Актуальность для новых версий

В БСП 3.x подсистема «Свойства» подключается к форме теми же вызовами модуля УправлениеСвойствами. Главное отличие — наборы свойств для новых объектов рекомендуется регистрировать в процедуре ПриПолученииПредопределенныхНаборовСвойств общего модуля УправлениеСвойствамиПереопределяемый, а не только предопределённым элементом справочника. Порядок интеграции для своей версии сверяйте с документацией БСП в составе поставки.

Частые вопросы

Чем дополнительные реквизиты отличаются от дополнительных сведений?

Реквизиты хранятся в табличной части самого объекта и редактируются на его форме. Сведения хранятся в отдельном регистре и не требуют табличной части.

Почему дополнительные реквизиты не появляются на форме?

Чаще всего у набора свойств не установлен признак «Используется» или на форме нет группы, имя которой передано в УправлениеСвойствами.ПриСозданииНаСервере.

Как установить реквизит «Используется», если его нет на форме?

Через обработку «Групповое изменение реквизитов» с включённой настройкой «Показывать служебные реквизиты».

Откуда взять табличную часть ДополнительныеРеквизиты?

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

БСП 2.3

БСП 1С: Библиотека стандартных подсистем для разработчика

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

БСП 2.3

Как подключить контактную информацию к справочнику или документу в БСП

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

БСП 2.3

Как подключить дополнительные сведения к справочнику или документу в БСП

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

Алгоритмы

Какая версия платформы 1С актуальна: 8.3.27 и 8.5 на ноябрь 2026

Какая платформа 1С актуальна в ноябре 2026: линейки 8.3.27 и 8.5, отличия, новое в 8.5.4, как проверить версию и что проверить перед обновлением платформы.