Получение дополнительных реквизитов в запросе 1С

Устали копаться в таблицах? Узнайте простой способ достать дополнительные реквизиты 1С прямо в запрос для красивых отчётов с колонками.

Бесплатная консультация юриста

+7 (800) 302-87-29

Реклама jurik.ru

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

Где хранятся дополнительные реквизиты

Существует два основных механизма хранения дополнительной информации:

  • Дополнительные реквизиты — хранятся в табличной части самого объекта (например, Справочник.Номенклатура.ДополнительныеРеквизиты). Табличная часть содержит поля Свойство (ссылка на план видов характеристик «ДополнительныеРеквизитыИСведения») и Значение.
  • Дополнительные сведения — хранятся в регистре сведений ДополнительныеСведения с измерением «Объект» и ресурсом «Значение».

В этой статье мы сосредоточимся на первом варианте — дополнительных реквизитах табличной части.

Простой запрос к табличной части

Самый простой способ — обратиться к табличной части справочника напрямую в запросе:

ВЫБРАТЬ
	НоменклатураДополнительныеРеквизиты.Ссылка КАК Номенклатура,
	НоменклатураДополнительныеРеквизиты.Свойство КАК Свойство,
	НоменклатураДополнительныеРеквизиты.Значение КАК Значение
ИЗ
	Справочник.Номенклатура.ДополнительныеРеквизиты КАК НоменклатураДополнительныеРеквизиты
ГДЕ
	НоменклатураДополнительныеРеквизиты.Ссылка = &Ссылка

Такой запрос вернёт все дополнительные реквизиты конкретного элемента справочника.

Получение конкретного реквизита по имени

Если нужно получить значение одного конкретного реквизита, сначала находим ссылку на свойство по наименованию, а затем передаём её в запрос параметром:

Свойство = ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения
	.НайтиПоНаименованию("ИмяРеквизита", Истина);

Запрос = Новый Запрос;
Запрос.Текст =
	"ВЫБРАТЬ
	|	НоменклатураДополнительныеРеквизиты.Значение КАК Реквизит
	|ИЗ
	|	Справочник.Номенклатура.ДополнительныеРеквизиты КАК НоменклатураДополнительныеРеквизиты
	|ГДЕ
	|	НоменклатураДополнительныеРеквизиты.Ссылка = &Ссылка
	|	И НоменклатураДополнительныеРеквизиты.Свойство = &Свойство";

Запрос.УстановитьПараметр("Ссылка", НоменклатураСсылка);
Запрос.УстановитьПараметр("Свойство", Свойство);

Результат = Запрос.Выполнить.Выбрать;
Если Результат.Следующий Тогда
	ЗначениеРеквизита = Результат.Реквизит;
КонецЕсли;

Частая задача — вывести номенклатуру и несколько её дополнительных реквизитов в отдельных колонках. Для этого используют левые соединения табличной части с разными условиями по свойству:

ВЫБРАТЬ
	Номенклатура.Ссылка КАК Номенклатура,
	Цвет.Значение КАК Цвет,
	Размер.Значение КАК Размер
ИЗ
	Справочник.Номенклатура КАК Номенклатура
		ЛЕВОЕ СОЕДИНЕНИЕ Справочник.Номенклатура.ДополнительныеРеквизиты КАК Цвет
		ПО Номенклатура.Ссылка = Цвет.Ссылка
			И Цвет.Свойство = &СвойствоЦвет
		ЛЕВОЕ СОЕДИНЕНИЕ Справочник.Номенклатура.ДополнительныеРеквизиты КАК Размер
		ПО Номенклатура.Ссылка = Размер.Ссылка
			И Размер.Свойство = &СвойствоРазмер

Ссылки на свойства (&СвойствоЦвет, &СвойствоРазмер) заранее получают через НайтиПоНаименованию плана видов характеристик и передают параметрами.

Использование в СКД

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

Рекомендации и типичные ошибки

  • Ищите свойство не только по наименованию, но и проверяйте, что оно найдено, иначе запрос вернёт пустой результат без ошибки.
  • Помните, что поле Значение имеет составной тип — при необходимости приводите его функцией ВЫРАЗИТЬ.
  • Для больших выборок избегайте обхода табличной части в цикле с запросом внутри, используйте один запрос с соединениями.
  • Не путайте дополнительные реквизиты (табличная часть) и дополнительные сведения (регистр сведений) — это разные механизмы.

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