组过滤器微件

“组过滤器”微件允许对地图中的一个或多个图层应用过滤器。 可将图层分组到逻辑过滤器集中。 每个集可以具有一个预定义值以方便用户进行交互。

配置“组过滤器”微件

可将此微件设置为应用程序启动时自动打开。 将鼠标悬停在该微件上，然后单击不要在应用程序启动时打开此微件按钮 以将该设置更改为在应用程序启动时自动打开此微件。 （对于需要首先添加至应用程序的微件，可以在配置该微件后打开此选项。）

以下步骤指示如何创建过滤器集。 如果您需要定义其他过滤器集，可重复这些步骤。

1. 将鼠标悬停在微件上方，然后单击配置此微件按钮 以打开配置窗口。

   注：

   如果需要先将微件添加到应用程序，请在微件选项卡上单击微件占位符。 在打开的选择微件窗口中，选择微件然后单击确定。

2. 或者单击更改微件图标以替换此微件的默认图标。
   随即显示文件资源管理器窗口，供您选择可用作微件图标的本地图像文件。

   配置将显示一个需要修改的过滤器组。

3. 定义过滤器组：
   • 组名称 - 为过滤器组提供名称。 它将显示在可用过滤器组的下拉列表中。
   • 描述 -（可选）您可以提供描述以引导用户了解此组过滤的内容。
   • 预设运算符 -（可选）选择要用于此过滤器组的默认运算符。 最终用户可以在应用过滤器之前更改所选运算符。 如果未选择，过滤器默认使用 EQUALS 运算符。
   • 预设值 - 预定义此过滤器的值，这样用户将无需提供这些条件。 您可以选择输入值或者单击搜索按钮以从现有图层中选择值。 此值用于过滤过滤器组中定义的所有图层。
   • 当图层被多次列出时 - 如果图层在过滤器组中被多次列出并且过滤器应用于不同的字段，可以通过选择匹配任何或所有表达式来控制这些字段的连接方式。
     • 匹配任意表达式 - 过滤器结果将返回任意字段值与此过滤器组定义表达式匹配的要素。
     • 匹配所有表达式 - 过滤器结果将仅返回所有字段值均与此过滤器组定义表达式匹配的要素。
   • 执行区分大小写的搜索 - 选中该框以仅返回属性值与包含大写和小写字符的搜索输入完全匹配的要素。
4. 在提供的表中，将从地图中随机选择一个图层和字段，以开始使用示例。 自定义要应用过滤器的图层和字段。
   • 图层 - 地图中定义的图层名称 使用下拉列表从地图中选择一个图层。
   • 字段 - 过滤图层所依据的字段。 使用下拉列表从图层中选择一个字段。
   • 使用值 - 在下拉列表中使用此图层和字段中的值的选项，为要过滤的值选项列表。 如果没有为图层启用此参数，则会显示一个空文本框以供用户输入自定义值。 此为可选设置。
5. 要将另一个图层添加到此过滤器组，请单击添加图层按钮。
6. 要添加另一个过滤器组，请单击添加新组按钮。 如果需要，可重复执行步骤 3 到 5。
7. 使用提供要显示在过滤器选择上方的文本文本框来为微件指定自定义标题文本。
8. 以下六个复选框可以控制微件的工作方式：
   • 在简单视图中启动 - 确定微件对于最终用户的显示方式。 选中此复选框将从界面隐藏运算符下拉列表和添加条件按钮，使其具备更加基础的外观。
   • 隐藏微件选项 - 确定是否隐藏图标以提供其他微件设置。 这些设置包括保存和加载已定义的过滤器、追加到地图中的现有过滤器定义（如果存在）以及保留过滤器（甚至在关闭微件后）。
   • 向现有地图过滤器追加任意/全部表达式 - 如果 Web 地图应用了现有的预定义过滤器，则此设置允许您将在此微件中创建的过滤器添加到现有 Web 地图过滤器。 此设置将在多个群组中保留过滤器。 如果未选中，则微件将覆盖 Web 地图过滤器。
     • 使用任意为附加设置，配置的过滤器将添加到 Web 地图过滤器。
     • 使用全部为独占设置，仅显示同时满足已配置过滤器和 Web 地图过滤器要求的要素。
   • 缩放至结果 - 确定是否将地图缩放至过滤后的数据范围。 默认情况下，地图会保留其当前范围。
   • 关闭微件后保留过滤器 - 可在微件关闭后保持应用过滤器的状态。 默认情况下，当微件关闭时，会从地图中清除过滤器。

   • 隐藏标题和过滤器（仅对于单个过滤器组） - 在仅配置一组的情况下，允许您隐藏标题和过滤器组下拉菜单。

使用“组过滤器”微件

要使用该微件，请完成以下步骤：

1. 单击组过滤器微件会显示一组预定义的过滤器组。

   

   分隔线下面将显示两个下拉列表：运算符和值。 在本例中，将对地图进行过滤以仅显示废弃机动车辆投诉。

   注：

   根据微件中对图层的配置方式，您将看到值列表（类似本示例中所示）、用于用户输入的文本框或日期选取器。

2. 单击应用，将过滤器应用于地图。

   或者，您可以通过向应用程序的 URL 添加参数来应用过滤器。 URL 必须采用以下格式 - 用下面列表中描述的值来替换尖括号中的变量：

   https://<您的门户 URL>/apps/webappviewer/index.html?id=<Item ID>&groupfilter={"<过滤器集名称>":["<值>","<值>",...]}

   • 项目 ID - 应用程序的唯一 ID。
   • 过滤器组名称 - 过滤器组的已定义名称。 此值区分大小写。
   • 值 - 用于执行过滤器的值。 要基于属性域进行过滤，请使用属性域代码。

   例如，要应用上图中所示的过滤器，您将使用类似于以下示例的 URL：

   https://<your portal URL>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&groupfilter={"Group A":["Abandoned Motor Vehicle"]}

   注：

   如果未将“组过滤器”微件配置为在应用程序启动时自动打开，则在您打开微件之前，URL 中定义的过滤器将不适用。

3. 单击重置可移除过滤器，并将地图图层恢复到其初始状态。 （默认情况下，关闭微件的同时也会移除过滤器。）
4. 此微件允许在运行时添加附加过滤条件。 单击添加条件可以添加另一个子句。 请注意，两个条件通过连接词连接在一起。 您可以选择通过 OR 或 AND 将其连接在一起。

   

   要使用 URL 参数来应用此示例中显示的过滤器，您的 URL 需要类似于以下示例：

   https://<your portal URL>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&groupfilter={"Group A":["Abandoned Motor Vehicle","Auto Theft"]}

5. 除非在微件配置中选中了隐藏微件选项设置，否则可以保存这些定义的标准设置以供将来使用。 单击设置按钮 以访问选项面板。

   

   1. 单击保存按钮将当前过滤器设置保存到本地 JSON 文本文件中。
   2. 单击上传设置文件下的选择文件可以加载之前保存的文件，以便恢复文件中定义的所有条件。
   3. 如果需要在其他微件中使用已过滤的地图，请选中关闭微件后保留过滤器。 否则，关闭微件将移除应用于地图中图层的过滤器。
   4. 单击刷新按钮以从地图的图层中提取数据更改并刷新过滤器下拉列表中的值列表。 如果正在过滤的图层在当前应用程序会话期间被编辑（并且可能影响可用值列表），则可能需要执行此操作。