DataSync Documentation

Ofek Ashery edited this page Nov 15, 2018 · 2 revisions

Overview

The Orange Alliance (TOA) supports live FTC events reporting team lists, match schedules, qualification match results, alliance selections, and elimination round results. This is accomplished by running the TOA DataSync uploader program in the background on the scoring system computer.

If you are an FTC affiliate partner and want to report live event results, please do the following:

  1. Request a TOA Event Write Key for your event by filling out this google form. Please do this at least a few days in advance of your event if possible. You will receive an email with your Event ID and Event API Write Key.

  2. Download the latest release of the TOA DataSync. Download the zip file, copy it to the computer that will be running the FTC scoring system at your event, and uncompress it. The scoring system computer will need to have internet access to upload live event results.


Teams Tab

The teams tab is only meant to be used if information is incorrect in TOA’s databases, such as a team not showing up to your event. Inside of this table view, you can see the differences between TOA’s posted teams, and the teams from your event. If you have a team not show up, or a last-minute addition, follow these steps: Make sure the team list is correct in the scoring system. Add/drop your desired teams in the scoring system. Do a import of teams by TOA, and then an import by scoring system. Notice if there is any difference between the two view types. If there is a difference, then purge TOA’s Event Participant table by clicking the purge button. After a purge, import your teams by scoring system, and then upload that list to TOA.

Matches Tab

The matches tab is a fairly simple, yet important interface. There are two important processes that take place here: Uploading your match schedule to TOA Once your matches are completed, upload the results to TOA

Uploading Your Match Schedule

Once your match schedule is generated on the scoring system, you can upload your match schedule to TOA. Be warned, once you upload your schedule to TOA, the schedule will be available to the public. To upload your match schedule, do the following: Press the “Import from Scoring System” button. Once you do this, make sure the matches present in the DataSync match up with your match schedule. If they do not, contact a TOA admin. Post your match schedule by pressing the “Upload Schedule” button. After you upload your match schedule, head over to the Auto-Sync tab section to enable AutoSync to TOA.

Upload Your Match Results to TOA

With AutoSync on, the DataSync will automatically update from the scoring system every 30 seconds. In terms of matches, every cycle will check if the match results have been saved and uploaded to TOA. The DataSync should put matches in an upload queue once they are completed. However, this process can be manual: If you have AutoSync enabled, skip this step. Hit “Re-Sync Match Schedule” which will redo the match import from the scoring system, and determine which matches are completed. On a completed match, hit the “Upload” button to upload this match to TOA.

NOTE: If you need to go back into the scoring system and re-save a match result due to a scoring error, you must re-upload the matches to TOA manually.

Eliminations

In order to get eliminations matches to upload to TOA, you must do 2 special steps every time the scoring system populates a new match. For example, initially the scoring system populates Semis 1 Match 1, and Semis 2 Match 1. You must repeat these steps every time the scoring system gives you a new match (e.g. Semis 1 Match 2). Hit “ReSync match schedule” on the matches tab. Hit upload schedule to TOA. If you have auto sync enabled, the DataSync will automatically upload your eliminations scores when they are saved in the scoring system.

Rankings Tab

The rankings tab is even more simple, yet also just as important. The rankings should be AutoSync’d with the match results, but as of v1.3.9-BETA, this issue should theoretically be fixed. If people are complaining, hit the “Import Rankings from Scoring system” button then upload the rankings to TOA.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.