Website documentatie
Je zal eerst een inlogscherm krijgen. Als je op "inloggen" klikt dan zal je ofwel gerouteerd worden naar een scherm waar je met je UGent account moet inloggen, ofwel direct naar de home pagina.
Op deze pagina kan je je vakken zien, en erop doorklikken om naar hun respectievelijke pagina's te gaan. Er staat in de kaart van een vak ook een handig klein overzichtje van je laatste indieningen. Bovenaan staat er ook nog een knop die je oude vakken kan tonen. Aan de rechterkant, kan men een kleine kalender terugvinden, waarop de data van de deadlines van alle projecten staan aangeduid. Het is mogelijk om hier terug naar te navigeren vanuit eender welke pagina, door op het logo van 'Ghent University' (linksboven) te klikken.
Rechtsboven kan je de taal instellen of uitloggen.
Op de kalender kan je op een datum klikken om alle deadlines op die dag te zien.
Op de vak pagina staat een kort overzicht van de projecten met wat metadata. Als je op een rij uit de lijst klikt wordt je doorverwezen naar de project pagina.
Je kan al je medestudenten zien door op de studentenknop links onder te klikken.
De lesgever krijgt dezelfde pagina, maar met controle over de inhoud ervan. Zo bevat elke opdracht 3 extra knoppen, waardoor de zichtbaarheid kan aangepast worden en het project gearchiveerd of verwijderd kan worden.
Door op het potloodje te drukken kan de lesgever een vak aanpassen, dan komt hij/zij op deze pagina terecht. De lesgever kan er studenten en lesgevers toevoegen en de naam van het vak aanpassen. De lesgever heeft ook een plus knop op de home pagina om een volledig nieuw vak aan te maken. Dan krijgt de lesgever dezelfde pagina te zien, enkel waar nog geen gegevens zijn ingevuld.
\
Door rechtsonder op de plus-knop te duwen kan de lesgever ook nieuwe opdrachten aanmaken.
Hiervoor dient men een naam, een deadline, een eventuele extra deadline (BST) en een beschrijving mee te geven. Het is ook mogelijk om een opgave bestand up te loaden. Ook eventuele restrictietesten, waaraan de indiening dient te voldoen, kunnen hier meegegeven worden. Als laatste is het mogelijk om het aantal punten waarop de opdracht staat, aan te passen. Om al deze gegevens allemaal op te slaan, druk je op de 'submit'-knop rechts onderaan of je kan terug door op het kruisje te klikken.
Op de projectpagina kan je de opgave, de deadline en een lijst van je indieningen zien. Ook is de status zichtbaar, die meegeeft of de indiening voor de minimumtesten geslaagd is. Onderaan de pagina zijn er een knoppen om een nieuwe indiening te maken. Door op de 'upload' knop te drukken, zal er een bestandskiezer openen, waarin je het bestand dat je wenst in te dienen moet selecteren. Door nadien de 'Bevestig' knop te gebruiken, zal de indiening uitgevoerd worden.
Als men op een specifieke indiening klikt, komt men terecht op de submission pagina van de geselecteerde indiening.
Bij de lesgever ziet de pagina er grotendeels hetzelfde uit als voor de student. Maar de lesgever krijgt een lijst van studenten met hun laatste indiening. De lesgever kan deze indieningen downloaden via de downloadknop naast elke indiening. Om punten te geven, drukt men op de 'Scores Aanpassen' knop, waarna men terecht komt op de score pagina.
Bovendien kan een lesgever ook nog de opdracht aanpassen door op het potlood-icoontje te drukken naast de naam van de opdracht.
Voor de test scripts heb je 3 mogelijkheden:
- Een test script uploaden.
- Zelf een test script "from scratch" schrijven
- Starten vanaf een template test script.
Vooral dat laatste puntje verdient nog wat meer uitleg. Een template kan je openen in ofwel de ingebouwde text editor van de webapp. Ofwel kan je kiezen om een grafische interface te openen met speciale UI elementen om de parameters aan te passen. Als er bijvoorbeeld een parameter is dat een string is, dan krijg je een text field. Voor een boolean een toggle (of checkbox). Voor een lijst een dropdown, enz...
Als je zelf een template script wilt schrijven, dan kan dat ook. Je begint gewoon met een leeg (of bestaand) start script te openen in een text editor. Dit kan de text editor van de webapp zijn of een op je eigen machine. Daarna schrijf je gewoon de code zoals gebruikelijk, maar de parameters die je wilt tonen in de grafische interface, die moet je best bovenaan als variable assignment schrijven. Daar stopt het niet, op dit moment zal de grafische interface nog geen enkele parameter tonen. Boven de declaratie van je parameter in je code, kan je eventueel nog een beschrijvende comment plaatsen. Als je dit doet, dan zal de interface deze beschrijving bij het UI element van de parameter zetten. Daarboven plaats je een line comment die start met "@param". Pas als je dit doet zal de grafische interface de variabele als een parameter zien die getoond moet worden aan de eindgebruiker.
Zo een code in bash ziet er bijvoorbeeld zo uit:
#@param
# Schrijf in dit veld je voornaam.
naam=""
# de constante pi, nodig voor wanneer we de omtrek berekenen van het object dat de student indient.
pi=3.14159
#code...
Wanneer iemand dit testscript dan opent in de grafische interface, zal die persoon een veldje invullen dat "naam" heet. Naast Dat veldje zal de tekst "Schrijf in dit veld je voornaam." staan. De parameter pi wordt niet getoond in de interface. Want hierbij stond geen #@param comment. Dit is handig voor degene die de test schrijft. Want voor de boekhouding van je code wil je soms variabelen schrijven in de plaats van magic numbers. Maar die variabelen moeten soms niet getoond worden aan de eindgebruiker.
Deze pagina ziet er hetzelfde uit, voor zowel student als lesgever. Op de deze pagina kan je de details van de opdracht raadplegen, maar ook de ingediende bestanden downloaden en kijken of de indiening geslaagd is voor de minimumvereisten.
Deze pagina is enkel zichtbaar voor de student, indien de leerkracht het toelaat dat studenten zelf een groep mogen kiezen. Op deze pagina kan een student een groep verlaten en/of lid worden van nieuwe groep indien er nog plaats is.
Deze pagina is enkel zichtbaar voor de lesgever, en laat deze toe om groepen voor opdrachten te beheren. Zo kan ervoor gekozen worden om willekeurige groepen te vormen, of om studenten toe te laten zelf te kiezen. Bovendien is het ook mogelijk om handmatig groepen samen te stellen.
De leerkracht kan snel studenten opzoeken dankzij de zoekbalk:
Deze pagina laat toe om elke indiening van een project een bepaalde score te geven. Hiervoor is het mogelijk om elke indiening apart een score te geven, of om een CSV-file te uploaden, die alle scores bevat. Om alles op te slaan, druk je op de 'save' knop rechts onderaan. Ten slotte kunnen alle indieningen hier ook nog in 1 grote zip file gedownload worden, dankzij de 'Exporteer Indieningen' knop.
