Live-Ranglisten und Funkposten – ol-events.ch

Die öffentliche Seite lädt sich am Lauftag alle 10 Sekunden selbst neu, bis das Häkchen Rennen beendet gesetzt ist. Du musst dafür nichts einschalten: Lade einfach regelmässig die Resultatliste hoch. Alles aus dem Upload ist sofort öffentlich, ausser den Zwischenzeiten, die können zurückgehalten sein.

Wann das Live-Polling greift

Lauftag: Heute liegt im Datum des Laufs. Davor und danach lädt sich die Seite nicht neu.
Nicht beendet: Das Häkchen Rennen beendet unter Resultate bearbeiten ist nicht gesetzt.

Ist ein Import durch, zeigt der nächste Abruf die neuen Daten. Der Zwischenspeicher verzögert das nicht.

In der Übersicht Resultate aller Läufe erscheint dein Lauf erst später. Ein Hintergrundlauf zählt die Resultate alle 5 Minuten, und zwar nur bei Läufen mit gesetztem Anmelden ab, deren letzter Lauftag noch nicht vorbei ist.

Was öffentlich sichtbar wird

Eine Freigabe gibt es nicht. Sichtbar werden Name, Jahrgang, Verein, Startnummer, Startzeit, Laufzeit, Rückstand, Rang und Status. Das gilt auch für Testdaten und für Zeilen aus der Startliste. Teste deshalb nicht am echten Lauf, oder lösche danach mit alle Resultate löschen. Adressen braucht die Rangliste nicht, lass Person/Address weg.

Die Zwischenzeiten richten sich nach dem Feld Split Times öffentlich am unter Details bearbeiten:

Einstellung am Lauf	Vor dem Zeitpunkt	Danach
Zeitpunkt gesetzt	Nur Funkposten	Alle Zwischenzeiten
Kein Zeitpunkt, ohne hat technische Delegierte	Alle Zwischenzeiten, von Anfang an
Kein Zeitpunkt, mit hat technische Delegierte	Nur Funkposten, bis ein Zeitpunkt gesetzt ist

Funkposten anlegen

Funkposten legst du pro Kategorie mit POST /xml/v1/races/{race}/radiocontrollist an. Das Format steht in der API-Dokumentation. In der Rangliste erscheinen sie als eigene Zeiten, zum Beispiel R3: 12:34. Diese Liste wird sofort verarbeitet, 204 heisst also importiert. Das gilt aber nicht für jede Kategorie, deshalb danach mit GET prüfen.

Kategorie über ShortName angeben: Die Id der Funkposten-Liste ist nicht die Id aus der ClassList. Stimmt eine mitgeschickte Class/Id type="ol-events" nicht, wird die Kategorie übersprungen, auch wenn ShortName passt.
Kategorien müssen schon existieren: Unbekannte Kategorien werden ohne Meldung übersprungen. Die Liste legt anders als der Resultat-Import keine neuen an.
Nur numerische Postencodes: Der Import liest ControlCode als Zahl. Codes wie F1 kann er nicht auseinanderhalten.
Gleicher Code wie in den Resultaten: Eine Zwischenzeit erscheint beim Funkposten nur, wenn SplitTime/ControlCode übereinstimmt.
Position richtig setzen: Sendest du einen Posten mit neuer PositionOnCourse, kommt ein zweiter Funkposten dazu und der alte bleibt. Entfernen kannst du ihn selbst nicht, melde dich beim Support.

Was du während des Laufs schickst

Unterwegs: Schicke Personen ohne Zeit mit Active, Inactive oder ohne Status. Sie zählen noch nicht als im Ziel.
Im Ziel: Die Laufzeit erscheint in der Rangliste nur bei OK oder ohne Status. Bei Finished bleibt das Feld leer.
Rang: Wir zeigen Position aus deiner Datei und rechnen sie nicht nach. Am Lauftag bleibt der Rang grau, bis die Person mehr Zwischenzeiten hat als die Kategorie Funkposten plus eine.
Zwischenzeiten: Time ist die Zeit seit dem Start. Bei status="Missing" wird sie nicht übernommen. Korrekturen funktionieren nicht über einen neuen Upload, siehe Start- und Resultatlisten hochladen.
Teilmengen: Du kannst nur die geänderten Personen schicken, jede aber mit allen Feldern. Fehlende Felder werden geleert.

Wie oft du hochladen solltest

Wir empfehlen alle 30 bis 60 Sekunden. Häufiger als alle 10 Sekunden bringt nichts, weil die Seite nur so oft neu lädt. Jeder Upload wird vollständig importiert, und danach gleicht der Import alle Resultate des Laufs mit den Läuferkonten ab. Grosse Dateien sendest du deshalb besser seltener und mit GZip. Die harte Grenze liegt bei 300 Anfragen pro Minute.