Vokabulare
Die Vokabulare des IQB sind in Gruppen angelegt. Jede Gruppe ist in einem separaten Repository bei GitHub als CSV-Dateien (s. jeweils Link ‘GitHub’) geführt und fasst thematisch verwandte Vokabulare zusammen. In einem Gruppenrepository wird außerdem die Transformation in ttl-Dateien durchgeführt - jeweils für alle Vokabulare einer Gruppe in einem Arbeitsgang. Für diese Umsetzung nutzt das IQB eine eigene (TypeScript-)Programmierung csv2ttl.
Jede Gruppe ist bei SkoHub (s. jeweils Link ‘SkoHub’) gespiegelt. Dadurch steht automatisch eine ansprechende Präsentation im Html-Format zur Verfügung. Außerdem stellt SkoHub eine Übersetzung eines Vokabulars in eine JSON-Form zur Verfügung, was die Verwendung der Vokabulare in Programmierungen wesentlich erleichtert. Die SkoHub-Darstellung sowie die JSON-Form sind über eine w3id erreichbar, die in der SkoHub-Darstellung angezeigt wird. Die Spiegelung der ttl-Dateien nach SkoHub erfolgt durch einen Webhook bei GitHub, d. h. sie wird automatisch bei Aktualisierung des GitHub-Repositories ausgelöst.
JSON-Abruf von Vokabularen
Für die Referenzierung eines Vokabular-Eintrages in einem Datenobjekt muss das Vokabular über einen persistenten - also dauerhaften - Identifier verfügen. Wir benutzen perma-id bei w3id.org. Für die Auflösung beispielsweise des Eintrags
Vokabular: Bildungsstandards Fremdsprachen Sek I 2023 - Anforderungsbereiche
Vokabulareintrag: Anforderungsbereich I
ist die permanente URL
https://w3id.org/iqb/v51/a1/c6u
zu verwenden.
Für den Abruf eines kompletten Vokabulars im handlichen JSON-Format muss die URL des Vokabulars um /index.json
erweitert werden:
https://w3id.org/iqb/v51/a1/index.json