Другое · 6 мин
Запрос 1С с фильтром по списку значений
Как составить запрос 1С с фильтром по списку: оператор В, передача списка в параметр, временные таблицы, проверка результата и распространённые ошибки.
В языке запросов 1С фильтрация по набору значений обычно оформляется через оператор членства в списке. Это позволяет отобрать только те справочники, документы или регистры, ключи которых содержатся в переданном наборе, а не сканировать весь объект без ограничения.
Основное различие от обычного равенства заключается в том, что в условии указывается не одно значение, а параметр, содержащий несколько значений. Платформа проверяет каждое значение из набора источника на принадлежность этому набору и оставляет подходящие строки.
Перед изменением запроса в рабочей базе рекомендуется скопировать конфигурацию или поработать в копии информационной базы. Ошибочно составленный фильтр может исключить нужные данные из отчёта или обработки, а неоптимальный вариант замедлить выполнение.
Что означает фильтр «в списке» в запросе 1С
Оператор проверяет, входит ли значение поля источника в переданный список. В тексте запроса это часто записывается через слово «В», а отрицательная проверка — через «НЕ В». Типы значений в списке и в поле источника должны быть совместимыми, например ссылки на один справочник сравниваются со ссылками, а не со строками.
Результат зависит от того, какие значения реально попадают в параметр. Если список содержит только подмножество контрагентов, в отчёт попадут строки только по ним. Это удобно для отборов по выделенным в интерфейсе элементам, загруженным из файла или полученным из другого запроса.
Проверьте, что параметр заполнен и типы значений совпадают с типом поля источника
Уточните поведение для пустого списка и отсутствующих значений в консоли запросов
Рассмотрите временную таблицу или соединение вместо множества литералов
Как передать список в параметр запроса
Список можно сформировать как коллекцию значений, таблицу значений или временную таблицу, а затем присвоить параметру запроса перед выполнением. Точный способ зависит от используемого интерфейса: консоль запросов, отчет, обработка или управляемая форма могут иметь разные способы установки параметров.
Не передавайте в параметр элементы формы напрямую, если платформа ожидает набор значений или таблицу. Сначала соберите нужные ключи в подходящую структуру, проверьте её содержимое на небольшом примере, и только потом привяжите к запросу.
- 1Сформируйте список ключей в совместимой коллекции или таблице значений
- 2Назначьте этот список параметру запроса перед выполнением
- 3Запустите запрос в консоли и сравните результат с ожидаемым набором
Синтаксис и пример запроса со списком
Типичный вид условия: отбор по ссылке справочника через параметр со списком. В тексте запроса параметр помечается знаком амперсанда, например &СписокКонтрагентов, а в условии указывается поле источника и оператор членства в этом списке.
ВЫБРАТЬ
Контрагент.Ссылка,
Контрагент.Наименование
ИЗ
Справочник.Контрагенты КАК Контрагент
ГДЕ
Контрагент.Ссылка В (&СписокКонтрагентов)
После выполнения проверьте, что в результате есть ожидаемые контрагенты и нет лишних. Если запрос возвращает ноль строк, убедитесь, что список не пуст и значения действительно существуют в источнике.
Когда список лучше заменить временной таблицей или соединением
Для короткого и стабильного набора удобен параметр со списком. Если список большой, часто меняется или содержит дополнительные поля, проще загрузить его во временную таблицу и использовать соединение или подзапрос. Это облегчает поддержку и снижает риск ошибок в длинном тексте запроса.
| Вариант | Когда подходит | Ограничение |
|---|---|---|
| Список в параметре | Малый фиксированный набор ключей | Трудно поддерживать при росте количества значений |
| Временная таблица | Динамический или большой набор | Требует создания и заполнения перед запросом |
| Соединение с источником | Нужны дополнительные поля из списка | Может дать дубли, если ключи не уникальны |
Перед выбором варианта оцените, откуда берутся значения: пользовательская отметка, импорт из файла или результат другого запроса. Каждый источник диктует свой способ подготовки списка.
Проверка результата и частые ошибки
Отдельные сценарии
Пустой список часто приводит к отсутствию строк, поэтому проверяйте набор перед запуском. При отрицательной фильтрации уточните поведение для значений, отсутствующих в источнике, чтобы не получить неожиданный набор. Большие списки могут замедлять выполнение, особенно без индексации по полю отбора.
Частые ошибки: несовпадение типов значений, попытка передать элементы формы вместо набора данных, забытый параметр и изменение запроса в рабочей базе без копии. Всегда прогоняйте проверочный запуск с известным списком и выборочно сверяйте включённые и исключённые строки.
Ограничения и безопасная работа
Оператор членства работает корректно, когда типы данных на обеих сторонах совместимы. Не полагайтесь на поведение «по умолчанию» для пустых списков или отсутствующих значений без проверки в консоли запросов. При работе с регистрами и большими таблицами следите за временем выполнения и блокировками.
Безопасная самостоятельная работа возможна при копировании базы, тестировании на ограниченном наборе и документировании источника списка. Если запрос затрагивает критические отчёты или движения по складским и финансовым объектам, изменения лучше вносить через испытанную процедуру обновления конфигурации.
Что важно запомнить
Используйте совместимые типы, проверяйте пустые списки, тестируйте на копии и при росте набора переходите на временную таблицу или соединение.
Можно ли передать в «В» обычный массив?
Обычно лучше использовать коллекцию значений, таблицу значений или временную таблицу, поддерживаемую механизмом параметров запроса. Если у вас массив, сначала преобразуйте его в подходящую коллекцию и проверьте содержимое на примере.
Что будет, если список пуст?
Часто запрос возвращает ноль строк, но точное поведение зависит от платформы и способа передачи параметра. Проверьте этот случай в консоли запросов перед использованием в отчёте.
Чем отличается «В» от соединения?
Оператор «В» фильтрует строки по принадлежности к набору, а соединение объединяет данные из двух источников по ключу. Соединение может создавать дубли, если ключи не уникальны, поэтому для простого отбора подходит оператор членства.
Нужно ли перезапускать 1С после правки запроса?
Для внешних отчётов и обработок обычно достаточно сохранить и повторно запустить объект. Изменения в конфигурации могут требовать обновления базы, поэтому уточняйте порядок внесения правок для вашей конфигурации.
Можно ли использовать «В» с регистрами накопления?
Да, если отбираемое поле и значения в списке имеют совместимые типы. При больших объёмах регистров оценивайте производительность и проверяйте результат на ограниченном периоде.