FIRST Tech Challenge Live v1.5.0_OFFSEASON

This offseason build removes the matches per team limit and adds the ability to import a custom Qualification Match Schedule. This feature will not be supported long-term. This release removes the Event Select page from the event setup workflow.

Creating a Custom Schedule

From the Match Schedule Generation page, the system can now export the current schedule. This will download a csv file that is formatted properly to import back into the system:

We recommend generating a schedule, exporting it, and then editing that schedule to import back in to the system. However, MatchMaker cannot generate a schedule with fewer than 4 teams. In that case, please use the example table below, which you can paste into a spreadsheet-editor and then edit and save as a .csv file.

NOTE: This allows for the generation of schedules that would otherwise not be possible. For example, the same Team could be on both Red and Blue Alliance. Because of this, custom schedules may lead to unexpected results with the Qualification Rankings.

Date (mm/dd/yyyy)	Start Time (24hr hh:mm)	Match # or Break	Red 1 or Break Text	Red 2	Blue 1	Blue 2
6/10/2020	9:05	1	1111	2222	3333	4444
6/10/2020	9:12	Break	5 minute break
6/10/2020	9:17	2	2222	3333	1111	4444

Alternatively, you can directly edit the CSV shown below:

Date (mm/dd/yyyy),Start Time (24hr hh:mm),Match # or Break,Red 1 or Break Text,Red 2,Blue 1,Blue 2
6/10/2020,9:05,1,1111,2222,3333,4444
6/10/2020,9:12,Break,5 minute break,,,
6/10/2020,9:17,2,2222,3333,1111,4444

Surrogate Teams can be denoted by appending a * to the end of their number in the schedule.

Documentation

  FTC Scorekeeper Manual Rev 3.1 for v1.1.0
  Reference Documentation for Scorekeeping Software (Google Drive)

Skystone Scoresheets

  Blue_Alliance_Scoresheet.pdf
  Red_Alliance_Scoresheet.pdf

Detailed Change log

• Removes the matches per team limit
• Adds the ability to export the Qualification Match Schedule as a csv file
• Adds the ability to import a custom Qualification Match Schedule from a csv file
  • This allows for the creation of otherwise impossible matches, such as the same team playing on both the Red and Blue alliances. Custom schedules may lead to unexpected results with the Qualification Rankings.
• Removes the Select Event page from the event setup process.

FIRST Tech Challenge Live v1.4.2

This is a required update for Dual Division Events, as it fixes a bug that could result in the loss of awards data. See the discussion in Issue 497 on the bug and its cause. If you have already created a future Dual Division event and added teams to it through the method described in 497 (adding teams to the divisions without adding them to the finals first), you may import those databases into this version and they will be repaired, as long as no awards have been assigned.

Documentation

  FTC Scorekeeper Manual Rev 3.1 for v1.1.0
  Reference Documentation for Scorekeeping Software (Google Drive)

Skystone Scoresheets

  Blue_Alliance_Scoresheet.pdf
  Red_Alliance_Scoresheet.pdf

Detailed Change log

• Fix bug in Dual Division Events when adding team to division without first adding to finals division resulting in loss of team list and awards data after reboot
• Fix incorrect warning that Qualification Matches have not been generated on upload of Dual Division event.
• Judge role can now add and remove award assignments for Dean's List, Judges, and custom awards.
• Added shift+click as a way to reopen the display menu in addition to existing ctrl+click

FIRST Tech Challenge Live v1.4.1

Our apologies for releasing this late in the week. This is not a required update. This version re-introduces the ability to add custom sponsor logos and adds a new mechanism to the Match Control Page to help users recover old scores. This also adds the ability for users to turn on haptic feedback for the referee pages, adds some useful endpoints to the third party API, and fixes several bugs.

Upgrading to version v1.4.0 or higher is required for Dual Division events as it addresses multiple critical bugs for running Dual Division events. It is not required for other events.

Upgrading to v1.3.0 or higher is required for League Tournaments, as this fixes a bug with the uploading of League Tournament rankings after the event.

Documentation

  FTC Scorekeeper Manual Rev 3.1 for v1.1.0
  Reference Documentation for Scorekeeping Software (Google Drive)

Skystone Scoresheets

  Blue_Alliance_Scoresheet.pdf
  Red_Alliance_Scoresheet.pdf

