Виджет Запрос—ArcGIS Web AppBuilder

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

Векторный слой текущей карты
Векторный слой как элемент портала
Векторный слой из сервиса REST ArcGIS Server
Подсказка:
Векторный слой может быть на основе картографического сервиса или сервиса объектов.
Слой изображений из сервиса изображений
Автономная таблица

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

Настройка виджета Запрос

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

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

Наведите курсор на виджет и щелкните кнопку Настроить этот виджет , чтобы открыть диалоговое окно параметров настройки.
Примечание:
Если виджет необходимо сначала добавить в приложение, щелкните заполнитель виджета на вкладке Виджет. В окне Выбор виджета выберите виджет и щелкните OK.
Дополнительно щёлкните изменить значок виджета, чтобы выбрать другой значок вместо используемого по умолчанию.
Откроется окно файлового менеджера, которое позволит вам выбрать хранящийся локально файл изображения для его использования в качестве значка виджета.
Щёлкните + Новый запрос.
Откроется окно Установить источник данных. По умолчанию задано Карта, и все векторные слои текущей карты перечислены ниже.
Или вы можете выбрать ArcGIS Online или URL сервиса. Кроме слоев, можно запрашивать связанные таблицы.

Внимание:

ArcGIS Web AppBuilder при внедрении в ArcGIS Online поддерживает аутентификацию ArcGIS Server для добавления и доступа к защищенным сервисам. Для защищенных сервисов с аутентификацией веб-уровня администраторам необходимо настроить доверенные серверы, позволяющие ArcGIS Online автоматически проходить через запрос идентификации. При обновлении доверенных серверов, необходимо отредактировать приложение и внести соответствующие обновленные сведения. Более подробно см. в разделе Веб-сервисы ArcGIS Server.

Щёлкните опцию рядом с источником данных.
Выберите слой из списка.
Щёлкните OK, чтобы закрыть окно Установить источник данных и возвратиться к окну конфигурации запроса.
По умолчанию активна вкладка Информация.
Укажите название и значок для задачи запроса.
Щёлкните вкладку Фильтры.
Щёлкните Задать под пунктом Критерий запроса, чтобы задать выражение where для запроса.
1. Щёлкните + Добавить выражение, чтобы показать конструктор выражений.
  Выражение фильтра может представлять собой операцию со значениями либо операцию с двумя полями.
2. Выберите поле данных, выражение запроса и предоставьте входные данные в текстовом поле.
  Если вы выполняете запросы к атрибутам полей дат и указали опцию дата для значения, можно дополнительно подобрать время даты, отметив опцию Показать время. Эта опция позволяет указать точность времени для поля, отображаемого в приложении, если этот атрибут и его точность применимы.
  Примечание:
  Вам надо выбрать дату прежде, чем выберете время.
  Можно выбрать показывать время с точностью до Часов, Минут или Секунд. Например, если вы предварительно установите значения Часов и Минут, но оставите Секунды пустыми, во время работы вы не увидите значения секунд из выборки и не сможете их вводить, даже если слой содержит атрибуты второго уровня. Если опция Показать время отмечена, но все три текстовые окошка Часы, Минуты и Секунды пустые, во время работы вы не увидите опцию указания времени.
  У вас есть опции для Задания входного типа при помощи кнопки Задать :
  - Значение – для фильтра указывается конкретное значение. Вы можете или указать предустановленное значение или в интерактивном режиме запросить конечного пользователя, щелкнув Запросить значения. Если активна опция Запросить значения, введите информацию о значении в поле Запрос и подсказку в поле Подсказка. Это облегчит конечному пользователю ввод значений для запроса.
  - Поле – сравнивает значения в одном поле со значениями в другом поле.
  - Уникальные – этот фильтр основывается на списке уникальных значений для выбранного поля слоя. Часто используется в сочетании в опцией Запросить значения, чтобы конечный пользователь мог интерактивно выбрать значение из списка, который представляет собой набор всех уникальных значений или набор динамических уникальных значений, выбранных на основе предыдущего выражения или всех остальных выражений, в соответствии с их порядком. Если активна опция Запросить значения, введите информацию о значении в поле Запрос, подсказку в поле Подсказка и укажите, как будут перечислены значения.
  - Уникальное (предварительно заданное) – предварительно заданный статичный список значений; также позволяет динамически показывать значения на основе предыдущих выражений или всех остальных выражений, в зависимости от их порядка.
    Внимание:
    Фильтры уникальных значений требуют использования слоя картографического сервиса версии 10.1 или более поздней. Опция Уникальное не появляется, если вы создаете фильтр в слое сервиса версии 10.0 или более ранней.
    Внимание:
    Для отображения описания кодированных значений, если выбрано Значения предыдущих выражений фильтра или Значения всех остальных выражений фильтра сервис должен поддерживать возможность запроса по статистике.
  - Несколько – фильтрует несколько значений в поле и получает динамический список значений слоя.
  - Несколько (предварительно заданные) – предварительно заданный статичный список значений.
    Примечание:
    Лишь операторы любой из и ни один из поддерживают несколько значений.
  Примечание:
  Если вы создали выражение на основе значений или уникального значения, вы можете настроить интерактивное выражение, поставив отметку Запросить значения. Вы не можете запрашивать значения для выражений на основе поля.
