Добавление действий к виджетам

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

  • Соединить виджеты с данными и настройте их с помощью динамических ресурсов.
  • Настройка взаимодействия между виджетом и средой (источником данных).
  • Настроить взаимодействие между виджетами.

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

Действия с сообщениями

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

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

  • Триггеры из исходного виджета
  • Цели, реагирующие на триггер (виджеты и среда приложения)
  • Действия со стороны цели, связанные с ее целевым использованием

Триггер исходного виджета может быть добавлен только один раз; однако вы можете добавить несколько действий для этого конкретного триггера из одной или другой цели.

Триггеры

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

ТриггерОписание

Изменения фильтрации данных

Триггер возникает, когда к источнику данных применяется фильтр.

Изменения экстента

Триггер возникает, когда экстент карты изменяется посредством панорамирования, масштабирования, изменения размера и так далее.

Изменения выборки записей

Триггер возникает, когда выбрана запись или выбор записи очищен.

Записи созданы

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

Данные добавлены

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

Чтобы просмотреть доступные триггеры виджета, откройте его настройки и нажмите Добавить триггер на вкладке Действие. В следующей таблицы приведены исходные виджеты и поддерживаемые триггеры:

Исходный виджетДанные добавленыИзменения фильтрации данныхИзменения экстентаИзменения выборки записейЗаписи созданы

Добавить данные

Да

Диаграмма

Да

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

Да

Фильтр

Да

Список

Да

Карта

Да

Да

Запрос

Да

Да

Поиск

Да

Да

Да

Таблица

Да

Трассировка Инженерной сети

Да

Цели

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

Действия

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

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

Подсказка:

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

ЦельДействие1Триггер: Добавление данныхТриггер: Изменения фильтрации данныхТриггер: Изменения выборки записейТриггер: Изменения экстентаТриггер: Записи созданы

Платформа

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

Пример: Потенциальные участки для жилищного строительства в Великобритании

Да

Да

Выбрать записи данных2 - отмечает записи как выбранные и помещает их в вид Выбранные объекты.

Пример: Штата США, районы и избирательные округа

Да

Виджет Business Analyst

Выбрать объект - отметить объект, как выбранный.

Да

Виджет Профиль рельефа

Выбрать линию - отметить линейный объект как выбранный и создать профиль рельефа.

Пример: тропы Службы национальных парков

Да

Виджет Карта

Добавить на карту - добавить данные в веб-приложение или сцену в качество слоя.

Пример: Пользователь, имеющий право просматривать данные

Да

Закрепить3 – сохранить текущий масштаб и центрировать в указанном местоположении.

Пример: Птицы в Бостоне

Да

Да

Да

Да

Да

Приблизить4 – приблизить к указанному местоположению.

Пример: Портланд в 2D и в 3D

Да

Да

Да

Да

Да

Подсветить – подсветить объект на карте.

Пример: Изучение Новой Англии

Да

Фильтр - хранить только те объекты, которые соответствуют условиям для просмотра виджета Карта.

Пример: Местоположения для посещения Вашингтона, Округ Колумбия

Да

Показать на карте5 — отобразить созданные записи на карте в виде нового слоя.

Пример: ArcGIS World Geocoding Service

Да

Виджет Ближайшие

Задать местоположение — определить местоположение поиска и найти близлежащие объекты.

Да

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

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

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

4При добавлении действия Приблизить к вы можете изменить настройки Масштаба увеличения в окне Настройки действия. Выберите Пользовательский, чтобы настроить уровень приближения карты, или выберите Автоматический, чтобы использовать масштаб карты по умолчанию. Действие Приблизить к включает поведение поворота для веб-карт и веб-сцен и поведение наклона для веб-сцен.

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

Действия с данными

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

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

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

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

В следующей таблице перечислены доступные исходные виджеты, целевые объекты и поддерживаемые действия с данными (цель: действия с данными):

Исходный виджетПлатформа: ЭкспортПлатформа: Задать фильтрПутевой лист: Маршрут отПутевой лист: Маршрут доПрофиль рельефа: Просмотр профиля рельефаКарта: Переместить кКарта: Показать на карте1Карта: Приблизить кКарта: Добавить на карту2Ближайшие: Задать местоположениеТаблица: Посмотреть в таблице3

Анализ

Да

Да

Да

Да

Добавить данные

Да

