Seminar Enonic XP 8 – Suche, Query DSL, Aggregationen und Indexierung

Das Seminar entwickelt Suchfunktionen aus fachlichen Anforderungen und messbaren Qualitätskriterien. Datenmodell, Indexierung, Query DSL, Aggregationen und Berechtigungen werden gemeinsam betrachtet, damit Treffer nicht nur schnell, sondern auch korrekt und erklärbar sind.

Ein mehrsprachiger Datenbestand wird indexiert und über mehrere Suchvarianten abgefragt. Relevanz, Filter, Aggregationen, Paging und Performance werden mit reproduzierbaren Testfällen und festen Datenständen bewertet.

Inhaltsübersicht

1. Suchanforderungen und Qualitätskriterien
2. Indexmodell und Felder
3. Query DSL Grundlagen
4. Filter, Sortierung und Paging
5. Volltext, Relevanz und Highlighting
6. Aggregationen und Facetten
7. Berechtigung und Kontext
8. Performance, Reindexierung und Betrieb

Lernziele

• Indexierungs- und Suchmodell der Plattform sicher einordnen
• Query DSL, Filter, Sortierung und Paging korrekt einsetzen
• Volltext, Sprache, Highlighting und Aggregationen gestalten
• Berechtigungen und Datenkontext in Suchergebnissen berücksichtigen
• Performance, Reindexierung und Suchqualität systematisch testen

Praxisorientierte Lernschritte

1. Suchanforderungen und Qualitätskriterien

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Suchfälle nach Volltext, Filterung, Navigation und Analyse klassifizieren
2. Schritt 2: Trefferqualität, Antwortzeit und Vollständigkeit messbar definieren
3. Schritt 3: repräsentative Testdaten und erwartete Ergebnismengen festlegen

2. Indexmodell und Felder

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Eigenschaften, Datentypen und mehrwertige Felder für die Indexierung bewerten
2. Schritt 2: Volltext- und strukturierte Suchfelder voneinander trennen
3. Schritt 3: sprachabhängige allText- und Kollationsanforderungen im Modell berücksichtigen

3. Query DSL Grundlagen

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: einfache Term-, Bereichs- und Existenzbedingungen formulieren
2. Schritt 2: AND-, OR- und NOT-Verknüpfungen mit klarer Klammerung aufbauen
3. Schritt 3: Parameter sicher binden und nicht vertrauenswürdige Eingaben begrenzen

4. Filter, Sortierung und Paging

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: fachliche Filter von relevanzwirksamen Suchbedingungen trennen
2. Schritt 2: stabile Sortierung mit eindeutigen Tie-Breakern definieren
3. Schritt 3: Offset- und Cursor-nahe Pagingmuster auf Konsistenz und Kosten prüfen

5. Volltext, Relevanz und Highlighting

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Suchbegriffe, Felder und Sprachverhalten anhand von Beispielen kalibrieren
2. Schritt 2: Treffertexte mit Highlighting für eine verständliche Ergebnisdarstellung erzeugen
3. Schritt 3: Stoppwörter, Tippvarianten und unerwartete Treffer als Testfälle dokumentieren

6. Aggregationen und Facetten

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: fachliche Navigationsdimensionen und Kennzahlen auswählen
2. Schritt 2: Bucket- und Metrikaggregationen mit Filtern kombinieren
3. Schritt 3: leere, sehr große und mehrsprachige Facetten auf Stabilität prüfen

7. Berechtigung und Kontext

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Repository, Branch, Projekt und Principal für die Suche explizit festlegen
2. Schritt 2: nicht lesbare Inhalte aus Ergebnis und Aggregation ausschließen
3. Schritt 3: unterschiedliche Rollen mit identischen Suchanfragen gegentesten

8. Performance, Reindexierung und Betrieb

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Abfragekosten, Datenmenge, Sortierung und Aggregationen isoliert messen
2. Schritt 2: Optimierung mit identischer Baseline und Ergebnisprüfung durchführen
3. Schritt 3: Reindexierung, Monitoring und Rückfallverfahren als Betriebsrunbook festlegen

Zielgruppe und Vorkenntnisse

Zielgruppe: Enonic-Entwickler, Such- und Datenentwickler, Content Architects, API-Entwickler und technische Teams für katalog-, portal- oder wissensbasierte Anwendungen.

Vorkenntnisse: Gute Kenntnisse in strukturierten Daten, TypeScript oder API-Entwicklung sowie Grundkenntnisse der Enonic Content- oder Node-Bibliotheken.

Didaktik und Arbeitsweise

Kurze Fachimpulse werden unmittelbar durch Demonstrationen, strukturierte Konfigurations- oder Implementierungsschritte und kontrollierte Fehlerfälle vertieft. Jede Übung besitzt definierte Ausgangswerte, Prüfpunkte und Dokumentationsanforderungen. Dadurch bleiben die erarbeiteten Abläufe für Projekt- und Betriebsstandards nachvollziehbar.