向微件添加操作

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

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

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

消息操作

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

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

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

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

触发器

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

触发	描述
数据过滤更改	将过滤应用到数据源时触发触发器。
范围更改	当地图的范围通过平移、缩放、调整大小等操作进行更改时，将触发触发器。
记录选择更改	当选择记录或清除所选记录时，将触发触发器。
记录已创建	在源微件中加载结果记录时，将触发触发器。
已添加数据	在使用添加数据微件添加数据源后，会触发触发器。

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

源微件	已添加数据	数据过滤更改	范围更改	记录选择更改	记录已创建
添加数据
图表
要素信息
过滤器
列表
地图
查询
搜索
表

目标

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

操作

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

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

目标	操作^1	触发器：已添加数据	触发器：数据过滤更改	触发器：记录选择更改	触发器：范围更改	触发器：已创建记录
框架	过滤数据记录 - 仅保留数据视图中符合条件的记录，以通过应用程序进一步显示或处理。
	选择数据记录^2 - 将记录标记为选中并将其放入选定要素视图。
Business Analyst 微件	选择要素 - 将要素标记为选定。
“高程剖面”微件	选择线 - 将线要素标记为选定并生成高程剖面图。
地图微件	添加至地图 - 将数据作为图层添加至 Web 地图或场景。
	平移至^3 - 保持当前比例并在指定位置居中。
	缩放至^4 - 缩放至指定位置。
	闪烁 - 使要素在地图中闪烁。
	过滤器 - 仅保留满足在“地图”微件中查看的条件的要素。
	在地图中显示^5 - 在地图上将创建的记录显示为新图层。

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

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

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

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

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

数据操作

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

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

• 用于接收数据集的目标（微件和应用程序框架）
• 目标提供的数据操作仅在用户选择时执行

传递到目标的数据集取决于源微件。 例如，“图表”微件可用于将所有统计数据传递到“表”微件，无论是否选择。 下表列出了可用源微件、目标和支持的数据操作（目标：数据操作）以及每个源微件针对每个适用操作传递的数据集。

源微件	框架：导出	框架：设置过滤器	地图：平移到	地图：在地图上显示^1	地图：缩放到	地图：添加至地图	表：在表中查看
添加数据	所有记录	所有记录	所有记录		所有记录	所有记录	所有记录^2
图表	所有或选定记录（统计数据）						所有或选定记录（统计数据）
要素信息	所有或选定记录		所选记录	所选记录	所选记录		所选记录
列表	所有或选定记录		所有或选定记录	所选记录	所有或选定记录		所有或选定记录
地图图层	所有记录						所有记录
查询	所有或选定记录（查询结果）		所有或选定记录（查询结果）	所有或选定记录（查询结果）	所有或选定记录（查询结果）		所有或选定记录（查询结果）
表	所有或选定记录		所有或选定记录	所选记录	所有或选定记录

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

²可以使用“添加数据”微件添加多种类型的数据，但是只有“表格”微件支持的数据类型（具有关联的要素图层的要素图层和场景图层）才能触发在表格中查看数据操作。

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

配置交互

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

配置消息操作

可在源微件（提供触发器的微件）的设置中配置消息操作。

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

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

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

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

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

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

配置数据操作

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

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

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

   注：

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

   提示：

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

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

示例用法

添加消息操作以满足以下应用程序设计要求：

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

使用数据操作满足以下应用程序设计要求：

• 您添加“图表”微件以将数值或定性数据集表示为图形，并希望为用户提供在“表”微件中查看图表生成的统计数据的选项。 在“图表”微件旁添加“表”微件时，系统会自动将在表中查看数据操作添加到“图表”微件。 在运行时，用户可以单击“图表”微件中的操作按钮，然后选择在表中查看以在“表”微件中显示统计数据。
• 您将添加“列表”微件以显示数据记录，并添加“地图”微件以显示其他数据记录。 您希望为用户可以选择在地图中显示与在列表中选择的记录对应的要素，以在同一地图中比较不同数据。 在运行时，用户可以单击“列表”微件中的操作按钮，然后选择在地图中显示。
• 您将在“表”微件中显示数据记录并希望用户可以选择导出数据。 为数据源启用允许导出后，最终用户可以单击“表”微件中的操作按钮，并选择导出所选记录或所有记录。