Table of Contents |
---|
Introduction
Since version 2021.01 a new display has been introduced Annotation Display.
It has been introduced to
- To show Show special remarks that are valid for a specific location for a specific period
- 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 for this see Annotation Metadata Schema
There a 2 are two different ways of enabling the Annotation Display, both via the explorer task. One without specific config <predefinedDisplay>annotation display</predefinedDisplay> and one with referring to the display config file <displayConfigFileName>AnnotationDisplay</displayConfigFileName>
Code Block | ||||
---|---|---|---|---|
| ||||
<explorerTask name="Annotation Display">
<!--<predefinedDisplay>annotation display</predefinedDisplay>-->
<displayConfigFileName>AnnotationDisplay</displayConfigFileName>
<toolbarTask>true</toolbarTask>
<menubarTask>true</menubarTask>
<loadAtStartup>true</loadAtStartup>
</explorerTask>
|
The config file of the annotation display currently only holds 3 optional elements to add permissions.
Code Block | ||||
---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?> <annotationDisplay 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/annotationDisplay.xsd"> <createPermission>AllowDataEditor<<createPermission>PermissionA</createPermission> <editPermission>AllowValueEditor<<editPermission>PermissionB</editPermission> <deletePermission>AllowValueEditor<<deletePermission>PermissionC</deletePermission> </annotationDisplay> |
Usage
When configured correctly the Annotation Display will be come visible in the tabs.
By default it will show all annotations for all locations:
The location and creation time columns will always be filled, they uniquely identify the annotation. Start time is optional, no start time means the annotation has always been valid in the past. End time is optional, no end time means the annotation is valid until an undetermined time in the future.
...
Filtering can be applied to multiple columns at once and double clicking on a cell in a filtered column removes the filtering for that column.
Creating new annotation
When pressing the "create" button on the bottom a popup screen will show from which the user can input the desired information for creating a new annotation.
For each configured annotation property there will be an input field created automatically.
For configuring annotaion properties see Annotation Metadata Schema.
For a plain string property like "freeText" below a text input field is used.
...
When an enumeration property with constraints is used and the property on which the constraints are based is already filled in then only the valid enumeration values will be shown in the dropdown:
Edit, copy and delete
...
When the "delete" / "cross" button is pressed the selected annotation will be deleted immediatlyimmediately.
Listening to selection
The Annotation Display both listens to the selected locations from the Time Series Dialog as from the Grid Display.
When there is at least 1 one annotation available for the selected locations, the icon of the Annotation Display will be black
But when there are no annotations available for the selected locations the icon will become white:
When a selection is made from the time series dialog or grid display it can be chosen to filter for that selection (or not) via the "filter for selection" checkbox on the bottom.
Below the KNMI-RADAR location has been selected in the grid display and "filter for selection" is checked so only annotations for KNMI-RADAR are shown.
When "filter for selection" is unchecked annotation for all locations are shown.
...