Выбор данных

Данные лежат в основе большинства приложений, которые вы создаете в Experience Builder. Многие виджеты управляются данными, и конструктор обеспечивает единое управление данными. Виджеты, использующие одни и те же данные, могут быть связаны с друг другом в вашем приложении. Например, можно синхронизировать выбранные записи между несколькими виджетами и применить один и тот же фильтр к виджетам, подключенным к одним и тем же данным.

Когда вы добавляете данные в приложение Experience Builder, вы создаете соединение с источником данных. Это дает следующие преимущества:

  • Обновления в исходном источнике данных синхронизируются с данными в создаваемых приложениях.
  • Один и тот же источник данных можно добавлять несколько раз. Подключения к данным становятся независимыми данными в Experience Builder. Большая часть обработки данных не влияет на другие виды обработки данных (такие как фильтрация и сортировка), за исключением обновлений, выполняемых в исходном источнике данных (например, редактирование объектов и обновление атрибутов).

Управление данными

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

Добавление данных в приложение

При добавлении данных в приложение можно выбрать веб-карты, веб-сцены и слои, хранящиеся в качестве элементов содержания в ArcGIS, включая:

Вы можете просматривать и искать эти источники данных в ваших ресурсах, в ресурсах ваших групп, вашей организации и в общедоступных ресурсах, включая ArcGIS Living Atlas of the World. Также поддерживаются слои из URL-адресов сервисов объектов, сцен или картографических сервисов. Кроме того, при добавлении веб-карт и веб-сцен в приложение можно использовать поддерживаемые ими слои в качестве источника данных для виджетов.

Примечание:

  • Когда вы добавляете веб-карты или веб-сцены в качестве источника данных, виджеты могут подключаться к поддерживаемым слоям, таким как таблицы, слои изображений карты, слои листов и составные слои. Не поддерживаемые типы слоев недоступны в настройках виджета и не отображаются на вкладке описания панели Данные.
  • Веб-карты и веб-сцены, созданные с помощью JSAPI 3.x, которые не могут открываться в Map Viewer Classic или Scene Viewer, и не могут быть использованы в качестве источников данных. (Если вы добавите один из этих элементов, он будет недоступен для выбора и появится на панели Данные в виде карточки с ошибкой.)

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

  • Прежде чем добавлять какие-либо виджеты, нажмите кнопку Добавить данные на панели Данные, чтобы добавить данные, которые будут использоваться в приложении. Все поддерживаемые в Experience Builder типы данных перечислены в окне Добавить данные.
  • Если вы не добавляете данные перед добавлением виджетов, вы также можете добавить данные при настройке виджета, нажав кнопку Добавить данные в нижней части панели Выбрать данные. Добавить можно только тот тип данных, который поддерживается виджетом. Данные, добавляемые при настройке виджета, также отображаются на панели Данные и доступны для выбора при настройке других виджетов.
Примечание:

Вы можете скрыть некоторые подслои в сервисе, составном слое, или веб-карте, или веб-сцене при добавлении данных. Или вы можете скрыть их под панелью деталей сервиса, группы, веб-карты или веб-сцены. Скрытые слои не будут доступны в списке Выбрать данные при настройке виджетов. Вы можете скрыть только те слои, которые еще не используются.

Удаление данных

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

Подробная информация и представления данных

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

  • Для веб-карт, веб-сцен, сервисов и составных слоев можно просмотреть следующие сведения:
    • Вкладка Слои – слои, которые содержит источник данных. Слои делятся на две группы: в разделе Используются отображаются слои, выбранные в настройках виджета, а в разделе Другие – слои, еще не подключенные к виджету. Вы можете скрыть неиспользуемый слой, чтобы он не появлялся в списке Выбрать данные при настройке виджета. Щелкните карточку слоя, чтобы открыть панель сведений.
    • Вкладка Виджеты – виджеты, которые непосредственно используют всю карту, сцену, сервис или составной слой. Виджеты, которые используют только определенные слои под данными, здесь не перечислены; вместо этого они перечислены под соответствующим слоем.
  • Для отдельных слоев (включая те, которые не имеют подслоев) у вас есть следующие параметры настройки и детали:
    • Настройки данных – установка фильтров, полей сортировки и ограничений записи для данных. Настройки фильтра здесь влияют на все представления данных.
    • Настройки обновления – если автоматическое обновление отключено, данные будут обновляться только при обновлении приложения или конструктора. Включите Автоматическое обновление, чтобы обновить данные и получить последние объекты, используя определенный интервал времени. Вы можете установить пользовательский интервал времени или, если данные поступают с веб-карты, вы можете выбрать соблюдение настроек слоя.
    • Разрешить экспорт - дает возможности для пользователей экспортировать данные во время запуска из подключенных виджетов, для которых включено действия с данными. (Экспорт ограничен 5000 записями)
      Примечание:

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

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

      Каждый слой имеет встроенные виды, которые вы можете выбрать при настройке источников данных для виджета. Вид По умолчанию содержит все объекты. Вид Выбранные объекты содержит объекты, выбранные при запуске. Вид Автозаполнение используется для настройки динамических ресурсов с виджетами Списка.

      • Вид для пустой выборки - включите эту отметку и щелкните на ее кнопке Настройки, чтобы настроить вид, который отображается, когда нет выбранных объектов в виде Выбранные объекты. (Объекты в настроенном виде не будут выбираться автоматически.)
    • Вкладка Поля – поля, которые используют виджеты.
    • Вкладка Виджеты – виджеты, использующие этот слой, и их настройки.

