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

Разработка в платформе 1С:Предприятие 8.3 часто требует расширения стандартного функционала без изменения конфигурации на уровне метаданных. Механизм дополнительных реквизитов и сведений (ДРС) является штатным и наиболее гибким инструментом для решения этой задачи. Однако, когда дело доходит до программного доступа к этим данным, у разработчиков возникают сложности с синтаксисом и методами получения значений.

В отличие от обычных реквизитов, которые доступны через точку (например, Справочник.Номенклатура.Артикул), данные ДРС хранятся в специализированных регистрах сведений. Это означает, что для их извлечения в коде необходимо использовать специальные методы объектов или формировать сложные запросы. Понимание внутренней архитектуры хранения этих данных критически важно для написания производительного кода.

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

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

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

Такая архитектура позволяет добавлять неограниченное количество полей к любому объекту без перестройки таблиц СУБД. Однако это накладывает отпечаток на производительность. Прямое обращение к реквизиту через свойство объекта может вызывать скрытый запрос к регистру, что при обработке больших выборок в цикле приведет к значительному замедлению работы программы.

⚠️ Внимание: Прямой доступ к дополнительным реквизитам в цикле по большой выборке объектов является одной из самых частых причин падения производительности в 1С. Всегда старайтесь использовать выборку данных единым запросом.

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

Получение значения через методы объекта

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

Рассмотрим пример кода на встроенном языке. Допустим, у нас есть справочник "Номенклатура", к которому добавлен реквизит "ВесБрутто". Чтобы получить его значение, мы можем написать следующий код:

ЭлементСправочника = Справочники.Номенклатура.НайтиПоКоду("00001");
ЗначениеВеса = ЭлементСправочника.ВесБрутто;
Сообщить("Вес товара: " + ЗначениеВеса);

Важно отметить, что такой способ работает только если дополнительный реквизит имеет тип "Строка", "Число", "Дата" или булево значение. Если в качестве типа выбрано перечисление или другой сложный тип, могут возникнуть нюансы приведения типов. Также стоит помнить, что платформа автоматически подгружает значение из регистра при первом обращении.

• 🔹 Простота использования: не требует знания структуры регистров.
• 🔹 Автоматическое кэширование: платформа оптимизирует повторные обращения.
• 🔹 Ограниченная функциональность: сложно получить историю изменений или период действия.
• 🔹 Риск производительности: опасно использовать внутри циклов с большой итерацией.

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

Использование объекта ДополнительныеРеквизитыСведений

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

Чтобы получить значение с помощью этого объекта, необходимо сначала получить ссылку на сам объект дополнительных сведений. Это делается через метод ПолучитьДополнительныеРеквизиты() у объекта-владельца. Затем мы обращаемся к нужному реквизиту через коллекцию.

Объект = Справочники.Контрагенты.НайтиПоНаименованию("ООО Ромашка");
ДопРеквизиты = Объект.ПолучитьДополнительныеРеквизиты();
ИННДоп = ДопРеквизиты["ДополнительныйИНН"];

Преимущество данного подхода заключается в возможности указать дату актуальности данных. Вы можете запросить значение реквизита на конкретную дату в прошлом, что критически важно для корректного формирования регламентированной отчетности. Метод Получить() позволяет передать дату вторым параметром.

⚠️ Внимание: Убедитесь, что для вида дополнительных сведений включено ведение истории, иначе запрос значения на прошлую дату вернет null или текущее значение, игнорируя временную метку.

Использование этого объекта также позволяет проверить наличие реквизита перед обращением к нему, что предотвращает ошибки выполнения. Вы можете перебирать коллекцию доступных реквизитов, что удобно для универсальных обработок, работающих с разными видами объектов.

Особенности работы с периодическими реквизитами

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

Выборка данных через язык запросов

Самый производительный способ работы с дополнительными реквизитами — использование языка запросов 1С. Этот метод обязателен при формировании отчетов, обработок массового изменения данных или выгрузок в внешние системы. Запрос позволяет выбрать данные из регистра сведений одной командой к СУБД.

При написании запроса важно правильно указать таблицу виртуального регистра. Имя таблицы формируется как РегистрСведений.ДополнительныеРеквизитыСведений. В условии отбора необходимо указать ссылку на объект и имя дополнительного реквизита. Рассмотрим пример выборки весов для списка товаров.

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

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

Ключевой момент здесь — использование параметра ВидДополнительногоРеквизита. Вы должны передать в него не строку с именем, а ссылку на план видов характеристик, соответствующий вашему дополнительному реквизиту. Это обеспечивает типобезопасность и ускоряет выполнение запроса за счет использования индексов базы данных.

