Виджет Фильтр

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

Примеры

Используйте этот виджет для поддержки требований к разработке приложений, таких как:

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

Примечания по использованию

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

Настройки

Виджет Фильтр имеет следующие настройки:

• Новый фильтр - создает один фильтр методом выбора источника данных и добавления выражений. Открывающаяся панель Создать новый фильтр содержит следующие настройки:
  • Данные - выбор данных, которые вы хотите отфильтровать. На фильтр можно выбрать только один источник данных. Фильтры поддерживают слои объектов, слои объектов в выбранных веб-картах, виды данных и URL-адреса сервисов объектов. Если источник данных имеет какие-либо связанные представления данных, их можно выбрать в ниспадающем списке.
  • Надпись - задайте осмысленное имя для фильтра группы. По умолчанию надпись - это имя источника данных.
  • Значок - выберите значок для каждого фильтра. Вы можете выбрать значки из галерей Общие и Стрелки, либо добавить собственный значок из файла. Щелкните кнопку Удалить, чтобы удалить неиспользуемые загруженные значки.

    Примечание:

    Можно выгружать следующие форматы изображений: PNG, GIF, JPG, JPEG и BMP. Чтобы сохранить оптимальную производительность, на размер каждой загрузки есть ограничение в 10МБ.

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

      Примечание:

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

    • Автоматически сворачивать описание фильтра (если есть) - включите этот параметр, чтобы панели фильтров были свернуты по умолчанию. Если фильтр настроен на запрос значений, пользователь должен щелкнуть на фильтр, чтобы увидеть дополнительное описание. Этот параметр полезен для экономии места, если у вас много фильтров.
• Новая группа - нажмите кнопку Новая группа , затем нажмите Новая группа, чтобы создать фильтр группы. Открывающаяся панель Создать новую группу содержит следующие настройки:
  • Данные - выбрать данные, которые вы хотите отфильтровать. Можно выбрать разнообразные источники данных. Фильтры групп поддерживают слои объектов, слои объектов в выбранных веб-картах, виды данных и URL-адреса сервисов объектов. Если источник данных имеет какие-либо связанные представления данных, их можно выбрать в ниспадающем списке. Источники выходных данных не поддерживаются.
  • Надпись - задайте осмысленное имя для фильтра группы. Когда вы добавляете фильтр группы, его надпись по умолчанию следует правилам непрерывной нумерации.
  • Значок - выберите значок для фильтра группы. Вы можете выбрать значки из галерей Общие и Стрелки, либо добавить собственный значок из файла. Щелкните кнопку Удалить, чтобы удалить неиспользуемые загруженные значки.

    Примечание:

    Можно выгружать следующие форматы изображений: PNG, GIF, JPG, JPEG и BMP. Чтобы сохранить оптимальную производительность, на размер каждой загрузки есть ограничение в 10МБ.

  • Выражение SQL - создайте выражения SQL для задания критериев фильтрации. Конструктор выражений SQL группы предлагает несколько опций для создания сложных интерактивных запросов.
  • Опции - для каждого фильтра группы можно включить или выключить следующие опции:
    • Автоматически применять этот фильтр - включите эту опцию, чтобы автоматически применять фильтр к данным, когда пользователь открывает приложение.
    • Автоматически сворачивать описание фильтра (если есть) - включите этот параметр, чтобы панели фильтров были свернуты по умолчанию. Если фильтр настроен на запрос значений, пользователь должен щелкнуть на фильтр, чтобы увидеть дополнительное описание. Этот параметр полезен для экономии места, если у вас много фильтров.
• При добавлении нескольких отдельных фильтров или групп, щелкните AND, чтобы указать, что необходимо выполнение всех критериев фильтра, или OR, чтобы задать необходимость выполнения любого из них. Вы также можете перетаскивать фильтры и группы, чтобы менять их порядок.
• Вы можете использовать кнопки Дублировать и Удалить, которые появляются рядом с каждым фильтром и группой, чтобы дублировать и удалять их.
• Стиль размещения - выберите Вертикальный, Горизонтальный или Значок для настройки подходящего стиля для фильтров виджета.
• Стиль активации - выберите Переключатель или Кнопка в качестве стиля для включения или выключения каждого фильтра. (По умолчанию используется стиль Переключатель.)
  • Исключение стилей активации для одного условия - если в каждом фильтре имеется только одно условие, запрашивающее значения (или отображающее надпись), эта опция позволяет исключить стили активации (вместе с надписью и значком), отобразить содержание условия и применить его автоматически.
• Дополнительные инструменты—Настройка дополнительных инструментов.
  • Сбросить все фильтры—Включите кнопку для пользователей, чтобы сбросить все фильтры в исходные настроенные состояния.

    Подсказка:

    Инструмент фильтрации виджета списка по умолчанию предоставляет кнопку сброса.

Конструктор выражений SQL