Detailed Change log

Match Control Page Changes:

Match History

This adds a "View History" button to the Match Control Page.

Pressing the "View History" button will bring up a screen for you to view previous score sheets for the match:

From the dropdown at the top, you can view all of the previous states of the match:

If you would like to revert to the previous state, you can select it from the dropdown and then use the "Copy to Editor" button. This will close the viewer and fill in all of the scoring achievements to match the score sheet.

This can be very useful if for whatever reason the scores are missing or you need to revert to the previous scores.

Improved notifications

The match replay button now warns you which match will be replayed in the popup:

Haptic Feedback

Users now have the option to turn on haptic feedback for their device. From the account page (click on the "Hello, user" link in the upper right, where the login link is), there is now an option to turn on vibrations:

Currently, only the buttons on the Referee pages will cause the device to vibrate. Note: most tablets (Such as the Kindle Fire) do not have the capability to vibrate and thus this setting will have no affect.

Custom Sponsor Logos

Since the beginning of the season, the scoring system has not had the ability to display custom sponsor logos (more on that issue here).

This release adds the ability to upload a custom sponsor logo. However, these logos have a maximum size, and will be scaled down to fit this size. All added sponsors display four to a screen, grouped by type as they are currently.

Importing sponsors

Sponsors can be imported from one event to another. On the page to add sponsors, the import will accept any database of a prior event. If the event was run on the same copy of the scoring system, then it will automatically fill in the sponsor logos. However, if the event was on a different copy of the scoring system, the logos are not part of the import and will be removed - the user will then have to edit each sponsor and import the desired logo. We are still exploring options for imports that include the logo in the future.

Bug Fixes

• Fixes a bug where the Division event name could not be changed after it had been created.
• Fixes a bug with buttons not appearing correctly in Chrome on macOS and iOS devices
• Fixes a bug where sometimes a team number would not be properly highlighted yellow to denote a card was carried when first loading the score entry tab on the Match Control Page.

Misc.

• Adds a column to the Competing Teams Report in the Inter-division Finals event of a dual division setup that indicates which division each team is assigned to.

API Changes

All changes have been documented in the Swagger documentation, which can be reached at http://localhost/swagger-docs/api.html.

• The /api/v2/stream/ websocket endpoint now notifies when a match has been loaded
• Added a /api/v1/events/{code}/elim/all endpoint that returns all elimination matches that have been completed.
• Added two new API routes that can be used to query the ENTIRE state of an event:
  • These routes have a very strict rate limit: 4 requests per 30 minutes combined. The goal is that an application can use them to populate an internal cache once on boot and then query the other routes as needed to stay up to date.
  • Please be aware that for a large event the responses can be very large.
  • /api/v2/events/{code}/full returns all non-game specific data about an event. (About 75kB for a 32 team event)
  • /api/2020/v1/events/{code}/full/ returns all game specific data about an event. (About 165kB for a 32 team event)

FIRST Tech Challenge Live v1.4.0

This is a required update for Dual Division events as it addresses multiple critical bugs for running Dual Division events. It is not required for other events, but contains a few small bug fixes.

Copied from v1.3.0 Release Notes

Upgrading to v1.3.0 or higher is required for League Tournaments, as this fixes a bug with the uploading of League Tournament rankings after the event. This update adds a new step in the event setup process, and a change to editing team info:

During event setup, after the Region Key has been entered or skipped, the software now displays a "Select Event" page. This page shows a list of events the system knows about. They are sorted by country, then state. Find your event in the list and click it. This will bring up a popup with details about the event. In the popup click "Setup" to play that event, which will bring up the previous "Create Event" page with the fields populated, where you can proceed as before. If you cannot find your event in the list, you can use the "Create New Event" link in the top right of the page to reach a blank create form. It is important to note you cannot edit event information in that popup, but can in the form. The info in the popup is displayed to help ensure you select the correct event. If you do not see your event listed, but it is on ftc-events.firstinspires.org, you may need to do a Data Download through "Admin Menu" -> "Manage Server".

