Ввод по строке в 1С: что это такое и как его использовать

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

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

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

Как работает ввод по строке с точки зрения пользователя

Когда курсор стоит в поле ссылочного типа (например, «Контрагент» в документе реализации), достаточно начать печатать название организации. Платформа отправляет запрос к данным и выводит под полем список найденных объектов. В списке обычно видно наименование и дополнительные колонки — код, ИНН, артикул, — чтобы отличить похожие элементы друг от друга.

Выбрать нужный вариант можно мышью или клавишами: стрелки вверх и вниз перемещают по списку, Enter подтверждает выбор, Escape закрывает список без выбора. Если нажать Enter, когда в поле введён текст без выбора из списка, платформа попытается найти точное соответствие; при нескольких совпадениях откроется форма выбора с уже применённым отбором.

Важная особенность: поиск идёт по объектам, доступным пользователю с учётом прав доступа и ограничений на уровне записей (RLS). Если сотрудник не видит часть контрагентов по настройкам прав, ввод по строке их тоже не покажет. Это нормальное поведение, а не ошибка механизма.

Режимы поиска: по началу строки и по части строки

Платформа поддерживает два основных способа поиска. Первый — поиск по началу строки: совпадения ищутся только с начала значения поля. Если набрать «ромашка», найдётся «Ромашка ООО», но не «Торговый дом Ромашка». Второй — поиск по части строки (подстроке): совпадение ищется в любом месте значения, и «ромашка» найдёт оба варианта.

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

Есть нюанс с производительностью: поиск по части строки с ведущим символом процента (LIKE '%текст%') не использует индекс и на больших таблицах работает медленнее. Поэтому в конфигурациях с миллионами записей разработчики иногда ограничивают поиск началом строки или подключают полнотекстовый поиск платформы.

Настройка ввода по строке в конфигураторе

Основная настройка находится в свойствах объектов метаданных. У справочников, документов, планов видов характеристик и других ссылочных объектов есть свойство «Ввод по строке», где перечисляются поля, по которым выполняется поиск. По умолчанию туда входят код и наименование (или их аналоги для данного типа объекта), но можно добавить другие реквизиты — например, артикул для номенклатуры или ИНН для контрагентов.

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

Дополнительно у самого поля ввода на форме есть свойства, влияющие на поведение: «Кнопка выпадающего списка», «Быстрый выбор», «История выбора при вводе». Быстрый выбор заставляет форму выбора открываться в компактном режиме без лишних панелей, что ускоряет подбор при клике на кнопку выбора.

1. 1
   Откройте конфигуратор и найдите нужный объект (например, справочник «Номенклатура»)
2. 2
   Откройте палитру свойств объекта и найдите свойство «Ввод по строке»
3. 3
   Нажмите кнопку открытия редактора списка полей
4. 4
   Отметьте нужные поля — например, «Артикул» — и подтвердите выбор
5. 5
   Убедитесь, что реквизит индексирован или включён в полнотекстовый поиск
6. 6
   Обновите конфигурацию базы данных и проверьте поиск в режиме предприятия

Программная доработка через обработчики событий

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

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

Другие полезные события: «АвтоПодбор» (управляет моментом срабатывания поиска), «ОкончаниеВводаТекста» (срабатывает, когда пользователь завершил ввод без выбора из списка) и «ОбработкаВыбора» (выполняется после выбора значения). Комбинируя их, можно реализовать, например, автоматическое создание нового элемента, если по введённой строке ничего не найдено.

&НаКлиенте
Процедура КонтрагентОбработкаПолученияДанныхВыбора(Элемент, ДанныеВыбора, Параметры, СтандартнаяОбработка)
	// Пример: отключаем стандартный поиск и подставляем свой
	Если СтрДлина(Параметры.СтрокаПоиска) < 3 Тогда
		СтандартнаяОбработка = Ложь;
		ДанныеВыбора = Новый СписокЗначений; // пустой список до ввода 3 символов
	КонецЕсли;
КонецПроцедуры

Типичные проблемы и их решение

Самая частая жалоба пользователей — «поиск ничего не находит», хотя объект точно есть в базе. Причины обычно такие: искомое слово стоит не в начале наименования, а поиск настроен по началу строки; объект помечен на удаление (помеченные элементы по умолчанию не предлагаются); у пользователя нет прав на объект; либо поле, по которому ищут, не включено в список ввода по строке.

Вторая типичная ситуация — поиск работает медленно, список появляется с заметной задержкой. Это признак того, что поиск идёт по неиндексированному полю или по части строки на большой таблице. Решения: включить полнотекстовый поиск и обновить его индекс, ограничить поиск началом строки, добавить индексацию реквизиту или сократить число полей в настройке ввода по строке.

Третья группа проблем связана с полнотекстовым поиском: если индекс не обновлялся, новые объекты не находятся. В этом случае нужно выполнить обновление индекса в режиме предприятия (раздел администрирования, «Обслуживание», управление полнотекстовым поиском) или настроить регламентное обновление индекса.

Как проверить, что поиск настроен правильно

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

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

Ограничения и альтернативные способы подбора

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

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

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

Частые вопросы о вводе по строке в 1С