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

Другое · 9 мин

Отбор в динамическом списке 1С: практическая настройка

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

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

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

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

Что понимать под динамическим списком и отбором

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

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

Порядок действий
  1. 1
    Определите источник данных динамического списка
  2. 2
    Проверьте, что нужный реквизит входит в этот источник
  3. 3
    Задайте отбор пользовательски или программно
  4. 4
    Примените отбор и сравните количество строк
  5. 5
    Проверьте пустые и неверные значения
  6. 6
    Протестируйте на копии базы перед работой в реальной

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

В большинстве конфигураций форма динамического списка содержит кнопку или поле «Отбор», где пользователь может указать реквизит, вид сравнения и значение. Например, выбрать реквизит «Контрагент», условие «Равно» и конкретного контрагента. После применения список перезагружается и показывает только подходящие строки.

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

Программный отбор в модуле формы

В управляемой форме отбор задаётся через свойства элемента управления. Типичная последовательность: обратиться к элементу динамического списка, обратиться к его коллекции отбора, выбрать реквизит, установить признак использования и задать значение. Примерно это выглядит как обращение к свойству «Использование» со значением «Истина» и заполнение свойства «Значение» нужным данными.

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

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

Пользователь меняет фильтр самГибкий анализ, но нет гарантии обязательности

Проверьте, можно ли снять отбор и увидеть лишние данные

Отбор задан в кодеУсловие применяется всегда

Убедитесь, что реквизит есть в источнике списка

Список не сужается после отбораВозможно неверный реквизит или источник

Проверьте набор данных и права доступа

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

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

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

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

Проверка результата и ограничения

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

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

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

Типичные ошибки
01
Неверное наименование реквизита в коллекции отбора: условие игнорируется без ошибки
02
Отбор по реквизиту, отсутствующему в источнике данных
03
Изменение фильтра в рабочей базе без копии и проверки
04
Замена прав доступа программным отбором

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

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

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

Как выбрать способ отбора

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

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

Итог

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

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

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

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

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

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

Заменяет ли отбор ограничение прав доступа?

Нет. Отбор только скрывает строки в интерфейсе формы, но не блокирует доступ к данным на уровне ролей и профилей доступа. Для защиты конфиденциальной информации используйте настройки прав доступа, а отбор — для удобства работы.

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

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