Add a map filter
Add a map filter to display filtered map markers. This filter enables you to see only the map markers for the data that you want.
Before you begin
A map data item should be configured before accomplishing this task. The example map data item can work with the example map filter tables below to successfully set up a map filter.
Role required: admin
About this task
Map filters can be configured using lists and forms, or scripting. Create a container for your map filters first, configure filter items, and then choose a Map Page for your filter.
Procedure
Navigate to All > System Map Page > Map Filters.
Click New.
In the Name field, enter a name for the map filter.
In the Application field, define the application scope, if other than Global.
Click the menu icon (
Menu icon\) and select **Save**.
- In the Map filter item field, double-click the record and click the search icon (
Search icon\).
To create a Map Page filter item, click New.
On the form, fill in the fields.
| Field | Description | |
|---|---|---|
| Name | Name for your Map Page filter item. | |
| Label | Title for your Map Page filter item that's displayed in the map filter in your Map Page. | |
| UI Type | UI type for your Map Page filter item. This determines how your filter displays on the map page. Select Single selection, Multiple selection, or Date picker. When you select Date picker, the data item fields hide and the default value script appears. Image omitted: Map_Filter_UI_Selection.png Data typeThe UI Types on a map page.</td></tr><tr><td> | Data type for your Map Page filter item. Select Data item or Scripted for the data type. A data item enables you to configure or select data items using lists and forms. |
| Application | Application scope for your Map Page filter item, if other than Global.Note: This field is optional. | |
| Data item | Data item for your Map Page filter item. Select the data item that you previously configured. | |
| Data item table | Data item table for your Map Page filter item. Note: This field is automatically populated when a data item is selected. | |
| Data item value field | Data item value field for your Map Page filter item. Choose how data is used in a table. | |
| Default value script | Scripting field for your Map Page filter item. |
Click Submit.
When you return to the Map Page Filter form, click the check mark icon (
Check mark icon\).
The name of the Map Page filter item that you created is displayed in the field.
- Click the menu icon (
Menu icon\) and select **Save**.
Map Page Filter Item form
Select the options in the table to successfully create your Map Page filter item. This setup works with the map data item example.
| Field | Description |
|---|---|
| Name | Enter `Incident`. |
| Label | Enter `Incident`. |
| UI Type | Select Single selection. |
| Data type | Select the data item. |
| Application | Skip this field. |
| Data item | Select Incident state. Note: This data item is the map data item you created in the map data item example. |
| Data item table | Skip this field.Note: This field is automatically populated when a data item is selected. |
| Data item value field | Select Value. |
| Default value script | Skip this field. |
What to do next
Continue to the next task to configure a map filter data mapping.
Parent Topic:Create an advanced Map Page
Configure a map filter data mapping
Choose a Map Page for your map filter, and determine how it functions on the Map Page.
Before you begin
Role required: admin
Procedure
Navigate to All > System Map Page > Map Filters.
Select your map filter.
On the Map Page Filter record, select your map filter item.
On the Map Page Filter Item record, locate the Map Filter Data Mappings related list and select New.
On the form, fill in the fields.
| Field | Description |
|---|---|
| Map page | Map Page where your map filter is applied. |
| Data item | Data item for your map filter data mapping. Select the data item that you previously configured. |
| Application | Optional application scope for your map filter data mapping. |
| Filter item | Filter item for your map filter data mapping. Select the filter item that you previously configured.Note: This field is automatically populated with the filter item. |
| Table | Table for your map filter data mapping. Note: This field is automatically populated when a data item is selected. |
| Field | Data is retrieved from this field in the table that you selected. |
- Select Submit.
Map Filter Data Mapping form
Select the options in the table to create your map filter data mapping. This setup works with the map data item example.
| Field | Description |
|---|---|
| Map page | Select the Map Page that you created. |
| Data item | Select Incident state.Note: This data item is the map data item that you created in the map data item example. |
| Application | Skip this field. |
| Filter item | Skip this field.Note: This field is automatically populated when a data item is selected. |
| Table | Skip this field.Note: This field is automatically populated with the Choice [sys_choice] selection. |
| Field | Select Value. |
What to do next
Continue to the next task to select your map filter, and complete the map filter setup.
Select map filters
Select your map filter to complete the Map Page filter setup. This setup applies the map filter to your Map Page.
Before you begin
Role required: admin
Procedure
Navigate to All > System Map Page > Map Pages.
Select the Map Page that you want to apply your map filter to.
Select the Use advanced configuration check box.
In the Filter field, click the search icon (
Search icon\) and select the map filter that you created.
- Click the menu icon (
Menu icon\) and select **Save**.
What to do next
You've set up your map filter. Continue to the next task to see that you have successfully created it.
Check your map filter
Check to see that your map filter was successfully created in your Map Page.
Before you begin
Role required: admin
Procedure
Navigate to All > System Map Page > Map Pages.
Select your Map Page.
Select Try It.
In your Map Page, select Filter.
Your map filter displays.