Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The archive display can be used to interact with the FEWS-archive. It can be used to search for data, download data and import data from the archive.

Configuration

Note that when you start using the archive you need to configure the Archives.xml Archives.xml - 2018.02 and later - DELFT-FEWS Documentation - Deltares Public Wiki


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.

...

<?xml version="1.0" encoding="UTF-8"?>
<archives 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/archives.xsd">
	<catalogueUrl>http://dummy_server:dummy_port/deltares-archive-server/catalogue</catalogueUrl>
</archives>

Archives.xml

Note 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.

...

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.

Custom configuration

If the archive is not installed according to the conventions described 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.

...

<archiveServer>
	<archiveWebService>http://dummy_server:8080/deltares-archive-server</archiveWebService>
	<archiveConfigFileUrl>http://dummy_server:8080/thredds/fileServer/Config</archiveConfigFileUrl>
	<eventsFileServerUrl>http://dummy_server:8080/thredds/fileServer/Events</eventsFileServerUrl>
	<dataFileServerUrl>http://dummy_server:8080/thredds/fileServer/archive</dataFileServerUrl>
</archiveServer>

Below a more advanced example of a ArchiveModuleDisplay.xml is shown.

...

.

...


Archive panel

The archive display has several tabs which as are shown in the picture below.

...

Search and download datasets

Image Added

This panel can be used to search for specific datasets in the archive. It possible to search by area, source, period and data set type.

After selecting one or more data sets it is possible to download the selected data sets by pressing the download button Image Added.  Importing the data is possible by using the import button  Image Added

Downloading and importing grid data can be time consuming. The option import grids as references can be used to only download and import the references to a grid file. The actual data will only be imported when the actual data is needed in a workflow or the grid display.

Events panel

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 events panel. By default every user can delete or create events.

...