向微件添加操作

可按照以下操作使用 Experience Builder 创建动态和交互式应用程序:

  • 连接微件与数据,然后使用动态内容对微件进行配置。
  • 配置微件和框架(数据源)之间的交互。
  • 配置微件之间的交互。

可向微件添加两种类型的操作:消息操作数据操作。 消息操作用于响应触发器并自动执行操作,例如过滤列表以仅显示地图当前范围内的记录。 数据操作用于提供一个操作按钮,用户可以在运行时单击微件中的该按钮,然后从要执行的操作列表中进行选择,例如将记录导出到文件或导出为 ArcGIS 项目。

消息操作

Experience Builder 应用程序由数据驱动,这意味着微件显示的数据可以在基础数据更新时统一更改。 您可以通过配置消息操作以响应触发器来定义小部件与数据之间的交互。 例如,您可以创建一个交互,以在“地图”微件更改其范围时,其他微件(例如“列表”微件)将进行过滤并仅显示当前范围中的要素。 要执行此操作,请将“地图”微件中的范围更改设置为触发器,并将数据视图中“列表”微件使用的过滤数据记录设置为操作。 由于微件受数据驱动,因此过滤器操作将应用于框架级别的数据,并且使用相同数据视图的所有微件将自动同步。 您还可以定义微件之间的交互。 微件提供的操作仅在该微件中生效。 例如,您可以通过将一个“地图”微件的范围更改设置为触发器,将另一个“地图”微件的更改范围设置为操作来同步两个“地图”微件的范围。

此类交互在提供触发器的源微件的操作面板中进行定义和管理。 消息操作配置具有三个部分:

  • 源微件的触发器
  • 响应触发器的目标(微件和应用程序框架)
  • 目标所采取的与其预期用途相关的操作

源微件的触发器只能添加一次;但是,可为来自同一目标或不同目标的该特定触发器添加多个操作。

触发器

触发器是由源微件生成的事件。 在触发触发器后,将运行添加到该触发器的所有操作以进行响应。 下表介绍当前支持的七个触发器:

触发描述

按钮单击

当单击“按钮”微件或单击“视图导航”微件按钮时,会触发一个触发器。

已添加数据

在使用添加数据微件添加数据源后,会触发触发器。

数据过滤更改1

将过滤应用到数据源时触发触发器。

范围更改

当地图的范围通过平移、缩放、调整大小等操作进行更改时,将触发触发器。

记录已创建

在源微件中加载结果记录时,将触发触发器。

记录选择更改

当选择记录或清除所选记录时,将触发触发器。

视图更改

当使用视图导航微件选择视图时,会触发一个触发器。

1数据过滤更改操作不支持动态影像图层

要查看微件的可用触发器,打开其设置,然后单击操作选项卡上的添加触发器。 下表列出了源微件及其支持的触发器:

源微件按钮单击已添加数据数据过滤更改范围更改记录选择更改记录已创建视图更改

添加数据

是

按钮

是

图表

是

要素信息

是

过滤器

是

列表

是

是

地图

是

是

周边

是

查询

是

是

搜索

是

是

是

选择

是

是

公共设施网络追踪

是

视图导航

是

是

警告:

使用图表微件或地图微件选择大量要素可能使记录选择更改触发器无法处理,进而导致 Experience Builder 无法执行预期操作。

目标

目标执行操作。 目标可以是微件或框架。 如果使用框架作为目标,则将在应用程序的所有相关微件和页面中全局执行操作。

操作

与框架定义的触发器不同,操作由目标(尤其是微件)提供,用于执行特定的业务逻辑。 根据目标如何响应来自触发器的消息,某些操作可能需要其他配置。 例如,如果要为数据视图配置过滤器操作,并且触发器基于不同的数据,则可以通过建立属性或空间关系来过滤目标数据视图。 也可以设定 SQL 条件

如果要在触发字段和操作字段之间建立属性关系,则触发字段中的记录必须与操作字段中的记录完全匹配,包括大小写。

不同的目标提供不同的动作与不同的触发器相对应。 添加触发器并选择目标后,将显示可用操作。 下表列出了目标及其相应的操作:

提示:

使用以下操作列中的链接浏览每个操作的示例。

目标操作1触发器:按钮单击触发器:已添加数据触发器:数据过滤更改触发器:记录选择更改触发器:范围更改触发器:已创建记录触发器:视图更改

框架

过滤数据记录 - 仅保留数据视图中符合条件的记录,以通过应用程序进一步显示或处理。

示例:英国可能的住宅建筑地点

是

是

选择数据记录2 - 将记录标记为选中并将其放入选定要素视图。

示例:美国各州、县和人口普查区域

是

Business Analyst 微件

选择要素 - 将要素标记为选定。

是

“高程剖面”微件

选择线 - 将线要素标记为选定并生成高程剖面图。

示例:美国国家公园管理局路径

是

“地图”微件

添加至地图 - 将数据作为图层添加至 Web 地图或场景。

示例:数据查看器

是

平移至3 - 保持当前比例并在指定位置居中。

示例:波士顿观鸟地点

