29. FlagSourceColumns

Contents

Overview

Since version 2015.02 FEWS makes it possible to configure so-called 'flagSource columns' for each individual validation step, in which the flagSource of the specific validation step will be recorded. From these flagSource columns the user can deduct which individual validation steps have been performed and to what result. Even when a defined validation step has been executed successfully and no quality flag has been changed, a default flagSource "OK" will be set for the respective flagSource column. The flagSource columns therefor provide details on all the validation steps. 

Configuration

FlagSource columns can be defined in FlagSourceColumns.xml regional configuration file. These flagSource Columns are stored for each timestep for all timeseries that have been validated in the FEWS database. Various configuration options allow the user to harness the Validation Status in the operational process, either by visualisation, export, conditional filtering in transformations, etc.

id

Id of the column. This id is only used to reference this column from the rest of the configuration. This id is not stored in the database. This id can be changed at any time without the requirement of deleting the datastore

name

optional element with name of the column. When not specified the id is used as the name

storageKey

An integer between 0 to 127 that is used in the datastore to reference this column. After changing this key you have to delete the local datastore and MC database

description

optional element; Long (descriptive) name of location (tool tip) or description

shortName

Short name used in the header of in the time series dialog. When not specified the name is used

toolTip

Tooltip to be displayed in the time series dialog when hovering the column header

editable

The column is not editable in the time series dialog by default. Editable columns are also visible when empty

backgroundColor

Background color of this column in the the time series dialog

Example configuration

The example configuration below

<flagSourceColumns xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/flagSourceColumns.xsd">
	<column id="V1" name="A_tooltip">
		<storageKey>0</storageKey>
		<description>Validationstep A is the first validationstep</description>
		<shortName>V1</shortName>
		<toolTip>A Tooltip</toolTip>
		<editable>true</editable>
	</column>
	<column id="V2">
		<storageKey>5</storageKey>
		<description>Second validation step</description>
		<shortName>V2</shortName>
		<toolTip>B Tooltip</toolTip>
		<editable>true</editable>
	</column>
	<column id="V3">
		<storageKey>1</storageKey>
		<description>Validation step C</description>
		<shortName>V3</shortName>
		<toolTip>C Tooltip</toolTip>
		<editable>true</editable>
		<backgroundColor>cyan</backgroundColor>
	</column>
	<column id="V4">
		<storageKey>2</storageKey>
		<description>Validation step D</description>
		<shortName>V4</shortName>
		<toolTip>D Tooltip</toolTip>
		<editable>true</editable>
		<backgroundColor>purple</backgroundColor>
	</column>
	<column id="V5">
		<storageKey>6</storageKey>
		<description>My E</description>
		<shortName>V5</shortName>
		<toolTip>E Tooltip</toolTip>
		<editable>false</editable>
	</column>
</flagSourceColumns>