Фильтр по полю ввода с подбором значения
Назначение
Фильтр по полю ввода с подбором значения - это видоизмененная компонента Поле ввода с подбором значения, дополненная функцией поиска в связанной с ней компоненте Таблица по введенному пользователем значению. Иерархически обязательно должна быть расположена внутри компоненты Набор фильтров, в качестве параметра содержит указание на колонку таблицы, по которой осуществляется поиск. В зависимости от настроек родительской компоненты Набор фильтров в запущенном приложении выполняет поиск либо только после нажатия соответствующей кнопки (компонента Кнопка для фильтрации), либо по мере ввода пользователем искомого значения (так называемый, “живой поиск”).
Компонента Фильтр по полю ввода с подбором значения находится в разделе Фильтры - Фильтр по полю ввода с подбором значения.
Свойства
Компонента имеет набор общих свойств. Ниже отображены свойства, специфичные только для данной компоненты.
| Наименование свойства | Назначение свойства | Принимаемые значения |
|---|---|---|
| Подсказка | позволяет создать подсказку, расположенную внутри элемента | пример возможного значения: Выберите район |
| Надпись | позволяет задать наименование поля, которое будет отображаться на странице | пример возможного значения: Район |
| Зависит от | позволяет указать объект (родителя), например Выпадающий список, по идентификатору которого будут отображаться сведения в текущем зависимом элементе | |
| Начать подбор вариантов | позволяет задать количество символов, после ввода которых пользователем, компонента начинает подбор и вывод вариантов, соответствующих уже введенной пользователем подстроке | пример возможного значения: 3 |
| Допустимое количество для MultiValue | позволяет указать количество значений, которое может выбрать пользователь при работе с компонентой (включение режима MultiValue) | пример возможного значения: 4 |
Свойство компоненты: Поле ввода с подбором значения. Подгрузка данных
Подгрузка данных - позволяет задать источник подгрузки/сохранения данных в компоненту из/в объекта базы данных (таблицы или представления) с указанием следующих дополнительных настроек:
| Наименование свойства | Назначение свойства | Принимаемые значения |
|---|---|---|
| Возвращать значение доп.колонки | по умолчанию компонента возвращает идентификатор записи выбранной из справочника значений (primary_key) | Настройка данного параметра позволяет указать компоненте, значение из какой дополнительной колонки необходимо дополнительно считать и вернуть при использовании метода “Получить значение BusinessId” |
| Связаны по… | позволяет указать колонку текущей компоненты, по которой осуществляется связь с компонентой, указанной в свойстве “Зависит от”, обеспечивающую связь между родительской и текущей компонентами | |
| Тип поиска | позволяет задать один из вариантов поиска по вводимой пользователем подстроке | С начала строки (значение отображается в списке, если с введенной пользователем подстроки начинается значение колонки из базы данных). Во всей строке (значение отображается в списке, если введенная пользователем подстрока содержится в значении колонки из базы данных с любого места вхождения) |
| Сортировать по | позволяет задать элемент базы данных, по значению которого будет производиться сортировка | |
| Тип колонки | позволяет указать , каким образом будет отображаться выбранное пользователем значение в компоненте |
|
| Показывать пользователю | позволяет задать колонку базы данных, значение которой будет отображено пользователю в режиме "" | |
| Активировать фильтрацию по колонке | позволяет указать колонку текущей компоненты, по которой можно с использованием метода “Задать фильтр” компоненты “Обработка события” дополнительно ограничить список доступных для выбора пользователем значений | Выставленное в методе значение фильтра будет применено к указанной колонке |
| Граф сущностей | Настройка Графа сущностей | Является обязательным к заполнению и настройке |
| Показывать варианты по | позволяет ограничить список отображаемых вариантов в процессе подбора по подстроке |
Тип колонки - позволяет указать , каким образом будет отображаться выбранное пользователем значение в компоненте
- Из одной колонки
- Из нескольких колонок
- Колонка с оформлением
Из нескольких колонок - позволяет указать, что видимое пользователю значение должно быть сформировано путем объединения значений из нескольких колонок источника данных компоненты. Для тонкой настройки параметров объединения значений разных колонок, аналитик может задать свойства:
- префикс - символ или текст, который будет отображаться перед подгружаемым значением из колонки базы данных,например символ открывающейся скобки (;
- постфикс- символ или текст, который будет отображаться после подгружаемого значения из колонки базы данных,например символ закрывающейся скобки );
- разделитель- символ или пробел, который будет разделять между собой значения из разных колонок таблиц (ы), объединяемых в одно значение
Тип колонки - позволяет указать , каким образом будет отображаться выбранное пользователем значение в компоненте
- Из одной колонки
- Из нескольких колонок
- Колонка с оформлением
Колонка с оформлением - позволяет задать шаблон отображения одной или нескольких колонок в html формате. Колонки в шаблоне задаются в виде @{сущность из графа.колонка} или @{сущность из графа.колонка | форматер}. Форматер принимает одно из двух значений “date” и “datetime”.
Свойство Фильтра : Задать операцию фильтрации
| Наименование свойства | Назначение свойства | Принимаемые значения |
|---|---|---|
| Операция | позволяет задать условие, по которому будет осуществляться фильтрация данных по введенному пользователем значению |
Свойство Фильтра: Настроить колонки фильтрации
| Наименование свойства | Назначение свойства | Принимаемые значения |
|---|---|---|
| Фильтровать по | позволяет указать таблицу и колонку базы данных, к которой будет применяться фильтрация | Выбор таблицы и колонки базы данных в данном свойстве будет доступен только после заполнения свойства “Применить к…” у Набора фильтрации |
| Правило обработки MultiValue значений | позволяет указать правило работы фильтрации в режиме MultiValue, когда пользователем выбраны несколько значений в компоненту. | Данная настройка определяет оператор соединения для выбранных пользователем значений |
Свойство компоненты: Поле ввода с подбором значения.
Заполнить значением из переменной любого типа
Функции
В ходе настройки свойств компоненты (заданных по умолчанию) может оказаться недостаточно для выполнения поставленной задачи и получения необходимого результата.
Для каждой компоненты предусмотрен перечень функций, расширяющих её базовую функциональность, которые можно добавить нажатием кнопки Добавить скрипт
Вследствие технических особенностей реализации функций (функции, которые выполняются удаленно на сервере приложений. Функции, которые выполняются в браузере пользователя), они имеют разные иконки, но это никак не влияет на их функциональность или предпочтительность использования.
Сохранить значение в переменную процесса
Заполнить значением из переменной
Определить права текущего пользователя
Определить роли текущего пользователя
Сконвертировать значение в целочисленный тип
Заполнить значением по умолчанию
Заполнить значением по умолчанию
Методические рекомендации по применению
Пошаговые инструкции по применению компонента в типовых задачах Вы можете найти в разделах:
Часто задаваемые вопросы
| Вопрос | Ответ |
|---|---|
| Чем отличается компонента Фильтр по полю ввода с подбором значения от компоненты Фильтр по выпадающему списку? | Фильтр по полю ввода с подбором значения отличается от компоненты Фильтр по выпадающему списку тем, что не показывает и не подгружает сразу все строки из справочника, но по мере ввода пользователем подстроки предлагает всё более усеченный список вариантов, выводя только релевантные уже введенной подстроке значения. |
| Значение какого типа возвращает компонента? | В общем случае может быть любым (чаще всего целочисленным или строковым).Тип возвращаемого компонентойзначения определяется выбором аналитиком метода, который возвращает значение, а также типом колонки в базе данных. |
Метод “Получить значение” возвращает первичный ключ и тип такого значения зависит от типа колонки первичного ключа в базе данных (обычно целочисленный bigint).
Метод “Получить значение по BussinessId” возвращает значение колонки, заданной в параметре компоненты "Дополнительно возвращать значение из " и определяется типом этой колонки в базе данных.
Дополнительная функция “Сконвертировать значение в целочисленный тип” как раз используется для явной конвертации возвращаемого компонентой неопределенного типа (ANY) в явно желаемый Integer (например, при присвоении идентификатора строки выбранного в компоненте значения какой-либо переменной целого типа на странице) .