You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

Introduction

Since version 2021.01 a new concept has been introduced: Annotation.

Technically an annotation is a time series which does not contain numeric values but just text.

It has been introduced to

  • Use in the Annotation Display to show special remarks that are valid for a specific location for a specific period
  • Support higher volumes of text than is possible with the comment field of individual time steps of "classic" time series.
  • Define the text on a location basis and not time series basis

Besides the text of the annotation itself it is possible to define extra properties which belong to the annotation.

They will have an id, name and a value type.

The value type can be 

  • string (free text format)
  • double (number format)
  • dateTime (stored as numeric value but shown via the date format in Explorer)
  • enumeration (choice between predefined texts)

Both the enumerations as properties can be defined in pure xml and referred to a separate csv file.

Configuration example

See config examples below, for the "categorie" enumeration there is both an xml example (in comments) as the reference to a separate categroie.csv file.

AnnotationMetadataSchema
<?xml version="1.0" encoding="UTF-8"?>
<annotationMetadataSchema 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/annotationMetadataSchema.xsd">
	<valueTypes>
		<string id="TEXT"/>
		<double id="NUMBER"/>
		<dateTime id="DATE"/>
		<!--<enumeration id="Categorie">
			<value code="001" label="Peilbesluiten">
				<description>001 Peilbesluiten</description>
			</value>
			<value code="002" label="Grondwater">
				<description>002 Grondwater</description>
			</value>
			<value code="003" label="Alarmen CAW">
				<description>003 Alarmen CAW</description>
			</value>
		</enumeration>-->
		<enumeration id="Sub-Categorie">
			<value code="001001" label="Peilbesluit kan niet ingesteld worden." constraintEnumerationId="Categorie" constraintEnumerationCode="001">
				<description>001001 Peilbesluit kan niet ingesteld worden.</description>
			</value>
			<value code="001002" label="Droge zomer." constraintEnumerationId="Categorie" constraintEnumerationCode="001">
				<description>001002 Droge zomer.</description>
			</value>
			<value code="001003" label="Natte winter" constraintEnumerationId="Categorie" constraintEnumerationCode="001">
				<description>001003 Natte winter</description>
			</value>
			<value code="001004" label="Verkeerde instelling" constraintEnumerationId="Categorie" constraintEnumerationCode="001">
				<description>001004 Verkeerde instelling</description>
			</value>
			<!-- Categorie 002 -->
			<value code="002001" label="hemelwater" constraintEnumerationId="Categorie" constraintEnumerationCode="002">
				<description>002001 hemelwater</description>
			</value>
			<value code="002002" label="Grondwater" constraintEnumerationId="Categorie" constraintEnumerationCode="002">
				<description>002002 Grondwater</description>
			</value>
			<value code="002003" label="Lekke kelder" constraintEnumerationId="Categorie" constraintEnumerationCode="002">
				<description>002003 Lekke kelder</description>
			</value>
			<value code="003001" label="Alarm">
				<description>003001 Alarm</description>
			</value>
		</enumeration>
		<enumerationsCsvFile>
			<file>categorie.csv</file>
			<id>%id%</id>
			<code>%code%</code>
			<label>%naam%</label>
			<description>%description%</description>
			<constraintEnumerationId>%restrictieType%</constraintEnumerationId>
			<constraintEnumerationCode>%restrictieWaarde%</constraintEnumerationCode>
		</enumerationsCsvFile>
	</valueTypes>
	<properties>
		<property id="freeText" valueTypeId="TEXT"/>
		<property id="number" valueTypeId="NUMBER"/>
		<property id="date" valueTypeId="DATE"/>
		<propertiesCsvFile>
			<file>AnnotationProperties.csv</file>
			<charset>UTF-8</charset>
			<id>%id%</id>
			<name>%name%</name>
			<valueTypeId>%valueTypeId%</valueTypeId>
		</propertiesCsvFile>
	</properties>
</annotationMetadataSchema>

Definition of the different categorie enumeration values

categorie.csv
id;code;naam;description;restrictieType;restrictieWaarde
categorie;001;Peilbesluiten;001 Peilbesluiten;;
categorie;002;Grondwater;002 Grondwater;;
categorie;003;Alarmen CAW;003 Alarmen CAW;;
  • No labels

Disclaimer