注：
ArcGIS Configurable Apps 将于 2025 年弃用。 有关 ArcGIS Configurable Apps 弃用以及如何将可配置应用程序迁移到 ArcGIS Instant Apps 的详细信息，请参阅 ArcGIS 博客文章 ArcGIS Configurable Apps 停用计划。
大多数 ArcGIS Configurable Apps 模板支持在地图中搜索位置和要素的功能。 借助应用程序用户界面中的集成搜索微件，用户可输入搜索词。 如果已在 Web 地图中配置搜索，则在 Configurable Apps 中启用该配置后，应用程序将使用该配置。
您还可以使用应用程序配置面板中的搜索选项卡在应用程序中配置搜索，而无需考虑在 Web 地图级别设置的任何搜索属性。 以下各部分概述了如何在应用程序中配置搜索。
配置参数
Configurable Apps 支持与 Web 地图所支持类型相同的搜索源 - 例如，定位器和可搜索的要素图层。 支持搜索的应用程序的配置面板中具有搜索选项卡，其中列出了所有搜索源。 可从此列表中的应用程序启用或禁用各个搜索源。 您可以通过在列表中单击搜索源旁边的编辑来配置各个源的参数。
可配置以下搜索源参数：
- 名称 - 指定搜索源的自定义名称。
- 占位符 - 指定搜索框中在输入搜索值之前显示的预设文本。 占位符可视为提示文本。
- 将搜索限制在地图范围内 - 选中此框可仅查找地图范围内的要素。 这是在 Web 地图级别保存的范围。
- 启用建议 - 如果选中此框，则输入搜索值时，下拉菜单中将显示可能的匹配项。
- 最大建议数 - 如果启用了建议，则选择可一次性提供的最大建议数。
- 显示建议 - 对于可搜索的图层，您可以指定如何为应用程序用户显示建议。 您可以将建议显示为指定字段的值，或通过同时添加文本和字段值来自定义显示。
- 精确匹配 - 选中此框可将搜索结果限制为与搜索框中输入的值精确匹配的结果。
以下各部分概述了如何配置搜索源以自定义应用程序的搜索体验。
将定位器作为搜索源启用
在组织设置中指定的所有已建立的定位器均将显示在搜索源列表中，这些定位器在应用程序中的运行方式与在 Web 地图、Map Viewer 或 Map Viewer 经典版中相同。
执行以下操作以启用定位器作为搜索源：
- 如有必要，选中搜索选项卡顶部的启用搜索工具框。
- 选中想要启用的定位器旁边的框。
- 或者，单击定位器旁边的编辑以配置其他参数。 完成后单击保存。
将可搜索要素图层作为搜索源启用
如果在 Web 地图中检测到可搜索的要素图层，则该图层将显示在按名称标识的搜索源列表中。
执行以下操作以启用可搜索的要素图层作为搜索源：
- 如有必要，选中搜索选项卡顶部的启用搜索工具框。
- 选中想要启用的可搜索要素图层旁边的框。
- 单击图层名称旁边的编辑，然后从搜索字段列表中选择一个搜索字段。
注：
您必须先声明一个搜索字段，以便按要素图层进行搜索。
- 单击保存。
启用多个搜索源
您可能需要在一个应用程序中启用多个搜索源。当应用程序用户需要搜索多个信息源以使用该应用程序时，此功能十分有用。请牢记应用程序的用途，不要启用与此用途无关的搜索源，因为它们可能会导致最终用户产生不必要的混淆。 例如，如果应用程序用于定位和更新当地城市的人行横道维护的作业状态，则不建议启用全球定位器，因为这可能会导致最终用户远离所有人行横道维护要素所在的当地城市范围。
要启用多个搜索源，请执行以下操作：
- 如有必要，选中搜索选项卡顶部的启用搜索工具框。
- 选中想要启用的搜索源旁边的框。
- 单击各个源旁边的编辑，以根据需要确认或配置参数。
- 单击保存。
- 在搜索选项卡中，请执行以下操作之一：
- 如果您有首选的默认搜索源，请从选择默认源下拉菜单中进行选择。 应用程序用户可根据需要选择应用程序搜索中的其他搜索源。
- 如果您希望应用程序在默认情况下一次性搜索所有源，请选中搜索所有源框，然后从选择默认源下拉菜单中选择所有。
如果已找到所输入搜索词的可能匹配项，则已配置建议的所有源均将显示在建议下拉菜单中。
启用多字段搜索
可以在一个搜索源中搜索多个字段。 例如，您可以允许应用程序用户根据不同类型的信息查找要素，例如根据 ID 编号或所有者名称查找宗地要素。
要启用多字段搜索，请执行以下操作：
- 如有必要，选中搜索选项卡顶部的启用搜索工具框。
- 在列表中单击搜索源旁边的编辑。
- 在搜索字段列表中，单击其中一个字段，然后按 Ctrl 键，同时单击要启用搜索的其他字段。
- 单击保存。
配置多字段搜索时，建议您同时配置建议并自定义建议模板，如以下部分所述。
配置建议
如果您为应用程序启用了建议，则可能的匹配项将显示在搜索下拉菜单中，供用户在输入搜索值时进行选择。 当用户知道精确搜索词的一部分而非全部时，建议功能十分有用。 借助建议功能，应用程序用户还可在输入几个关键字符后，从列表中更快速地选择正确的匹配项。 为一个搜索源配置了多个搜索字段时，也推荐使用建议。
要配置建议，请执行下列操作：
- 如有必要，选中搜索选项卡顶部的启用搜索工具框。
- 在列表中单击搜索源旁边的编辑。
- 选中启用建议复选框。
- 从最大建议数下拉菜单中，选择要一次性显示的最大建议数。
- 对于可搜索的要素图层，请执行以下操作：
- 选择字段或模板。
- 根据需要配置其他参数。
- 单击保存。
创建建议模板
在可搜索图层上配置搜索时，或者要在应用程序搜索下拉菜单中自定义建议外观时，您可以使用建议模板在建议中显示多个字段。
要配置建议模板，请执行下列操作：
- 如有必要，选中搜索选项卡顶部的启用搜索工具框。
- 在列表中单击可搜索图层旁边的编辑。
- 选中启用建议复选框。
- 单击模板，然后输入您的建议模板。
基本语法是 ${fieldname}，其中 fieldname 将由值可显示的字段的名称替换。 例如，要创建将树类型字段值与公园名称字段值组合的建议字符串，可使用以下语法：
Tree Type: ${treeType}, Park: ${parkName}此字符串将为应用程序用户显示一个建议，如下所示：
Tree Type: Dogwood, Park: Eastland Community Park - 单击保存。