Вы можете сделать следующее, чтобы создать динамические и интерактивные приложения с помощью Experience Builder:
- Соединить виджеты с данными и настройте их с помощью динамических ресурсов.
- Настройка взаимодействия между виджетом и средой (источником данных).
- Настроить взаимодействие между виджетами.
К виджетам можно добавить два типа действий: действия с сообщениями и действия с данными. Действия с сообщениями реагируют на триггеры и автоматически выполняют действия, такие как фильтрация списка для отображения только записей в текущем экстенте карты. Для действий с данными есть кнопка Действия, которую пользователи могут нажать в виджетах в процессе работы и выбрать из списка действие, которое необходимо выполнить, например, экспорт записей в файл или в качестве элемента ArcGIS.
Действия с сообщениями
Приложения Experience Builder управляются данными, а это означает, что данные, отображаемые виджетами, могут изменяться везде при обновлении лежащих в основе данных. Вы можете определить взаимодействия между виджетами и данными, настроив действия с сообщениями в ответ на триггеры. Например, вы можете настроить взаимодействие таким образом, что при изменении экстента карты в виджете Карта, остальные виджеты, например виджет Список, обновляют фильтр и отображают только объекты текущего экстента. Для этого необходимо установить Изменение экстента в виджете Карта в качестве триггера и Отфильтровать данные записей в виде данных, используемом виджетом Список в качестве действия. Поскольку виджеты управляются данными, действие фильтра применяется к данным на уровне среды, каждый виджет, использующий один и тот же вид данных, будет синхронизирован автоматически. Вы также можете настраивать взаимодействие между виджетами. Действия, настроенные для виджета, работают только внутри этого виджета. Например, вы можете синхронизировать экстент двух виджетов Карта, когда пользователь масштабирует или перемещает один из них, настроив Изменения экстента одного виджета Карта как триггер и изменив экстент другого виджета как действие.
Эти взаимодействия определяются и управляются в панели Действие исходного виджета, который предоставляет триггеры. Конфигурации Действия с сообщением состоят из трех частей:
- Триггеры из исходного виджета
- Цели, реагирующие на триггер (виджеты и среда приложения)
- Действия со стороны цели, связанные с ее целевым использованием
Триггер исходного виджета может быть добавлен только один раз; однако вы можете добавить несколько действий для этого конкретного триггера из одной или другой цели.
Триггеры
Триггеры – это события, генерируемые исходным виджетом. Когда возникает триггер, любые добавленные к нему действия выполняются в качестве ответа. В следующей таблице описаны семь триггеров, которые поддерживаются в настоящее время:
| Триггер | Описание |
|---|---|
Нажатие кнопки | Триггер срабатывает при щелчке на виджет Кнопка или при щелчке на кнопку виджета Навигация по видам. |
Данные добавлены | Триггер срабатывает, когда источник данных добавляется с помощью виджета Добавить данные. |
Изменения фильтрации данных1 | Триггер срабатывает, когда к источнику данных применяется фильтр. |
Изменения экстента | Триггер срабатывает, когда экстент карты изменяется посредством перемещения, масштабирования, изменения размера и так далее. |
Записи созданы | Триггер срабатывает, когда записи результатов загружаются в исходный виджет. |
Изменения выборки записей | Триггер срабатывает, когда выбрана запись или выбор записи очищен. |
Изменение видов | Триггер срабатывает, когда представление выбирается с помощью виджета Навигация по видам. |
1 Действие Изменения фильтрации данных не поддерживает динамические слои изображения.
Чтобы просмотреть доступные триггеры виджета, откройте его настройки и нажмите Добавить триггер на вкладке Действие. В следующей таблицы приведены исходные виджеты и поддерживаемые триггеры:
| Исходный виджет | Нажатие кнопки | Данные добавлены | Изменения фильтрации данных | Изменения экстента | Изменения выборки записей | Записи созданы | Изменение видов |
|---|---|---|---|---|---|---|---|
Добавить данные |
| ||||||
Кнопка |
| ||||||
Диаграмма |
| ||||||
Информация об объекте |
| ||||||
Фильтр |
| ||||||
Список |
|
| |||||
Карта |
|
| |||||
Ближайшие |
| ||||||
Запрос |
|
| |||||
Поиск |
|
|
| ||||
Выбрать |
| ||||||
Таблица |
| ||||||
Трассировка Инженерной сети |
| ||||||
Навигация по видам |
|
|
Внимание:
Выборка большого количества объектов с помощью виджета Диаграмма или виджета Карта может привести к перегрузке триггера Изменения выборки записей и привести Experience Builder к невыполнению ожидаемого действия.
Цели
Цели выполняют действия. Цель может быть виджетом среды. Если вы используете среду в качестве цели, то действие будет выполняться глобально – во всех соответствующих виджетах и страницах приложения.
Действия
В отличие от триггеров, которые определены средой, действия предоставляются целями (особенно виджетами) для выполнения определенной бизнес-логики. Некоторые действия могут потребовать дополнительной настройки в зависимости от того, как цель реагирует на сообщение от триггера. Например, если вы настраиваете действие фильтра для вида данных, и триггер основан на других данных, вы можете отфильтровать целевой вид данных, установив атрибут или пространственное отношение. Вы также можете настроить условия SQL.
Если вы хотите установить связь атрибутов между полем триггера и полем действия, записи в поле триггера должны точно соответствовать записям в поле действия, включая заглавные буквы.
Различные цели обеспечивают различные действия, соответствующие различным триггерам. Доступные действия появляются, как только вы добавляете триггер и выбираете цель. В следующей таблице перечислены цели и соответствующие им действия:
Подсказка:
Изучите примеры для каждого действия, используя ссылки в столбце Действие ниже.
| Цель | Действие1 | Триггер: Нажатие кнопки | Триггер: Добавление данных | Триггер: Изменения фильтрации данных | Триггер: Изменения выборки записей | Триггер: Изменения экстента | Триггер: Записи созданы | Триггер: Изменение видов |
|---|---|---|---|---|---|---|---|---|
Платформа | Фильтровать записи данных – хранить только те записи данных, которые соответствуют условиям для дальнейшего отображения или обработки через приложение.
|
|
| |||||
Выбрать записи данных2 - отмечает записи как выбранные и помещает их в вид Выбранные объекты. |
| |||||||
Виджет Business Analyst | Выбрать объект - отметить объект, как выбранный. |
| ||||||
Виджет Профиль рельефа | Выбрать линию - отметить линейный объект как выбранный и создать профиль рельефа.
|
| ||||||
Виджет Карта | Добавить на карту - добавить данные в веб-приложение или сцену в качество слоя. |
| ||||||
Закрепить3 – сохранить текущий масштаб и центрировать в указанном местоположении.
|
|
|
|
|
| |||
Приблизить4 – приблизить к указанному местоположению.
|
|
|
|
|
| |||
Подсветить – подсветить объект на карте.
|
| |||||||
Фильтр - хранить только те объекты, которые соответствуют условиям для просмотра виджета Карта.
|
| |||||||
Показать на карте5 — отобразить созданные записи на карте в виде нового слоя.
|
| |||||||
Виджет Ближайшие | Задать местоположение — определить местоположение поиска и найти близлежащие объекты. |
| ||||||
Виджет Боковая панель | Открыть боковую панель — открыть боковую панель. |
|
|
| ||||
Переключить боковую панель - открыть или закрыть боковую панель. |
| |||||||
Виджет Контроллер виджетов | Открыть виджет - открыть виджет в контроллере. |
|
|
Пример: 1Для действий среды, если действие с данными является видом по умолчанию, оно затронет все виджеты, использующие эти данные и их виды. Если действие относится к данным в конкретном виде, оно затронет только виджеты, использующие этот вид. Для действий виджетов каждое действие затронет только целевой виджет. (Например действие фильтра карты применяется только для фильтра записей карты и не затронет другие виджеты, использующие тот же слой.)
2Выбранное состояние записи синхронизируется через приложение, и выбранные записи сохраняются в виде Выбранные объекты. Виджеты могут иметь различную конфигурацию для отображения выбранной записи.
3Если виджет Карта настроен на действия Приблизить к и Переместить к, то действие Приблизить к имеет приоритет. Это означает, что при одновременном перемещении и приближении карты, действие Переместить к игнорируется.
4При добавлении действия Приблизить к вы можете изменить настройки Масштаба увеличения в окне Настройки действия. Выберите Пользовательский, чтобы настроить уровень приближения карты, или выберите Автоматический, чтобы использовать масштаб карты по умолчанию. Действие Приблизить к включает поведение поворота для веб-карт и веб-сцен и поведение наклона для веб-сцен.
5При добавлении действия Показать на карте вы можете настроить символы для созданных записей. Выберите Использовать пользовательские символы, чтобы настроить заливку, контур, прозрачность и многое другое для точек, линий и полигонов. Выберите Использовать символы, заданные слоем, чтобы использовать символы из слоев, связанных с текущим действием в исходном виджете.
Связанные данные
Если источник данных имеет связанные данные, вы можете использовать отношения слоя для настройки действия с сообщением. Следующий триггер, цели и действия поддерживают связанные данные:
| Триггер | Цель | Действия |
|---|---|---|
Изменения выборки записей | Платформа | Выбрать записи данных, фильтровать записи данных |
Карта | Фильтровать, Подсветить |
Действия с данными
Вы можете настроить действия с данными для пользователей, чтобы данные обрабатывались в приложении во время работы. Они могут нажать кнопку Действия на исходных виджетах и передать набор данных в определенный виджет (например, просмотр результатов запроса в таблице) или среду приложения (для экспорта данных).
Эти взаимодействия определяются и управляются в панели Действие исходного виджета, который предоставляет набор данных. Настройки действий с данными состоят из двух частей:
- Цели, получающие набор данных (виджеты и среда приложения)
- Действия с данными, предоставляемые целевым объектом, выполняются только тогда, когда пользователи задают действие
Набор данных, передаваемый целевому объекту, варьируется в зависимости от исходного виджета. Например, виджет Диаграмма передает все статистические данные виджету Таблица, независимо от наличия выборки.
В следующих двух таблицах перечислены доступные исходные виджеты, целевые объекты и поддерживаемые действия с данными (цель: действия с данными):
| Исходный виджет | Платформа: Экспорт | Платформа: Связанные данные 1 | Платформа: Задать фильтр | Платформа: Статистика | Анализ: Задать в качестве входных данных анализа | Путевой лист: Маршрут от | Путевой лист: Маршрут до |
|---|---|---|---|---|---|---|---|
Анализ |
|
| |||||
Добавить данные |
|
|
|
| |||
Диаграмма |
|
|
| ||||
Информация об объекте |
|
|
|
|
|
|
|
Список |
|
|
|
|
|
|
|
Карта |
|
|
|
|
| ||
Слои карты |
|
|
|
| |||
Ближайшие |
|
| |||||
Запрос |
|
|
|
|
|
|
|
Выбрать |
|
|
|
|
|
| |
Таблица |
|
|
|
|
|
|
|
| Исходный виджет | Путевой лист: планирование маршрута | Профиль рельефа: Просмотр профиля рельефа | Карта: Переместить к | Карта: Показать на карте2 | Карта: Приблизить к | Карта: Добавить на карту3 | Ближайшие: Задать местоположение | Таблица: Добавить в таблицу | Таблица: Посмотреть в таблице4 |
|---|---|---|---|---|---|---|---|---|---|
Анализ |
|
|
|
| |||||
Добавить данные |
|
|
|
|
| ||||
Диаграмма |
|
| |||||||
Информация об объекте |
|
|
|
|
|
|
| ||
Список |
|
|
|
|
|
|
|
| |
Карта |
|
|
|
|
|
| |||
Слои карты |
|
| |||||||
Ближайшие |
| ||||||||
Запрос |
|
|
|
|
|
|
|
| |
Выбрать |
|
|
|
|
|
|
| ||
Таблица |
|
|
|
|
|
|
|
1 Поля Arcade не отображаются должным образом при выполнении действия Связанные данные. Experience Builder не поддерживает arcade на данный момент.
2 При добавлении действия Показать на карте вы можете настроить символы для созданных записей.
3 Вы не можете добавлять один и тот же слой из виджета Добавить данные на карту несколько раз. Как только вы используете действие с данными Добавить на карту с виджетом Таблица или Добавить данные, оно исчезает как опция для этого слоя в обоих виджетах. Если вы настроите виджет Анализ на автоматическое добавление результирующих слоев на карту, Добавить на карту будет недоступно в качестве действия с данными для этих результатов.
4 Вы можете добавить много типов данных с помощью виджета Добавить данные, но только те типы данных, которые поддерживает виджет Таблица (векторные слои и слои сцены со связанными векторными слоями), могут инициировать действие с данными Добавить в таблицу.
Когда действие с данными выполняется над целевым виджетом, целевой виджет включает в себя кнопку для очистки. Например, когда пользователь выбирает данные в виджете Список и выбирает просмотр выборки в виджете Таблица, рядом с новым листом появляется кнопка, позволяющая удалить лист из таблицы. Точно так же, когда они выбирают действие с данными Показать на карте, на карте появляется кнопка, чтобы очистить карту. (Обновление страницы очищает все результаты действий с данными.)
Примечание:
Начиная с версии от февраля 2024 года, Experience Builder загружает только необходимые поля, чтобы повысить производительность. Например, если виджет настроен на использование определенных полей из источника данных, Experience Builder загружает только эти поля. Из-за этого выгруженные поля могут не отображаться при выполнении действия с данными Статистика. Если вы хотите просмотреть статистику для большего количества полей, вы можете использовать действия с данными Просмотреть в таблице или Добавить в таблицу для просмотра данных в виджете Таблица во время запуска, а также использовать действие с данными Статистика в виджете Таблица.
Уровни действий с данными
Действия с данными могут влиять на некоторые или все данные из исходного виджета. Действия с данными, которые влияют на все записи во всем источнике данных, называются действиями на уровне источника данных. Действия с данными, которые влияют только на выбранные записи, загруженные записи или текущую запись, называются действиями на уровне записи.
В следующей таблице перечислены исходные виджеты и поддерживаемые ими уровни действий с данными:
| Исходный виджет | Уровень действий с данными | Уровень записи | ||
|---|---|---|---|---|
Все записи | Выбранные записи | Загруженные записи | Текущая запись | |
Добавить данные |
| |||
Диаграмма |
|
| ||
Информация об объекте |
|
| ||
Список |
|
| ||
Карта |
| |||
Слои карты |
| |||
Ближайшие |
| |||
Запрос |
|
|
| |
Выбрать |
| |||
Таблица |
|
|
|
|
В следующей таблицы приведены все возможные цели и поддерживаемые ими уровни действий с данными:
| Цель | Действие | Уровень действий с данными | Уровень записи |
|---|---|---|---|
Анализ | Задать в качестве входных данных анализа |
|
|
Профиль рельефа | Просмотр профиля рельефа |
| |
Путевой лист | Маршрут от |
| |
Маршрут до |
| ||
Планирование маршрута |
| ||
Платформа | Экспорт |
|
|
Связанные данные |
| ||
Задать фильтр |
| ||
Статистика |
|
| |
Карта | Приблизить к |
|
|
Переместить к |
|
| |
Показать на карте |
| ||
Добавить к карте |
| ||
Ближайшие | Задать местоположение |
|
|
Таблица | Добавить в таблицу |
| |
Просмотреть в таблице |
|
Настройка взаимодействий
Настройте действия с сообщениями и действия с данными в панели Действия исходных виджетов.
Настройка действий с сообщениями
Действия с сообщениями можно настроить в настройках исходных виджетов (виджеты, предоставляющие триггеры).
Для настройки действий с сообщениями, выполните следующие шаги:
- На панели Действия на вкладке Действия с сообщениями щелкните Добавить триггер.
- Выберите триггер, выберите цель, а также добавьте и выберите действия.
Некоторые действия, такие как Фильтровать, Подсветить и Выбрать записи данных, требуют дополнительной настройки. При выборе действия отображаются параметры Настройки действия. Каждый триггер можно добавить только один раз.
- Чтобы добавить несколько действий для одного и того же триггера, нажмите Добавить действие.
Действия для одного и того же триггера происходят в последовательном порядке.
- Перетащите действия, сгруппированные под триггером, чтобы изменить порядок.
- Чтобы изменить эти настроенные параметры позже, нажмите кнопку Настройки действия
. - Чтобы изменить действие или цель после добавления действия, удалите его и добавьте новое.
Удаление триггера также удаляет все добавленные к нему действия.
Настройка действий с данными
Действия с данными можно настроить в настройках исходных виджетов, за исключением Экспорта, который настраивается для источника данных в панели Данные. Действия с данными включены по умолчанию, и кнопка Действия виджета автоматически включает все доступные действия с данными.
Для настройки действий с данными, выполните следующие шаги:
- На панели Действия на вкладке Действие с данными снимите или установите флажок Действия с данными, чтобы указать параметры меню действия виджета. Либо отключите Активировать действие с данными, чтобы исключить кнопку Действия из виджета.
- Для каждого отмеченного действия с данными выберите целевые виджеты для взаимодействия с исходным виджетом, например виджет Карта.
Вы можете выбрать только те целевые виджеты, которые находятся на той же странице, что и исходный виджет.
Примечание:
Когда вы добавляете целевой виджет на страницу, его соответствующие действия с данными автоматически добавляются в доступные исходные виджеты на той же странице.
Подсказка:
Для достижения наилучшего результата поместите исходный виджет рядом с целевым виджетом, поскольку действия с данными не переходят в целевое местоположение в приложении.
- Чтобы исключить действие с данными Экспорт, перейдите на панель Данные и отключите Разрешить экспорт для источника данных.
Пример использования
Добавьте действия с сообщениями для поддержки следующих требований к дизайну приложения:
- Вы хотите создать приложение, которое сравнивает две карты, две сцены или карту и сцену, поэтому экстенты двух виджетов карты всегда должны быть синхронизированы. Вы можете добавить триггер Изменения экстента к обоим виджетам, выбрать другой виджет в качестве цели для каждого из них и выбрать действие Закрепить или Приблизить.
- Вы добавляете виджет Список рядом с виджетом Карта и хотите, чтобы список отображал только записи в текущем экстенте карты. Вы можете добавить триггер Изменения экстента в виджет Карта, выбрать действие среды Фильтр записей данных, выбрать действие данных для вида данных, настроенного в опциях виджета Список и настроить действие с пространственным отношением к экстенту.
Используйте действия с данными для поддержки следующих требований к дизайну приложения:
- Вы добавляете виджет Диаграмма для представления набора числовых или категорийных данных в виде графика и хотите предоставить пользователю возможность просматривать статистические данные, генерируемые диаграммой, в виджете Таблица. При добавлении виджета Таблица рядом с виджетом Диаграмма действие с данными Посмотреть в таблице добавляется в виджет Диаграмма автоматически. Во время выполнения пользователь может нажать кнопку Действия в виджете Диаграмма и выбрать Посмотреть в таблице, чтобы отобразить статистические данные в виджете Таблица.
Подсказка:
Если целевой виджет, которым в данном примере является виджет Таблица, расположен в виджете Контроллер виджетов, целевой виджет автоматически открывается в Контроллере виджетов, когда пользователь активирует действие с данными.
- Вы добавляете виджет Список для отображения записи данных и виджет Карта для отображения другой записи данных. Вы хотите предоставить пользователю возможность отображения на карте объекта, соответствующего записи, выбранной в списке, для сравнения различных данных на одной карте. Во время выполнения пользователь может нажать на кнопку Действия в виджете Список и выбрать Показать на карте.
- Вы показываете записи данных в виджете Таблица и хотите, чтобы пользователи могли экспортировать данные. Если для источника данных включен параметр Разрешить экспорт, они могут нажать кнопку Действия в виджете Таблица и экспортировать выбранные записи или все записи.