选择数据

数据是您使用 Experience Builder 创建的大多数应用程序的核心。 许多微件都是数据驱动的,且构建器提供统一的数据管理。 可以将使用相同数据的微件连接到您的应用程序中。 例如,您可以在多个微件之间同步记录选择,并在连接到相同数据的微件上应用相同的过滤器。

将数据添加到 Experience Builder 中的应用程序,就是数据源连接的特定实例。 此功能的优势如下所述:

  • 可在您构建的应用程序中同步更新原始数据源。
  • 您可以多次添加同一数据源。 连接成为 Experience Builder 中的独立数据。 除了对原始数据源进行的更新(例如编辑要素和更新属性)外,大多数的数据处理过程之间都不会相互影响(例如筛选和排序)。

管理数据

您添加到应用程序中的所有数据都列在构建器工作区的数据面板中。 您可以在此处管理应用程序的数据,并查看相关信息,例如与数据相连的微件数量和名称以及连接到的字段名称,如果适用。 使用搜索框来过滤列表,以帮助您查找特定数据源。 搜索结果包括您已添加到应用程序的 web 地图和 web 场景的子图层。

向应用程序添加数据

将数据添加到应用程序时,可以选择作为内容项存储在 ArcGIS 中的 Web 地图、Web 场景和图层,其中包括:

  • 托管要素图层
  • 支持查询的 3D 对象和点场景图层
  • 要素、场景和地图服务
  • 要素集合(不包括地图注释和路径图层)

您可以在您的内容、群组、组织和公开共享的内容中浏览和搜索这些数据源,其中包括 ArcGIS Living Atlas of the World。 同时支持要素、场景或地图服务 URL 中的图层。 另外,在将 Web 地图和 Web 场景添加到您的应用程序时,可以将其支持的图层用作微件的数据源。

注:

  • 将 Web 地图或 Web 场景添加为数据源时,微件可以连接到其支持的图层,例如表、地图图像图层、切片图层和图层组。 不支持的图层类型在微件设置中不可用,并且不会显示在数据面板的详情选项卡中。
  • 使用 JSAPI 3.x 创建的 Web 地图和 Web 场景无法在 Map Viewer 经典版 中打开或者 Scene Viewer 不能用作数据源。 (如果您添加了其中一个项目,则该项目将不可选且作为错误卡片显示在数据面板中。)

您可以通过两种方式向应用程序添加数据:

  • 添加任何微件之前,请单击数据面板中的添加数据按钮以添加用于应用程序的数据。Experience Builder 中支持的所有数据类型都列在添加数据窗口中。
  • 如果在添加微件之前不添加数据,则还可以在配置微件时通过单击选择数据窗格底部的添加数据按钮来添加数据。 仅可添加微件支持的数据类型。 您在配置微件时添加的数据也会显示在数据面板中,并可在配置其他微件时选择这些数据。
注:

添加数据时,您可以选择隐藏服务、图层组、web 地图或或 web 场景中的一些子图层。 或者,您可以将其隐藏在服务、组、web 地图或 web 场景的详细信息面板下。 配置微件时,隐藏图层在选择数据列表中将不可用。 您仅可以隐藏尚未使用的图层。

移除数据

您可以使用数据面板中选项卡的移除选项来移除数据源。 数据源中包含的数据也将被移除。 当您在此处移除数据时,该数据将不可再用于微件配置。 如果您移除的数据已被某一微件所使用,则该应用程序将不再显示此数据中的信息,并且与此数据连接的所有微件都将受到影响。 您可以在删除数据的同时删除受影响的微件,也可以稍后再连接其他数据来重新配置微件设置。

数据详细信息和数据视图

