API: Unterschied zwischen den Versionen
Keine Bearbeitungszusammenfassung |
Keine Bearbeitungszusammenfassung |
||
| Zeile 16: | Zeile 16: | ||
Die Daten müssen als POST-Daten mittels einem Request versendet werden. | Die Daten müssen als POST-Daten mittels einem Request versendet werden. | ||
Beispiel – JavaScript | Beispiel – JavaScript | ||
<nowiki> | |||
<script> | <nowiki><script></nowiki><br /> | ||
$(document).ready(function() { | <nowiki>$(document).ready(function() {</nowiki><br /> | ||
//Daten | <nowiki>//Daten</nowiki><br /> | ||
var data = { | <nowiki>var data = {</nowiki><br /> | ||
<nowiki> ACTION: 'WP_ZEIT_SPEICHERN',</nowiki><br /> | |||
<nowiki> VERANSTALTUNG_ID: '123456789',</nowiki><br /> | |||
<nowiki> WP_NR: '1',</nowiki><br /> | |||
<nowiki> ART: 'FAHRZEIT',</nowiki><br /> | |||
<nowiki> ZEIT: '320.6',</nowiki><br /> | |||
<nowiki> STARTNUMMER: '5'</nowiki><br /> | |||
<nowiki> };</nowiki><br /> | |||
//Request an Gateway senden | <nowiki>//Request an Gateway senden</nowiki><br /> | ||
$.ajax({ | <nowiki>$.ajax({</nowiki><br /> | ||
<nowiki> url: 'https://www.tw-sportsoft.de/GATEWAY/index.php',</nowiki><br /> | |||
<nowiki> type: 'POST',</nowiki><br /> | |||
<nowiki> data: data</nowiki><br /> | |||
<nowiki> });</nowiki><br /> | |||
}); | <nowiki>});</nowiki><br /> | ||
</script> | <nowiki></script></nowiki><br /> | ||
</nowiki> | |||
== Request: Zeiten speichern == | == Request: Zeiten speichern == | ||
Version vom 7. Januar 2020, 14:41 Uhr
Einleitung
Über die TW-Sportsoft API (Gateway-Schnittstelle) können externe Systeme angeschlossen werden.
Extern anfallende Daten z.B. aus dem Bereich Auswertung/Zeitnahme (Startartzeiten, Zielzeiten, Fahrzeiten, Strafzeiten, Meldungen etc.) müssen somit nicht manuell erfasst werden, sondern könnten automatisch über diese Schnittstelle in das System übertragen werden.
Voraussetzungen
- Es muss eine Installation des Veranstaltungssystems mit den Modulen „Online-Nennung“ und „Auswertung“ vorhanden sein.
- Alle Teilnehmer-Daten müssen mit Startnummern, Wertungsgruppen/Klassen und ggf. Prädikatszuordnungen angelegt sein.
- Das Gateway muss über den Systemparameter im Administrationsbereichs der Veranstaltung geöffnet werden.
- Die eindeutige Veranstaltungsid muss bekannt sein. Ersichtlich auf der Startseite (Cockpit) des Admin-Bereiches des Veranstaltungssystems.
Rechtzeitig vor der Veranstaltung sollten entsprechende Tests und eine Probe-Auswertung mit dem Veranstaltungssystem durchgeführt werden.
Technik
Die Daten müssen als POST-Daten mittels einem Request versendet werden. Beispiel – JavaScript
<script>
$(document).ready(function() {
//Daten
var data = {
ACTION: 'WP_ZEIT_SPEICHERN',
VERANSTALTUNG_ID: '123456789',
WP_NR: '1',
ART: 'FAHRZEIT',
ZEIT: '320.6',
STARTNUMMER: '5'
};
//Request an Gateway senden
$.ajax({
url: 'https://www.tw-sportsoft.de/GATEWAY/index.php',
type: 'POST',
data: data
});
});
</script>
Request: Zeiten speichern
Über diese Funktion werden Zeiten oder Status-Kennzeichen an das System gesendet. Hinweis: Wird eine Zeit zu gleicher Veranstaltung, WP/Lauf-Nummer und Startnummer nochmals gesendet, so wird die vorherige Zeit automatisch überschrieben. Darüber können eventuelle Fehleingaben korrigiert werden.
| Datenfeld | Standard-Wert | Beispiel-Wert(e) | Datentyp | Pflichtfeld | Beschreibung |
|---|---|---|---|---|---|
| ACTION | WP_ZEIT_SPEICHERN | WP_ZEIT_SPEICHERN | VARCHAR | ja | Angabe, welche Aktion ausgeführt wird |
| VERANSTALTUNG_ID | 4711 | INTEGER | ja | Eindeutige Veranstaltungsid |