1С: дополнительные реквизиты справочника — где хранятся и как их найти

Дополнительные реквизиты в типовых конфигурациях 1С (УТ, ERP, КА, БП и других на базе БСП) — это не обычные поля объекта, а значения, которые хранятся в отдельной структуре данных. Поэтому простой запрос к таблице справочника их не покажет, и это часто вводит в заблуждение как пользователей, так и начинающих разработчиков.

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

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

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

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

Второй уровень — наборы свойств. Справочник «НаборыДополнительныхРеквизитовИСведений» определяет, какие реквизиты доступны для конкретного вида объектов: например, для справочника «Номенклатура» один набор, для «Контрагентов» — другой. Именно поэтому в карточке товара и в карточке контрагента отображаются разные дополнительные поля.

Третий уровень — сами значения. Они хранятся не в общей таблице, а в табличной части «ДополнительныеРеквизиты» каждого конкретного элемента справочника или документа. Каждая строка содержит ссылку на свойство (ПВХ) и значение произвольного типа.

Где физически хранятся значения реквизитов

На уровне СУБД табличная часть «ДополнительныеРеквизиты» — это отдельная таблица, связанная с основной таблицей справочника по ссылке на объект. Например, для справочника «Номенклатура» структура выглядит так: основная таблица номенклатуры плюс таблица табличной части с полями «Ссылка», «Свойство», «Значение» и служебным полем текстового представления значения.

Важное следствие: один элемент справочника может иметь сколько угодно значений реквизитов, и каждое значение — отдельная строка. Поле «Значение» имеет составной тип, поэтому в нём могут лежать строки, числа, даты и ссылки. При хранении ссылочных значений в базе сохраняется именно ссылка, а не текст.

Если свойство имеет тип «Дополнительное значение», то сами варианты значений хранятся в справочнике «ЗначенияСвойствОбъектов» (в новых версиях БСП — «ЗначенияСвойствОбъектовИерархия»). Это отдельный справочник, подчинённый плану видов характеристик.

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

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

Дополнительное сведение хранится в независимом регистре сведений «ДополнительныеСведения» с измерениями «Объект» и «Свойство» и ресурсом «Значение». Сведения показываются по кнопке «Ещё — Дополнительные сведения» и не входят в структуру самого объекта.

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

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

Чтобы получить значения, нужно обращаться к табличной части объекта и соединять её с планом видов характеристик для получения имени свойства. Типовой запрос выглядит так:

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

Обратите внимание: отбор по конкретному реквизиту делается по ссылке на элемент ПВХ, а не по его названию. Чтобы получить ссылку по имени, сначала найдите свойство: «ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения.НайтиПоРеквизиту» или поиск по заголовку/имени.

Поле «Значение» имеет составной тип, поэтому сравнение и сортировка по нему в запросе работают с ограничениями. Для строковых представлений у табличной части есть поле «ЗначениеСтрокой» (в ряде версий БСП — «ТекстоваяСтрока»), но надёжнее работать с типизированным значением.

Свойство = ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения.НайтиПоНаименованию("Цвет корпуса");
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Таб.Ссылка, Таб.Значение ИЗ Справочник.Номенклатура.ДополнительныеРеквизиты КАК Таб ГДЕ Таб.Свойство = &Свойство";
Запрос.УстановитьПараметр("Свойство", Свойство);
Выборка = Запрос.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
	Сообщить(Строка(Выборка.Ссылка) + " — " + Строка(Выборка.Значение));
КонецЦикла;

Как прочитать и записать реквизит программно

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

В БСП есть готовые процедуры модуля «УправлениеСвойствами» (в старых версиях — «УправлениеСвойствамиСлужебный»), которые упрощают чтение значений без ручной работы с табличной частью. Использовать их предпочтительнее: они учитывают особенности версии библиотеки.

1. 1
   Найдите ссылку на свойство в ПВХ «ДополнительныеРеквизитыИСведения» по имени или заголовку
2. 2
   Получите объект справочника методом ПолучитьОбъект()
3. 3
   Найдите строку в табличной части ДополнительныеРеквизиты по свойству; если нет — добавьте новую
4. 4
   Установите поле Значение нужным значением подходящего типа
5. 5
   Запишите объект и проверьте результат через форму элемента или запрос

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

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

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

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

Типичные ошибки и ограничения

Самая распространённая ошибка — искать значения реквизитов в основной таблице справочника. Внешний вид поля на форме обманчив: оно выглядит как обычный реквизит, но физически лежит в табличной части. Вторая частая ошибка — сравнивать свойство по строковому имени в запросе вместо ссылки на ПВХ: при переименовании реквизита такой запрос перестаёт работать.

Ещё одна проблема — дубли свойств. Если реквизит создавался несколько раз (например, при загрузке из разных источников), в ПВХ появляются несколько элементов с одинаковым заголовком, и значения оказываются размазаны по разным свойствам. Лечится объединением дублей с переносом значений на одно свойство.

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

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