Page History

Contents

General

Filters are used in DELFT-FEWS to define the locations that are displayed on the main map display, and that can be selected to display data. Filters are defined to arrange locations, with associated parameters in logical groups. Each filter is defined as a collection of time series sets.

...

When available on the file system, the name of the XML file is for example: Filters 1.00 default.xml

Figure 31 Elements of the filters configuration

The main elements of the filters configuration are shown in the image above and explained further below:

• description: Optional description of the filter configuration. Used for reference purposes only.
• defaultFilterId: Filter that is selected automatically on start up of FEWS. If not defined no filter will be selected.
• timeSeriesSets: Optional element that may appear an unlimited amount of times. It is possible to explicitly define every (child)filter. This may result in to many repeating timeSeriesSet definitions. Therefore it is also possible (since version 2009.02) to define groups of timeSeriesSets that can be used many times in the filter, additionally by using constraints on the location attributes

...

description

Optional description of the filter configuration. Used for reference purposes only.

defaultFilterId

...

• (see ???). Each <timeSeriesSets> element should contain an id attribute and one or more <timeSeriesSet> elements. 
• filter: Required element with the definition of a filter. Multiple entries may exist where multiple filters are defined.

filter

Definition of a filter. Multiple entries may exist where multiple filters are defined. Each filter may contain either a set of one or more time series set, or a child filter. The child is a reference to another filter definition that again contains either a child filter or a list of time series sets. This structure is used to construct a hierarchal tree view of filters.

Attributes:

• id: Id of the filter. This ID is used Used when this filter is referenced elsewhere in the configuration. Used in the tree view in the main display when no name attribute is given.
• name: optional name for the filter. For reference purposes only.. When given it is used in the tree view in the main display.

The possible elements are each explained in their own section.

description

Optional description of the filter configuration. Used for reference purposes only.

validationIconsViewPeriod and validationIconsVisible

Both elements are optional, only one of the may be configured for a filter. 

• validationIconsViewPeriod: Since 2017.01, optional element. Calculate validation icons in the specified period. By using this you can for example ignore the validation problems for the most recent data. Can not be combined with a <validationIconsVisible> element. 
• validationIconsVisible: Optional element allowing ValidationIconsVisible: This allows the user to make use of the additional validation icons available in the explorer (2009.01). When set to true, all validation icons in the view period of the time series sets will be shown. Can not be combined with a <validationIconsVisible> element.

lastValueVisible

Optional element available since 2013.01. 

In versions 2013.01 until 2017.01, when this filter is selected the last value for the selected parameter is visible in the location label on the map. If several filters are selected, the last value is only shown if all filters have this element set to true. When a parent filter is selected, the last values are only shown if the element is set to true for all child filters and the parent filter. Note that all cases, the last values are only shown for locations which do not have a custom label configured. Additionally, the values are only shown when a single parameter is selected in the data viewer.

Since 2017.02 a button was added to the explorer which controls whether the labels show the last value. When a filter selection is made for which in previous versions the last values would be shown, the button is now turned on automatically instead. Note that this means the user can still turn of the last values by turning the button back off (clicking it). Also note that when a different selection is made (while the button is still on), the button will remain turned on even if <lastValueVisible> is not set to true for the new selection. 

mapExtentId

Optional element, when this filter is selected the map will automatically zoom to the specified map extent. 

viewPermission

Optional element, set a permission to control who can view this filter.

editPermission

Optional element, set a permission to control who can edit timeseries enumerated in this filter (only editable timeseries can be editted).

child

Reference to another filter. The child element refers to the ID of the other filter as a foreign key.

Attributes:

• foreignKey: Reference to ID of another filter, that is displayed as child filter

timeSeriesSet

Definition of a time series set belonging to a filter. Multiple time series sets may be defined.

...

Figure32 Example of filter configuration, as defined in the example XML configuration above.

timeSeriesSetId & constraints

Instead of an extensive definition of all possible time series that usually will be repeated for different types of locations and various districts, it is possible to define the timeSeriesSets once and to use it various times through all filters. At this point you refer to such a timeSeriesSets and optionally add some constraints on the location attributes. Notice that location attributes only can be defined in the locationSets for locations that are read from an ArcGIS shape DBF file. See the example below.

It is possible to define filters that may become empty: no locations comply with the constraints. These filters are not displayed. An advantage of this approach is that all possible filters can be defined once and automatically become visible when a location complies to the constraints.

...