数据面板会显示带有项目名称的项目卡片,这些项目名称包含您添加到应用程序中的数据。带有图标的标签可帮助您区分数据类型。 您可以通过单击链接打开原始数据源的项目页面来查看其他详细信息。 您可以将项目卡片上显示的名称更改为与您的应用程序更相关的名称(源数据保持不变)。 每张卡片都指示地图或场景中相关的微件和图层的数量。 单击数据卡片,包含更多数据详细信息的窗格随即打开。

  • 对于 web 地图、web 场景、服务和图层组,您可以查看以下详细信息:
    • 图层选项卡 - 数据源包含的图层。 图层将被分为两组:使用中显示在微件设置已选中的图层,其他显示尚未连接到微件的图层。 您可以隐藏未使用的图层,以使其在配置微件时不会显示在选择数据列表中。 单击图层卡片以打开详细信息窗格。
    • 微件选项卡 - 直接使用整个地图、场景、服务或图层组的微件。 仅适用数据下指定图层的微件不在此处列出;它们会列在相应的图层下。
  • 对于单个图层(包括不具有子图层的图层),您具有以下设置选项和详细信息:
    • 数据设置 - 设置过滤器、排序字段并记录数据限制。 此处的过滤器设置会影响其所有数据视图。
    • 刷新设置 - 如果关闭了自动刷新,则仅当刷新应用程序或构建器时,数据才会刷新。 打开自动刷新以允许刷新数据并基于特定时间间隔获取最新要素。 您可以设置自定义时间间隔,或者如果数据来自 web 地图,则可以选择采用该图层的设置。
    • 允许导出 - 让用户可以在运行时选择从已启用数据操作的连接微件导出数据。 (仅限导出 5,000 个记录。)
      注:

      对于托管要素图层,应用程序还将验证最终用户角色和项目设置是否允许导出数据。

    • 数据视图选项卡 - 通过添加过滤器、排序字段和记录限值来控制已连接微件中的显示内容,创建支持的要素图层和场景图层的数据视图。 这些设置仅在视图中生效,而不会影响其他数据视图或源数据。
      注:

      每个图层还具有内置视图,以在为微件配置数据源时进行选择。 默认视图包含所有要素。 选定要素视图包含在运行时选择的要素。 自动填充视图适用于“列表”微件的动态内容设置。

      • 空白选择视图 - 选中此框并单击其设置按钮可配置未在选定要素视图中选择要素时显示的视图。 (系统不会自动选择此配置视图中的要素。)
    • 字段标签 - 微件所使用的字段。
    • 微件标签 - 在其设置中使用图层的微件。

使用数据

无论您如何将数据添加到应用程序,该应用程序中的所有受支持的微件的数据都可以使用这些数据。 一个微件使用的数据源可以被其他微件使用。 记录选择可在整个应用程序内同步。 此外,默认数据视图上的过滤器 将影响使用数据或其视图的所有微件。 特定数据视图上的过滤器仅影响使用同一数据视图的微件。

注:

在“地图”微件中显示 web 地图或 web 场景时,会自动创建一个新的 web 地图或 web 场景视图,并且该视图仅用于当前微件。 因此,“地图”微件内的数据处理不会影响使用同一数据源或其包含的图层的微件。 但是“地图”会受到默认视图上数据处理的影响。

每个微件的配置面板均包含用于连接数据的标准设置。 单击选择数据时,将显示一个窗格,其中列出了微件支持的应用程序中的添加数据输出数据(未列出隐藏数据)。 您可以从列表中选择数据,也可以向应用程序添加更多数据。使用搜索框过滤选项列表。 搜索结果包括您已添加到应用程序的 web 地图和 web 场景的子图层。一些微件支持多个数据源,因此您可以在列表中选择多个项目。 如果微件只能连接到一个数据源,请单击现有数据卡片以打开选择数据窗格,您可以在其中清除已选项并选择新项。

下表列出了可以连接到数据的微件以及每种微件支持的数据类型。

微件支持的数据类型*支持的数据个数

分支版本管理

