0. Voor wie is dit document bedoeld

Dit document is bedoeld voor webmasters.
Het lezerspubliek wordt geacht meer dan gemiddelde kennis te hebben van de opbouw en samenstelling van URLs en de werking van scripts.
Wanneer u niet weet wat GET variabelen en hoe deze aan een URL tot te voegen, of wat CSS betekent zijn is dit document niet voor u bedoeld.
Tevens dient de lezer in staat te zijn eigenhandig de classes die de KNBSB pagina's gebruiken te kunnen extraheren uit de source-documenten en deze in CSS een passende vormgeving te kunnen geven.


1. Inleiding
De gegevens van de KNBSB website kunnen rechtstreeks in de website van een vereniging worden opgenomen. Dit kan op een aantal manieren:

- In een frame
- In een i-frame
- Met behulp van een XMLHttpRequest aanroep in javaScript. NB: het resultaat van de callback kan eenvoudigweg aan de InnerHTML van het element worden toegevoegd

In elk van de gevallen wordt als basis een URL op het competitiegedeelte van de knbsb website (http://www.knbsb.nl/la/) aangeroepen. Aan deze URL moeten vervolgens een aantal GET-parameters worden toegevoegd om de pagina naar eigen wensen te configureren.

De volgende parameters bepalen de inhoud van de pagina

Competitiegegevens:
-------------------
LevelID: een bepaald competitieniveau, bv LevelID=110 verwijst naar de hoofdklasse honkbal; Niveaus zijn seizoens-onafhankelijk
CompID: een bepaalde klasse, bv. CompID=722 verwijst naar Honkbal junioren 3e klasse A; De nummers van de klassen veranderen per seizoen
ClubID: een vereniging, bv ClubID=57 verwijst naar Falcons
TeamID: een specifiek team, bv TeamID=131021 verwijst naar Amsterdam Pirates
VenueID: Alle velden van een bepaalde speellocatie, bv. VenueID=79 verwijst naar sportpark Zanderijweg in Bussum.
Pitch: Een specifiek veld
SeasonID: een seizoen, bv SeasonID=2008. Let op: Het seizoen wordt in een sessie opgeslagen, Afhankelijk van de aanroepmethode kan dit betekenen dat een eenmaal opgegeven seizoen wordt gebruikt tot expliciet een ander seizoen wordt opgegeven. Gebruik daarom OF nooit OF altijd een SeasonID


Begin en Einddatum:
-------------------
Begin: gebruik alleen wedstrijden vanaf deze datum. De datum kan opgegeven worden als jjjj-mm-dd, jjjjmmdd of als aantal dagen voor 'vandaag'.
End: gebruik alleen wedstrijden tot en met deze datum. De datum kan opgegeven worden als jjjj-mm-dd, jjjjmmdd of als aantal dagen na 'vandaag'.

Tabelindelingen:
----------------
Columns: een beschrijving van de kolommen waaruit de tabellen worden opgebouwd
Separator: hoe/wanneer de tabellen worden gescheiden of onderbroken voor een tussenkop
Text: De tekst die boven een tabel of na een scheiding wordt geplaatst

Weergave:
---------
CSS: de volledige URL naar een CSS bestand, of -1 wanneer geen CSS moet worden gebruikt. Wanneer geen CSS is opgegeven wordt de standaard vormgeving van de knbsb gebruikt. NB: Voor het gebruik van HTML-tags, Classes en IDs wordt verwezen naar de sources van de pagina. Het zou te ver voeren om alles in detail te bespreken. Over het algemeen kan worden volstaan met een relatief klein aantal veelvoorkomende classes en tags.


2. Wedstrijden
==============

BasisURL: http://www.knbsb.nl/la/results.php

Kolommen:
---------
   N: Game No.
   n: Speelronde
   w: speeldag (ma, di, wo do vr za zo)
   W: kalenderweek
   D: Datum
   T: Tijd
   V: Veld / stadion
   Y: Plaats
   C: Divisie (afkorting)
   c: Divisie (uitgeschreven)
   L: Klasse (afkorting)
   l: Klasse (uitgeschreven)
   X: Uit/Thuis team
   x: Uit/Thuis vereniging
   A: Thuisspelend team
   a: Thuisspelende vereniging
   h: Thuisspelend team (afkorting)
   B: Uitspelend team
   b: Uitspelende vereniging
   g: Uitspelend team (afkorting)
   P: Gereserveerd voor toekomstig gebruik (Innings)
   F: Eindstand
   I: Iconen (indicatie van wijzigingen)

Standaardweergave: NTABF

Separator:
===========
D: Scheiden per dag (default)
d: Scheiden per weekend
W: Scheiden per week
w: Scheiden per weekend/midweek
L: Scheiden per speellocatie en datum
l: Scheiden per speelveld en datum
O: Scheiden per speelronde

Variabelen:
===========
In de scheidingstekst kunnen de volgende variabelen worden opgenomen

$Date: Datum
$Day: Dag (maandag, dinsdag...)
$KW: kalenderweek
$Location: Speellocatie (alleen in combinatie met L en l)
$Pitch: Speelveld (alleen in combinatie met l)
$Round: Speelronde (alleen in combinatie met O)



3. Standen
==========

BasisURL: http://www.knbsb.nl/la/ranking.php

Geeft altijd de actuele stand, dwz. onafhankelijk van eventuele Begin en End parameters

Kolommen:
---------
R: Positie
r: Positie (geen herhaling wanneer teams gelijk staan)
N: Naam van het team
n: Naam van de vereniging
G: Aantal gespeelde wedstrijden
W: Aantal gewonnen wedstrijden
T: Aantal gelijk gespeelde wedstrijden
L: Aantal verloren wedstrijden
M: Aantal in mindering gebrachte wedstrijdpunten
p: Aantal behaalde wedstrijdpunten
P: Totaal behaalde wedstrijdpunten
H: Games In Hand
h: Points Behind
F: Totaal aantal gescoorde runs
A: Totaal aantal runs tegen
D: Totaal aantal runs voor - tegen
d: Verschil in runs voor / tegen

Standaardweergave: rNGWTLPD


Separator:
----------
Niet van toepassing

Variabelen:
-----------
Niet van toepassing

Overzicht CompID - TeamID:
-----------
Op deze pagina staan alle ID's op een rij: www.knbsb.nl/la/systemids.php
(Let op, deze code's zijn nu niet actueel. Dit is afhankelijk van de inschrijvingen van de teams door de verenigingen en het daarna indelen van de teams in de juiste klasse/poule. De verenigingen kunnen tot half januari de teams inschrijven, vanaf 15 februari zijn de teams definitief ingedeeld en staan dus op deze link de code's juist.)