Contest definition

From DXLog.net
Revision as of 13:51, 7 February 2014 by 9a5k (talk | contribs) (General contest description)
Jump to navigation Jump to search

Description

Rules for each of the contests are more or less different from each other.
It can be difference in points per qso calculations, multiplier determination and calculations etc.

To support all these different rules and to allow easier adding / changing contest rules in DXLog.net, all parameters in contest rules are defined and controlled through contest config files.
Contest config files are plain text files which are installed in Contest sub-folder in DXLog.net installation folder.

When application is started, content of Contest folder is copied into ApplicationData folder in your Windows OS.
During copying process, DXLog.net compares modify date of each file in installation folder with version in ApplicationData folder.
If newer version already exists in ApplicationData folder, file wouldn't be copied there.

User can change existing or create new files in Application folder, in case it is needed for some testing purposes, or if user wants to create new contest definition file to support some new contest.

File structure

Each line in contest config file usually contains of KEY + VALUE pairs.
This pair is separated by "=" sign.
For example:

 CONTEST_NAME=9A CW 
This means that field KEY is CONTEST-NAME, and 9A CW is value for that field.

General contest description

These keys are used for general contest description in config file, such as contest name, link to the rules etc.

  • CONTESTGROUP

Used for group contest when displaying on config screen for contest selection.
For example: Digital, 9A Local Contest etc.

  • CONTESTNAME

Contest name as it will be shown and recognized in contest selection box.
Note: this can be same as cabrillo contest name, but usually it is full contest name.
This field is mandatory and must be unique for all files in contest definition folder.

  • CONTESTRULES

Link to contest rules.

  • CONTESTWEB

Link to contest web.

Configuration screen control

Band and mode specific

Entry field definitions