“搜索”微件

“搜索”微件允许您配置搜索工具以根据特定图层和定位器查找要素、记录或位置，并定义如何显示搜索结果。 如果您向微件添加多个搜索源，用户可以选择要搜索的源。 使用图层源执行搜索会影响应用程序中的数据，因此使用相同图层的其他微件会被过滤以显示相应的搜索结果。 如果您希望选择搜索结果，则您可以设置一个操作。 要让微件选择要素而不过滤数据，请为可用作图层源的数据源创建数据视图。 使用定位器源执行搜索会生成其他微件可以使用的输出数据源。

要进行搜索，用户在搜索框中键入单词或短语并按 Enter 键，单击搜索按钮，或从基于匹配记录出现的建议列表中进行选择。 （建议列表将每个匹配值显示为一个项目，因此如果一条记录有两个与搜索短语匹配的字段，该记录将显示为两个建议。）用户可以使用上箭头和下箭头键浏览建议列表。 单击建议会将搜索短语替换为建议项目的内容以应用使用新值的搜索，这会在结果面板中返回相应的数据。 要简化此过程，您可以打开一个设置以自动选择第一个搜索结果。 您还可以将微件配置为在您的应用程序中打开另一个页面，以在另一个微件中显示结果。

示例

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

• 您希望在您的应用程序中配置一个搜索选项，该选项提供比地图、列表和表微件中所包含的搜索工具更大的灵活性。 特别是，您希望搜索地图中特定图层的有限字段，在搜索框中提供唯一的提示文本，并在结果面板中显示某些数据字段的值。
• 您希望用户在执行搜索时从多个来源查找信息。
• 您希望在应用程序的不同页面上的其他微件中显示搜索结果。

用法说明

搜索微件支持两种类型的搜索源 - 图层和定位器。 要使用定位器源，请添加定位器服务。 您可以使用在组织中指定的定位器，或您在选择实用程序面板中添加的定位器。 要搜索图层，请从作为数据添加到应用程序的要素图层和场景图层中进行选择。

您可以为搜索微件设置操作以与应用程序中的其他微件进行交互，例如将地图缩放到所选结果或在地图中显示搜索结果（来自定位器源）。

设置

“搜索”微件包含以下设置：

• 新搜索源 - 添加用于搜索内容的源。 选择图层源或定位器源并为每个源指定以下设置：
  • 数据 - 如果适用，请为您希望用户搜索的要素图层选择数据源。 在数据视图设置中，您可以过滤数据以限制搜索范围或对数据进行排序以按特定顺序显示搜索结果。
  • 定位器 URL - 连接定位器实用程序服务。 选择实用程序面板显示在组织设置中指定或由您在实用程序服务面板中添加的定位器。
  • 标注 - 输入搜索源的名称。 此名称将出现在搜索菜单、建议列表和结果面板中。
  • 图标 - 为源选择一个图标。 此图标显示在建议列表和搜索结果面板中。 可从常规和箭头库中选择图标，或从文件自行添加图标。 单击移除按钮以移除未使用的已上传图标。

    注：

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

  • 搜索选项 - 您可以设置以下附加选项：
    • 选择搜索字段（仅图层源）- 选择要在图层中搜索的一个或多个字段。
    • 完全匹配（仅图层源）- 将搜索结果限制为仅与搜索短语匹配的记录。
    • 显示字段 - 选择一个或多个字段以显示在搜索结果面板中。 您可拖动所选字段以对其进行重新排序。
    • 提示 - 自定义当用户选择仅搜索此源时出现在搜索框中的提示文本。
• 为图层源搜索启用过滤 - 如果启用此设置，则当用户执行搜索时，微件将按搜索条件过滤连接的图层源。
• 常规搜索选项 - 您可以设置以下常规搜索选项：
  • 多个搜索源的提示 - 自定义当用户选择搜索多个来源时出现在搜索框中的提示文本。
  • 搜索建议 - 定义为每个搜索源显示的最大建议数。 您也可配置以下选项：
    • 使用当前位置 - 包括要基于用户的当前位置进行搜索的建议选项。
    • 最近搜索 - 根据指定的最大最近搜索次数在建议框中显示搜索历史记录。 （用户可以清除搜索历史。）

    提示：

    将每个源的最大建议数设置为 0 以禁用搜索源建议。

• 搜索结果 - 选择显示搜索结果面板或链接到您的应用程序中的页面以在另一个微件中显示结果。
  • 结果面板 - 在搜索框下方出现的面板中显示搜索结果。 您可以定义每个搜索源显示的最大结果数，并选择自动选择第一个结果。
  • 设置链接 - 添加一个链接以在应用程序中打开特定页面、窗口或部分视图，或者滚动到特定内容块或页面顶部以在相应的微件中显示相关的搜索结果。 当关闭结果面板时会出现此设置。
  • 样式 - 选择结果面板的界面样式，经典或紧凑。 紧凑包含一个较小的折叠按钮，显示在面板的底部。

交互选项

在为“搜索”微件配置消息操作时，您可以根据搜索源从以下触发器中进行选择。

触发	图层源	定位器源
记录选择更改
记录已创建
数据过滤更改

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

要在地图上选择与所选搜索结果相对应的要素，请为搜索微件添加记录选择更改触发器（当配置为使用结果面板时）。 选择目标框架，添加选择数据记录操作，将其配置为具有地图要素图层和绑定触发器和操作数据之间的连接的字段。 此外，还可以添加缩放至操作以将地图缩放至要素。

在使用图层源进行配置时，如果希望地图缩放或平移至所选搜索结果，请添加数据过滤更改触发器，选择目标地图，然后添加平移至和缩放至操作。

要调整缩放到操作的缩放级别，请将缩放比例切换到自定义并提供所需的比例。

提示：

要使“搜索”微件在不过滤数据的情况下选择地图上的要素，请为可用作图层源的数据源创建数据视图。