“查询”微件

“查询”微件允许通过运行属性或空间过滤器查询，从源数据中检索信息。 查询结果将生成其他微件可使用的输出数据源。

示例

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

• 您希望允许用户基于查询表达式查找要素。
• 您希望允许用户在地图上绘制形状并返回与所绘形状相交的要素。
• 您希望允许用户查找与其他微件中所选要素的形状具有特定空间关系（例如相交或重叠）的要素。
• 您希望使用查询结果为其他微件创建要素。

用法说明

“查询”微件要求为添加的每个查询设置数据源。每个查询适用于单一图层，可定义多个属性和空间过滤器。 也可以创建多个查询并使用来自多个数据源的图层。 查询可配置为带或不带地图。 要在“地图”微件中显示查询返回的要素，可设置操作以动态显示这些要素或使用允许用户单击按钮的数据操作。 目前，使用场景图层需要添加记录选择更改触发器，这样用户单击查询结果即可将其在地图上高亮显示。

警告：

尝试对非常复杂的要素进行空间查询（例如具有大量折点的面要素）时，可能使微件过载，无法返回结果。 如果出现此情况，可以尝试概化要素。 确保遵守服务器的最大资源限制。

设置

“查询”微件包含以下设置：

• 新建查询 - 创建查询并在设置查询面板中指定以下设置：
  • 数据 - 选择要查询的数据。 每个查询只能选择一个数据源。 支持要素图层、所选 web 地图和 Web 场景中的要素图层、数据视图、输出数据源和要素服务 URL。
  • 标注 - 自定义每个查询的名称。 如果微件中存在单一查询，可关闭垂直和图标排列样式的显示标注。
  • 图标 - 为在微件中和内容面板的查询列表中显示的每个查询选择图标。 可从常规和箭头库中选择图标，或从文件中添加图标。 单击移除按钮以移除未使用的已上传图标。

    注：

    可以上传以下图像格式：PNG、GIF、JPG、JPEG 和 BMP。 为了保持最佳性能，每次上传的大小限制为 10 MB。

  • 属性过滤器 - 构建 SQL 表达式以指定属性过滤条件。 打开的 SQL 表达式构建器包含几个选项，用于创建复杂的交互式查询。
    • 标注 - 自定义属性过滤器部分的标注。
    • 描述 - 为特定受众（例如新用户）提供说明，且在信息图标上将显示为悬停文本。
  • 空间过滤器 - 选择可用的空间过滤器和（可选）地图微件。
    • 标注 - 自定义空间过滤器部分的标注。
    • 从数据源中选择的要素 - 返回与另一图层中的要素有空间关系的要素。 或者，可以将搜索距离应用于相关图层中要素的几何。
      • 空间关系规则 - 选择要提供给用户的哪些空间关系：
        • 相交 - 源图层中要素的某个部分包含在过滤图层中的要素内。
        • 包含 - 源图层中的要素被过滤图层中的要素完全包围。
        • 交叉 - 源图层中的要素与过滤图层中的要素交叉。
        • 包络矩形相交 - 源图层的包络矩形与过滤图层的包络矩形相交。
        • 索引相交 - 源图层的包络矩形与过滤图层的索引条目相交。
        • 重叠 - 源图层中的要素与过滤图层中的要素重叠。
        • 接触 - 源图层中的要素与过滤图层中要素的边界接触。
        • 包围 - 过滤图层中的要素被源图层中的要素完全包围。
      • 启用缓冲 - 添加搜索距离。 您可以定义默认距离和单位。
    • 地图中的几何 - 返回当前地图范围内的要素或与地图上绘制的形状相交的要素。 可打开和关闭绘制工具以控制微件中的可用工具。
    • 描述 - 为特定受众（例如新用户）提供说明，且在信息图标上将显示为悬停文本。
  • 结果 - 定义微件如何显示查询结果。
    • 标注 - 自定义结果列表的标注。
    • 选择模式 - 选择用户可以从结果列表中选择多少条记录。
      • 单选 - 用户一次只能选择一条记录。
      • 多选 - 用户可以选择多条记录。
    • 配置每条记录 - 支持源数据的设置或通过指定要从图层显示的字段并提供有意义的标题来自定义结果。 如果选择自定义，则当用户导出为 JSON、CSV、GeoJSON 或 ArcGIS 项目时，将仅导出指定为显示字段或包含在标题中的字段。
    • 默认展开 - 选中此框可默认展开所有结果节点。
    • 排序记录 - 配置排序结果列表时依据的字段。
• 排列样式 - 选择垂直、水平或图标来自定义微件中的查询样式。
• 结果样式 - 在单个页面或多个页面上水平或垂直组织查询结果。
  • 每页的记录数（当将多页设置为分页样式时可用）- 定义每页显示的记录数。 此数值可以大于等于 10 并小于等于 1,000。 现在，用户可以在运行时使用下拉菜单或键入数字，选择每页显示的结果数。 将在下拉菜单中填充对应您所定义数值的 100%、50% 和 33% 的值。

    注：

    “查询”微件遵循您在数据选项卡上为要素图层设置的任何最大记录数限制。

交互选项

“查询”微件用于生成可在其他微件中使用的输出数据源。 可通过添加操作与使用同一输出数据源的其他微件进行交互。 例如，地图可自动显示查询结果并缩放到要素。 在“查询”微件设置的操作选项卡上，添加已创建记录触发器，选择目标地图，然后为在地图上显示和缩放至添加操作。

查询结果将在列表中显示。 要选择列表中的项目并地图中的对应要素，为“查询”微件添加记录选择更改触发器。 选择目标框架，添加选择数据记录操作，将其配置为具有地图要素图层和绑定触发器和操作数据之间的连接的字段。 还可以添加缩放至操作以将地图缩放至选定要素。