This is a beta test version of the seamless integration between Roster Athletics and FinishLynx. Please keep in mind that since this is still a beta version, there may be potential bugs and corner cases where the integration may stop working without warning.
What do you need to do to set up the integration?
- You have created the meeting in the Roster Athletics platform.
- You have downloaded and installed the Roster/Lynx data transfer program named “RosterAgent” (to receive the program, send an email to firstname.lastname@example.org and we will send you the program installer).
- You have an active demo of, or a full license to use, the FinishLynx software (note that FinishLynx only works with Windows). You can download it here: http://www.finishlynx.com/product/software/finishlynx-results-software/
The RosterAgent program is a small program that allows communications between the Roster platform and FinishLynx so that they can stay in sync with each other during the competition for start lists upload from Roster to Lynx and results download and sync from Lynx to the Roster platform (and immediately in the app).
Make sure you have administrator privileges for the machine you wish to use. Download the RosterAgent installer (either RosterAgent-x.x.x.msi for Windows or RosterAgent-x.x.x.dmg for Mac) and open the installer. You may need to approve the installer with an admin account and/or allow the installer to run through the virus protection and security settings. Allow the program to make changes to your device. Once installed, the RosterAgent program will appear in your standard applications folder.
Note for Mac users: the first time that you run the program after installing, you may have to approve the agent under your security settings. In Mac OS, you can do this under your general settings --> Security & Privacy --> accept the agent.
Now you should have everything ready to start the integration. Make sure you have the following three programs open:
- Roster Athletics in a browser
In the RosterAgent program, you will need to select the integration mode by choosing either Serial port or Shared files per the instructions below in order to share information data between Lynx and Roster.
- Serial port: Use this option if you have connected one computer running FinishLynx with another separate computer running Roster Athletics via a serial cable.
- Shared files: Use this option if you are using the same computer or you are using a shared file folder between computers.
If you select Shared files as the integration mode, then you will have to select both an input and an output directory. These directories NEED to be the same as the input and output directories that FinishLynx uses in order for the data to be transferred between Roster and Lynx (see below on the Lynx setup).
Now let’s go to the FinishLynx setup before returning to load the configuration in Roster. Go to the FinishLynx program.
Open the Options menu under File in FinishLynx.
Make sure the Input Directory and the Output Directory point to the exact same directories as you set up in the RosterAgent. Additionally, you need to make sure that Code set and LIF Code set are set to Unicode.
NOTE: If the directories are not the same between Roster and Lynx, the data will not be transferred and you will not get the expected results. Please double check these directories.
You will only need to change these settings the first time you set up the integration, after which they will come up by default.
If you select Serial port as the integration mode, then you will have to select the serial port.
It should look like this in the RosterAgent:
You will also need to change the corresponding settings in Lynx by setting the Data Source to Serial Port and Serial Port to the appropriate COM port in the Database tab under the File and Option menu in FinishLynx.
NOTE: If you don't have a Serial port on your computer, see this link for a recommendation for a USB to Serial adapter.
Now you are ready to load and integrate your meeting data.
Go back to Roster Athletics in your browser.
Open the relevant meeting and go to DETAILS. On the left-hand-side, click the Agent config button.
This will download an authentication .json file for your specific meeting that lets the RosterAgent know to use this meeting to connect with Lynx. Save the file in a place where you can easily find it again.
NOTE: It is critical that you use the LAST downloaded authentication file to load into the RosterAgent. Otherwise, the permissions will not match and you will not be able to connect to your meeting (“Can’t connect - permission denied”).
Once the authentication file is downloaded, go to the RosterAgent. Click on Load configuration and select the latest .json file (e.g., meeting-xxx-auth.json) for this meeting that you downloaded (as soon as you load the configuration, a "setting.json" file will be saved in the same folder as the RosterAgent file. This file stores the directory information so you don't need to enter directory settings every time.).
Click Connect. Now FinishLynx and Roster Athletics are connected.
If you have the Show notifications enabled by default, you will see status messages such as:
Once you have prepared your start lists in Roster Athletics, then go to FinishLynx. Click on the Select event icon and when you see the dialogue, then click on Load Schedule. When you have done so, click on the drop-down menu and select the event you want to time and click OK.
Now the synchronization setup is complete and the start lists for a particular event are loaded into FinishLynx. FinishLynx is now ready to go and the event can commence in standard FinishLynx procedure. Once the event has finished and FinishLynx has the results, click on the Save LIF under File and wait approximately 10 seconds or less while the data is synced to Roster Athletics.
BIB-numbers: If you want to transfer BIB numbers from Roster Athletics to FinishLynx, you need to enable an additional field in FinishLynx as follows: (i) Select User 1 under File --> Options... --> Results, (ii) select User 1 under Fields and (iii) click Enable. You will now be able to transfer BIB-numbers as shown below.
Now you can go back to Roster Athletics and see the times and rankings for the athletes that have been updated from FinishLynx. The results are also immediately available in the Roster Athletics App.
NOTE: Every time you make an update to the start list in Roster Athletics, it is automatically pushed to the Roster Athletics Agent, but you still need to Load Schedule in FinishLynx. Also, field events are not supported by the standard version of FinishLynx.