🟡 Klassifizierungen Grundlagen

Klassifizierungen sind ein zentrales Strukturierungs- und Filterinstrument in dataCycle. Sie ermöglichen es, Inhalte fachlich einzuordnen, zu gruppieren und gezielt über die API auffindbar zu machen.

Im Gegensatz zu Attributen sind Klassifizierungen kontrollierte, wiederverwendbare Werte, die projektweit einheitlich genutzt werden.

Überblick

Klassifizierungen werden in dataCycle verwendet, um:

Inhalte fachlich zu kategorisieren
Filterung und Facettierung über die API zu ermöglichen
stabile, sprechende Filterlogiken aufzubauen
Inhalte unabhängig vom Ausgabekanal einzuordnen

Typische Beispiele sind:

Kategorien (z. B. Konzert, Wanderung, Museum)
Zielgruppen (z. B. Familien, Senioren)
Themen (z. B. Natur, Kultur, Sport)
Regionen oder Orte

Was ist eine Klassifizierung?

Eine Klassifizierung ist ein vordefinierter Eintrag aus einem Klassifizierungsbaum (Concept Scheme).

Ein Inhalt verweist dabei nicht auf einen Freitext, sondern auf einen konkreten Klassifizierungs-Knoten.

Eigenschaften:

eindeutig identifizierbar (ID / URI)
hierarchisch organisierbar (Baumstruktur)
mehrsprachig pflegbar
projektweit konsistent

Klassifizierungen am Inhalt

Ein Inhalt kann null, eine oder mehrere Klassifizierungen besitzen.

Beispiel (stark vereinfacht):

{
  "@id": "8c6a1a1e-3f3a-4b33-8e7a-6b1b9c9c1234",
  "@type": ["Event"],
  "name": "Sommerkonzert im Park",
  "classification": [
    {
      "@id": "urn:dc:classification:event-type:concert",
      "@type": ["Concept"],
      "prefLabel": "Konzert"
    }
  ]
}

Wichtig:

der Inhalt speichert nicht nur einen Text, sondern eine Referenz
die fachliche Bedeutung ist eindeutig
Filter funktionieren stabil, auch bei Umbenennungen

Warum Klassifizierungen und keine Attribute?

Attribute eignen sich für:

freie Werte
Zahlen, Texte, Datumsfelder
individuell gepflegte Inhalte

Klassifizierungen eignen sich für:

feste Kategorien
kontrollierte Auswahl
Filter, Facetten und Navigation
konsistente API-Abfragen

👉 Faustregel:

Alles, was später gefiltert, facettiert oder gruppiert werden soll, ist ein Kandidat für eine Klassifizierung.

Filtern nach Klassifizierungen (Ausblick)

Klassifizierungen sind direkt filterbar über die API.

Beispiel (schematisch):

GET /api/v4/endpoints/{endpoint}
  ?filter[classification]=urn:dc:classification:event-type:concert

Dabei gilt:

es wird nach der ID der Klassifizierung gefiltert
Baumlogiken (Eltern / Kinder) können berücksichtigt werden
mehrere Klassifizierungen sind kombinierbar

Details dazu folgen im Kapitel „Filtern > Klassifizierungen“.

Wichtige Eigenschaften von Klassifizierungen

zentral gepflegt
konsistent über alle Inhalte hinweg
unabhängig von Sprache und Darstellung
stabil für langfristige Integrationen
ideal für Suche, Filter und Navigation

Kurz zusammengefasst

Klassifizierungen ordnen Inhalte fachlich ein
Sie sind kontrolliert, eindeutig und wiederverwendbar
Inhalte referenzieren Klassifizierungen – keine Freitexte
Klassifizierungen sind die Basis für Filter & Facetten
Sie sorgen für stabile und wartbare APIs

➡️ Im nächsten Kapitel schauen wir uns an, wie Relationen und include zusammenspielen.