Поле регистра	Описание	Тип данных
Ссылка	Ссылка на объект владельца (справочник, документ)	Ссылка
ВидДополнительногоРеквизита	План видов характеристик, описывающий реквизит	ПланВидовХарактеристикСсылка
ЗначениеСтрока	Хранит значение, если тип реквизита строка	Строка
ЗначениеЧисло	Хранит значение, если тип реквизита число	Число
Период	Дата актуальности записи (если ведётся история)	Дата

Обратите внимание, что в зависимости от типа дополнительного реквизита, значение будет храниться в разных полях таблицы: ЗначениеСтрока, ЗначениеЧисло, ЗначениеДата или ЗначениеБулево. В запросе необходимо выбирать именно то поле, которое соответствует типу данных, иначе вы получите пустые значения.

Обработка разных типов данных реквизитов

Одной из сложностей программирования с ДРС является гетерогенность типов данных. Поскольку в одном регистре хранятся и строки, и числа, и даты, программист должен явно приводить типы или использовать универсальные методы чтения. Неправильная обработка типов часто приводит к ошибкам выполнения или некорректным данным в отчетах.

При использовании запросов рекомендуется использовать оператор ЕСТЬNULL или функцию приведения типов, чтобы собрать все значения в одну колонку результата. Однако, более правильным подходом является явная проверка типа плана видов характеристик перед формированием запроса.

Если вы используете метод ПолучитьДополнительныеРеквизиты(), система сама вернет объект соответствующего типа. Но при работе с таблицей значений, полученной из запроса, вам придется вручную проверять тип значения. Это можно сделать через определение типа переменной или попытку приведения.

• ✅ Всегда проверяйте тип значения перед арифметическими операциями.
• ✅ Используйте ТипЗнч() для динамического определения типа данных в цикле.
• ✅ Для булевых значений проверяйте поле ЗначениеБулево, не пытаясь читать его из строки.
• ✅ Учитывайте, что пустое значение в числовом поле регистра хранится как Null, а не как 0.

Особое внимание стоит уделить реквизитам типа "ПеречислениеСсылка". В регистре сведений они хранятся как ссылки на элементы перечислений. При выгрузке таких данных убедитесь, что ваша целевая система или отчет корректно интерпретируют эти ссылки.

Лайфхак для универсальной выгрузки

Создайте временную таблицу с колонкой типа "Строка" и используйте функцию Формат() для приведения любых типов дополнительных реквизитов к строковому виду перед записью.

Оптимизация и типовые ошибки разработчиков

Работа с дополнительными реквизитами требует дисциплины в вопросах оптимизации. Самая распространенная ошибка — попытка получить значение дополнительного реквизита внутри цикла перебора документов или справочников, используя обращение через точку. Это генерирует N+1 запрос к базе данных, где N — количество объектов.

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

⚠️ Внимание: Интерфейсные расширения и клиентский код имеют ограничения на прямой доступ к некоторым регистрам сведений. Всегда проверяйте права доступа и контекст выполнения кода (Клиент/Сервер).

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

Также стоит помнить о лимитах длины строки. Поле ЗначениеСтрока в регистре имеет ограничение (обычно до 367 символов в зависимости от версии платформы и настроек СУБД). Попытка записать более длинную строку приведет к усечению данных без явного предупреждения в некоторых конфигурациях.

Часто задаваемые вопросы (FAQ)

Можно ли использовать дополнительные реквизиты в условиях отбора запроса?

Да, можно. Вы можете добавить таблицу РегистрСведений.ДополнительныеРеквизитыСведений в запрос и использовать её поля в секции ГДЕ. Однако это может усложнить план выполнения запроса, поэтому убедитесь, что по полям отбора установлены индексы в конфигураторе.

Как получить дополнительное сведение о документе, а не о справочнике?

Механизм полностью идентичен. Для документов используется тот же регистр сведений. Разница лишь в том, что в поле Ссылка будет храниться ссылка на документ. Убедитесь, что вид дополнительных сведений разрешен для использования с документами в свойствах плана видов характеристик.

Почему запрос возвращает несколько строк на один объект?

Это происходит, если для вида дополнительных сведений включено ведение истории. В регистре хранятся записи за разные периоды. Чтобы получить только актуальное значение, используйте таблицу виртуального регистра с указанием периода (СрезПоследних) или добавьте условие отбора по периоду и флагам актуальности.

Можно ли программно создать новый вид дополнительного реквизита?

Да, это возможно через объект ПланыВидовХарактеристик. Вы можете создать новый элемент плана видов характеристик, задать ему свойства и привязку к объектам. Однако это требует прав на изменение метаданных или использования специальных механизмов расширения, в зависимости от режима работы базы.