Виджет Групповой фильтр

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

Настройка виджета Групповой фильтр

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

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

  1. Наведите курсор на виджет и щелкните кнопку Настроить этот виджет Настроить этот виджет, чтобы открыть диалоговое окно параметров настройки.
    Примечание:

    Если виджет необходимо сначала добавить в приложение, щелкните заполнитель виджета на вкладке Виджет. В окне Выбор виджета выберите виджет и щелкните OK.

  2. Дополнительно, щелкните Изменить значок виджета, чтобы выбрать для этого виджета другой значок вместо того, который используется по умолчанию.
    Откроется окно файлового менеджера, которое позволит вам выбрать локальный файл изображения для использования в качестве значка виджета.

    В конфигурации отображается одна группа, готовая для изменения.

  3. Задайте группу фильтров:
    • Имя группы - укажите имя для этой группы фильтров. Оно будет отображаться в раскрывающемся списке доступных групп фильтров.
    • Описание - дополнительно можно добавить описание, чтобы пользователю было проще разобраться, как работает этот фильтр.
    • Заданный оператор - дополнительно выберите оператор по умолчанию, который будет использоваться для этой группы фильтров. Конечный пользователь может изменить выбранный оператор перед применением фильтра. Если значение не выбрано, фильтр будет использовать оператор EQUALS.
    • Заданное значение - предварительно задайте значение для этого фильтра, чтобы конечным пользователям не приходилось указывать этот критерий. Значение можно ввести вручную, либо щелкнуть кнопку поиска, чтобы выбрать значение из имеющегося слоя. Это значение используется для фильтрации по всем слоям, заданным в группе фильтров.
    • Если один слой указывается несколько раз - Если один слой указывается несколько раз в группе фильтров, а фильтр применяется к разным полям, то можно контролировать, как объединяются эти поля, выбирая соответствие любому или всем выражениям.
      • Соответствовать любому выражению - в результате фильтрации будут возвращены объекты, в которых любое из значений поля соответствует выражению, определенному для этой группы фильтров.
      • Соответствовать всем выражениям - в результате фильтрации будут возвращены только те объекты, в которых все значения поля соответствуют выражению, определенному для этой группы фильтров.
    • Выполнить поиск, чувствительный к регистру - включите эту опцию, чтобы возвращать объекты с теми значениями атрибутов, которые точно соответствуют вводимым при поиске символам верхнего и нижнего регистра.
  4. В приведенной таблице слой и поле выбираются в случайном порядке из карты, чтобы вы могли начать с примера. Выберите слои и поля, к которым нужно применить фильтр.
    • Слои – имя слоя, как определено на карте. Выберите слой карты из раскрывающегося меню.
    • Поля - поле, по которому будет фильтроваться слой. Выберите поле слоя из раскрывающегося списка.
    • Использовать значение - возможность использовать значения из этого слоя и поля в раскрывающемся списке в виде списка параметров значений для фильтрации. Если эта опция не включена для слоя, то появится пустое текстовое поле, в котором можно указать свое значение. Эта настройка является необязательной.
  5. Чтобы добавить в эту группу фильтров еще один слой, щелкните кнопку Добавить слой.
  6. Чтобы добавить другую группу фильтров, щелкните кнопку Добавить новую группу. При необходимости повторите шаги 3 - 5.
  7. Введите собственный текст заголовка виджета в поле Введите текст, отображающийся над выбором фильтров.
  8. Следующие шесть параметров задают поведение виджета:
    • Начать в простом виде - эта настройка определяет, как виджет будет отображаться для конечных пользователей. Если опция будет отмечена, то из интерфейса будут скрыты ниспадающий список операторов и кнопка Добавить критерии, придавая ему более простой вид.
    • Скрыть опции виджета - определяет, будет ли скрыт значок для перехода к расширенным опциям виджета. Эти настройки включают сохранение и загрузку фильтров, добавление к существующему фильтру на карте и продолжение использования фильтра даже после закрытия виджета.
    • Добавить любое/все выражения к существующему фильтру карты - если у карты уже есть предварительно настроенный фильтр, данная опция позволяет добавить фильтры, созданные в виджете, к существующему фильтру карты. Эта настройка позволит применить фильтры в нескольких группах. Если опция не выбрана, виджет переопределит фильтр веб-карты.
      • Использование опции any является дополнительным; настроенный фильтр добавляется к фильтру веб-карты.
      • Использование опции all является исключительным; отображаются только те функции, которые соответствуют требованиям настроенного фильтра и фильтра веб-карты.
    • Приблизить к результату - определяет, нужно ли приближать карту к экстенту отфильтрованных данных. По умолчанию сохраняется текущий экстент.
    • Сохранять фильтры после закрытия виджета - позволяет сохранить примененные фильтры и после закрытия виджета. По умолчанию фильтры удаляются с карты при закрытии виджета.
    • Скрыть заголовок и фильтр (для одной группы фильтров) - позволяет скрыть заголовок и ниспадающее меню группы фильтров, если настроена только одна группа.

