Tree Filters

To customize these filters, you’ll modify the XML for the dockable window in ControlStylesConfig.xml. You’ll need to know which dockable window you’re modifying. Below are the dockable windows with filters that may be customized. These names are as they appear in ControlStylesConfig.xml. The name in parentheses corresponds to the name of the window in the user interface when it’s not obvious.

CrewTree
RegionTree (Selected Regions)
UserTree (Dispatchers)
TagTree
ScheduleSwitchingOrderTree

Create a Custom Filter

This topic walks through an example of adding a filter that displays all of the crews associated with a particular company. This filter resides on the Crews (CrewTree) dockable window in Responder Explorer.

Open ControlStylesConfig.xml. By default, this file is installed here: C:\Program Files (x86)\Miner and Miner\Responder\Server.
Search for the control (dockable window) that holds the filter you want to customize (e.g., CrewTree).
Each control has tables associated with it. Filters must be associated with the first table under the control. The list below shows the control followed by the initial table.
- CrewTree: RX_CREWS
- RegionTree: Regions
- UserTree: RX_USERS
- TagTree: RX_TAGS_AND_GROUNDS
- ScheduleSwitchingOrderTree: RX_SWITCHING_ORDERS

The table referenced by the RegionTree (Regions) control does not correspond to a table in the geodatabase. Instead, the Regions column (there's only one: Name) is listed in ControlStylesConfig.xml. For example:

<Tables Key="">
 <Table Represents="Regions">
  <Columns Key="">
   <Column Represents="Name" />
  </Columns>

Use this column to create your filter.

Figure 1, ControlStylesConfig.xml

Place the <FilterFinders> tag immediately after the </Appearances> tag. The <FilterFinders> tag may contain multiple <FilterFinder> tags. Each <FilterFinder> tag represents one filter. You can copy paste filters and modify them as needed. Below is an example of filters that use VB Script.

<FilterFinders>
 <FilterFinder Key="CrewTree_All" FilterFinderType="Filter" IsDefault="true">
  <Evaluator>Dvf:true</Evaluator>
  <Caption>All Crews</Caption>
 </FilterFinder>
 <FilterFinder Key="CrewTree_Company_MyCompany" FilterFinderType="Filter">
  <Evaluator>Dvf:[Company] = 0</Evaluator>
  <Caption>My Company</Caption>
  <Description>All My Company Crews</Description>
 </FilterFinder>
 <FilterFinder Key="CrewTree_Company_Acme" FilterFinderType="Filter">
  <Evaluator>Dvf:[Company] = 1</Evaluator>
  <Caption>Acme</Caption>
  <Description>All Acme Crews</Description>
 </FilterFinder>
</FilterFinders>

DVF is not case sensitive.

Figure 2, Sample filters in the user interface

Attributes

Key: This is a unique value that identifies the filter.
FilterFinderType: This is the type of filter and determines where in the user interface it appears. This attribute is set to "Filter" for basic filters. It can be set to "Finder" to appear in the Search dialogs. Use "Both" if you want your custom filter to appear in both places.
IsDefault: This attribute identifies whether the filter is the one displayed by default.
Evaluator: This is the criteria used by the filter. See the Evaluators section on this page.
Caption: The text displayed in the user interface.
Description: A brief description of the filter. This text is not displayed in the user interface.