RaceCommittee App (Administrator's User Guide)

Table of Contents

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. Follow the instructions on the screen and reopen the newly updated app. After the update you must re-synchronize your device with 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.

As you can see you are able to select for which racing procedure type you wish to create a configuration. If you don't activate a racing procedure's configuration the device's local configuration values will be preserved.

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 overwrite 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 overwrite the device's configuration.
  • Set racing procedure configuration: When checked enables you to configure the default racing procedure of this regatta. Setting regatta-specific preferences here will overwrite device-global preferences.

On-Device Configuration

As stated above it is possible to (re-)configure these preferences in the app. Changes on the device will not be synchronized with the server.