Да

Да

Да

Да

Да

Диаграмма

Да

Да

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

Да

Да

Да

Да

Да

Да

Да

Да

Да

Да

Список

Да

Да

Да

Да

Да

Да

Да

Да

Да

Да

Карта

Да

Да

Да

Да

Да

Да

Да

Да

Да

Слои карты

Да

Да

Ближайшие

Да

Запрос

Да

Да

Да

Да

Да

Да

Да

Да

Да

Да

Таблица

Да

Да

Да

Да

Да

Да

Да

Да

Да

Да

1При добавлении действия Показать на карте вы можете настроить символы для созданных записей.

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

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

Когда действие с данными выполняется над целевым виджетом, целевой виджет включает в себя кнопку для очистки. Например, когда пользователь выбирает данные в виджете Список и выбирает просмотр выборки в виджете Таблица, рядом с новым листом появляется кнопка, позволяющая удалить лист из таблицы. Точно так же, когда они выбирают действие с данными Показать на карте, на карте появляется кнопка, чтобы очистить карту. (Обновление страницы очищает все результаты действий с данными.)

Уровни действий с данными

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

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

Исходный виджетУровень действий с даннымиУровень записи

Все записи

Выбранные записи

Загруженные записи

Текущая запись

Добавить данные

Да

Диаграмма

Да

Да

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

Да

Да

Список

Да

Да

Карта

Да

Слои карты

Да

Ближайшие

Да

Запрос

Да

Да

Да

Таблица

Да

Да

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

ЦельДействиеУровень действий с даннымиУровень записи

Профиль рельефа

Просмотр профиля рельефа

Да

Путевой лист

Маршрут от

Да

Маршрут до

Да

Платформа

Экспорт

Да

Да

Задать фильтр

Да

Карта

Приблизить к

Да

Да

Переместить к

Да

Да

Показать на карте

Да

Добавить к карте

Да

Ближайшие

Задать местоположение

Да

Таблица

Просмотреть в таблице

Да

Да

Настройка взаимодействий

Настройте действия с сообщениями и действия с данными в панели Действия исходных виджетов.

Настройка действий с сообщениями

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

Для настройки действий с сообщениями, выполните следующие шаги:

  1. На панели Действия на вкладке Действия с сообщениями щелкните Добавить триггер.
  2. Выберите триггер, выберите цель, а также добавьте и выберите действия.

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

  3. Чтобы добавить несколько действий для одного и того же триггера, нажмите Добавить действие.

    Действия для одного и того же триггера происходят в последовательном порядке.

  4. Перетащите действия, сгруппированные под триггером, чтобы изменить порядок.
  5. Чтобы изменить эти настроенные параметры позже, нажмите кнопку Настройки действия Настройки.
  6. Чтобы изменить действие или цель после добавления действия, удалите его и добавьте новое.

    Удаление триггера также удаляет все добавленные к нему действия.

Настройка действий с данными

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

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

  1. На панели Действия на вкладке Действие с данными снимите или установите флажок Действия с данными, чтобы указать параметры меню действия виджета. Либо отключите Активировать действие с данными, чтобы исключить кнопку Действия из виджета.
  2. Для каждого отмеченного действия с данными выберите целевые виджеты для взаимодействия с исходным виджетом, например виджет Карта.

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

    Примечание:

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

    Подсказка:

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

  3. Чтобы исключить действие с данными Экспорт, перейдите на панель Данные и отключите Разрешить экспорт для источника данных.

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

Добавьте действия с сообщениями для поддержки следующих требований к дизайну приложения:

  • Вы хотите создать приложение, которое сравнивает две карты, две сцены или карту и сцену, поэтому экстенты двух виджетов карты всегда должны быть синхронизированы. Вы можете добавить триггер Изменения экстента к обоим виджетам, выбрать другой виджет в качестве цели для каждого из них и выбрать действие Закрепить или Приблизить.
  • Вы добавляете виджет Список рядом с виджетом Карта и хотите, чтобы список отображал только записи в текущем экстенте карты. Вы можете добавить триггер Изменения экстента в виджет Карта, выбрать действие среды Фильтр записей данных, выбрать действие данных для вида данных, настроенного в опциях виджета Список и настроить действие с пространственным отношением к экстенту.

Используйте действия с данными для поддержки следующих требований к дизайну приложения:

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

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

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