В современных конфигурациях 1С (Управление торговлей, ERP, Бухгалтерия и другие) широко используется механизм дополнительных реквизитов и сведений. Он позволяет пользователю в режиме «Предприятие» добавлять собственные характеристики к объектам (например, к номенклатуре, контрагентам, партнёрам), не изменяя конфигурацию. Однако у начинающих разработчиков часто возникает вопрос: как получить значения этих реквизитов в запросе, например, для вывода в отчёт отдельными колонками. Разберём этот вопрос подробно.
Где хранятся дополнительные реквизиты
Существует два основных механизма хранения дополнительной информации:
- Дополнительные реквизиты — хранятся в табличной части самого объекта (например, Справочник.Номенклатура.ДополнительныеРеквизиты). Табличная часть содержит поля Свойство (ссылка на план видов характеристик «ДополнительныеРеквизитыИСведения») и Значение.
- Дополнительные сведения — хранятся в регистре сведений ДополнительныеСведения с измерением «Объект» и ресурсом «Значение».
В этой статье мы сосредоточимся на первом варианте — дополнительных реквизитах табличной части.
Простой запрос к табличной части
Самый простой способ — обратиться к табличной части справочника напрямую в запросе:
ВЫБРАТЬ НоменклатураДополнительныеРеквизиты.Ссылка КАК Номенклатура, НоменклатураДополнительныеРеквизиты.Свойство КАК Свойство, НоменклатураДополнительныеРеквизиты.Значение КАК Значение ИЗ Справочник.Номенклатура.ДополнительныеРеквизиты КАК НоменклатураДополнительныеРеквизиты ГДЕ НоменклатураДополнительныеРеквизиты.Ссылка = &Ссылка
Такой запрос вернёт все дополнительные реквизиты конкретного элемента справочника.
Получение конкретного реквизита по имени
Если нужно получить значение одного конкретного реквизита, сначала находим ссылку на свойство по наименованию, а затем передаём её в запрос параметром:
Свойство = ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения
.НайтиПоНаименованию("ИмяРеквизита", Истина);
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| НоменклатураДополнительныеРеквизиты.Значение КАК Реквизит
|ИЗ
| Справочник.Номенклатура.ДополнительныеРеквизиты КАК НоменклатураДополнительныеРеквизиты
|ГДЕ
| НоменклатураДополнительныеРеквизиты.Ссылка = &Ссылка
| И НоменклатураДополнительныеРеквизиты.Свойство = &Свойство";
Запрос.УстановитьПараметр("Ссылка", НоменклатураСсылка);
Запрос.УстановитьПараметр("Свойство", Свойство);
Результат = Запрос.Выполнить.Выбрать;
Если Результат.Следующий Тогда
ЗначениеРеквизита = Результат.Реквизит;
КонецЕсли;
Частая задача — вывести номенклатуру и несколько её дополнительных реквизитов в отдельных колонках. Для этого используют левые соединения табличной части с разными условиями по свойству:
ВЫБРАТЬ Номенклатура.Ссылка КАК Номенклатура, Цвет.Значение КАК Цвет, Размер.Значение КАК Размер ИЗ Справочник.Номенклатура КАК Номенклатура ЛЕВОЕ СОЕДИНЕНИЕ Справочник.Номенклатура.ДополнительныеРеквизиты КАК Цвет ПО Номенклатура.Ссылка = Цвет.Ссылка И Цвет.Свойство = &СвойствоЦвет ЛЕВОЕ СОЕДИНЕНИЕ Справочник.Номенклатура.ДополнительныеРеквизиты КАК Размер ПО Номенклатура.Ссылка = Размер.Ссылка И Размер.Свойство = &СвойствоРазмер
Ссылки на свойства (&СвойствоЦвет, &СвойствоРазмер) заранее получают через НайтиПоНаименованию плана видов характеристик и передают параметрами.
Использование в СКД
В отчётах на СКД (система компоновки данных) дополнительные реквизиты часто доступны автоматически — платформа и типовые конфигурации добавляют их в наборы данных. Если же запрос пишется вручную, применяется тот же подход с левыми соединениями, описанный выше. Также в типовых конфигурациях есть программный интерфейс БСП — модуль УправлениеСвойствами (или ДополнительныеРеквизитыИСведения в зависимости от версии).
Рекомендации и типичные ошибки
- Ищите свойство не только по наименованию, но и проверяйте, что оно найдено, иначе запрос вернёт пустой результат без ошибки.
- Помните, что поле Значение имеет составной тип — при необходимости приводите его функцией ВЫРАЗИТЬ.
- Для больших выборок избегайте обхода табличной части в цикле с запросом внутри, используйте один запрос с соединениями.
- Не путайте дополнительные реквизиты (табличная часть) и дополнительные сведения (регистр сведений) — это разные механизмы.
Получение дополнительных реквизитов справочника в запросе — стандартная задача, решаемая обращением к табличной части объекта с отбором по свойству. Для отчётов удобнее всего использовать левые соединения с параметрами-свойствами, что позволяет вывести каждый реквизит в отдельной колонке одним запросом, без циклов и лишних обращений к базе данных.