Использование данных

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

Примечание:

При отображении веб-карты или веб-сцены в виджете карты автоматически создается новый вид веб-карты или веб-сцены, который используется только в текущем виджете. Таким образом, обработка данных в виджете карты не повлияет на виджеты, использующие один и тот же источник данных или содержащиеся в нем слои. Но на карту влияет обработка данных в виде по умолчанию.

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

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

ВиджетПоддерживаемый тип данных*Поддерживаемое количество данных

Управление версиями ветвления

Сервис объектов, картографический сервис (должен быть зарегестрирован как версионный)

1 или несколько

Кнопка**

Слой объектов, слой сцены

0 или 1

Диаграмма

Слой объектов, слой сцены

1

Редактировать

Векторный слой, слой сцены (слои должны быть доступны для редактирования)

1 или несколько

Внедрение**

Слой объектов, слой сцены

0 или 1

Информация об объекте

Слой объектов, слой сцены

1

Фильтр

Слой объектов, слой сцены

1 для каждого фильтра

Изображение**

Слой объектов, слой сцены

0 или 1

Список

Слой объектов, слой сцены

1

Карта

Веб-карта, веб-сцена

1 или 2

Слои карты

Веб-карта, веб-сцена

0 или 1

Запрос

Слой объектов, слой сцены

1 для каждого запроса

Поиск

Слой объектов, слой сцены

1 для каждого источника слоя

Таблица

Слой объектов, слой сцены

1 для каждого листа

Текст**

Слой объектов, слой сцены

0 или несколько

*Более точный список поддерживаемых типов элементов см в разделе Добавление данных в приложение.

**Виджеты Изображение, Текст, Кнопка и Внедрение по умолчанию статичны. Чтобы отобразить информацию из данных, включите параметр Подключиться к данным и укажите параметры с атрибутами, статистикой или выражениями. Подробнее см. раздел Динамическое содержание.

Выходные данные

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

Исходный виджетТип выходных данныхВыходной набор данных

Диаграмма

Векторный слой

1

Путевой лист

Векторный слой

1 для остановок, точек направлений, линий направлений и маршрутов

Запрос

Векторный слой

1 для каждого запроса

Поиск

Векторный слой

1 для каждого источника локатора

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

Примечание:

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

Схема выходных данных определяется виджетом источника.

  • Диаграмма — статистика с атрибутами поля категории (если настроено) и результатами вычисления числовых полей (не содержат геометрии)
  • Запрос — поднабор записей, которые удовлетворяют критерию запроса, с полями, настроенными в его параметрах Результаты
  • Поиск - адрес результата поиска, найденный в соответствующем источнике локатора

Реальные записи в выходных данных генерируются динамически виджетом источника во время запуска.

Виды источника данных

После того как данные выбраны в настройках виджета, вы можете выбрать один или несколько видов в ниспадающем списке, основываясь на том, сколько источников данных поддерживает виджет. Источник данных имеет четыре типа видов:

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

    Выходные данные не поддерживает добавление пользовательских видов данных.

    Примечание:

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

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

Динамическое содержимое

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

Атрибут

Получить значение атрибута объекта в указанном виде данных можно с помощью одного из следующих видов:

  • Виды, заданные в настройках источника данных виджета.
  • Вид Выбранные объекты исходного слоя данных. Этот вид позволяет отображать результаты взаимодействия, такие как отображение атрибутов выбранного объекта.
  • Вид Авто-заполнение, если виджет находится в виджете Список (например, текст, изображение или кнопка) и имеет тот же вид данных, что и Список. Этот вид содержит только один объект, который представляет элемент списка.

Если выбранный вид содержит несколько объектов, возвращается значение атрибута первого объекта (на основе настроек сортировки в виде данных).

Статистика

Получите статистические результаты набора объектов, определенного видом данных.

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

Выражение

Редактор выражений позволяет вводить текст (формат: “text”), числа, переменные поля (формат: {fieldname}) и функции, включая AVERAGE({fieldname}), COUNT({fieldname}), SUM({fieldname}), MAX({fieldname}) и MIN({fieldname}). Каждая часть соединена знаком плюс (+). Выражение возвращает результат конкатенации строк и вычисления чисел. Например, если вы вводите 1+1, он возвращает 2 (число), но если вы вводите 1 + “1”, он возвращает “11” (строка).

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

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

Если в функции используется числовая переменная поля, например AVG ({fieldname}), функция возвращает статистический результат вида данных для этого поля.

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