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

Работа с расширенными возможностями системы 1С:Предприятие часто требует гибкости в хранении данных. Стандартных полей справочников или документов может быть недостаточно для специфических бизнес-процессов. Именно здесь на сцену выходят дополнительные реквизиты и дополнительные сведения, позволяющие адаптивно изменять структуру метаданных без изменения конфигурации.

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

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

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

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

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

⚠️ Внимание: Прямой доступ к системным таблицам дополнительных реквизитов (типа _AddProps) без использования встроенных функций платформы может привести к ошибкам при обновлении конфигурации или смене версии платформы. Всегда используйте штатные средства языка запросов.

Использование функции ДополнительныеРеквизитыСрезПоследних

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

Синтаксис функции требует указания ссылки на объект и, опционально, списка отбираемых характеристик. Если список не указан, система вернет все заполненные дополнительные реквизиты для указанных объектов. Результат работы функции представляет собой виртуальную таблицу, которую можно соединять с основными таблицами запроса.

Рассмотрим пример получения всех допреков для элементов справочника. В теле запроса мы используем конструкцию ВЫБРАТЬ.. ИЗ ДополнительныеРеквизитыСрезПоследних(..).

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

Синтаксис запроса с псевдонимами полей

При работе с функцией среза последних значений результат возвращается в виде трех колонок: Ссылка, Характеристика и Значение. Для дальнейшего использования в коде или вывода на экран эти колонки необходимо переименовать с помощью оператора КАК. Без этого обращение к полям будет неудобным и менее читаемым.

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

Вот как выглядит корректная конструкция выбора с алиасами:

ВЫБРАТЬ
ДопРек.Ссылка КАК Объект,
ДопРек.Характеристика КАК ВидРеквизита,
ДопРек.Значение КАК ЗначениеРеквизита
ИЗ
ДополнительныеРеквизитыСрезПоследних(&МассивОбъектов) КАК ДопРек

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

Фильтрация по виду характеристики

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

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

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

Способ фильтрации	Производительность	Гибкость	Рекомендуемое использование
Параметр функции	Высокая	Средняя	Статичный список реквизитов
Оператор ГДЕ	Средняя	Высокая	Динамический отбор в коде
Без фильтрации	Низкая	Максимальная	Универсальные обработчики

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

Обработка типов значений и приведение

Поле Значение в результате работы функции является универсальным. Оно может содержать строку, число, дату, булево значение или даже ссылку на другой объект. При попытке выполнить математическую операцию с таким полем без предварительной проверки типа система выдаст ошибку выполнения.

Для безопасной работы необходимо использовать функцию ЕСТЬNULL или проверять тип значения в условиях запроса, если требуется отбор по числовому диапазону. Например, чтобы отобрать товары с весом более 10 кг, нужно убедиться, что в поле значения действительно хранится число, а не строка "нет данных".

В некоторых случаях требуется явное приведение типа. Хотя язык запросов 1С выполняет его автоматически во многих ситуациях, явное указание через конструкцию КАК ЧИСЛО или использование специфических функций делает код более предсказуемым. Это защищает от скрытых ошибок при изменении настроек дополнительных реквизитов администратором.

⚠️ Внимание: Если в дополнительных реквизитах хранятся ссылки на объекты, при соединении с основными таблицами убедитесь, что типы ссылок совместимы. Попытка соединить ссылку на "ФизическихЛиц" с таблицей "Контрагенты" вызовет ошибку типов, даже если визуально данные похожи.

Оптимизация производительности при больших объемах

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

Главное правило оптимизации — минимизировать количество обращений к функции среза. Не вызывайте функцию внутри цикла по каждому объекту отдельно. Формируйте массив ссылок и передавайте его одним параметром. Платформа 1С:Предприятие эффективно обрабатывает такие пакетные выборки, используя внутренние индексы.

Также стоит избегать выбора лишних полей. Если вам нужен только "Артикул", не запрашивайте "Цвет", "Размер" и "Производитель". Каждый лишний байт в выборке умножается на количество строк, увеличивая нагрузку на сеть и память клиента. Используйте точечную фильтрацию по характеристикам.

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

Частые ошибки и способы их решения

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

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

⚠️ Внимание: Интерфейс и настройки дополнительных реквизитов могут меняться в зависимости от версии конфигурации и прав пользователя. Всегда проверяйте актуальность имен характеристик в той базе, на которой ведется разработка или тестирование.

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

Секрет быстрой отладки

Если запрос не возвращает данные, попробуйте убрать все соединения и выбрать данные только из функции среза для одного конкретного, заведомо заполненного объекта. Это изолирует проблему.

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

Пример комплексного решения

Давайте соберем все знания воедино и рассмотрим пример реального запроса. Представим задачу: нужно получить список товаров из категории "Обувь" с указанием их цвета и размера. Цвет и размер хранятся в дополнительных реквизитах.

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

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

Такой подход обеспечивает высокую читаемость и эффективность. Использование именованных соединений (Цвет, Размер) позволяет легко манипулировать данными в дальнейшей обработке. Обратите внимание на использование предопределенных элементов плана видов характеристик в параметрах функции.

Заключение и лучшие практики

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

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

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

Можно ли использовать ДополнительныеРеквизитыСрезПоследних в СКД?

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

В чем разница между ДополнительнымиРеквизитами и ДополнительнымиСведениями?

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

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

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

Как получить историю изменений дополнительного реквизита?

Функция СрезПоследних дает только текущее состояние. Для получения истории необходимо обращаться к регистру сведений, хранящему историю изменений дополнительных реквизитов, обычно это ИсторияИзмененияДополнительныхРеквизитов.

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

Нет, язык запросов 1С предназначен только для чтения данных. Для записи или изменения значений дополнительных реквизитов необходимо использовать объектный режим или специальные методы расширения объектов в коде 1С.