Introduction
This user guide will help you to configure all your RaceCommittee App devices. The guide is targeted at a multi-device, multi-course-area, multi-race-officer setting. So feel free to omit steps whenever you feel that you don't have to use every feature for your current regatta. It is reasonable to stick to the presented order of steps.
Preparation of devices
The RaceCommittee App supports remote configuration via the AdminConsole interface on the server. Open up the AdminConsole and select the tab Device Configuration. Click Add Configuration.
First you need to enter a device identifier. It is a good idea to label the device with the this identifier, to enable the identification of the device by an untrained user.
You need to assign this identifier to the target device. Click on QR-Sync, recheck the current identifier and ensure that the Server URL is the correct server the device should be talking to. When done with your modifications hit Generate.
Fire up the RaceCommittee app on the target device. Go to the settings view by clicking on the options overflow button (top right corner) or your device's menu button. Select the preference category General and click on Synchronize connection settings. Scan the barcode shown in the AdminConsole (if you don't have a barcode app installed the RaceCommittee App should redirect you to the Google Play Store offering an app). The Device Identifier and Webservice URL preferences should reflect the changes made.
After the server URL has been updated the app will check the server whether it should auto-update itself or not. To ensure that your app is compatible with the server you should choose to install the APK provided by the server.
Back in the AdminConsole configure your device (see next step). When done click Save + Clone to use the current configuration as a template for the next device.
Repeat until you've configured all your devices.
Configuration of devices
There are several preferences you can configure to control the overall functionality of the RaceCommittee App.
All these options can be configured either via remote configuration (see above) or on the device itself. The remote configuration is fetched on selecting an event in the event selection screen. If there is a configuration stored on the server for the target device, each configured option will overwrite the corresponding option in the device's local configuration. If you leave an option unconfigured in the AdminConsole, the device will preserves its value. E.g. by leaving the 'Results recipient' option unchecked in the AdminConsole will preserve the recipient configuration currently stored on the device.
In the following we will have a look at some of these settings. Most of them are enabled for remote configuration.
General preferences
- Device Identifier: See above. Used to identify the device when fetching a remote configuration.
- Server URL: The server the device will talk to. On change you should reload the app.
- Managed course areas: The user is able to logon to the configured course areas.
- Results recipient: When active, the race's results (photos) will be sent to this mail.
Course Designer
- Configuration of designers: Each designer has some options to be configured.
Regatta Configuration (default)
- Default racing procedure: the app will preselect the chosen racing procedure for all races, whose specific regatta configuration (see down) doesn't overwrite this.
- Default course designer: the app will preselect the chosen course designer for all races, whose specific regatta configuration (see down) doesn't overwrite this.
- Configuration of procedure: Each racing procedure has some options to be configured. An option value applies to all races, whose specific regatta configuration doesn't have this option set.
Keep in mind that changing these options in the app will only have an effect on new racing procedures (ongoing race with no change in their racing procedure will keep the old settings).
Configuration of regattas
For races attached to a regatta (i.e. RegattaLeaderboard) you are able to configure certain options per-regatta. The regatta's configuration is fetched by the app together with the race information on logon.
In the Regatta tab of the AdminConsole click the Edit action of the regatta to be configured. If you check Set regatta configuration this configuration will overwrite any device configuration.
- Regatta's default racing procedure: the app will preselect the chosen racing procedure for all races of this regatta. This option will have no effect when Overwrite Racing Procedure is set in the device's configuration.
- Regatta's default course designer: the app will preselect the chosen course designer for all races of this regatta. This option will have no effect when Overwrite Course Designer is set in the device's configuration.
- Set racing procedure configuration: When checked enables you to configure the default racing procedure of this regatta. This option will have no effect when Overwrite racing procedure configuration is set for the device's remote configuration.