3. Используйте + Добавить набор, чтобы определить и применить два фильтра к одному запросу. Если Все или Некоторые выражения набора возвращают true, удовлетворяющие всем или некоторым критериям записи набора будут возвращены в качестве результатов.
4. Нажмите OK, чтобы закрыть диалоговое окно.
Дополнительно поставьте отметку Показать выражение SQL конечным пользователям, если вы собираетесь показывать выражение SQL в виджете.
Раздел Пространственные фильтры позволяет выбрать доступные конечным пользователям пространственные фильтры. Отметьте один или несколько фильтров и задайте один из них в качестве используемого по умолчанию, щелкнув Сделать используемым по умолчанию:
- Возвращать объекты только в текущем экстенте карты — показывать только объекты, попадающие в текущий экстент.
- Будут возвращены только объекты, пересекающие прорисованную на карте геометрию – Щёлкните значки, чтобы выбрать инструменты рисования, показанные в виджете. Дополнительно отметьте Включить опцию буферизации, если вы хотите добавить настройку буфера для конечных пользователей.
- Будут возвращены только объекты с пространственным отношением с другим слоем – Щелкните Задать для выбора правил пространственных отношений в списке Задать пространственные отношения. Вы можете задать удобную для пользователя подпись каждого отношения, дважды щелкнув поле подписи. Дополнительно поставьте отметку Включить опцию буферизации, если вы хотите добавить опцию буферизации для конечных пользователей. Поддерживаются следующие пространственные отношения:
  - Пересекает – часть объекта слоя 1 содержится в объекте слоя 2.
  - Содержит – часть или целый объект слоя 1 полностью содержит объект слоя 2.
  - Перекрещивается – объект слоя 1 перекрещивается с объектом слоя 2.
  - Конверт пересекает – конверт слоя 1 пересекает конверт слоя 2.
  - Индекс пересекает – конверт запрашиваемого слоя пересекает объект с заданным индексом целевого слоя.
  - Перекрывает – объекты слоя 1 перекрывают объекты слоя 2.
  - Касается – объект слоя 1 касается границы объекта слоя 2.
  - Внутри – объект слоя 1 полностью находится внутри объекта слоя 2.
- Возвращать объекты только в полном экстенте карты – показывать объекты, попадающие в полный экстент.
Примечание:
Снимите все отметки, если не хотите применять пространственный фильтр к запросу.
Щелкните вкладку Результаты для настройки отображаемого содержимого и символов результатов запросов.
Дополнительно поставьте отметку Использовать настройку всплывающего окна слоя веб-карты, если вы хотите показывать такое же содержимое, как задано это в настройках всплывающего окна слоя веб-карты.
Дополнительно поставьте отметку Настроить пользовательские ресурсы, чтобы отображать пользовательские ресурсы.
1. Щелкните значок Добавить рядом со строкой Название полученного элемента.
  Отобразится список поле слоя. Вы можете выбирать поля по одному. Значения выбранного поля отобразятся в текстовом окне и будут использованы в качестве заголовка результатов запроса. Повторите это действие, чтобы добавить дополнительные поля. Если добавлены несколько полей, для заголовка результатов будет использована конкатенация значений поля.
