Docs  /  Konfigurator aufbauen  /  Regelwerk aufbauen

Regelwerk aufbauen

Zuletzt aktualisiert: 20. Oktober 2026

Mit Regeln sorgst du dafür, dass deine Kunden nur Konfigurationen zusammenstellen, die du auch liefern kannst. Eine Regel prüft eine Bedingung – etwa „Antrieb ist Solar“ – und löst eine Wirkung aus: Sie blendet Werte oder ganze Merkmale aus, belegt Werte vor oder zeigt eine Meldung.

Das Prinzip

  • Regelgruppen ordnen deine Regeln, z. B. „Antrieb“, „Maße“, „Farben“. Jede neue Regel legst du in einer Regelgruppe an.
  • Jede Regel besteht aus einer Bedingung (WENN) und einer Wirkung, die vom Regeltyp abhängt.
  • Regeln werden bei jeder Auswahl neu geprüft. Trifft die Bedingung nicht mehr zu, endet auch die Wirkung – ein ausgeblendeter Wert erscheint wieder.

Schritt für Schritt

  1. Öffne die Komponente und wechsle links in den Reiter Regeln.
  2. Lege mit + neben Regeln eine Regelgruppe an (Regelgruppe hinzufügen). Über das Zahnrad (Gruppeneinstellungen) gibst du ihr einen Gruppennamen.
  3. Klicke an der Gruppe auf + (Regel hinzufügen). Es entsteht die Regel „Neue Regel“ vom Typ Blacklist.
  4. Rechts unter Regeleinstellungen vergibst du eine Regelbezeichnung und wählst den Regeltyp.
  5. In der Mitte baust du unter Bedingung (WENN) die Bedingung auf (siehe Bedingungen).
  6. Lege rechts die Wirkung fest – je nach Regeltyp unterschiedlich (siehe Regeltypen).
  7. Speichere und teste in der Vorschau. Wie jede Änderung gilt eine Regel im Shop erst nach dem Veröffentlichen.

Mit Regel löschen unten in den Regeleinstellungen entfernst du eine Regel. Wird eine Regelgruppe gelöscht, verschwinden alle Regeln darin.

Regeltypen

Regeltyp Wirkung, wenn die Bedingung zutrifft Engine
Blacklist Blendet einzelne Werte oder ganze Merkmale aus Legacy und V3
Wertvorbelegung Setzt in einem Merkmal einen bestimmten Wert Legacy und V3, mit Unterschieden
Mengenvorbelegung Setzt Mindest- und Höchstmenge eines Merkmals mit Mengeneingabe nur Legacy
Min/Max-Vorbelegung Ändert den erlaubten Bereich eines Eingabefelds nur Legacy
Fehler / Hinweis Zeigt dem Kunden eine Meldung Legacy und V3, mit Unterschieden

Was „Legacy“ und „V3“ bedeuten, erklärt Frontend-Engine: Legacy oder V3.

Blacklist

Rechts siehst du alle Merkmale nach Gruppen geordnet.

  • Einzelne Werte ausblenden: Klappe ein Merkmal auf und hake die Werte an, die nicht mehr wählbar sein sollen.
  • Ganzes Merkmal ausblenden: Hake das Kästchen vor dem Merkmalsnamen an (Ganzes Merkmal sperren). Das Merkmal verschwindet vollständig, auch aus Preis und Zusammenfassung.

Mit Alle auswählen und Alle abwählen markierst du alle Einträge einer Gruppe oder eines Merkmals auf einmal.

Wertvorbelegung

Für jedes Merkmal wählst du einen Modus:

Modus Wann der Wert gesetzt wird
Deaktiviert Nie – das Merkmal bleibt unberührt (Standard)
Immer anwenden Immer, auch wenn der Kunde schon etwas anderes gewählt hat
Nur bei Standardwert Nur wenn noch nichts oder der Standardwert gewählt ist
Keine Auswahl oder Standardwert Wie Nur bei Standardwert – und zusätzlich, wenn eine Blacklist den bisher gewählten Wert gerade ausgeblendet hat

Danach wählst du den Wert, der gesetzt werden soll. Einen Wert, den eine Blacklist gerade sperrt, setzt die Regel nicht.

Dynamischer Wert (nur Legacy): Statt eines festen Werts übernimmt die Regel den aktuellen Wert eines anderen Merkmals. Bei Merkmalen mit Werten legst du fest, ob über den Wert (Wert abgleichen) oder die ID (ID abgleichen) zugeordnet wird. V3 überspringt dynamische Vorbelegungen.

Bei Eingabefeldern setzt V3 nur Zahlen vor, Legacy auch Text.

Mengenvorbelegung (nur Legacy)