是

是

是

是

是

缩放至4 - 缩放至指定位置。

示例:波特兰 2D 和 3D

是

是

是

是

是

闪烁 - 使要素在地图中闪烁。

示例:浏览新英格兰

是

过滤器 - 仅保留满足在“地图”微件中查看的条件的要素。

示例:华盛顿特区观光地点

是

在地图中显示5 - 在地图上将创建的记录显示为新图层。

示例:ArcGIS Geocoding service

是

“周边”微件

设置位置 - 定义搜索位置并查找附近的要素。

是

侧边栏微件

打开侧边栏 - 打开侧边栏

是

是

是

切换侧边栏 - 打开或关闭侧边栏。

是

微件控制器微件

打开微件 - 在控制器中打开微件。

是

是

1对于框架操作,如果操作数据是默认视图,则该操作将影响使用该数据及其视图的所有微件。 如果操作数据是指定的视图,则该操作将仅影响使用该视图的微件。 对于微件操作,该操作将仅在目标微件上执行。 (例如,地图过滤器操作只会过滤地图中的记录,而不会影响使用同一图层的所有其他微件。)

2记录的选定状态会在整个应用程序中同步,并且选定的记录将保存在数据的所选要素视图。 微件可以使用其他配置显示所选记录。

3如果“地图”微件配置了缩放至平移至操作,则缩放至操作优先。 这意味着如果用户同时平移和缩放地图,则平移至操作将被忽略。

4当添加缩放至操作时,您可以在操作设置窗口中更改缩放比例设置。 选择自定义调整地图的缩放级别,或选择自动使用地图的默认比例。 缩放至操作包括 web 地图和 web 场景的旋转行为以及 web 场景的倾斜行为。

5当您添加在地图上显示操作时,可以为创建的记录自定义符号。 选择使用自定义符号可自定义点、线和面的填充、轮廓、透明度等。 选择使用由图层定义的符号以使用与源微件中的当前操作关联的图层中的符号。

相关数据

如果数据源有相关数据,可以使用图层的关系来配置消息操作。 以下触发器、目标和操作支持相关数据:

触发目标操作

记录选择更改

框架

选择数据记录,过滤数据记录

地图

过滤,闪烁

数据操作

配置数据操作以供用户在运行时在应用程序中处理数据。 最终用户可以在源微件上单击操作按钮,然后将数据集传递到特定微件(例如在表中查看查询结果)或应用程序框架(用于导出数据)。

此类交互在提供运行时数据集的源微件的操作面板中进行定义和管理。 “数据”操作配置具有两个部分:

  • 用于接收数据集的目标(微件和应用程序框架)
  • 目标提供的数据操作,仅当用户指定操作时执行

传递到目标的数据集取决于源微件。 例如,“图表”微件可将所有统计数据传递到“表格”微件,无论选择是否存在。

下面的两个表中列出了可用源微件、目标和支持的数据操作(目标:数据操作):

源微件框架:导出框架:相关数据1框架:设置过滤器框架:统计数据分析:设置为分析输入方向:起始方向方向:目标方向

分析

是

是

添加数据

是

是

是

是

图表

是

是

是

要素信息

是

是

是

是

是

是

是

列表

是

是

是

是

是

是

是

地图

是

是

是

是

是

地图图层

是

是

是

是

周边

是

是

查询

是

是

是

是

是

是

是

选择

是

是

是

是

是

是

是

是

是

是

是

是

是

源微件方向:计划路径高程剖面:视图高程剖面地图:平移到地图:在地图上显示2地图:缩放到地图:添加到地图3周边:设置位置表:添加至表表:在表中查看4

分析

是

是

是

是

添加数据

是

是

是

是

是

图表

是

是

要素信息

是

是

是

是

是

是

是

列表

是

是

是

是

是

是

是

是

地图

是

是

是

是

是

是

地图图层

是

是

周边

是

查询

是

是

是

是

是

是

是

是

选择

是

是

是

是

是

是

是

是

是

是

是

是

是

是

1相关数据操作当前不支持 Arcade 字段。 Experience Builder 目前不支持 Arcade。

2当您添加在地图上显示操作时,可以为创建的记录自定义符号

3无法多次将同一图层从“添加数据”微件添加至地图。 将添加至地图数据操作与“表格”或“添加数据”微件配合使用后,它将作为该图层的选项在两个微件中消失。 如果您将“分析”微件配置为自动将结果图层添加至地图,则添加至地图无法作为这些结果的数据操作。

4可以使用“添加数据”微件添加多种类型的数据,但是只有“表格”微件支持的数据类型(具有关联的要素图层的要素图层和场景图层)才能触发添加至表数据操作。

对目标微件执行数据操作时,目标微件包含一个用于清除数据的按钮。 例如,如果用户在“列表”微件中选择数据并选择在“表”微件中查看选择,将在新工作表旁边显示一个按钮,用于从表中移除该工作表。 同样,如果最终该用户选择在地图上显示数据操作,将在地图中显示一个按钮,用于将其从地图中清除。 (刷新页面将清除所有数据操作结果。)

