This is an early test version of the integration between Roster Athletics and FinishLynx. Please keep in mind that since this is a test version, there may be potential bugs where the integration can stop working at any time 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 agent – it is named “Roster-agent” (send us an email to email@example.com and we will send you the agent, which is a JAR file).
- 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/
Download and open the Roster-agent.JAR file. To run this .jar program, please download and install the latest Java Runtime Environment (JRE) first. It is not necessary to install the entire JDK (Java Development Kit) - it will work fine but has features you don't need.
You can find the latest JRE/JDK from OpenJDK here:
Version 12 has an installer for both Windows, Linux, and Mac (at the time of this user guide, version 13 is only available for Windows). Find your operating system, select the JRE, and install it on your computer.
Open the Roster-agent.JAR file by simply double-clicking on it. The first time that you open it, you might have to approve the agent under your security settings. If you are using a Mac computer, you can do it under your general settings --> Security & Privacy --> accept the agent.
Now you have everything ready to open the Roster-agent.JAR file.
To continue the integration process you should have the following three programs open:
- Roster Athletics in a browser
- Roster-agent.JAR (which opens through JarLauncher or a similar program). Once the program is open, it is called Roster Athletics Agent.
In the Roster Athletics Agent, you have 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 seperate 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.
Before you load the configuration, go to FinishLynx.
Open the Option 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 Roster Athletics Agent. Additionally, you need to make sure that Code set and LIF Code set are set to Unicode.
You 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 Roster Athletics Agent:
And use the following setting in the Database tab under the File and Option menu in FinishLynx.
PS: 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 a .json file. Save the file in a place where you can easily find it again.
Go to the Roster Athletics Agent in the JarLauncher (or in whichever program you used to open the Roster-agent.JAR file).
Click on Load configuration and select the .json file (e.g., meeting-xxx-auth.json). Click Connect. Now FinishLynx and Roster Athletics are connected.
As soon as you load the configuration, a "setting.json" file will be saved in the same folder as the Roster-agent.JAR file. This file stores the directory information so you don't need to enter directory settings every time.
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 while the data is synced to Roster Athletics.
You can also enable the auto-save option in FinishLynx for faster live results. This feature will enable FinishLynx to auto-save and update the targeted LIF results file automatically every 5 seconds, and the Roster agent will immediately take the results and transfer to the Roster platform. To do this, hold Ctrl + Shift and click Options under File. Click the "+" next to the Database. Click the "+" next to the LIF, click the AutoSave, enter "5" (this will update the live scoreboard every 5 seconds), and click OK. To now activate this option, restart FinishLynx.
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.