When editing team info on the "Add/Edit Teams" page, the data is no longer edited inline, but in a popup. This freed up some extra space on the table and allows some extra functionality. The page will also now show icons next to the team numbers to indicate the registration status of the team. If these icons appear, it will not prevent or hinder the event in any way, but results will likely be delayed in publishing on ftc-events.firstinspires.org. If you edit a team's info, a red sync icon will appear to indicate it is different. If a team is not registered with FIRST, they will appear with a yellow triangle. If a team registered after being added to the event, it will be a red triangle. If there is a red sync or triangle, there will be a "synchronize" button in the edit popup that will replace the contents of the editor with the data from FIRST's master team list. Clicking "save" completes the synchronization operation.

Documentation

  FTC Scorekeeper Manual Rev 3.1 for v1.1.0
  Reference Documentation for Scorekeeping Software (Google Drive)

Skystone Scoresheets

  Blue_Alliance_Scoresheet.pdf
  Red_Alliance_Scoresheet.pdf

Detailed Change log

Additional Features

• Bug fixes are features 😄

Bug Fixes

• Fixes the bug where editing the end time of a break in the schedule would not update the duration.
• Addresses this issue by giving more descriptive error messages when attempting to create a match schedule that is infeasible.
• Fixes a bug where the link to the awards page for a judge account was not present for League Tournaments.
• Fixes a bug introduced in v1.3.0 that caused the Dual Division advancement report to be calculated incorrectly.
• Fixes a bug for dual division events where a team could be listed as being in division 0 even though the team appeared in a division.

FIRST Tech Challenge Live v1.3.2

Our apologies for releasing several weeks in a row. This is not a required update but contains a few useful bug fixes. Along with a few others, this version fixes a bug that has been present since the beginning of the season that would cause an event to load improperly after it had been completed. If you have an event that has been completed that you cannot access, you can import it into v1.3.2. If you cannot access the event by booting the old copy of the scoring software, you can find the database file in the libs/db/ folder and import that into v1.3.2.

LEAGUE MEETS: if you manually take the database from libs/db/, once you have imported into v1.3.2, you must export it from v1.3.2 for it to import properly into future meets/league tournaments.

Copied from v1.3.0 Release Notes

Upgrading to v1.3.0 or higher is required for League Tournaments, as this fixes a bug with the uploading of League Tournament rankings after the event. This update adds a new step in the event setup process, and a change to editing team info:

During event setup, after the Region Key has been entered or skipped, the software now displays a "Select Event" page. This page shows a list of events the system knows about. They are sorted by country, then state. Find your event in the list and click it. This will bring up a popup with details about the event. In the popup click "Setup" to play that event, which will bring up the previous "Create Event" page with the fields populated, where you can proceed as before. If you cannot find your event in the list, you can use the "Create New Event" link in the top right of the page to reach a blank create form. It is important to note you cannot edit event information in that popup, but can in the form. The info in the popup is displayed to help ensure you select the correct event. If you do not see your event listed, but it is on ftc-events.firstinspires.org, you may need to do a Data Download through "Admin Menu" -> "Manage Server".

When editing team info on the "Add/Edit Teams" page, the data is no longer edited inline, but in a popup. This freed up some extra space on the table and allows some extra functionality. The page will also now show icons next to the team numbers to indicate the registration status of the team. If these icons appear, it will not prevent or hinder the event in any way, but results will likely be delayed in publishing on ftc-events.firstinspires.org. If you edit a team's info, a red sync icon will appear to indicate it is different. If a team is not registered with FIRST, they will appear with a yellow triangle. If a team registered after being added to the event, it will be a red triangle. If there is a red sync or triangle, there will be a "synchronize" button in the edit popup that will replace the contents of the editor with the data from FIRST's master team list. Clicking "save" completes the synchronization operation.

Documentation

  FTC Scorekeeper Manual Rev 3.1 for v1.1.0
  Reference Documentation for Scorekeeping Software (Google Drive)

Skystone Scoresheets

  Blue_Alliance_Scoresheet.pdf
  Red_Alliance_Scoresheet.pdf

Detailed Change log

Added features

• Added a printable page for all inspection forms that aggregates the notes entered by Inspectors.

Bug Fixes

• Fixes the bug that would cause completed events to throw errors after rebooting the scoring system.

FIRST Tech Challenge Live v1.3.1

This is not a required update but contains a few useful bug fixes. Along with a few others, this version fixes a bug in v1.3.0 that would in some scenarios cause the Match Control Page to erroneously claim that the user was trying to commit invalid match data.

