Properties (systemwide)

The property file, valid for all users

This property file is called ".nc.properties" and it is stored in a folder called "data" under the installation folder. The path is dependent on your input during the installation. The systemwide property file will be updated, if you update exchange rates. You can add additional formats which are shown by the "Format" dialog.

Example:

 
#/* properties updated */
#Sat May 10 10:43:21 CEST 2003
rates_logic=false
rates_date=Monday, May  5, 2003 at 9am
rates_preferred=pacific.commerce.ubc.ca.filter
format_0=$SVALUE \= $TVALUE 
format_1=$SVALUE [$SUNIT] \= $TVALUE [$TUNIT] 
format_2=$SVALUE [$SFLAG; $SUNIT] \= $TVALUE [$TFLAG; $TUNIT] 
format_3=$SVALUE\t$TVALUE 
format_4=$SVALUE\t$SUNIT\t$TVALUE\t$TUNIT 
format_5=$SVALUE\t$SFLAG\t$SUNIT\t$TVALUE\t$TFLAG\t$TUNIT 
format_6=$SVALUE;$SUNIT;$TVALUE;$TUNIT 
format_7=<tr><td>$SVALUE</td><td>$SUNIT</td><td>$TVALUE</td><td>$TUNIT</td></tr>


Description of all valid keys:  

 
Key datatype Default Since NC Description
#

1.0.0 Leading hashes are recognized as comments and will be ignored
rates_logic boolean
1.3.0 the logic of the exchange rates (true or false)
rates_date String
1.3.0 the date of the exchange rates
rates_name String   2.2.0 der Name des Wechselkursservices
rates_preferred String
1.3.0 the latest selected exchange reates filter
rates_preferred_dir String
1.3.0 das zuletzt gewählte Verzeichnis
format_<n> String
1.4.0 The format that should appear at the dialog box called "Set format for notice". The decimal parameter <n> has to start with 0.
rates_filter.<filterID>.supportedRates Integer
3.0.0 The number of supported exchange rates for each filter. The value is updated each time an exchange rate filter is successfully used.
rates_update.policy String "none" 3.0.0 Valid values are "none" and "OnAppStartUp".

If the directive is set to "none", the application will not automatically update the exchange rates.

If the directive is set to "OnAppStartUp" and an exchange rate update has not already been requested from the command line, exchange rates are updated when the application is started.
rates_update.policy.OnAppStartUp.doNotUpdateIfLastUpdateIsYoungerThanMs Long 21600000 3.0.0 Only used if the directive rates_update.directive.main is set to "OnAppStartUp".

You can specify a time period in ms that specifies how much time must have elapsed since the last automatic update before a new download of exchange rates takes place. This prevents exchange rates from being updated every time the application is started, even though they may not have changed at all. The default value for this property is 6 hours. If the value is set to 0, exchange rates will always be updated when the application is started.
rates_update.policy.OnAppStartUp.lastSuccessfulUpdate Long
3.0.0 Only used if the directive rates_update.directive.main is set to "OnAppStartUp".

This value is automatically set if the automatic exchange rate update was successful. The value is set to the number of elapsed ms since 01.01.1970 until the last successful update.
rates_update.policy.OnAppStartUp.filterID String "list" 3.0.0 Only used if the directive rates_update.directive.main is set to "OnAppStartUp".

A filter similar to rates_preferred can be specified. The value of this property refers only to the automatic update and not to the manual update of the exchange rates. This allows independent preferences for automatic and manual exchange rate updates. If this key is missing, list will be assumed and only a list of all available exchange rates that can be used on the command line will be printed on standard out.