要素服务、地图服务(必须注册为版本

1 个或多个

按钮**

要素图层,场景图层

0 或 1

图表

要素图层,场景图层

1

嵌入**

要素图层,场景图层

0 或 1

要素信息

要素图层,场景图层

1

过滤

要素图层,场景图层

每个过滤器 1 个

图像**

要素图层,场景图层

0 或 1

列表

要素图层,场景图层

1

地图

Web 地图和场景

1 或 2

地图图层

Web 地图和场景

0 或 1

查询

要素图层,场景图层

每个查询 1 个

表格

要素图层

每个工作表 1 个

文本**

要素图层,场景图层

0 或多个

*有关受支持项目类型的特定列表,请参阅向应用程序添加数据

**默认情况下,图像、文本、按钮和嵌入微件是静态的。 要显示数据信息,请打开连接数据设置并使用属性、统计信息或表达式来指定参数。 有关详细信息,请参阅动态内容

输出数据

除了手动添加到应用程序的数据之外,以下微件还可以处理原始数据并使用显示的结果生成新输出数据集。

源微件输出数据类型输出数据数

图表

要素图层

1

查询

要素图层

每个查询 1 个

在应用程序中配置这些源微件后,配置其他微件时,其输出数据将在选择数据窗格中列出。 输出将创建为新数据源,以防输出数据上的过滤器和选择影响原始数据源。

注:

如果您在移除一个微件时,其输出数据正被另一个微件使用,则您将收到一条包含相关微件列表的警告消息。 您还可以选择相关微件以便将其删除,或将其保留以便稍后使用其他数据源对其进行重新配置。

输出数据的方案由其源微件定义。 “图表”微件的输出数据是具有类别字段属性(如果已配置)和数值字段的计算结果的统计数据;不含几何。 “查询”微件的输出数据是满足查询条件的记录子集,字段配置与其结果设置相同。 输出数据中的实际记录将在运行时由源微件动态生成。

数据源视图

在微件设置中选择数据后,可根据微件支持的数据源数,在下拉列表中选择一个或多个视图。 数据源具有四种类型的视图:

  • 默认是包含数据中的所有要素的内置视图。
  • 选定要素是包含用户在运行时选择的要素的内置视图。 要素的选定状态会在所有视图间同步。 可使用此视图显示交互结果。 例如,如果针对“列表”微件配置,则列表仅显示选定记录,列表中的项目会随着选择变化动态变化。 如果未选择,列表仅显示无数据消息,直到选择了记录为止。 或者,可在数据面板上为空白选择创建视图
  • 自动填充是在将微件添加到“列表”微件中并将其连接到同一数据视图时,在动态内容设置中提供的内置视图。 该视图仅包含列表为其中的每个项目生成的一个要素。
  • 数据视图是可使用不同过滤器、排序字段和记录限制创建的要素子集。 可使用多个数据视图预处理数据源,以控制在微件中显示的数据,而不会影响其他数据视图或源数据。
    注:

    输出数据不支持添加自定义数据视图。

    注:

    记录选项卡上的页面大小设置将用于提高查询性能和效率。 该设置不会影响支持分页的微件中结果要素的总数。 如果页面大小小于实际结果,则系统会发送多个请求,直到所有结果都加载完毕为止。

默认情况下,默认视图处于选中状态。 也可以编辑现有视图或选择为微件创建另一个视图。 也可以在其他微件设置中选择通过微件配置面板创建的视图。

动态内容

多个微件具有多种设置,您可以使用这些设置或显示来自已连接数据源的动态信息。 示例包括指定要素的属性值、满足特定条件的要素的统计结果或包含静态字符串、动态值和计算的表达式。

属性

使用以下视图之一获取指定数据视图中要素的属性值:

  • 您在微件的数据源设置中设置的视图。
  • 原始数据图层的选定要素视图。 您可以通过该视图显示交互结果,例如显示所选要素的属性。
  • 当微件位于“列表”微件中(例如文本、图像或按钮)且具有与“列表”相同的数据视图的自动填充视图。 此视图仅包含列表项表示的一个要素。

如果您选择的视图包含多个要素,则将返回第一个要素的属性值(基于数据视图中的排序设置)。

统计数据

获取指定数据视图定义的要素及的统计结果。

结果可以是数字字段的最大值、最小值、平均值或总和或要素集的要素计数。

表达式

表达式编辑器允许您输入文本(格式:“文本”)、数字、字段变量(格式:{fieldname})和函数,包括 AVERAGE({fieldname})COUNTSUM({fieldname})MAX({fieldname})MIN({fieldname})。 每个部分都用加号 (+) 串联。 该表达式返回字符串串联和和数字计算的结果。 例如,如果输入 1+1,则返回 2(数字),但是如果输入 1 +“1”,则返回“11”(字符串)。

输入时,将提供建议,您可以单击以进行插入。 另外,您可以通过单击输入框下方列出的字段名称或函数名称来插入字段变量或函数。

您可通过字段选项卡下的数据设置字段变量表示的数据视图。 如果将字段变量作为独立部分添加到表达式中,则会从指定数据视图中的第一个要素返回该字段的属性值。

如果在函数中使用了数值字段变量;例如 AVG({fieldname}),该函数返回该字段的数据视图的统计结果。