Filter for a Structure Browser Page

You can provide an auto filter mechanism for root nodes of a structure browser page or for a structure browser shown in flat table mode the same way as for a table page.

See Structure Browser in Flat Table Mode. The auto filter does not work for structure browsers with a single root node, and for multiple root nodes only filters on the root nodes, not any expanded rows. For more information on table filtering, see Building a Table.

See Filtering Page Data to see how this feature works.

The filter icon, , is automatically added to the page toolbar if the structure browser includes any column that is capable of autofiltering. A column is capable of autofiltering if it:


  • Is listed in the emxFramework.AutoFilter.Basic.InclusionList property in emxSystem.properties
  • Is listed in the emxFramework.AutoFilter.Attribute.InclusionList property in emxSystem.properties
  • Has ranges defined for the attribute
  • Has the Auto Filter=true setting defined (cannot use with a column that can have multiple values for a single cell)

Even if any of the above criteria are met, the filter icon does not displays if the autoFilter=false URL parameter is passed.

If you want to exclude attributes with defined ranges from being used as filters, add the attribute to the emxFramework.AutoFilter.Attribute.ExclusionList property in emxSystem.properties.

If the column contains an attribute configured with a dimension, the page is filtered based on the display value, not the normalized value.

Configuring many columns for autofiltering or applying an autofilter to inappropriate columns can adversely effect performance when viewing the filtered list. For optimum performance, only define a limited number of columns with autofilter. Choose columns that have a limited set of possible values on which the user may want to filter the table data. For example, state and owner columns are good candidates. Columns such as description and name are inappropriate because of the unlimited number of resulting values.