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

1. Navigate to All > System Map Page > Map Filters.
2. Click New.
3. In the Name field, enter a name for the map filter.
4. In the Application field, define the application scope, if other than Global.
5. Click the menu icon () and select Save.
6. In the Map filter item field, double-click the record and click the search icon ().
7. To create a Map Page filter item, click New.
8. On the form, fill in the fields.

   Table 1. Map Page Filter Item form

   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. Select Single selection, Multiple selection, or Date picker. When you select Date picker, the data item fields hide and the default value script appears.
   Data type	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.

9. Click Submit.
10. When you return to the Map Page Filter form, click the check mark icon ().
    The name of the Map Page filter item that you created is displayed in the field.
11. Click the 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.

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

1. Navigate to All > System Map Page > Map Filters.
2. Select your map filter.
3. On the Map Page Filter record, select your map filter item.
4. On the Map Page Filter Item record, locate the Map Filter Data Mappings related list and select New.
5. On the form, fill in the fields.

   Table 2. Map Filter Data Mapping form

   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.

6. 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

1. Navigate to All > System Map Page > Map Pages.
2. Select the Map Page that you want to apply your map filter to.
3. Select the Use advanced configuration check box.
4. In the Filter field, click the search icon () and select the map filter that you created.
5. Click the 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

1. Navigate to All > System Map Page > Map Pages.
2. Select your Map Page.
3. Click Try It.
4. In your Map Page, click Filter.
   Your map filter appears.