Filter, Sortierung und Facettensuche bei Klassifizierungen

Um in umfangreichen Klassifizierungsbäumen gezielt die richtigen Kategorien zu finden oder die Ergebnisse an spezifische Anforderungen anzupassen, kannst du Filter und Sortierungen verwenden. Außerdem erlaubt die Facettensuche eine schnelle Übersicht, wie viele Inhalte zu welchen Kategorien gehören.

Was ist ein Filter?

Ein Filter ist eine Art Abfragebedingung, mit der du Kategorien eingrenzen kannst. Zum Beispiel kannst du nur Kategorien abfragen, die eine bestimmte übergeordnete Kategorie haben, oder nur solche, die eine bestimmte Eigenschaft erfüllen.

Beispiel: Filter nach Unterkategorien

Wenn du z. B. nur Kategorien abfragen möchtest, die direkt unter „Österreich” liegen (angenommen, die ID von „Österreich” ist 4ec1c188-ccf0-4979-8f3d-5e03f1ca5078), kannst du diesen Filter verwenden:

{
  "filter": {
    "attribute": {
      "skos:ancestors": {
        "in": ["4ec1c188-ccf0-4979-8f3d-5e03f1ca5078"]
      },
      "skos:broader": {
        "in": ["null", "4ec1c188-ccf0-4979-8f3d-5e03f1ca5078"]
      }
    }
  }
}

Dieser Filter sorgt dafür, dass nur Kategorien zurückgegeben werden, die entweder direkt unter „Österreich” sind oder deren Vorfahren „Österreich” enthalten.

Wie wende ich den Filter an?

Den Filter sendest du als POST-Body an den Kategorien-Endpunkt, z.B.:

POST /api/v4/concept_schemes/DEINE_BAUM_ID/concepts?token=DEIN_TOKEN
Content-Type: application/json

{
  "filter": {
    "attribute": {
      "skos:ancestors": {
        "in": ["4ec1c188-ccf0-4979-8f3d-5e03f1ca5078"]
      },
      "skos:broader": {
        "in": ["null", "4ec1c188-ccf0-4979-8f3d-5e03f1ca5078"]
      }
    }
  }
}

Sortierung der Ergebnisse

Du kannst die zurückgegebenen Kategorien auch sortieren, z.B. nach der Anzahl der zugeordneten Inhalte. Folgende Parameter sind möglich:

sort=+dc:thingCountWithSubtree – aufsteigend nach der Anzahl aller Inhalte in der Kategorie inklusive Unterkategorien
sort=-dc:thingCountWithSubtree – absteigend nach der Anzahl aller Inhalte

Beispiel: Kategorien absteigend sortieren nach Anzahl der Inhalte

GET /api/v4/endpoints/ENDPOINT_ID/facets/CONCEPT_SCHEME_ID?token=DEIN_TOKEN&sort=-dc:thingCountWithSubtree

Facettensuche

Mit der Facettensuche erhältst du eine Übersicht, wie viele Inhalte zu jeder Kategorie gehören, inklusive oder exklusive der Unterkategorien. Das hilft dir, Kategorien mit hoher Relevanz schnell zu erkennen.

Beispiel-Antwort einer Facettensuche:

{
  "@graph": [
    {
      "@id": "6d9fbb75-1365-4edb-b470-56f8626d3a66",
      "skos:prefLabel": "Klassische Musik",
      "dc:thingCountWithSubtree": 55,
      "dc:thingCountWithoutSubtree": 25
    }
  ]
}

Fazit

Filter, Sortierung und Facettensuche helfen dir dabei,

gezielt Kategorien zu finden,
Ergebnisse nach Relevanz zu ordnen,
und einen schnellen Überblick über die Datenverteilung zu bekommen.

So kannst du in deiner Anwendung dynamische Filter bauen und die Nutzererfahrung deutlich verbessern.