What |
application_config.xml |
---|---|
Description |
Configuration of the Water Coach application |
schema location |
application_config.xsd |
In the application configuration, global settings for the Water Coach (fka FEWS Game) which are valid for all scenarios/scripts can be specified.
The structure of the XML-schema for the application configuration is as follows:
The keys in the XML-schema are explained in the figure above. Some of the keys are explained in more detail here.
Note: when 'relative path' is mentioned, this is the relative path with respect to the location of the Water Coach executable (i.e. not the FEWS executable).
locale
must be a 2-letter abbreviation of the language in which the game screens will be displayed (currently available: EN for English or NL for Dutch).hideYear
to true. Note that for the Water Coach a copy of the operational system should be used since some changes in the FEWS configuration are required; see below.fewsExecutable
must contain the (absolute or relative) path to the FEWS executable, which is usually located in the bin
-directory of a FEWS release. On the Linux platform, the FEWS executable is the shell script fews.sh
. See below for required changes in the FEWS configuration.fewsRegionDir
is the (absolute or relative) path to the so-called region directory of FEWS. The region directory contains the FEWS configuration (the Config
-subdirectory) and the global properties for the FEWS configuration. The Water Coach is generic and can be used with any FEWS configuration. Note that on a Windows system, the FEWS region directory is also specified in the so-called jpif
-file that is located in the bin
-directory of the FEWS system. This specification must be consistent with the one in FewsRegionDir
.fewsSystemTimeUpdateInMinutes
. See below for required changes in the FEWS configuration.scenarioScriptDatabasePath
contains the (absolute or relative) path to the scenario/script database.fileAssociation
, programs can be specified with which files with indicated extensions must be processed. Default file associations are used if nothing is specified here.timeControl
, the presence of buttons for time control during the game can be configured, namely a pause/play
button, a next
button for jumping to the next scheduled event in the script, fast Forward/Backward
buttons for speeding up/down time, and a set
button for adjusting the time manually.fewsPiPortNumber
. See below for required changes in the FEWS configuration.serverHostName
and serverPort
, respectively. In a stand-alone Water Coach set-up these keys are not relevant.It is advisable to use a copy of the operational system for the Water Coach, to prevent any possible obstructions to the operational activities. Also, some minor changes are needed in the FEWS configuration in order to use it with the Water Coach:
Note: for a more detailed description of the FEWS configuration files, please refer to the wiki pages of the Delft FEWS Configuration Guide.
dateTimeFormat
must be configured accordingly in the dateTime
section of the FEWS configuration file Explorer.xml
.cardinalTimeStep
, as configured in the dateTime
section of the FEWS configuration file Explorer.xml
, should be consistent with fewsSystemTimeUpdateInMinutes
. Indeed, it makes no sense to set it in the Water Coach to 1 minute, while it is set to 1 hour in the FEWS configuration (although this will not cause any problems in the game).adjustSystemTimeAutomatically
should be set to 'false', otherwise it will not be possible for the Water Coach to alter the systemTime during the game.hideExternalHistoricalAfterSystemTime=true
in the file global.properties
, which is located in the FEWS configuration directory. As the name of this key implies, only time series of the type "external historical" are hidden; time series of the types "external forecast", "simulated historical", and "simulated forecast" are completely visible.fewsPiPortNumber
for the FEWS PI service has to be in the range of port numbers that must be specified in the FEWS configuration file Explorer.xml
in the directory SystemConfigFiles
, e.g.
<piServicePortRange start="8100" end="8200"/> |
Explorer.xml
, which you will find in the directory SystemConfigFiles
. The name of the Explorer window is configured with systemCaption
and the name of the panels with panelHeaderLabels
. For example, the term TRAINING or SERIOUS GAME could be added to the captions of these panels.<?xml version="1.0" encoding="UTF-8"?> <config xmlns="http://localhost" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://localhost xml-schemas/application_config.xsd"> <name>Example of application configuration</name> <locale>EN</locale> <hideYear>true</hideYear> <fewsExecutable>FEWS\bin\FewsNoordzee_SA.exe</fewsExecutable> <fewsRegionDir>FEWS\FewsNoordzee_SA</fewsRegionDir> <fewsSystemTimeUpdateInMinutes>1</fewsSystemTimeUpdateInMinutes> <scenarioScriptDatabasePath>ScenarioScriptDatabase\Noordzee</scenarioScriptDatabasePath> <fileAssociation extension="pdf">C:\Program Files\Adobe\Reader 9.0\Reader\AcroRd32.exe</fileAssociation> <timeControl> <pause>true</pause> <next>false</next> <set>false</set> <fastForwardBackward>true</fastForwardBackward> </timeControl> <fewsPiPortNumber>8100</fewsPiPortNumber> </config> |