The archive display can be used to interact with the FEWS-archive.
The main functions which are supported by this display are:
- management of events in the archive,
- search for events and download data related to events from the archive,
- search for data in the archive
To use the archive display, configure it as <explorerTask> in Explorer.xml. For example:
The ArchiveModuleDisplay configuration
The archive display uses the file Archives.xml file in the SystemConfigFiles directory to identify were the archive web server is located.
The Archives.xml is explained in more detail in the section seamless integration.
Below an example is shown.
If the archive is installed following the conventions described in Installation of the Deltares OpenArchive (earlier versions) the configuration shown above is sufficient.
Note however that when you start using the seamless integration in the pi-webservice that more configuration is required in the Archives.xml file.
The archives.xml will be used by the archive display panel to identify were the webservices of the archive are located.
In addition you will need to configure a file called ArchiveModuleDisplay.xml in the DisplayConfigFiles folder.
Below an example of this file containing the most important tags is shown.
The $ARCHIVE_DOWNLOAD_FOLDER$ should be configured in your global.properties file and should point to the folder were the panel should download the files of the archive to.
The tag workFolder configures which folder will be used as the workfolder. The workfolder is used by the event-panels.
The archiveImportWorkflowId is used to configure the id of the import workflow. The panel offers two options for downloading data. The first option only downloads the data. The second option
downloads the data first and runs an import workflow directly after finishing the download. The id configured in the tag archiveImportWorkflowId identifies which workflow should be ran.
Below a more advanced example of a ArchiveModuleDisplay.xml is shown.
The events-panel can be used to search for events in the archive. It is possible to search for events in which certain thresholds were crossed.
The tag levelThresholds can be used to configure for which thresholds can be searched in the eventspanel.
By default every user can delete or create events. The tags createEventPermission and deleteEventPermission can be used to restrict those actions to users which have the required permissions.
The "Search and download datasets"-panel can be used to search for data in the archive. The dropdown-box in this panel shows by default all possible datasets-types.
To restrict this list, for example when not all datasets-types are exported by FEWS to the archive, the tag searchDataTypes can be used.
The states can be downloaded and imported as a part of ‘simulated forecast’ data set, together with simulated time series, reports and modifiers. For this purpose an item ‘simulated forecast’ should be selected from the data set drop down list.
From 2019.02 it is also possible to download and import states only. To download and import states only, select first the data set 'simulated forecast' and then ‘states’ from the drop down list behind the button 'Select...'
When ‘states’ is selected, all simulated data sets that include states are listed in the table and the ‘Download and import data’ button becomes enabled. To download and import the states, select one or more data sets from the table and press button ‘Download and import data’ . The states data sets will be first downloaded to the archive download folder ./simulated and then imported in the database table WarmStates. If there is already a state for the same module and with the same state time in the database table, the downloaded state will be skipped.
If the archive is not installed according to the conventions desribed in the installation manual than it might be needed to configure custom endpoint for the archive-webservices which
are used by the archive panel. This custom configuration can be done in the tag "archiveServer", below an example is given.