Использование виджета Групповой фильтр

Выполните следующие действия, чтобы воспользоваться этим виджетом:

  1. Щелкните виджет Групповой фильтр, чтобы отобразить выборку предварительно заданных групп фильтров.

    Применить предустановленный набор фильтров

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

    Примечание:

    В зависимости от настройки слоев в виджете, вы увидите либо список значений (как в этом примере), текстовое поле ввода, либо выбор дат.

  2. Щелкните Применить, чтобы применить фильтр к карте.

    Дополнительно, можно применить фильтры, добавив параметры к URL приложения. URL должен быть в следующем формате - замените переменные в угловых скобках значениями, описанными в списке ниже:

    https://<your portal URL>/apps/webappviewer/index.html?id=<Item ID>&groupfilter={"<Filter Set Name>":["<value>","<value>",...]}
    • Item ID – уникальный идентификатор приложения.
    • Filter Set Name - имя группы фильтров. Это значение чувствительно к регистру.
    • Value - значение, используемое для применения фильтра. Для фильтров на основе доменов, используйте код домена.

    Например, чтобы применить фильтр, показанный на предыдущем изображении, используйте URL, похожий на приведенный в примере ниже:

    https://<your portal URL>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&groupfilter={"Group A":["Abandoned Motor Vehicle"]}

    Примечание:

    Если виджет Групповой фильтр не настроен на автоматическое открытие при запуске приложения, фильтр, заданный в URL, не будет применен до открытия виджета.

  3. Щелкните Сброс, чтобы удалить фильтр и вернуть слои карты в исходное состояние. (По умолчанию, при закрытии виджета также удалится фильтр.)
  4. Виджет позволяет добавить дополнительный параметры фильтра при запуске. Щелкните Добавить критерий, чтобы ввести другое выражение. Обратите внимание, что оба критерия будут объединены в одну связку. Вы можете выбрать оператор соединения: ИЛИ или И.

    Добавить дополнительный критерий фильтра

    Чтобы использовать параметры URL для применения фильтра, показанного в этом примере, URL должен выглядеть примерно так:

    https://<your portal URL>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&groupfilter={"Group A":["Abandoned Motor Vehicle","Auto Theft"]}

  5. Если настройка Скрыть опции виджета не была включена, вы можете сохранить эти заданные параметры фильтра для последующего использования. Щелкните кнопку Настройки, чтобы получить доступ к панели опций.

    Опция сохранения

    1. Нажмите кнопку Сохранить, чтобы текущие настройки фильтра были сохранены локально в текстовом файле JSON.
    2. Щелкните Выбрать файл в разделе Загрузить файл настроек, чтобы загрузить ранее сохраненный текстовой файл JSON для восстановления всех заданных в нем критериев.
    3. Если вам нужно использовать отфильтрованную карту в других виджетах, отметьте Сохранить фильтры после закрытия виджета. Иначе при закрытии виджета удаляются все фильтры, примененные к слоям на карте.
    4. Щелкните кнопку Обновить, чтобы извлечь изменения данных из слоев на карте и обновить список значений в ниспадающем списке фильтра. Это может понадобиться, если фильтруемые слои редактировались во время текущего сеанса работы с приложением, что могло повлиять на список доступных значений.