Как добавить строку поиска на форму в 1С: Предприятие

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

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

В этой статье мы подробно разберем алгоритм внедрения поля ввода для поиска, настройки его свойств и написания кода, который будет реагировать на ввод пользователя. Мы рассмотрим как простейшие варианты фильтрации, так и более сложные сценарии с использованием стандартных подсистем библиотеки стандартных подсистем (БСП).

Подготовка формы и создание реквизита

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

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

Для нового поля ввода задайте имя, например, ПолеПоиска. В свойстве "Вид" выберите значение Текст, чтобы пользователь вводил строковое значение. Ключевым моментом является привязка этого элемента к реквизиту формы. Если такого реквизита нет, система предложит создать его автоматически.

Создаваемый реквизит должен иметь тип Строка с неограниченной длиной или достаточной длиной (например, 255 символов). Также рекомендуется установить свойство АвтоМаксимум в значение Ложь, если вы хотите контролировать ширину поля вручную, или оставить стандартное поведение для адаптивности.

⚠️ Внимание: Не привязывайте поле поиска напрямую к реквизитам основного объекта данных. Это поле существует только в контексте формы и служит фильтром, а не частью хранимых данных документа или справочника.

Настройка обработчика изменения текста

После создания визуального элемента необходимо реализовать логику его работы. Самый простой и эффективный способ — использовать событие ПриИзменении (OnChange) для поля ввода. Этот срабатывает каждый раз, когда пользователь меняет содержимое строки поиска.

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

&НаКлиенте
Процедура ПолеПоискаПриИзменении(Элемент)

// Получаем текущий текст из поля поиска
ТекстПоиска = Объект.ПолеПоиска;

// Вызываем процедуру применения фильтра
ПрименитьФильтрПоиска(ТекстПоиска);

КонецПроцедуры

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

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

Реализация логики фильтрации данных

Сердцем системы поиска является процедура, которая непосредственно фильтрует данные. В зависимости от типа формы (список справочника, табличная часть документа, форма отчета) подход может отличаться. Рассмотрим наиболее распространенный случай — фильтрацию списка справочника.

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

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

Метод фильтрации	Сложность	Производительность	Гибкость
Отбор динамического списка	Низкая	Высокая	Средняя
Ручной запрос (Запрос.Текст)	Высокая	Зависит от кода	Высокая
Фильтрация на клиенте	Средняя	Низкая (при больших данных)	Высокая

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

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

Оптимизация больших списков

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

Использование стандартных подсистем БСП

Для типовых конфигураций, таких как Управление торговлей или Бухгалтерия предприятия, предпочтительным вариантом является использование механизмов библиотеки стандартных подсистем (БСП). Это обеспечивает единообразие интерфейса и упрощает поддержку кода при обновлении платформы.

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

Ключевым преимуществом использования БСП является автоматическая обработка прав доступа. Стандартные механизмы фильтрации учитывают ограничения РЛС (ограничения на уровне записей), что критически важно для безопасности данных в корпоративном секторе.

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

⚠️ Внимание: При использовании БСП убедитесь, что версия библиотеки стандартных подсистем в вашей конфигурации поддерживает используемые методы. В старых версиях некоторые функции поиска могут отсутствовать или работать иначе.

Поиск по нескольким полям и сложным условиям

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

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

Пример логики построения сложного отбора может выглядеть следующим образом: создается новый элемент отбора для поля "Наименование", затем второй элемент для поля "ИНН", и между ними устанавливается связь ИЛИ. Это позволит найти запись, если введенный текст совпадает хотя бы с одним из полей.

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

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

Обработка ошибок и тестирование функционала

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

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

Важным аспектом является проверка прав доступа. Зайдите под пользователем с ограниченными правами и убедитесь, что поиск не выдает данные, которые этому пользователю видеть запрещено. Механизм отборов должен корректно накладываться на существующие ограничения РЛС.

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

⚠️ Внимание: Интерфейс и методы работы с формами могут отличаться в различных версиях платформы 1С:Предприятие. Всегда сверяйте синтаксис и доступные свойства в справочной системе вашей конкретной версии платформы.

Можно ли сделать поиск с задержкой (debounce), чтобы не фильтровать при каждом нажатии клавиши?

Да, это возможно. Для реализации задержки можно использовать объект РегистрНакопления в сочетании с таймером на клиенте, либо написать простую обертку, которая будет вызывать процедуру фильтрации только если с момента последнего нажатия прошло определенное время (например, 500 мс). Это снизит нагрузку на интерфейс при быстром вводе.

Как очистить поле поиска программно?

Для программной очистки поля достаточно присвоить реквизиту формы пустую строку: Объект.ПолеПоиска = "";. После этого необходимо принудительно вызвать процедуру обработки изменения или событие ПриИзменении, чтобы применился сброс фильтра. Можно использовать метод Элементы.ПолеПоиска.УстановитьФокус() для возврата фокуса.

Работает ли поиск по табличной части документа в управляемых формах?

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

Нужно ли сохранять текст поиска при закрытии и открытии формы?

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