Koncepti
Številke tednov in zakaj so koledarske napačne
Vsaka ustanova šteje svoje pedagoške tedne, skoraj nobena pa jih ne šteje tako kot koledar, v tej vrzeli pa živi presenetljivo veliko zmede.
Dve različni številki z istim imenom
Vprašajte koledar, kateri teden je, in dobite ISO številko tedna: teden 1 je teden, ki vsebuje prvi četrtek v januarju, ob začetku akademskega leta na severni polobli pa ste nekje okoli tedna 36 do tedna 40.
Isto vprašanje zastavite urnikarski službi in dobite povsem drugo številko. Teden 1 je prvi pedagoški teden v letu, kjerkoli v koledarju že pade, vse pa se šteje od tam. To je številka, natisnjena na urniku, številka v obrazcu za rezervacijo učilnic in številka, ki jo uporabita dva kolega, ko se dogovorita za srečanje v 9. tednu.
Nikoli nista enaki, razen če se pedagoško leto ustanove slučajno začne v prvem tednu januarja, kar pomeni: nikoli. In ker se obe imenujeta številka tedna, programska oprema, ki tiho prikaže napačno, prikaže nekaj, kar je videti povsem verjetno.
Kako izgleda, ko gre narobe
Ne izgleda kot napaka. Izgleda kot stran s številko na vrhu, številka pa je napačna za drugačen znesek v vsaki ustanovi — ker vsaka začne leto na drug datum.
Zato je draga. Sesutje se prijavi v eni uri. Naslov z napisom Teden 36, ko vsi v stavbi pravijo Teden 2, se prijavi čez tedne, nekdo, ki je domneval, da je sistem narobe razumel on in ne sistem njega — vmes pa so ljudje zaradi tega prihajali v učilnice.
Pravilo, ki to prepreči, je kratko: številka tedna se prebere, nikoli izračuna. Ustanova odloči, kje je teden 1; naloga programske opreme je sporočiti, kar je ustanova odločila, in ne iz datuma izpeljati lastne številke.
Teden 1 ni vedno prvi teden, ki obstaja
Ustanove običajno potrebujejo datume pred svojim pedagoškim letom: uvajalni dvotedenski termin, obdobje popravnih izpitov, poletno šolo, ki pripada letu, ki se pravkar končuje. Namesto da bi vse preštevilčili — kar bi tiho spremenilo pomen vsakega urnika, vsake rezervacije in vsakega sporočila, ki ga je kdo kadar koli poslal o 9. tednu — je smiselno koledar podaljšati nazaj, v ničlo in v negativna števila.
Prvič je videti nenavadno, drugič pa povsem prav: teden 1 ohrani pomen, ki ga je vedno imel, dvotedensko obdobje pred njim pa sta teden −1 in teden −2. Imamo ustanove, katerih tabela tednov sega daleč v negativno in daleč čez konec pedagoškega leta, vse vmes pa naslavlja pravi datum.
Karkoli programsko bere urnik, mora to pričakovati. Številka tedna je predznačeno celo število, ne števec, ki se začne pri ena.
Nekatere ustanove sploh ne uporabljajo številk
Oxford in Cambridge poimenujeta svoje tedne po semestru in jih ne štejeta čez leto: datum je v Michaelmas, četrti teden, številka pa ne bi pomenila ničesar nikomur v učilnici. Druge ustanove označijo dvotedensko obdobje kot Priprava na izpite, Uvajanje ali Obdobje preverjanja in pričakujejo, da urnik to tudi navede.
Pedagoški teden torej nosi dve stvari, ne ene: številko, s katero ga naslavlja programska oprema, in ustanovino lastno ime zanj, kar bralec na vrhu strani dejansko želi. Kjer ime obstaja, ga je treba natisniti namesto številke in v celoti — krajšanje semestrskega poimenovanja nekoga zaradi prihranka osmih pikslov je vrsta uslužnosti, ki je nihče ni zahteval.
Kjer imena ni, in za večino ustanov ga ni, je številka ime in to je povsem v redu.
Štiri stvari, ki jih je vredno preveriti v vsakem urnikovnem sistemu
Nobena ni eksotična. Vse so nekje tiho napačne.
| Vprašanje | Kako izgleda dober odgovor |
|---|---|
| Kje se začne teden 1? | Datum, ki ga je določila Vaša ustanova, shranjen enkrat, uporabljen povsod. Ne izpeljan iz koledarja in ne nastavljiv po zaslonu. |
| Ali lahko koledar sega pred teden 1? | Da, v ničlo in negativna števila, brez preštevilčenja česar koli, kar že obstaja. |
| Ali lahko teden nosi ime? | Da, ime pa se natisne namesto številke, v celoti. |
| Od kod študentska aplikacija dobi številko? | Iz urnika, v istem odgovoru kot predavanja. Odjemalec, ki izračuna svojo, bo napačen, in drugače napačen v vsaki ustanovi. |
Zakaj je to tudi vprašanje povezovanja
Portal, aplikacija ali informacijski zaslon, ki prikazuje naslov tedna, mora to nekje dobiti, edini vir, ki je lahko pravilen, pa je sam urnik. V programu Wise Timetable odgovor o urniku vsebuje številke in imena tednov za obseg, ki ga pokriva, zato odjemalec nikoli nima razloga, da bi jih izračunal — in GET /v2/weeks isto vprašanje odgovori samostojno za zaslon, ki mora označiti cel semester hkrati.
Priročnik za REST API dokumentira oboje, vključno z negativnim primerom, in je objavljen v celoti in brez omejitev, da lahko razvijalec preveri obliko odgovora, preden kdorkoli karkoli podpiše.
Želite videti, kako deluje?
Rezervirajte 45-minutno spletno predstavitev, na kateri bomo postopek prikazali na primeru urnikovnega problema Vaše ustanove.