Gilt für Merkmale, bei denen die Menge aktiviert ist. Du trägst Min. Menge und Max. Menge ein. Mit Dynamisch übernimmst du die Grenzen aus einem anderen Merkmal. V3 ignoriert diesen Regeltyp.

Min/Max-Vorbelegung (nur Legacy)

Ändert den erlaubten Bereich eines Eingabefelds, z. B. „bei Material Holz höchstens 180 cm Breite“. Für das Merkmal stellst du Ja ein und trägst den Bereich als min-max ein, etwa 40-180 (ganze Zahlen). Angeboten werden Eingabefelder mit einer Erlaubten Eingabe. V3 ignoriert diesen Regeltyp – wenn deine Komponente mit V3 läuft, begrenze Maße stattdessen über eine Fehler / Hinweis-Regel.

Fehler / Hinweis

Einstellung Bedeutung
Fehlermeldung Der Text, den der Kunde sieht. Du kannst Merkmale über ihren internen Namen einsetzen, z. B. Maximal $max_breite cm – im Shop steht dort der aktuelle Wert (bei Merkmalen mit Werten das Feld Wert).
Meldungstyp Fehler oder Hinweis
Ausführen bei Wann die Meldung erscheint (nur Legacy, siehe unten)

So verhalten sich die Engines:

Legacy V3
Fehler Erscheint als Fenster und verhindert das Hinzufügen zum Warenkorb Erscheint rot unter dem Gesamtpreis und verhindert Warenkorb und Aktions-Button, solange die Bedingung zutrifft
Hinweis Erscheint als Fenster mit Fortfahren – der Kunde kann trotzdem bestellen Erscheint gelb unter dem Gesamtpreis – der Kunde kann trotzdem bestellen
Ausführen bei Direkt danach: sobald die Bedingung zutrifft. Wizard: beim Weiterklicken aus dem Schritt. Warenkorb: beim Klick auf In den Warenkorb. Geprüft wird beim Warenkorb in jedem Fall. Wird nicht ausgewertet – die Meldung erscheint, sobald die Bedingung zutrifft
Merkmale im Meldungstext Werden ersetzt Werden ersetzt

Bedingungen

Regel-Editor: links die Regeln der Regelgruppe, in der Mitte die Bedingung (WENN), rechts die Regeleinstellungen mit Regeltyp, Gewichtung und den ausgeblendeten Werten

Die Bedingung baust du in der Mitte unter Bedingung (WENN) auf:

  1. Wähle das Merkmal.
  2. Wähle den Vergleich (Operator).
  3. Wähle den Wert oder gib ihn ein.

Mit + Bedingung fügst du eine weitere Zeile hinzu, mit + Gruppe eine Untergruppe. Über und / oder legst du fest, ob alle Zeilen zutreffen müssen oder eine genügt.

Operatoren

Operator Bedeutung Für
enthält Einer der gewählten Werte ist ausgewählt alle Merkmale mit Werten
enthält nicht Keiner der gewählten Werte ist ausgewählt alle Merkmale mit Werten
ist leer Nichts gewählt bzw. nichts eingegeben alle
ist nicht leer Etwas gewählt bzw. eingegeben alle
= / ≠ Gleich / ungleich Eingabefelder, Berechnungen
< / ≤ / > / ≥ Kleiner, kleiner gleich, größer, größer gleich Zahlen, z. B. Breite

Bei Merkmalen mit Werten (Auswahl, Radio Buttons, Checkbox, Liste mit Bildern …) bietet der Editor nur enthält, enthält nicht, ist leer und ist nicht leer an. Du kannst mehrere Werte auf einmal angeben – die Bedingung trifft zu, wenn einer davon gewählt ist. Bei Checkbox und Mehrfachauswahl genügt es, wenn einer der angehakten Werte in deiner Liste steht.

Was als Bedingung taugt

Merkmal Legacy V3
Auswahl, Radio Buttons, Liste mit Bildern ✓ ✓
Checkbox, Mehrfachauswahl ✓ ✓
Eingabefelder (Zahl, Text) ✓ ✓
Berechnete Merkmale (Formel, Preisliste, Kombination) ✓ ✓

Untergruppen: Hinweis für Legacy

V3 wertet verschachtelte Gruppen genau so aus, wie sie im Editor stehen. Legacy verknüpft eine Untergruppe dagegen immer mit und mit der Zeile direkt davor – auch wenn außen oder eingestellt ist – und kann eine Untergruppe an erster Stelle nicht auswerten. Für Komponenten mit Legacy gilt deshalb: Untergruppe nie an den Anfang stellen und nur mit und kombinieren. Brauchst du ein oder zwischen Gruppen, lege lieber zwei Regeln an.

Legacy wertet bei ist leer außerdem die Zahl 0 als leer.