Фильтр использует логические выражения для поиска и отображения объектов в слое на основе значений атрибутов в его данных. В выражениях используется общая форма <Имя поля> <оператор, задающий условие> <Значение или поле>. Например, вместимость укрытия больше 200.

Чтобы создать выражения в Конструкторе выражений SQL, щелкните Добавить условие или Добавить набор условий.

Выражение для каждого условия включает следующие части:

• Поле - выбор поля для фильтрации из источника данных. Используется три типа поля: числовое, строковое и дата. Соответствующие значки отображаются рядом с именами полей.
• Оператор - выберите оператор для оценки данных выбранного поля. Операторы могут отличаться, в зависимости от типа поля. Просмотрите полный список поддерживаемых операторов для каждого типа поля.
• Значение - введите или выберите значение для завершения выражения. Щелкните кнопку Выбрать тип источника , чтобы выбрать значение, такое как пользовательский ввод, поле, уникальное, уникальное (заданное), множественное и множественное (заданное).

Примечание:

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

Для каждого условия можно установить следующие дополнительные свойства:

• Учитывать регистр - для соответствия критериям фильтра, данные должны соответствовать регистру значений в условии. Опция применима только к строковым полям в неразмещенных слоях (у размещенных слоев кнопка не доступна).
• Без ввода пользователя - по умолчанию условие не запрашивает ввода данных у пользователя. Вы можете включить опцию Отображение надписи, чтобы у пользователей отображались только надписи по умолчанию или собственные надписи.
• Запрашивать значения - позволяет пользователям вводить собственные значения и менять фильтр во время запуска. Можно выполнить следующее:
  • Выбрать входной стиль (если доступно несколько стилей, основанных на значении выбранного типа источника).
  • Настройка надписи.
  • Настройка положения надписи. Вы можете выбрать перенос на другую строку или в той же строке, что и входные данные.
  • Укажите подсказку или инструкцию для пользователей.
  • Выберите критерии для списка значений, которые пользователь видит в опциях фильтра (применимо только к источникам с уникальными и множественными значениями). Вы можете отобразить все значения, отфильтровать значения на основе предыдущего выражения, или фильтровать значения по всем выражениям.

    Примечание:

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

• Дублировать - дублировать одно условие или весь набор условий и добавлять его в конец запроса в Конструкторе выражений SQL. Если имеется набор условий, эта кнопка дублирует одно условие и добавляет его в конец этого набора.

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

Конструктор выражений SQL группы

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

• Основное поле — поле, которое вы используете для установки оператора и значений для остальных полей в фильтре группы.
• Все поля - все поля, отфильтрованные фильтром группы, включая основное поле. Вы можете использовать ниспадающие списки для выбора полей из подключенных источников данных. Вы можете выбирать только те поля, которые имеют тот же тип поля (строковое, дата или число), что и основное поле. Если вы выбираете несколько полей из одного источника данных, нажмите AND, чтобы указать, что значение должно существовать в обоих полях, или нажмите OR, чтобы указать, что значение может существовать в любом поле.
• Оператор - выберите оператор для оценки данных выбранного поля. Операторы могут отличаться, в зависимости от типа основного поля. Просмотрите полный список поддерживаемых операторов для каждого типа поля.
• Значение - введите или выберите значение для завершения выражения. Щелкните кнопку Выбрать тип источника , чтобы выбрать значение, такое как пользовательский ввод, поле, уникальное, уникальное (заданное), множественное и множественное (заданное).

Вы можете настроить следующие дополнительные опции для выражения:

• Учитывать регистр - для соответствия критериям фильтра, данные должны соответствовать регистру значений в основном поле. Опция применима только к строковым полям в неразмещенных слоях (у размещенных слоев кнопка не доступна).
• Без ввода пользователя - по умолчанию выражение не запрашивает ввода данных у пользователя. Вы можете включить опцию Отображение надписи, чтобы у пользователей отображались только надписи по умолчанию или собственные надписи.
• Запрашивать значения - позволяет пользователям вводить собственные значения и менять фильтр во время выполнения. Можно выполнить следующее:
  • Выбрать входной стиль (если доступно несколько стилей, основанных на значении выбранного типа источника).
  • Настройка надписи выражения.
  • Настройка положения надписи. Вы можете выбрать перенос на другую строку или в той же строке, что и входные данные.
  • Укажите подсказку или инструкцию для пользователей.
  • Выберите критерии для списка значений, которые пользователь видит в опциях фильтра (применимо только к источникам с уникальными и множественными значениями).

Операторы

В следующей таблице перечислены типы полей и поддерживаемые ими операторы:

Оператор	Число	String	Дата
равно
не соответствует
больше или равно
меньше или равно
меньше
больше
между
не между
начинается с
не начинается с
заканчивается на
не заканчивается на
содержит
не содержит
любой из
ни один из
соответствует
не соответствует
в
не в
было
после
соответствует или до
соответствует или после
в последние*
не в последние*
в следующих*
не в следующих*
является пустым
не является пустым

*Применимо только для размещенных сервисов объектов ArcGIS Online.