Виджет "Фильтр данных на основе блоков" (с поддержкой темы)
Введение
Виджет "Фильтр данных на основе блоков" позволяет запрашивать и фильтровать большой набор данных путем использования фильтров на основе блоков.
Смотрите следующее видео о том, как использовать виджет для фильтрации данных в виджете "Расширенная сетка". Чтобы просмотреть видео в окне большего размера, щелкните заголовок видео.
На следующих изображениях показан пример виджета "Фильтр данных на основе блоков", используемого в мэшапе. Этот виджет можно увидеть перед применением фильтров, а выходные блоки - после применения фильтров.
1. Перед применением фильтров:
2. После применения фильтров: фильтры отображаются как блоки.
 | • Виджет "Фильтр данных на основе блоков" доступен, начиная с версии ThingWorx 9.1, и в более поздних версиях. • Этот виджет доступен как Стандартное включение в платформу, а также как веб-компонент при импорте из SDK. |
Формат данных
В виджете "Фильтр данных на основе блоков" используется две модели данных, как показано ниже.
• Для Data:
Необходимо создать Структуру данных, а для нее создать Определения полей, которые будут использоваться как категории фильтров для виджета. Эти определения полей необходимо сопоставить, и каждое поле должно представлять категорию, которая отображается в выпадающем списке фильтров.
На следующем изображении показан пример определений полей.
На изображении показан выпадающий список категорий фильтров в виджете, созданный на основе определений полей.
Определения полей можно сконфигурировать для виджета с помощью диалогового окна "Конфигурация".
• Для DaysContainingData:
Это необязательная модель данных, которая используется, если требуется показать дни, содержащие данные. Необходимо создать Структуру данных с единственным Определением поля с базовым типом DATETIME.
На следующем изображении показан пример определения поля.
При выполнении Фильтра подате в виджете индикатор точки отображается на календаре для каждого дня, для которого имеются данные. На следующем изображении приведен пример:
Таблица свойств
Ниже перечислены свойства виджета "Фильтр данных на основе блоков".
Имя свойства | Описание | Базовый тип | Значение по умолчанию | Доступно для привязки? (Д/Н) | Локализуемое? (Д/Н) |
|---|---|---|---|---|---|
CategoryLabel | Текст, который отображается над выпадающим списком категорий фильтров. | STRING | Фильтровать по | Д | Д |
ConditionLabel | Текст, который отображается над выпадающим списком условий фильтрации. | STRING | Условие | Д | Д |
CustomClass | Определяет CSS для верхнего раздела (div) виджета. При вводе нескольких классов отделяйте каждый класс пробелом. | STRING | Н/Д | Д | Н |
Data | Исходные данные таблицы данных для элементов блока, отображаемых в фильтре с выпадающим списком. | INFOTABLE | Н/Д | Д | Н |
DateOrder | Задает формат отображаемой даты. Действительные опции: Авто, День-месяц-год, Месяц-день-год и Год-месяц-день | STRING | Auto | Д | Н |
DaysContainingData | Источник таблицы данных, содержащий данные о дате и времени для дней, имеющих сгенерированные значения данных. Индикатор в виде точки отображается в календаре для каждого дня с данными. | INFOTABLE | Н/Д | Д | Н |
FormatToken | Локализует формат данных с использованием шаблона "DD-MM-YY". Формат учитывает регистр и переопределяет свойство DateOrder. Этот синтаксис следует формату ISO. | STRING | Н/Д | Н | Д |
LatitudeLabel | Текст, отображаемый над полем ввода для широты при фильтрации по расположению. | STRING | Latitude | Д | Д |
LongitudeLabel | Текст, отображаемый над полем ввода для долготы при фильтрации по расположению. | STRING | Longitude | Д | Д |
Query | Позволяет задать запрос JSON, который используется для загрузки набора отфильтрованных данных. | QUERY | Н/Д | Д | Н |
QueryChanged | Инициирует событие при изменении запроса для виджета "Фильтр данных на основе блоков". | Н/Д | Н/Д | Д | Н |
RangeEndValueLabel | Текст, отображаемый над вторым полем ввода при фильтрации по диапазону значений. | STRING | Значение 2 | Д | Д |
RangeStartValueLabel | Текст, отображаемый над первым полем ввода при фильтрации по диапазону значений. | STRING | Значение 1 | Д | Д |
ShowAndHideFilters | Добавляет ссылку, позволяющую показывать и скрывать фильтры, добавленные в виджет. | BOOLEAN | True | Д | Н |
ShowAndOrOperator | Отображает выпадающий список, позволяющий комбинировать несколько фильтров с помощью логических операторов "ИЛИ" и "И", соединяющих блоки. | BOOLEAN | false | Д | Н |
ShowCategoryListFilter | Добавляет поле фильтра в выпадающий список для категорий. Можно ввести текст, чтобы применить фильтр, упрощающий выбор элементов из длинного списка. | BOOLEAN | false | Д | Н |
SortFilters | Сортирует список фильтров данных в алфавитном порядке. Чтобы отсортировать фильтры данных вручную, выключите это свойство и переупорядочите фильтры в диалоговом окне конфигурации виджета. | BOOLEAN | True | Д | Н |
TabSequence | Номер последовательности виджета "Фильтр данных на основе блоков" при нажатии клавиши TAB. | NUMBER | Н/Д | Д | Н |
UnitsLabel | Текст, отображаемый над выпадающим списком, который используется для задания единиц измерения при фильтрации по расположению или дате. | STRING | Ед. измерения | Д | Д |
ValueLabel | Текст, отображаемый над полем, которое содержит значение для условия. | STRING | Значение | Д | Д |