注:

从 2024 年 2 月版本开始,Experience Builder 仅加载必要的字段以提高性能。 例如,如果微件配置为使用数据源中的某些字段,则 Experience Builder 仅加载这些字段。 因此,当您运行统计数据操作时,可能不会显示未加载的字段。 如果要查看更多字段的统计数据,可以使用在表中查看添加至表数据操作在运行时查看表微件中的数据,并使用表微件的统计数据操作。

数据操作级别

数据操作会影响源微件中的部分或全部数据。 影响整个数据源中所有记录的数据操作称为数据源级别的操作。 仅影响所选记录、已加载记录或当前记录的数据操作称为记录级别的操作。

下表列出了源微件及其受支持的数据操作级别:

源微件数据源级别记录级别

所有记录

所选记录

已加载记录

当前记录

添加数据

是

图表

是

是

要素信息

是

是

列表

是

是

地图

是

地图图层

是

周边

是

查询

是

是

是

选择

是

是

是

是

是

下表列出了所有可能的目标及其受支持的数据操作级别:

目标操作数据源级别记录级别

分析

设置为分析输入

是

是

高程剖面

视图高程剖面

是

方向

起始方向

是

目标方向

是

计划路径

是

框架

导出

是

是

相关数据

是

设置过滤器

是

统计数据

是

是

地图

缩放至

是

是

平移至

是

是

在地图上显示

是

添加至地图

是

周边

设置位置

是

是

添加至表

是

在表格中查看

是

配置交互

在源微件的操作面板中配置消息操作和数据操作。

配置消息操作

可在源微件(提供触发器的微件)的设置中配置消息操作

要配置消息操作,请完成以下步骤:

  1. 操作面板的消息操作选项卡中,单击添加触发器
  2. 选择触发器,选择目标,然后添加并选择操作。

    过滤闪烁选择数据记录等操作需要其他配置。 操作设置选项会在选择操作时显示。 所有触发器只能添加一次。

  3. 要为同一触发器添加多个操作,单击添加操作

    同一触发器的操作按顺序发生。

  4. 拖动在触发器下分组的操作可更改顺序。
  5. 要稍后修改这些已配置设置,单击操作的设置按钮 设置
  6. 要在添加操作后更改操作或目标,删除该操作,然后添加新操作。

    删除触发器时,还会删除向其添加的所有操作。

配置数据操作

可在源微件的设置中配置数据操作导出例外,需要在数据面板中针对数据源进行配置。 默认启用数据操作,微件的操作按钮会自动包含所有其可用数据操作。

要配置数据操作,请完成以下步骤:

  1. 操作面板的数据操作选项卡中,取消选中或选择数据操作以指定微件操作菜单选项。 否则,关闭启用数据操作以从微件中排除操作按钮。
  2. 对于每个选中的数据操作,为源微件选择要与之交互的目标微件,例如“地图”微件。

    只能选择源微件所在的页面中的目标微件。

    注:

    将目标微件添加到页面时,其对应的数据操作会自动添加到同一页面中的可用源位置。

    提示:

    要获取最佳结果,将源微件置于目标微件旁,因为数据操作不会跳转至应用程序中的目标位置。

  3. 要排除导出数据操作,转至数据面板,然后关闭数据源的允许导出

示例用法

可以添加消息操作以支持应用程序设计要求,例如在以下场景中:

  • 您想要构建用于比较两个地图、两个场景或一个地图和一个场景的应用程序,以使两个“地图”微件的范围始终同步。 可向两个微件添加范围更改触发器,选择另一个微件作为这两个微件的目标,然后选择平移至缩放至操作。
  • 您在“地图”微件旁边添加“列表”微件,并希望该列表仅显示地图当前范围内的记录。 您可以向“地图”微件添加一个范围更改触发器,选择框架过滤数据记录操作,选择操作数据作为“列表”微件设置中配置的数据视图,然后为操作配置范围的空间关系。

可以使用数据操作以支持应用程序设计要求,例如在以下场景中:

  • 您添加“图表”微件以将数值或定性数据集表示为图形,并希望为用户提供在“表”微件中查看图表生成的统计数据的选项。 在“图表”微件旁添加“表”微件时,系统会自动将在表中查看数据操作添加到“图表”微件。 在运行时,用户可以单击“图表”微件中的操作按钮,然后选择在表中查看以在“表”微件中显示统计数据。
    提示:

    如果目标微件(在本示例中为“表格”微件)位于“微件控制器”微件中,则当用户激活数据操作时,目标微件将自动在“微件控制器”中打开。

  • 您将添加“列表”微件以显示数据记录,并添加“地图”微件以显示其他数据记录。 您希望为用户提供可以选择在地图中显示与在列表中选择的记录对应的要素,以在同一地图中比较不同数据。 在运行时,用户可以单击“列表”微件中的操作按钮,然后选择在地图中显示
  • 您将在“表”微件中显示数据记录并希望用户可以选择导出数据。 为数据源启用允许导出后,最终用户可以单击“表格”微件中的操作按钮,并导出所选记录或所有记录。