2. Нажмите на карандаш, расположенный рядом с текстовым окном Эти атрибутивные поля будут отображены, чтобы открыть диалоговое окно Задать отображаемые поля. Отметьте поля, которые вы хотите показать в результатах. Для отдельных полей столбец Специальный тип позволяет им отображаться в виде изображения. Также можно щелкнуть стрелку вверх или вниз в столбце Действия для изменения порядка полей.
Нажмите на карандаш, расположенный рядом с текстовым окномСортировать найденные элементы, чтобы настроить поля, по которым будут сортироваться результаты запроса.
Сервисы должны поддерживать разбиение на страницы или сортировку результатов запроса.
Дополнительно выберите опцию Использовать символы, заданные слоем, чтобы использовать используемый по умолчанию символ слоя.
Дополнительно выберите опцию Применить пользовательский символ и щелкните значок символа для установки пользовательского символа.
Откроется окно Просмотра, с использованием которого вы сможете выбрать цвет и стиль символа подсветки результатов.
Щелкните в любом месте вне окна показа символа, чтобы закрыть его.
Дополнительно отметьте Разрешить изменение символов при запуске, чтобы интерактивно менять символы для результирующих объектов по мере их появления.
Щелкните вкладку Опции, чтобы определить, могут ли быть экспортированы результаты запроса, а также то, как задача запроса создает слои.
Повторите шаги 3 – 20, чтобы добавить новые задачи для запроса.
Чтобы изменить порядок имеющихся задач запросов, поместите курсор над задачей и нажимайте стрелки вверх и вниз.
Дополнительно выберите Выключить слои результата запроса при закрытии виджета и настройте Подписи вкладки.
Нажмите OK, чтобы сохранить и закрыть окно Запрос.

Использование виджета Запрос

В приведенных ниже шагах показано, как используется виджет Запрос.

Щелкните виджет Запрос, чтобы открыть его. Если вы настроили несколько запросов, их список будет представлен на вкладке Задачи.
Если в виджете есть только один запрос, и он не запрашивает ввода конечным пользователем данных, щелчок по виджету запустит запрос, и будут немедленно показаны его результаты.
Если в виджете есть только один запрос, и он требует ввода конечным пользователем данных, щелчок по виджету отобразит запрос с пользовательским вводом.
Примечание:
Введенные конечным пользователем данные могут содержать атрибутивный критерий, один или несколько пространственных фильтров либо сочетание и того, и другого.
Щелкните один из запросов. Запрос может выполняться по-разному, в зависимости от ваших настроек.
1. Если запрос не требует пользовательского ввода данных, на вкладке Результаты отобразится результат, а полученные объекты будут показаны на карте с использованием символа, заданного вами во время настройки.
2. Если стоит отметка Запрашивать значения, появится окно, предлагающее вам задать новое значение параметра. В окне уже содержится значение по умолчанию. Если заданы уникальные значения, в текстовом поле появится весь список этих значений.
  Примечание:
  При запросе к атрибутам поля даты, если настроен указатель времени, вы можете выбрать предварительно установленные значения времени из ниспадающего списка или изменить их, указав в окошке.
3. Вы можете применить один или несколько пространственных фильтров.
  - Возвращать объекты только в текущем экстенте карты — показывать только объекты, попадающие в текущий экстент.
  - Будут возвращены только объекты, пересекающие нарисованную на карте геометрию – для рисования на карте геометрических фигур, задающих область, можно использовать набор инструментов рисования. Кроме того, вы можете задать расстояние поиска для применения к этим фигурам.
  - Будут возвращены только объекты, находящиеся в пространственном отношении с объектами другого слоя - Результаты основываются на пространственном отношении между объектами запрашиваемого и связанного слоев. Кроме того, вы можете задать расстояние поиска для применения к геометрии объектов связанного слоя.
  - Возвращать объекты только в полном экстенте карты – показывать объекты, попадающие в полный экстент.
4. Щёлкните Применить, чтобы запустить запрос.
  Объекты, полученные в результате выполнения запроса, будут подсвечены на карте с применением заданного вами в настройках символа. Если в слое содержатся связанные данные, то в результатах будут также содержаться и связанные записи.
На панели результатов запроса:
- Отображаемые объекты – показывает сколько результатов показывается из всех возвращённых результатов. Щёлкните кнопку Загрузить ещё , чтобы загрузить больше результатов для отображения.
- Щёлкните Развернуть все или Свернуть все , чтобы развернуть/свернуть все отображаемые подробности результатов, или либо для отдельных результатов.
- Щёлкните кнопку с многоточием (...), чтобы предпринять к набору результатов следующие действия:
  - Приблизить к
  - Переместить к
  - Подсветить
  - Статистика
  - Просмотреть в таблице атрибутов
  - Удалить этот результат
  - Изменить символ
Подсказка:
Максимальное число объектов, возвращаемое запросом, зависит от свойства maxRecordCount, заданного в сервисе. Значение по умолчанию равно 1,000. К примеру, если вы возьмете значение по умолчанию и предполагаете, что будет возвращено 1300 объектов, на панели результатов запроса вы увидите первые 1000 объектов. При перемещении вниз по панели вы увидите остальные 300 объектов.
Или, если запросы выполняются для связанной таблицы, все связанные объекты теперь подсвечиваются на карте и перечисляются на панели Запрос.