Copied from v1.3.0 Release Notes

Upgrading to v1.3.0 or higher is required for League Tournaments, as this fixes a bug with the uploading of League Tournament rankings after the event. This update adds a new step in the event setup process, and a change to editing team info:

During event setup, after the Region Key has been entered or skipped, the software now displays a "Select Event" page. This page shows a list of events the system knows about. They are sorted by country, then state. Find your event in the list and click it. This will bring up a popup with details about the event. In the popup click "Setup" to play that event, which will bring up the previous "Create Event" page with the fields populated, where you can proceed as before. If you cannot find your event in the list, you can use the "Create New Event" link in the top right of the page to reach a blank create form. It is important to note you cannot edit event information in that popup, but can in the form. The info in the popup is displayed to help ensure you select the correct event. If you do not see your event listed, but it is on ftc-events.firstinspires.org, you may need to do a Data Download through "Admin Menu" -> "Manage Server".

When editing team info on the "Add/Edit Teams" page, the data is no longer edited inline, but in a popup. This freed up some extra space on the table and allows some extra functionality. The page will also now show icons next to the team numbers to indicate the registration status of the team. If these icons appear, it will not prevent or hinder the event in any way, but results will likely be delayed in publishing on ftc-events.firstinspires.org. If you edit a team's info, a red sync icon will appear to indicate it is different. If a team is not registered with FIRST, they will appear with a yellow triangle. If a team registered after being added to the event, it will be a red triangle. If there is a red sync or triangle, there will be a "synchronize" button in the edit popup that will replace the contents of the editor with the data from FIRST's master team list. Clicking "save" completes the synchronization operation.

Documentation

  FTC Scorekeeper Manual Rev 3.1 for v1.1.0
  Reference Documentation for Scorekeeping Software (Google Drive)

Skystone Scoresheets

  Blue_Alliance_Scoresheet.pdf
  Red_Alliance_Scoresheet.pdf

Detailed Change log

Added features

• The Advancement Report now has an option to show the team name as well as a condensed version for printing.
• Adds a link to the schedule page for printing on the schedule generation page.

Bug Fixes

• Fixes the erroneous "Invalid Data" when committing from the schedule tab.
• Fixes the macOS Catalina printing issue.

FIRST Tech Challenge Live v1.3.0

This release is a required update for League Tournaments, as this fixes a bug with the uploading of League Tournament rankings after the event. This update adds a new step in the event setup process, and a change to editing team info:

During event setup, after the Region Key has been entered or skipped, the software now displays a "Select Event" page. This page shows a list of events the system knows about. They are sorted by country, then state. Find your event in the list and click it. This will bring up a popup with details about the event. In the popup click "Setup" to play that event, which will bring up the previous "Create Event" page with the fields populated, where you can proceed as before. If you cannot find your event in the list, you can use the "Create New Event" link in the top right of the page to reach a blank create form. It is important to note you cannot edit event information in that popup, but can in the form. The info in the popup is displayed to help ensure you select the correct event. If you do not see your event listed, but it is on ftc-events.firstinspires.org, you may need to do a Data Download through "Admin Menu" -> "Manage Server".

When editing team info on the "Add/Edit Teams" page, the data is no longer edited inline, but in a popup. This freed up some extra space on the table and allows some extra functionality. The page will also now show icons next to the team numbers to indicate the registration status of the team. If these icons appear, it will not prevent or hinder the event in any way, but results will likely be delayed in publishing on ftc-events.firstinspires.org. If you edit a team's info, a red sync icon will appear to indicate it is different. If a team is not registered with FIRST, they will appear with a yellow triangle. If a team registered after being added to the event, it will be a red triangle. If there is a red sync or triangle, there will be a "synchronize" button in the edit popup that will replace the contents of the editor with the data from FIRST's master team list. Clicking "save" completes the synchronization operation.

Documentation

  FTC Scorekeeper Manual Rev 3.1 for v1.1.0
  Reference Documentation for Scorekeeping Software (Google Drive)

Skystone Scoresheets

  Blue_Alliance_Scoresheet.pdf
  Red_Alliance_Scoresheet.pdf

Detailed Change log

Select Event

• A list of events is shown after region key which will pre-populate event data.
• Only shows current week. Use the links above the top left and top right corners of the list to change week.
• The Data Download operation now also updates the list of Events.
• Select Event stage is skippable

