Другое · 7 мин
Список значений 1С как параметр в запросе
Как передать СписокЗначений в параметр запроса 1С: подготовка, условия фильтрации, проверка результата и типичные ошибки.
СписокЗначений в 1С:Предприятии часто используется для сбора выбранных пользователем элементов: номенклатуры, контрагентов, договоров или других ссылочных объектов. Когда такие элементы нужно отфильтровать в запросе, возникает задача передать этот список в параметр языка запросов.
Язык запросов 1С не принимает СписокЗначений как готовый текстовый перечисление. Параметр запроса должен иметь подходящий тип, а значения из списка — быть представлены в форме, которую понимает запрос. На практике это чаще всего таблица значений с одной или несколькими колонками.
Ниже разобрано, когда стоит использовать список значений как параметр, как подготовить данные, как записать условие запроса, как проверить результат и каких ошибок стоит избегать. Материал ориентирован на самостоятельную настройку в типичных конфигурациях 1С.
Когда список значений нужен в параметре запроса
Основной сценарий — пользователь в форме выбирает несколько объектов, а программа должна отобрать по ним данные из регистров, документов или справочников. Например, сформировать остатки только по выбранной номенклатуре или движения по указанным контрагентам.
В таких случаях выбранные элементы складывают в СписокЗначений, а затем передают в запрос для фильтрации. Это удобно, когда набор элементов заранее неизвестен и формируется в процессе работы пользователя.
Отбор по выбранным ссылкам
Если в СпискеЗначений хранятся ссылки на справочные объекты, запрос может отбирать записи, где поле «Ссылка» или «Номенклатура» входит в этот набор. В языке запросов такое условие обычно выражается через оператор IN с параметром таблицы значений.
Отбор по произвольным значениям
СписокЗначений может содержать не только ссылки, но и числа, строки, даты. Тогда параметр запроса должен содержать колонку с соответствующим типом, а условие — сравнивать поле объекта со значениями из этой колонки.
Как подготовить параметр из СпискаЗначений
Перед передачей в запрос СписокЗначений обычно преобразуют в ТаблицуЗначений. Для этого создают таблицу с нужными колонками, перебирают строки списка и копируют значения. Количество и имена колонок должны соответствовать тому, как параметр будет использоваться в запросе.
Если список содержит только ссылки, достаточно одной колонки типа СправочникСсылка или другого подходящего типа. Если нужны несколько признаков, добавляют несколько колонок, но тогда усложняется условие запроса.
Важно проверять, что список не пуст перед выполнением запроса. Пустой параметр таблицы значений может привести к отсутствию отобранных записей или к ошибке, в зависимости от конструкции запроса и платформы.
- 1Создать ТаблицуЗначений с колонками под значения из СпискаЗначений
- 2Пройти по строкам списка и скопировать значения в таблицу
- 3Проверить, что таблица не пуста
- 4Передать таблицу в параметр запроса
- 5Выполнить запрос и проверить отбор
Передача параметра в запрос и условие отбора
Подготовленную таблицу значений передают в запрос как параметр. В тексте запроса параметр обозначается знаком амперсанда, например &ОтобранныеНоменклатуры. Далее его можно использовать в условии WHERE через оператор IN.
Типичное условие выглядит так: отобрать записи, где поле объекта входит в набор значений из параметра. Запрос сравнивает значения из таблицы параметров с данными в регистре или документе и возвращает только подходящие строки.
Если нужно соединить данные с параметром, можно использовать конструкцию соединения с таблицей параметров. Это позволяет подтягивать дополнительные атрибуты по выбранным элементам, но требует осторожности с типами и уникальностью значений.
Проверка результата и признаки корректной работы
После выполнения запроса проверьте, что количество и состав записей соответствуют ожидаемому. Сравните результат с отбором вручную по тем же элементам из СпискаЗначений. Если записи отсутствуют, убедитесь, что значения в параметре имеют те же типы и представления, что и поля в базе.
Признак корректной работы — запрос возвращает только те объекты, которые были включены в список, и не возвращает лишние. Если в результате есть объекты вне списка, вероятно, условие отбора составлено неверно или параметр содержит лишние значения.
Также проверьте производительность при большом количестве элементов в списке. Очень большой параметр таблицы значений может замедлить выполнение запроса, особенно если отбор идёт по большим регистрам без подходящих индексов.
Ограничения и типичные ошибки
Частая ошибка — попытка передать СписокЗначений как строку с перечислением через запятые. Язык запросов не распознаёт такое значение как набор для условия IN, и запрос либо не выполнится, либо вернёт неверный результат.
Другая ошибка — несоответствие типов. Если в параметре хранятся строки, а в базе ссылки, сравнение не сработает. Перед передачей нужно привести значения к типам полей, по которым идёт отбор.
Не стоит передавать в запрос слишком вложенные или составные значения без подготовки. СписокЗначений с вложенными таблицами или сложными структурами требует предварительной обработки, иначе параметр будет некорректным.
Альтернативы и когда не использовать список значений
Если набор элементов известен заранее и не меняется, проще использовать константы или справочники отбора без динамического списка. Для больших объёмов данных удобнее загружать отбор из регистра накопления или документа, чем формировать СписокЗначений в памяти.
Как проверить результат
Соответствует выбранным элементам списка
Лишние или отсутствующие записи
Совпадают с типами полей отбора
Сравнение не работает из-за разных типов
Обработан явно перед запросом
Запрос выполняется с пустым параметром без проверки
Если нужно отобрать по одному значению, нет смысла создавать список и таблицу параметров — достаточно простого параметра скалярного типа. СписокЗначений оправдан, когда элементов несколько и их состав формируется динамически.
Для массовой обработки тысяч элементов стоит оценить альтернативу через временные таблицы или загрузку из файла. СписокЗначений подходит для типичных пользовательских отборов, но не всегда является самым эффективным инструментом для больших массивов.
Что важно запомнить
СписокЗначений передаётся в запрос через таблицу значений, используется в условии отбора, а результат обязательно проверяется на соответствие выбранным элементам.
Часто задаваемые вопросы
Можно ли передать СписокЗначений в запрос без преобразования?
В общем случае нет: параметр запроса должен иметь тип, который понимает язык запросов, а СписокЗначений обычно предварительно преобразуют в ТаблицуЗначений с подходящими колонками.
Что делать, если запрос не возвращает записи по выбранному списку?
Проверьте, что список не пуст, типы значений в параметре совпадают с типами полей в базе, и условие отбора составлено верно. Также убедитесь, что значения в списке действительно существуют в таблицах запроса.
Подходит ли СписокЗначений для отбора по тысячам элементов?
Для больших объёмов такой способ может быть неэффективным. Стоит оценить использование временных таблиц, регистров или других источников данных вместо формирования большого списка в памяти.
Нужно ли проверять пустой список перед запросом?
Да. Пустой параметр таблицы значений может привести к пустому результату или к неожиданному поведению запроса, поэтому наличие элементов проверяют заранее.