Wenn mehrere Regeln zusammentreffen

  • Blacklists addieren sich: Ausgeblendet ist alles, was mindestens eine zutreffende Regel ausblendet.
  • Ketten: Ein Merkmal, das eine Regel ausblendet, und ein gesperrter Wert lösen keine weiteren Regeln aus. Beide Engines werten neu aus, bis sich nichts mehr ändert. Legacy löscht dabei die Auswahl des ausgeblendeten Merkmals; V3 merkt sie sich und zeigt sie wieder, sobald die Regel nicht mehr greift.
  • Vorbelegungen für dasselbe Merkmal: Es gewinnt eine Regel.
    • In V3 entscheidet die Gewichtung: Die Regel mit dem höheren Wert gewinnt. Bei gleicher Gewichtung gewinnt die Regel, die weiter unten in der Liste steht.
    • In Legacy wird die Gewichtung nicht ausgewertet. Es gilt die Reihenfolge in der Liste.
  • Meldungen zeigt V3 nach Gewichtung sortiert an, die schwerste zuerst.

Die Gewichtung stellst du in den Regeleinstellungen ein (Standard 0). Regeln mit einer Gewichtung ungleich 0 tragen sie in der Liste als Kennzeichen, z. B. +5.

Reihenfolge

Die Reihenfolge der Regeln und Regelgruppen änderst du per Ziehen am Griff ⠿ in der Regelliste. Ausgewertet werden zuerst Regeln außerhalb von Gruppen, dann die Gruppen von oben nach unten.

Regeln testen

  1. Speichere die Komponente.
  2. Schalte in der Mitte auf Vorschau und klicke typische und kritische Kombinationen durch.
  3. Prüfe, ob Werte verschwinden und wieder auftauchen, Vorbelegungen greifen und Meldungen erscheinen.

Die Vorschau läuft mit der eingestellten Frontend-Engine. Wechselst du später die Engine, teste die Regeln erneut – vor allem Untergruppen, Vorbelegungen und Fehlermeldungen.

Welche Regeln ein Merkmal betreffen, siehst du im Merkmal rechts im Reiter Referenziert in. Von dort springst du direkt zur Regel.

Regeln per KI-Agent

Regeln kannst du auch beschreiben statt klicken: „Wenn das Material Holz ist, soll die Farbe RAL 7016 nicht wählbar sein.“ Der KI-Agent legt die Regel an. Kontrolliere sie danach im Reiter Regeln und in der Vorschau. Mehr dazu: KI-Agent: Regeln per Chat definieren.

Praxisbeispiele

1. Farbe passt nicht zum Antrieb Regeltyp Blacklist. Bedingung: Antrieb enthält Solar. Wirkung: bei Farbe den Wert Weiß anhaken.

2. Zubehör nur mit Motor Regeltyp Blacklist. Bedingung: Antrieb enthält Kurbel. Wirkung: beim Merkmal Fernbedienung Ganzes Merkmal sperren anhaken.

3. Sinnvolle Vorauswahl Regeltyp Wertvorbelegung. Bedingung: Modell enthält Basic. Wirkung: Farbe auf Keine Auswahl oder Standardwert, Wert Weiß. Hat der Kunde schon eine eigene Farbe gewählt, bleibt sie erhalten.

4. Maß nicht lieferbar Regeltyp Fehler / Hinweis. Bedingung: Material enthält Holz und Breite > 180. Meldungstyp Fehler, Fehlermeldung „Holz ist bis 180 cm Breite lieferbar.“

5. Nur in Legacy: Bereich begrenzen Regeltyp Min/Max-Vorbelegung. Bedingung: Material enthält Holz. Wirkung: Breite auf Ja, Bereich 40-180.

Fehlersuche

  1. Die Regel greift gar nicht – prüfe den Operator: Bei Merkmalen mit Werten brauchst du enthält, nicht =. Prüfe auch, ob die Komponente veröffentlicht ist; der Shop zeigt den zuletzt veröffentlichten Stand.
  2. Die Regel greift nur manchmal – steht eine Untergruppe am Anfang oder ist sie mit oder verknüpft? In Legacy wird das anders ausgewertet (siehe Untergruppen).
  3. Mengen- oder Min/Max-Vorbelegung wirkt nicht – die Komponente läuft mit V3, das diese Regeltypen nicht kennt.
  4. Zwei Vorbelegungen widersprechen sich – vergib in V3 eine Gewichtung, in Legacy ändere die Reihenfolge.
  5. Der Kunde kann trotz Meldung bestellen – prüfe den Meldungstyp: Nur Fehler sperrt den Warenkorb, ein Hinweis informiert nur.

Nächste Schritte


← Alle Artikel 14 Tage kostenlos testen