IQB-Logo

Das IQB auf GitHub - Metadaten

License: CC0-1.0 License: MIT

Das Institut zur Qualitätsentwicklung im Bildungswesen nutzt GitHub für die Veröffentlichung von Metadatendefinitionen: Vokabulare und Metadatenprofile. Außerdem sind hier Module und Komponenten veröffentlicht, die die Nutzung der Metadatendefinitionen in Webanwendungen unterstützen (TypeScript, Angular) oder der Validierung und Dokumentation der Metadatendefinitionen dienen.

Metadatenprofile

Für Datenobjekte speichert das IQB Metadaten. Welche Daten dies genau sein sollen, wird in sog. Metadatenprofilen definiert. Bei GitHub sind diese Profile als JSON-Dateien gespeichert, jeweils mehrere thematisch verwandte Profile zusammen in einem Repository, dem sog. Profil-Store.

Folgende Profile sind veröffentlicht:

Das IQB führt ein Register von Metadatenprofilen, um es Anwendungen zu erleichtern, passende Profile bestimmten Objekten zuzuweisen. Das Register finden Sie hier.

Typdefinitionen für Metadatenprofile und Metadaten-Werte finden Sie hier (TypeScript).

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.

Veröffentlichte Vokabulare

Bildungsstandards

Aufgaben und Items allgemein

Forschungsdaten

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