表格微件

“表格”微件可显示要素图层和具有关联要素图层的场景图层的交互式属性表，并可以选择包括用户从选项卡或列表访问的多个工作表。 您可以选择要包括在表中的字段，然后打开诸如搜索和选择之类的工具。 用户可以按一个或多个字段以及升序或降序对表进行排序。

示例

使用此微件可支持以下应用程序设计要求：

• 您希望显示属性表。
• 您想要提供一个供用户与之交互的表，例如查找或排序记录、编辑属性以及在地图中选择相应的要素。

用法说明

此微件要求为表中的每个工作表设置数据源。 表格支持要素图层和具有关联要素图层的场景图层。 可设置操作使表微件与其他微件进行交互，例如在“地图”微件中缩放到地图上的所选要素或在列表微件中过滤行。 也可以使用此微件显示要素属性，而无需在应用程序中包含地图。

提示：

对于包含长字符串的字段，用户可以将光标悬停在任何单元格上以在工具提示中查看其整个值。 单元格中的 URL 会自动缩短为查看按钮并成为实时链接。

搜索方法

“表格”微件的搜索工具使用不同的方法来检索搜索建议和搜索结果。

搜索工具将使用全文搜索以生成搜索建议。 全文搜索是一种有效的搜索方法，该搜索将使用全文字段索引，此索引可将记录分割为较小的单元，例如单个单词。 例如，假设您拥有一个美国邮局位置图层，其中的名称字段包含每个邮局位置的名称。 该索引将名称 Highland Station Baltimore Post Office 分割为 5 个可单独搜索的单词：Highland、Station、Baltimore、Post 和 Office。 如果输入由这些单词的任意组合（或仅其中任何单词的第一部分）组成的搜索短语，例如 Baltimore Office、Highland Baltimore 或 Stat Balt Office，则可在搜索建议中找到该邮局。

如果您是托管要素图层的所有者或者组织管理员，则当选择托管要素图层作为“搜索”、“列表”或“表格”微件的搜索字段时，将自动生成托管要素图层的全文字段索引。 您还可以在图层的项目详细信息页面上手动向属性字段添加索引。 如果您的图层没有索引，并且您没有编辑图层的权限，则“表格”微件将使用 START WITH abc% 查找建议，这意味着该微件将查找以搜索短语开头的记录。 这是一种效率较低的搜索方法。

为了检索搜索结果，该微件将使用 CONTAIN %abc%，这意味着搜索短语可以位于记录中的任何位置。 例如，可以搜索 alt 以在搜索结果中得到 Baltimore、Salt Lake City 和 Alton。

警告：

全文搜索是 Experience Builder 2023 年 10 月版本中的新增功能，是一项重大更改。 在此版本之前，该微件使用了 CONTAIN %abc% 以同时检索建议和结果。 与 CONTAIN %abc% 查询不同，全文搜索无法找到位于单词中间的搜索短语。 在以上示例中，搜索 altimor 或 ighlan 将不会在搜索建议中返回预期邮局。

了解有关在地图和应用程序中搜索要素的详细信息。

设置

表微件包含以下设置：

• 新建工作表 - 在表中创建一个或多个工作表。 （单击移除按钮移除表中的工作表。）对于每个工作表，请在工作表配置面板中指定以下设置：
  • 数据 - 选择在微件中显示属性的图层的数据源。 在数据视图设置中，可以过滤数据以限制微件中显示的内容，对数据进行排序以按特定顺序显示要素或者限制要素数量。
  • 上次更新文本 - 包括说明数据上次更新时间的文本。 仅当针对连接的数据源打开自动刷新时，此设置才可用。
  • 标注 - 为工作表输入名称。 该名称将在微件中显示为选项卡或显示在工作表列表中。
  • 配置字段 - 配置在工作表中显示的字段的设置。
    • 使用图层设置 - 使用图层默认设置确定针对初始显示显示的字段、可见字段以及可编辑字段。
    • 自定义 - 选择要包含在工作表中的字段。 （系统会自动选中前 50 个字段；可以视需要使用清除所选内容按钮。）拖动所选字段以对其进行重新排序。 单击可见按钮可在首次加载微件时打开或关闭列可见性。 （用户可以在运行时使用显示/隐藏列工具更改可见性。）如果数据源支持编辑，请选中允许编辑框，以便有权访问数据的用户可以通过双击表中单元格编辑属性。 您可以选择可编辑的字段。 锁定图标出现在无法编辑的字段的列标题中。

      注：

      “表格”微件不支持附件。

      注：

      当用户使用导出数据操作导出为 JSON、CSV 或 GeoJSON 格式时，将仅在导出中包含选择显示的字段。

  • 标题选项 - 自定义显示在工作表顶部的标题行。 您可以对标题文本应用粗体格式，更改文本的字体颜色，并更改以像素 (px) 为单位的字体大小。 您还可以选择标题背景颜色。
  • 工具 - 为用户提供与表中的工作表进行交互的工具。
    • 搜索 - 为工作表在表中提供搜索框。
      • 选择搜索字段 - 选择一个或多个字段进行搜索。
      • 完全匹配 - 将搜索结果限制为仅与搜索短语匹配的记录。
      • 提示 - 自定义在搜索框中显示的提示文本。
    • 选择记录 - 允许用户在工作表中选择记录。 启用此工具还包括显示选择（更新工作表以仅显示所选项目）和工作表的选项菜单中的清除选择。
      • 选择模式 - 允许用户在表中选择单个或多个记录。
    • 显示记录计数 - 显示总记录数和所选记录数。
    • 刷新 - 此工具显示在工作表的选项菜单中，供用户刷新表以获取最新数据。
• 排列样式 - 从选项卡或下拉菜单中选择以指定用户如何在表中的工作表之间进行切换。

交互选项

此微件支持操作，可在微件设置的操作选项卡上配置这些操作。

消息操作对于在微件之间创建交互非常有用。 例如，当用户在表格中选择要素时，您可以通过在“表格”微件的操作设置中添加记录选择更改触发器、将“地图”微件设置为目标以及添加缩放至消息操作以使地图缩放至要素。

打开数据操作以将按钮添加至微件的用户界面，以用于执行数据处理任务，例如导出和过滤。 例如，可以打开设置过滤器数据操作，以允许用户在运行时使用 SQL 表达式来设置表格过滤器。

共有两个表相关数据操作可在其他微件设置中打开，即在表中查看和添加至表。 这两个操作用于将另一个微件中的记录发送至表。 区别在于哪些记录。 添加至表为数据源级别操作，意味着它会将整个数据源中的所有记录发送到表微件。 在表中查看为记录级别数据操作，意味着它仅影响选定、当前或已加载记录。

下表列出了可用于在表微件中查看记录的微件和数据操作。

	添加至表	在表格中查看
源微件	所有记录	所选记录	已加载记录	当前记录
添加数据
分析
图表
要素信息
列表
地图
地图图层
查询
选择