3. Regelsets & Validierung
Das Plugin unterscheidet zwei Regeltypen: Completeness-Regeln (gewichteter Score) und Validierungsregeln (binäre Prüfung). Beide werden in Regelsets verwaltet.
Regelsets verwalten
Navigieren Sie zu Kataloge → Produktvollständigkeit → Regelsets, um Ihre Regelsets einzusehen, zu erstellen und zu bearbeiten.
Regelset erstellen
Klicken Sie auf Regelset hinzufügen und füllen Sie das Formular aus:
Name: Ein interner Name für das Regelset (z. B. „Standard-Checkliste" oder „SEO-Prüfung")
Verkaufskanäle (optional): Schränken Sie das Regelset auf einen oder mehrere Verkaufskanäle ein. Ohne Auswahl gilt es für alle Kanäle.
Sprache (optional): Begrenzen Sie das Regelset auf eine bestimmte Sprache. Ohne Auswahl gilt es sprachübergreifend.
Bedingungen hinzufügen
Jedes Regelset enthält eine oder mehrere Bedingungen. Pro Bedingung legen Sie fest:
Feld
Das zu prüfende Produktfeld (automatisch aus der Shopware ProductDefinition erkannt)
Operator
Die Prüflogik: required, min_length, count_min, regex u. a.
Wert (je nach Operator)
Der Vergleichswert, z. B. Mindestlänge oder Mindestanzahl
Gewichtung
Nur bei Completeness-Regeln: Wie stark dieses Feld den Score beeinflusst
Regeltyp
Completeness-Regel (Score) oder Validierungsregel (Gültig/Ungültig)
Unterstützte Operatoren
required
Feld muss vorhanden und nicht leer sein
min_length
Text muss mindestens N Zeichen haben
count_min
Sammlung (z. B. Bilder) muss mindestens N Einträge haben
regex
Feldwert muss einem regulären Ausdruck entsprechen
Regex-Eingaben werden auf ReDoS-Sicherheit geprüft.
Completeness-Regeln
Completeness-Regeln tragen zum gewichteten Score (0–100 %) bei. Ein Produkt erreicht 100 %, wenn alle Bedingungen in den für es relevanten Regelsets erfüllt sind.
Beispielkonfiguration:
Name
required
20
Beschreibung
min_length 100
30
Cover-Bild
required
25
Kategorien
count_min 1
15
Meta-Titel
required
10
Validierungsregeln
Validierungsregeln prüfen binäre Bedingungen — ein Produkt ist entweder gültig oder ungültig. Sie erscheinen getrennt vom Score im Dashboard und in der Produktliste.
Verwenden Sie Validierungsregeln für Pflichtfelder, die zwingend vorhanden sein müssen (z. B. EAN, Herstellernummer), aber nicht sinnvoll gewichtet werden sollen.
Scope: Verkaufskanal & Sprache
Ein Regelset gilt nur für Produkte, die dem gewählten Verkaufskanal zugeordnet sind. So können Sie unterschiedliche Anforderungen für verschiedene Shops oder Exportkanäle definieren:
Kein Filter: Das Regelset gilt für alle Produkte aller Kanäle
Verkaufskanal-Filter: Nur Produkte in diesen Kanälen werden nach diesem Regelset bewertet
Sprach-Filter: Nur Produktübersetzungen in dieser Sprache werden geprüft
Regelsets verwalten
Die angelegten Regelsets werden in einer Übersicht angezeigt mit Name, Scope-Badge und Anzahl der Bedingungen. Über den Schalter in der Spalte Aktiv können Sie einzelne Regelsets temporär deaktivieren.
Scores neu berechnen
Nach Änderungen an Regelsets werden die Scores nicht automatisch für alle Produkte neu berechnet. Klicken Sie auf dem Dashboard auf Scores neu berechnen, um eine vollständige Neuberechnung anzustoßen. Die Berechnung läuft asynchron — je nach Produktanzahl kann sie einige Minuten dauern.
Bei jedem Produkt-Speichervorgang wird der Score für das betreffende Produkt automatisch aktualisiert.
Last updated