Scoreboard Viewing - pc2ccs/pc2v9 GitHub Wiki
Overview
PC² provides two general mechanisms for viewing contest standings. First, the system contains a "standings" pane which can be used to directly view the current standings. This standings pane can be viewed in a variety of different ways: by viewing the Standings tab on either the PC² Admin screen or the PC² Scoreboard module screen, or by using the PC2 Reports function to view scoreboard reports. The standings which are viewable through any of these mechanism are always the actual current contest standings (that is to say, these displays do not take into account any configured "scoreboard freeze" time).
The second, and more flexible, way of displaying the contest standings is via a set of HTML standings pages which are automatically generated by running a Scoreboard module. The Scoreboard module runs whenever a scoreboard account is logged into; this can be done either via an interactive login screen or by running a scoreboard in "No GUI" mode (see the PC² Contest Administrator's Guide chapter on Scoreboards for further details). The Scoreboard module automatically generates/updates HTML pages showing contest standings whenever any event which affects standings occurs.
In addition to providing the above views of the contest standings, various PC² modules also automatically generate contest standings in the form of "output files", in several formats. One file, results.xml, contains the current contest standings formatted as an XML document following an (old, deprecated) results file format. Anther file, pc2export.dat, also contains contest standings, formatted in a manner suitable for import into the [ICPC Contest Management System] using an older, deprecated layout. In addition, when a contest is marked by the Contest Administrator as "Finalized", PC² writes files named results.tsv, scoreboard.tsv, and scoreboard.json into a folder named results.
HTML Output
The Scoreboard module actually generates two complete sets of HTML standings pages. The first set of HTML pages comprises the public scoreboard. This set of pages shows the current standings, but it respects any scoreboard freeze configured in the contest settings (that is, it will show any submissions received during the freeze period as "Pending" and will not take the judgement results of those submissions into account when computing standings).
The second set of HTML pages comprises the private scoreboard. This set of scoreboard data shows the actual (up to the moment) contest standings, ignoring any scoreboard freeze. This scoreboard data is intended for viewing by contest administrators, judges, and other personnel who are allowed to see the final results as they occur.
The two sets of HTML pages ("public" and "private") are stored in separate folders, each of whose location can be specified using the Edit Scoring Properties button on the PC² Admin screen Configure > Settings tab.
The HTML pages created by the Scoreboard module are stored in folders on the local machine. If it is desired to have those pages be accessible elsewhere, a common approach is to set up a separate external batch script which periodically copies the contents of the public HTML pages to a URL where it can be viewed by spectators, teams, and/or any others whom the contest administrator wishes to be able to see the public scoreboard. Similarly, a separate script can be set up to copy the private HTML pages to a location whose URL is only known to those who are allowed to see the actual real-time standings.
The HTML output generated by PC² is configurable; see Scoreboard HTML Configuration for details.