К статье
Практический материал

Другое · 7 мин

Список как параметр запроса в 1С: использование и примеры

Как передать список в параметр запроса 1С: способы, источники данных, проверка результата и частые ошибки при работе с параметрами.

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

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

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

Что представляет собой параметр типа список в запросе

Параметр запроса в 1С объявляется с определённым типом, например СправочникСсылка.Номенклатура, ДокументСсылка.РеализацияТоваровИУслуг или простым типом Число, Строка. Когда в такой параметр передаётся список, платформа ожидает набор значений того же типа, что и сам параметр. Запрос использует этот набор для оператора В или для соединения с временной таблицей.

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

Как передать список в параметр запроса

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

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

Параметр описан как ссылкаНужен набор ссылок, а не кодов или наименований

Получите ссылки через выборку или функцию Передана ли ссылка в список

Источник — таблица значенийМожет потребоваться преобразование в массив или набор записей

Проверьте метод передачи параметров для выбранного типа таблицы

Результат запроса пустВозможно несоответствие типов или пустой источник

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

Источники данных для списка параметра

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

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

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

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

Проверка результата и типичные ошибки

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

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

Порядок действий
  1. 1
    Определите тип параметра в тексте запроса
  2. 2
    Сформируйте список значений того же типа
  3. 3
    Передайте список в коллекцию параметров перед выполнением
  4. 4
    Выполните запрос и проверьте количество строк в результате

Ограничения и безопасная самостоятельная работа

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

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

Типичные ошибки
01
Передача кодов вместо ссылок в параметр типа ссылка — запрос не находит записи
02
Использование пустого списка без проверки — результат может быть пустым без ошибки
03
Передача слишком большого списка через параметр — замедление выполнения запроса

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

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

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

Итог

Что важно запомнить

Список передаётся в параметр запроса 1С только при совпадении типов, с предварительным заполнением источника и проверкой результата.

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

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

Если параметр описан как ссылка на элемент справочника, передавать строки с кодами нельзя. Нужно получить ссылки на элементы и передать их в список. Для параметра типа Строка можно передавать строки, но тогда отбор будет по строковому полю, а не по ссылке.

Что делать, если запрос с параметром-списком возвращает пустой результат?

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

Подходит ли таблица значений в качестве источника списка параметра?

Таблица значений может использоваться, но метод передачи параметров должен поддерживать этот тип. Часто удобнее преобразовать нужный столбец таблицы в массив или набор записей перед передачей в параметр запроса.

Безопасно ли экспериментировать с запросами на рабочей базе?

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