Page History

...

Voor onderwijsaanbod is het goed de 'lecturer' en 'coordinator' rol te ontwikkelen. Om te orienteren op een vak kan het van toegevoegde waarde zijn om te weten wie het vak doceert. Daarnaast kan de coordinator gebruikt worden als contactpersoon voor specifieke vragen over een vak. Het is niet nodig de 'student' rol aan te bieden. Het is niet nodig te weten wie al voor een vak ingetekend heeft.

22a. Als een instelling ervoor kiest om de leerdoelen als tekstbox (HTML) te definiëren is het dan de bedoeling dat hiervoor 1 string-object wordt aangeleverd, of wordt dit dan een omschrijving?

22b. Waarom is leerdoelen een string[] en geen object? Ik zou verwachten dat je zowel leerdoel als niveau waarop het leerdoel wordt geleverd wil weten.

We gaan er bij het beantwoorden van deze vragen (22a en 22b) vanuit dat het over vakken gaat, dus dat dit /courses/{courseId}.learningOutcomes betreft.

Het klopt dat learningOutcomes een array van strings is. Een lijst van één of meerdere learningOutcomes dus. Het niveau van het vak kan opgegeven worden in /courses/{courseId}.level. Er is dus één niveau dat voor alle learningOutcomes geldt. Wat we zien is dat er bij veel instellingen voor een vak vaak een aantal outcomes beschreven staan als een lijstje met punten, vandaar de array. Mocht er voor een vak maar één outcome beschreven staan dan kan die als het eerste en enige element in de array doorgegeven worden.

Als de instelling learningOutcomes gebruikt om het vak te beschrijven, dan is het inderdaad een optie om die in de de /courses/{courseId}.description op te nemen. Let wel op dat daar dan geen HTML in kan zitten. Wel kan er gebruik gemaakt worden van markdown.

23. Is er een lijstje met de omschrijvingen die verwacht worden van een specifieke course, of zijn alleen description, requirements, enrollment en assessment gewenst?

De required velden van OOAPI zijn aangegeven in de specificatie. Dat zijn voor het object /courses/{coursId}:

• courseId
• name
• abbreviation
• description
• level

Verder wordt er niets verwacht. Hoe meer info hoe beter, want dan kunnen verschillende frontends van de data gebruik maken. De demo omgeving zal aangeven welke velden wel en welke velden niet gebruikt worden. 

Als je als voorbeeld van een frontend naar eduXchange kijkt. Dat is een omgeving voor het intekenen op bijvakken. Dan worden de volgende aanvullende velden gebruikt:

• learningOutcomes
• requirements
• enrollment
• ects
• coordinator

Ook worden van de aanbiedingen van cursussen nog gegevens gebruikt. Dat betreft van /courses/{courseId}/offerings de volgende attributen:

• mainLanguage
• academicSession
• maNumberOfStudents en enrolledNumberOfStudents
• startDate & endDate

...