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