Awot Online palvelimen API lähettää tulossanomia henk.koht. kilpailu
____________________________________________________________________

Versiohistoria:
Versio 1.1 9.8.2002, Jukka Inkeri, Jukka.Inkeri@awot.biz
-lisätty mahdollisuus lähettää valmis HTML-tiedosto
 <Html*>

Versio 1.0 6.8.2002, Jukka Inkeri, Jukka.Inkeri@awot.biz
-lisätty tuki myös muille ohjelmille kuin Pirilän versio
 <Program>

____________________________________________________________________
Palvelin toimii osoitteessa www.suunnistus.info

Palveluportin käyttö onnistuu vain Awot:n kertomalla tavalla. Vaatii
autentisoinnin tietoturvajärjestelmäämme.

Noudattaa IOF:n määrityksiä XML:n sisällöstä.

Tulossanoma, esimerkki
___________________________________________________________________________

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<Update>
<Program>Pirila</Program>
<EventName>Kisan nimi</EventName>
<Competitor>
<ClassName>H10RR</ClassName>
<ClassDist>2,3</ClassDist>
<StartNumber>589</StartNumber>
<Indentity>11111</Identity>
<Name>
<Family>Valtanen</Family>
<Given>Taneli</Given>
</Name>
<ClubID>HinnYr</ClubID>
<Time>33:30</Time>
<TSecs>2010</TSecs>
</Competitor>
</Update>

Tarkoittaa kilpailija nro 589, Taneli Valtanen, HinnYr, 
sarja H10RR, matka(paikka josta aika) 2,3 km, aika  33:20, aikasek 2010
Emit-nro 11111.

Matka voi olla mikä tahansa merkkijono (A-Z 0-9), vaikka vakio Maali.
Lähinnä käyttöarvoa, jos on myös väliaikoja.

Program on lähettävän ohjelman tunniste. Käytetään palvelimen päässä
tarvittaessa, jos on joitakin eroja jossakin ...

Aika merkkijonona ja sekunteina. Jos aika yli tunnin, niin h:mm:ss.
Aika sekunteina on kenttä, jolla palvelin käsittelee tuloksia. Time
kenttä julkaistaan sellaisenaan.

Jos hylätty      Time=DQ  ja aikasec 0
Jos kesk.        Time=DNF ja aikasec 0
Jos ei lähtenyt  Time=DNS ja aikasec 0


xml-header voi tulla, joka tulospaketin välissä tai vain kun socket avataan.
Oikeastaan palvelin on kiinnostunut vain, jos löytyy riviltä merkkijono
	<?xml*
niin oletetaan olevan xml-kamaa.
Kun yksikin tuollainen  rivi tulee socket-yhteyden aikana, niin sen jälkeen 
alkaa palvelin tulkita vasta XML-dataa.

Yhteys kannattaa olla auki kokoajan. Toki toimii vaikka avaisi ja sulkisi
kokoajan.

EventName  on tunniste kisalle. Jokin sopiva merkkijono.

Protokolla
___________________________________________________________________________

TCP-Stream, 
	host www.suunnistus.info

Esimerkkirunko ohjelmalle:

	avaa socket ( www.suunnistus.info, portti-X)
	
	send "<?xml* header ...."
	
	while true
	do
		result_xmlpacket
	done
	
	sulje socket

	......................................
	result_xmlpacket
		send "<Update>"
		send ... muut paketin rivit
		send "</Update>"


	Rivit lähetetään normaalina tekstirivinä, rivin loppuessa
	newline merkkiin (ascii 10).


Testauksen voi siis tehdä vaikka telnet-ohjelmalla
	telnet www.suunnistus.info portti-X

Palvelin ei lähetä mitään kuittaussanomaa ellei toisin sovita.


Palvelin alkaa päivittämään sarjalistaa pienellä viiveellä (n. 1 min), mutta
tulokset ovat aina reaaliajassa.



Tuloksien lähetys valmiina html-tiedostona
_________________________________________________________________________
<Event>
<EvenName>...</EventName>
<HtmlHeader>Otsikko tuloksille</HtmlHeader</HtmlHeader>
<HtmlFile>filename</HtmlFile>
<HtmlData>
tässä sitten on puhdasta HTML kamaa
</HtmlData>
</Event>