Add/Edit Teams

• Icons indicate differences with FIRST registration data as of the last Data Download
• Edit is done in a popup
• Can synchronize data in event of mismatch

Illegal Scoring Protections

• If a robot is marked as no-show, the control page now enforces only one robot can be marked scored for the robot scoring achievements.

Other

• Fix League Tournament rankings upload
• No-show team in elims is no longer struck-through on results page
• Teams that play in an elims match are bolded on results page
• Added third team to scoresheet in elims
• Added button in Display Settings to show in-match view for video calibration
• Additional bug fixes

FIRST Tech Challenge Live v1.2.1

This is a patch for v1.2.0. DO NOT USE v1.2.0. If you have already started your event using v1.2.0, it is strongly recommended that you pause your event, SAVE any match edits, and import into this version (or v1.1.2 if you have it locally). If you are running a Qualifier, DO NOT START ALLIANCE SELECTION BEFORE CORRECTING & COMMITTING ALL MATCHES!

Steps:

1. Finish any in progress matches/actions
2. SAVE any edits, even if you cannot commit the match.
3. Download Event Archive from the Event Dashboard.
4. Shut down v1.2.0 of scoring software
5. Boot this version
6. Use Server Management page to import the downloaded archive.
7. You will need to use the Match History scoresheet to repair any matches. Go to Match Results, then click "View Match History". Select the most recent scoresheet.
8. On the match control page, click the "Enter Scores" or "Edit" button on Control Page's Schedule tab for to corresponding match above, and copy the data from the scoresheet. See this issue for details on these steps.

We are very sorry for this inconvenience. Please post a new issue if you have any additional questions. We are happy to help repair databases posted there.

FIRST Tech Challenge Live v1.2.0

DO NOT USE

FIRST Tech Challenge Live v1.1.2

This is a mandatory update for Qualifiers and League Tournaments. This release is not required for League Meets, but it does fix the edit bug, so we recommend updating. This is NOT approved for Dual-Division or FIRST Championship-advancing events.

This release fixes several bugs, the most notable of which is editing a match no longer clears the scores if the next match has been started.

Known UI issue affecting Google Chrome on macOS and iOS devices

We have received reports that Google Chrome on macOS and iOS devices are rendering some buttons incorrectly by not showing the border (see image below). The buttons still function correctly, and we still recommend using Google Chrome over Safari, etc. because we have observed better connection stability using Google Chrome.

Above, the buttons for Undo and Delivered/Returned and +/- are missing their gray background that indicates that it is a button. The button is still functional.

Important note copied from previous release

A major change we want to highlight for this season:
Built-in upload of event results to FIRST. This requires a Region Token, which Affiliate Partners will receive shortly. As a reminder, please do not share these tokens beyond the people that need them, and please do not post them publicly, including on this GitHub repository - please do not post a full zip of the scoring system as this will contain your key - the log files will not contain your key, and the db file using the "Download Event Archive" button on the dashboard will not contain your key. These tokens are for official events only. Please do not use them for testing or scrimmages (an exception being a scrimmage that is listed on the public Event Search). Now that upload is built in to the scoring software, we are asking for all events to upload data. This includes league meets, which previously did not upload to Schoology.

In addition, now that we are releasing less frequently and are collecting event results in a more centralized manner, it is more important that you utilize the Data Download feature before setting up your event ("Admin Menu" -> "Manage Server"). If you upload an event with any non-registered teams, the results for that event may not appear in the public result set when it is available later this season. (A team is likely not registered if the team info fields appear empty when you add them to an event).

Documentation

  FTC Scorekeeper Manual Rev 3.1 for v1.1.0
  Reference Documentation for Scorekeeping Software (Google Drive)

Skystone Scoresheets

  Blue_Alliance_Scoresheet.pdf
  Red_Alliance_Scoresheet.pdf

Detailed Change log

UI Changes

• Added Team City and State/Province to awards script.
• Reworked Awards presentation on displays.

Bug Fixes

• Fixed bug where the edit tab on the Match Control Page could show 0-0.
• Fixed bug where TBP showed as "--" on first load of the scoring system.

API Fixes

• Fixed WLT reported on first load of scoring system

Other

• Updated the manuals, etc. shipped with the system on the resources page.