JSON-LD modellieren
JSON-LD @context wirklich verstehen
Der @context ordnet kurze JSON-Schlüssel eindeutigen IRIs und Datentypen zu.
Der Context ist eine Bedeutungszuordnung
JSON-LD trennt die vertraute JSON-Struktur von den globalen IRIs des RDF-Modells. `@context` ordnet Schlüssel wie `name` oder `hersteller` definierten Begriffen zu.
Ohne Context bleiben JSON-Schlüssel lokal und mehrdeutig. Mit Context können zwei Systeme erkennen, ob sie dasselbe Prädikat meinen.
Termdefinitionen kontrollieren Datentyp und Richtung
Eine Termdefinition kann `@type: @id` festlegen. Dann wird ein Stringwert als IRI und nicht als Textliteral interpretiert. `@reverse` modelliert eine umgekehrte Beziehung, sollte aber sparsam eingesetzt werden.
Remote Contexts sind eine Laufzeitabhängigkeit. Produktionssysteme brauchen Versionierung, Cache und Schutz vor stillen Änderungen.
Expansion als Debugging-Werkzeug
Expandieren Sie ein Dokument, wenn unklar ist, welche IRIs tatsächlich erzeugt werden. Die expandierte Form zeigt Begriffe ohne Aliase und macht unerwartete Literale sichtbar.
Vergleichen Sie nicht nur das ursprüngliche JSON, sondern den resultierenden RDF-Datensatz.
Ein lokaler Context für ein Produkt
`hersteller` wird ausdrücklich als IRI-Beziehung definiert. Der Wert erzeugt daher keine Zeichenkette.
{
"@context": {
"schema": "https://schema.org/",
"name": "schema:name",
"hersteller": {"@id": "schema:manufacturer", "@type": "@id"}
},
"@id": "https://example.org/id/produkt-42",
"@type": "schema:Product",
"name": {"@value": "Pumpe X42", "@language": "de"},
"hersteller": "https://example.org/id/firma-7"
}Eigenständiges Redaktionsbeispiel. Reservierte example.org-Adressen bezeichnen keine realen Systeme.
Prüffrage für die Praxis
Behandle den Kontext als versionierte Schnittstelle.
Prüfen Sie die Regel an einem positiven und einem absichtlich problematischen Fall, bevor Daten veröffentlicht werden.
Quellen zu diesem Beitrag
Auswahl auf Artikelebene, geprüft am 18.09.2026.
- W3C JSON-LD 1.1
Normative Definition von Context, Expansion und Termdefinitionen. - W3C JSON-LD 1.1 Framing
Vertieft die Formung von JSON-LD-Ausgaben.