1. Setup the integration for your Timing Company
To use our RACE RESULT 12 (RR12) Integration, you’ll first need to attribute your RR12 account with your Timing Company on Race Roster. To do so, navigate to the Companies page in the Timer Dashboard, and select "Manage integrations" from the ellipsis menu of the company you wish to connect.
Then, click "+ Create integration" and select "RACE RESULT".
To set the connection, enter your RR12 username and click "Save". Once the overall integration has been set, you will now be able to access a "RACE RESULT" settings page for any event in Timer Dashboard which you’ve attributed to the connected Company.
2. Connect your Race Roster event to its corresponding RACE RESULT event
Now that you have access to the RACE RESULT settings page for a particular event, you must connect that event to one of your events in RR12. When you enter your RR12 password on the settings page and click "Authenticate and fetch events", you’ll be provided a list of your RR12 events from the current year. Select the corresponding event from the dropdown menu. There is an option to sync your contests from RR12 upon connection (more on that below), but you may also select to sync contests at a later time by deselecting the "Sync RACE RESULT contests on connect" toggle.
3. Sync your RACE RESULT contests
You may sync the contests from your RR12 event either by leaving the "Sync RACE RESULT contests on connect" toggle ON when connecting your event, or by clicking the "Sync RACE RESULT contests" button after event connection.
The sync process performs several actions, both on Race Roster and within RR12:
Race creation: Syncing contests automatically creates races on Race Roster which mimic the contests you have set up in RR12. The settings of the races that are created (such as name, distance, distance unit) are based upon the corresponding contest settings in RR12. Segments are also created for the races and they correspond to "Splits" from RR12. The integration currently only supports cumulative type segments. In order to Race Roster to properly interpret and translate RR12 splits to segments, the distance of all splits in RR12 needs to be "(From Start)". Live Predictive Tracking must be enabled on Race Roster manually, if you wish. To learn more about Live Predictive Tracking, see How to set up predictive tracking for my event.
List creation: Race Roster will automatically add output lists to your RR12 event upon contest sync. These lists are unique to each contest and will be utilized when importing results to Race Roster from RR12. Lists are set up with a default sort order, set of columns/fields, and set of filters. You may adjust the settings of each list in RR12 if you see fit.
Webhook creation: Also in preparation for results import, Race Roster will add a webhook-based exporter to your RR12 event. By default, this exporter is set to accept passings from all Timing Points. These passings will not be scored, but instead act as a trigger which lets Race Roster know to check for and update results if they exist.
4. Push participant data from Race Roster to RACE RESULT
There are two ways to export participant data from Race Roster. In either case, the data is pre-formatted to map standard Race Roster fields to corresponding RR12 fields, with any custom or otherwise non-standard registration fields being created in RR12 upon import. Only participants with an assigned bib number and active status on Race Roster will be exported.
API: Once you’ve connected your Race Roster event to your RR12 event, you can opt for Race Roster to send participant data directly to RR12.
CSV Export: You may also opt to export a CSV which you can then manually import to RR12. This option may be useful if your event has circumstances that require some slight data editing before being imported to RR12.
Data Manipulation in RACE RESULT: As sub-events in Race Roster registration do not always correspond 1:1 with races/contests, we export SubEventName as a custom field that is not mapped directly to ContestName in RR12. As such, you will need to use RR12’s "Data Manipulation" tool to map the Sub-Event:Contest relationship after the participant data is in RR12. The tool may also be helpful if you have custom registration questions from Race Roster which happen to map to any standard fields in RR12.
Note that participant export is momentary, rather than being synced. Thus, you may need to export multiple times, depending on the circumstance of the event, such as the case of additional bibs being assigned as race morning progresses. We provide several export configuration options to give you control in choosing how to handle various conditions of conflicting or no-longer-applicable data from one export to the next.
5. Import results from RACE RESULT to Race Roster
At any time after event connection and contest sync, you can import results for all races at once or any subset thereof by clicking the ‘Import Results’ buttons. Additionally, you may utilize the import toggles to allow results imports on an ongoing basis. This feature relies on the integration’s webhook exporter in RR12 being on and started (which can be controlled using the ‘Start RACE RESULT webhook’ toggle). With the webhook exporter running and one or more of the import toggles ON, Race Roster will attempt to import an updated results set each time a chip passing is sent via the exporter. During congested finish line conditions where each new chip passing is within 30 seconds of the last, results will be ingested for processing about every 30 seconds. When chip passings are less frequent, Race Roster will only attempt to process an updated set of when the passing is encountered. If there are changes to any results that are occurring while there are no passings or while the webhook exporter is off, you should perform a momentary import with the ‘Import Results’ buttons.
As stated above, to edit the display settings of your results, you can adjust the corresponding output lists in RR12, or utilize Race Roster’s display setting editor to skip, hide or rename certain fields. To learn more about results display options, see How to make column edits.
Should you have questions about the Race Roster / RACE RESULT integration, please contact timer@raceroster.com.
Comments
0 comments