Function: | Configure Validation Status |
Where to Use? |
|
Why to Use? | The FlagSourceColumns.xml is necessary to be able to use validation status related functionality, as described in 26. Validation Status |
Description: | The FlagSourceColumns file is used to define flagSourceColumns (i.e. validation steps) which can be defined to store flagSources of individual validation steps and which can be stored in the datastore and visualized in the time series dialog |
Available since: | DelftFEWS 2015.02 |
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 defines 5 validation steps.
<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>