Фильтр по полю адреса ФИАС
Назначение
Фильтр по полю адреса ФИАС - это видоизмененная компонента поле адреса ФИАС, дополненная функцией поиска в связанной с ней компоненте Таблица по введенному пользователем значению. Иерархически обязательно должна быть расположена внутри компоненты Набор фильтров, в качестве параметра содержит указание на колонку таблицы, по которой осуществляется поиск. В зависимости от настроек родительской компоненты Набор фильтров в запущенном приложении выполняет поиск либо только после нажатия соответствующей кнопки (компонента Кнопка для фильтрации), либо по мере ввода пользователем искомого значения (так называемый, “живой поиск”).
Компонента Фильтр по полю адреса ФИАС находится в разделе Фильтры - Фильтр по полю адреса ФИАС.
Свойства
Компонента имеет набор общих свойств. Ниже отображены свойства, специфичные только для данной компоненты.
| Наименование свойства | Назначение свойства | Принимаемые значения |
|---|---|---|
| Подсказка | позволяет создать подсказку, расположенную внутри элемента | пример возможного значения: Выберите район |
| Надпись | позволяет задать наименование поля, которое будет отображаться на странице | пример возможного значения: Район |
| Минимальное количество символов | позволяет задать количество символов, после ввода которых пользователем, компонента начинает подбор и вывод вариантов, соответствующих уже введенной пользователем подстроке | |
| Исторический адрес | Если отметка поставлена, то компоненте предписывается осуществлять поиск не только по актуальным вариантам адресов, но и по историческим версиям этих адресов. Если отметка снята, то компоненте предписывается осуществлять поиск только по актуальным вариантам адресов, игнорируя исторические версии этих адресов. Информация о том, какой версией является то или иное наименование адреса (актуальной или исторической) компонента берет из федеральной информационной адресной системы в режиме чтения как исходное данное, и не осуществляет присвоение или снятие этого признака своей активностью. |
|
| Фильтр по умолчанию | Предписывает компоненте при отображении вариантов отфильтровать адреса по указанной в этом параметре подстроке. Используется как дополнительный предустановленный фильтр к подстроке, вводимой пользователем. | |
| Количество строк | Указывает компоненте максимально допустимое количество вариантов для отображения в выпадающем списке при подборе пользователем интересующего значения. | |
| Минимальный уровень адреса | Ограничивает область поиска адреса по вводимой пользователем подстроке “сверху” - то есть указанным элементом адреса и его нижележащими в иерархии дочерними элементами. | При указании “Минимального уровня поиска адреса” в значение “Субъект РФ” поиск по введенной пользователем в компоненту подстроке будет осуществляться по всем Субъектам РФ и по всем Районам субъекта, и по всем Городам, и по всем Районам города, и по всем Населенным пунктам, и по всем Улицам. Данную настройку могут ограничивать параметры:
|
| Максимального уровня поиска адреса | Ограничивает область поиска адреса по вводимой пользователем подстроке “снизу” - то есть указанным элементом адреса и его вышележащими в иерархии родительскими элементами. | При указании “Максимального уровня поиска адреса” в значение “Улица” поиск по введенной пользователем в компоненту подстроке будет осуществляться по всем Улицам во всех Населенных пунктах, всех Районов города, всехГородов, всех Районов субъекта и всех Субъектов РФ. Данную настройку могут ограничивать параметры:
|
| Показывать краткий вид типа | указывает компоненте на стиль отображения строки адреса - наименование адресных элементов (таких как город, улица, район и т.п.) отображать в принятых сокращениях (г., ул.,р-н) или полностью. |
|
| Операция | позволяет задать условие, по которому будет осуществляться фильтрация данных по введенному пользователем значению | |
| Фильтровать по … | позволяет указать таблицу и колонку базы данных, к которой будет применяться фильтрация | Выбор таблицы и колонки базы данных в данном свойстве будет доступен только после заполнения свойства “Применить к…” у Набора фильтров |
| Правило обработки MultiValue | позволяет указать правило работы фильтрации в режиме MultiValue, когда пользователем выбраны несколько значений в компоненту. Данная настройка определяет оператор соединения для выбранных пользователем значений | Значение по умолчанию - “или”. Данная настройка имеет значение только для компонентов, поддерживающих множественный ввод (возможность указания нескольких значений в строке поиска). Компонента Фильтр по полю адреса не поддерживает множественный ввод, поэтому выбор текущего параметра не повлияет на результаты. |
Свойство компоненты: Поле адреса ФИАС. Настройка
Источник подгрузки значений адресов конфигурируется в файле standalone.xml проекта в секции datasource jndi-name=“java:jboss/datasources/fias-ds” pool-name=“FIASDS” enabled=“true” use-java-context=“true”.
Настройка секции на источник данных происходит при инициации проекта техническим специалистом и используется аналитиком “как есть”. В составе компоненты настройка параметров подключения и подгрузки данных не осуществляется.
Функции
В ходе настройки свойств компоненты (заданных по умолчанию) может оказаться недостаточно для выполнения поставленной задачи и получения необходимого результата.
Для каждой компоненты предусмотрен перечень функций, расширяющих её базовую функциональность, которые можно добавить нажатием кнопки Добавить скрипт.
Вследствие технических особенностей реализации функций (функции, которые выполняются удаленно на сервере приложений,- функции, которые выполняются в браузере пользователя), они имеют разные иконки, но это никак не влияет на их функциональность или предпочтительность использования.
Сохранить значение в переменную процесса любого типа
Заполнить значением из переменной любого типа
Определить права текущего пользователя
Определить роли текущего пользователя
Сконвертировать значение в целочисленный тип
Заполнить значением по умолчанию
Методические рекомендации по применению
Пошаговые инструкции по применению компонента в типовых задачах Вы можете найти в разделах:
Часто задаваемые вопросы
| Вопрос | Ответ |
|---|---|
| Значение какого типа возвращает компонента? | В общем случае компонента возвращает значение тестового типа в виде длинного идентификатора (для поиска записи в базе данных). Для использования значения выбранного адреса на экранной форме посредством компоненты Обработка событий, аналитику доступны несколько методов, которые возвращают разные значения. |
В условиях сравнения компоненты Обработка событий могут использоваться методы:
Метод “Получить значение” возвращает идентификатор (так называемый GUID) выбранного адреса в строковом виде, например: {“version”:“1.0”,“aoid”:“b026a0f9-9478-4c61-a55f-95b38cb099c1”,“aoid_p1”:“c6d874d0-a7e8-46a1-b345-e2e1e9758c59”,“aoid_p2”:“625866a1-1278-4883-8dc5-ba34e0c463c4”,“aoid_p3”:“fc50add0-c3c7-4f07-99cd-8831166e6619”,“aoid_p4”:null,“aoid_p5”:null,“guid”:“b026a0f9-9478-4c61-a55f-95b38cb099c1”}
Метод “Получить значение как текст” возвращает строку адреса в человекочитаемом виде в строковом виде, например “Респ Дагестан, р-н Буйнакский, с Верхнее Казанище, ул Ленина”
В секции Тогдакомпоненты Обработка событий могут использоваться методы:
Метод"ФИАС.Задать значение" выставляет в компоненте адрес по идентификатору GUID ({“version”:“1.0”,“aoid”:“b026a0f9-9478-4c61-a55f-95b38cb099c1”,“aoid_p1”:“c6d874d0-a7e8-46a1-b345-e2e1e9758c59”,“aoid_p2”:“625866a1-1278-4883-8dc5-ba34e0c463c4”,“aoid_p3”:“fc50add0-c3c7-4f07-99cd-8831166e6619”,“aoid_p4”:null,“aoid_p5”:null,“guid”:“b026a0f9-9478-4c61-a55f-95b38cb099c1”}). Используется для полей - приемника информации об адресе (как показано на скриншоте).
Метод “ФИАС.Получить значение” возвращает значение - идентификатор GUID, как из источника данных об адресе для последующей вставки в другое поле ФИАС.
Метод "ФИАС.Получить значение"возвращает строку адреса в человекочитаемом виде в строковом виде,как из источника данных об адресе для последующей вставки в другое читаемое тестовое поле (например, Компонент Текстовое поле).