组过滤器微件

“组过滤器”微件允许基于地图中的一个或多个图层在地图上应用过滤器。可将图层集分组到逻辑过滤器集中。每个集可以具有一个预定义值以方便用户进行交互。此微件有两种模式：一种为正常模式，该模式允许在运行时构建复杂过滤器；另一种为简单模式，该模式仅允许应用一个过滤器。

配置“组过滤器”微件

可将此微件设置为应用程序启动时自动打开。单击微件上的不要在应用程序启动时打开此微件按钮以启用自动打开微件的选项。（对于需要首先添加到应用程序的微件，您可以在配置微件后进行此设置。）

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

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

   注：

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

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

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

3. 定义过滤器组名称。

   过滤器组名称选项是用户将从中选择的名称。或者，您可以提供描述以引导用户了解此组将过滤的内容。

4. 或者，使用预设运算符和预设值来定义此过滤器的值，以便在运行时用户不必提供这些条件。对于预设值，您可以选择输入值或者单击搜索按钮以从现有图层中选择值。
5. 如果想要对相同图层中的不同字段进行过滤，当图层多次列出，在字段之间使用以下运算符参数可以控制如何使用 OR 或 AND 来连接这些过滤器。
6. 提供的表格显示了要在过滤器组下分组到一起的图层。默认情况下，您应该会看到已使用地图中的随机图层填充了一个图层。选择要应用过滤器的图层和字段。
7. 选择使用值按钮，由此可选择是否显示值下拉列表以供用户查找值。如果未选择此选项，则将显示纯文本框。

   注：

   此按钮为可选项。

8. 要将另一个图层添加到此过滤器集，请单击添加图层按钮。
9. 要添加另一个过滤器集，请单击添加新组按钮。这将创建另一个过滤器集分组。如果需要，可重复执行步骤 3 到 7。
10. 使用提供要显示在过滤器选择上方的文本文本框来指定自定义标题文本。
11. 以下 5 个复选框可以控制微件的工作方式：
    • 在简单视图中启动可以确定微件对于最终用户的显示方式。选中此复选框将从界面移除运算符下拉列表和添加条件按钮，使其具备更加基础的外观。
    • 隐藏微件选项可以确定是否显示图标以提供其他微件设置。这些设置包括保存和加载已定义的过滤器、追加到地图中的现有过滤器定义（如果存在）以及保留过滤器（甚至在关闭微件后）。
    • 如果 web 地图已应用现有的预定义过滤器，则可通过使用 OR 或 And 将过滤器追加到现有 web 地图过滤器来确定是覆盖此过滤器，还是将在此微件中创建的过滤器追加到现有 web 地图过滤器。默认情况下，此微件将覆盖 web 地图过滤器。此外，启用此选项将在多个群组中保留过滤器。
    • 缩放至可确定是否将地图缩放至过滤后的数据范围。默认情况下，地图会保留其当前范围。
    • 微件关闭后保持可在微件关闭后保持过滤器的状态。

    • 如果仅配置 1 个组，则隐藏标题和过滤器选择可让您在仅配置一个组的情况下，隐藏标题和下拉菜单。

使用“组过滤器”微件

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

   

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

   注：

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

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

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

   https://<your portal URL>/apps/webappviewer/index.html?id=<Item ID>&groupfilter={"<Filter Set Name>":["<value>","<value>",...]}

   • 项目 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. 如果需要在其他微件中使用已过滤的地图，请选中微件关闭后保持。否则，关闭微件时将移除过滤器并恢复地图的初始状态。