Почему функция СвойстваОбъекта в БСП возвращает не все дополнительные реквизиты

При работе с Библиотекой стандартных подсистем (БСП), а именно с подсистемой «Свойства», разработчики часто сталкиваются с ситуацией, когда программный интерфейс ведет себя не совсем так, как ожидается. Типичный пример: при вызове функции СвойстваОбъекта для справочника «Номенклатура» в ERP или УТ 11, массив возвращаемых свойств оказывается неполным. Рассмотрим подробнее, почему это происходит, разберем внутреннюю логику БСП и выясним, как правильно получать список доступных свойств для объектов.

Суть проблемы: ожидание vs реальность

Представим ситуацию в конфигурации 1С:ERP. У нас есть справочник Номенклатура. В системе настроены дополнительные реквизиты:

1. «Реквизит 1» — общий для всего справочника «Номенклатура».
2. «Реквизит 2» — назначен только для определенного «Вида номенклатуры» (например, «Первый вид»).

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

Анализ внутренней логики функции

Для того чтобы понять причину такого поведения, проанализируем фрагмент запроса, который обычно лежит в основе механизмов получения свойств в БСП (модуль УправлениеСвойствами):

ВЫБРАТЬ РАЗРЕШЕННЫЕ
    ТаблицаСвойств.Свойство КАК Свойство,
    ТаблицаСвойств.Значение КАК Значение,
    ТаблицаСвойств.ТекстоваяСтрока,
    ТаблицаСвойств.Ссылка КАК ВладелецСвойств
ИЗ
    [ИмяОбъектаСоСвойствами].ДополнительныеРеквизиты КАК ТаблицаСвойств
    ЛЕВОЕ СОЕДИНЕНИЕ ПланВидовХарактеристик.ДополнительныеРеквизитыИСведения КАК ДополнительныеРеквизитыИСведения
    ПО ДополнительныеРеквизитыИСведения.Ссылка = ТаблицаСвойств.Свойство
ГДЕ
    ТаблицаСвойств.Ссылка В (&ОбъектыСоСвойствами)

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

• Функция СвойстваОбъекта предназначена для чтения уже существующих данных в конкретном экземпляре объекта.
• Если в табличной части объекта физически нет строки с «Реквизитом 2», то запрос его не выберет.
• Если передана пустая ссылка, система не может определить контекст объекта, а значит, не видит связи с конкретным «Видом номенклатуры».

Понятие «Владельца свойств» и наборов

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

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

«Реквизит 2» не является свойством «Номенклатуры» вообще. Он является свойством Набора, который соответствует «Первому виду номенклатуры». Пока объект не связан с этим видом, БСП не считает эти свойства «его» свойствами.

Как получить полный список доступных свойств для нового объекта

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

Рассмотрим шаги для получения всех доступных свойств:

1. Определить наборы свойств: Сначала нужно понять, к каким наборам относится наш объект. Для этого в БСП используется механизм определения владельца наборов. В случае с ERP это часто переопределяемая логика в модуле УправлениеСвойствПереопределяемый.
2. Использовать функцию СвойстваНаборов: Вместо ссылки на объект, нужно передать массив ссылок на Справочник.НаборыДополнительныхРеквизитовИСведения.

Пример программного получения доступных свойств для конкретного вида номенклатуры:

// 1. Получаем набор свойств, соответствующий виду номенклатуры
Наборы = Новый Массив;
Наборы.Добавить(ВидНоменклатуры.НаборСвойств); // В ERP ссылка на набор хранится в виде номенклатуры

// 2. Получаем описание всех свойств этого набора
ОписаниеСвойств = УправлениеСвойствами.СвойстваНаборов(Наборы);

// Теперь в ОписаниеСвойств содержатся метаданные всех реквизитов (и общих, и специфических)
Для Каждого Свойство Из ОписаниеСвойств Цикл
    Сообщить("Доступное свойство: " + Свойство.Заголовок);
КонецЦикла;

Различие между данными и метаданными

Проанализируем ситуацию еще раз, чтобы закрепить понимание. В БСП разделены два понятия:

1. Значения свойств объекта: То, что реально записано в базе в табличной части ДополнительныеРеквизиты. Именно с этим работает СвойстваОбъекта. Если пользователь не заполнил реквизит на форме и он не имеет значения по умолчанию, строки в ТЧ может просто не быть.

2. Доступные свойства типа: Это настройки в справочнике наборов. Они определяют, какие поля должны появиться на форме. Для работы с ними используются функции СвойстваНаборов или специализированные методы из модуля УправлениеСвойствамиСлужебный.

Особенности динамических свойств в ERP и КА

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

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

• УправлениеСвойствами.ЗаполнитьНаборыСвойствОбъекта() — для первичного определения состава наборов.
• Механизмы подсистемы, отвечающие за проверку условий (вычисляемые в контексте текущих данных объекта).

Резюме и рекомендации

Выясним краткие итоги нашего анализа:

• Не используйте СвойстваОбъекта для анализа «пустых» или новых объектов, если вам нужны свойства, зависящие от категории/вида/типа объекта.
• Всегда проверяйте, к какому Набору относится свойство. В 1С:ERP связь между объектом и его свойствами почти всегда идет через посредника (Вид номенклатуры, Вид характеристики, Категория).
• Для получения всех возможных реквизитов используйте функцию СвойстваНаборов, предварительно определив массив ссылок на наборы свойств.
• Помните, что СвойстваОбъекта — это инструмент для чтения значений, а не для проектирования интерфейса.

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