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

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

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

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

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

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

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

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

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

Триггеры

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

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

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

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

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

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

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

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

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

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

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

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

Диаграмма

Да

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

Да

Фильтр

Да

Список

Да

Карта

Да

Да

Запрос

Да

Да

Поиск

Да

Да

Да

Таблица

Да

Цели

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

Действия

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

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

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

Платформа

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

Да

Да

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

Да

Виджет Карта

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

Да

Да

Да

Да

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

Да

Да

Да

Да

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

Да

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

Да

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

Да

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

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

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

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

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

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

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

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

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

Исходный виджетПлатформа: ЭкспортКарта: Приблизить кКарта: Переместить кКарта: Показать на карте*Таблица: Посмотреть в таблице

Диаграмма

Все или выбранные записи (статистические данные)

Н/Д

Н/Д

Н/Д

Все записи (статистические данные)

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

Выборка

Выборка

Выборка

Выборка

Выборка

Список

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

Выборка

Выборка

Выборка

Выборка

Запрос

Все или выбранные записи (результат выполнения запроса)

Все записи (результат выполнения запроса)

Все записи (результат выполнения запроса)

Все записи (результат выполнения запроса)

Все записи (результат выполнения запроса)

Таблица

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

Выборка

Выборка

Выборка

Н/Д

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Примечание:

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

    Подсказка:

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

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

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

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

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

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

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