Regeln für die Element-Erkennung
Wenn Sie einen Hinweis, eine Sprechblase oder einen Guide-Schritt mit einem bestimmten Element auf Ihrer Shop-Seite verknüpfen (z. B. einem Button oder Menüpunkt), muss das System dieses Element eindeutig wiedererkennen können. Diese Regeln legen fest, welche Merkmale eines Elements dafür verwendet werden dürfen — und welche nicht.
Was kann ich hier tun?
- Regeln anlegen, die festlegen, welche Merkmale eines Elements zur Wiedererkennung genutzt werden dürfen (Einschließen) oder ausdrücklich nicht genutzt werden sollen (Ausschließen)
- Regeln nach Merkmal und Beschreibung durchsuchen sowie nach Typ und Status filtern
- Die Reihenfolge festlegen, in der Regeln angewendet werden (Priorität)
- Regeln bearbeiten, aktivieren/deaktivieren und löschen
/crm/adoption/selector-rulesSchritt für Schritt
Eine neue Regel anlegen
- Klicken Sie auf Neue Regel.
- Wählen Sie den Typ: Einschließen, wenn das Merkmal verwendet werden darf, oder Ausschließen, wenn es vermieden werden soll.
- Geben Sie das Merkmal an (z. B.
class,data-testid,id,role). - Optional: Schränken Sie mit einem Muster ein, welche Werte dieses Merkmals gemeint sind.
- Vergeben Sie eine Priorität (höhere Zahl = wird zuerst angewendet) und speichern Sie.
Eine Regel deaktivieren, statt sie zu löschen
- Öffnen Sie die Regel über das Stift-Symbol.
- Entfernen Sie das Häkchen bei „Aktiv“ und speichern Sie.
- Die Regel bleibt erhalten, wird aber nicht mehr angewendet.
Felder erklärt
| Feld | Bedeutung | Hinweise/Auswirkung |
|---|---|---|
| Typ | Ob das Merkmal genutzt werden darf (Einschließen) oder vermieden werden soll (Ausschließen) | Siehe Werte & Status unten |
| Attribut | Das Merkmal eines Elements, um das es in dieser Regel geht | Pflichtfeld, z. B. class, id, data-testid, role |
| Muster | Ein optionales Muster, das eingrenzt, welche Werte dieses Merkmals gemeint sind | Freitext (regulärer Ausdruck) |
| Beschreibung | Erklärung, wofür die Regel gedacht ist | Optional, erleichtert späteres Verständnis |
| Priorität | Reihenfolge, in der Regeln angewendet werden | Werte 0–1000; höhere Priorität wird zuerst angewendet |
| Status | Ob die Regel aktuell wirksam ist | Siehe Werte & Status unten |
Werte & Status
Typ
| Wert | Bedeutung | Was passiert dann |
|---|---|---|
| Einschließen | Das angegebene Merkmal darf zur Wiedererkennung eines Elements genutzt werden | Wird bevorzugt für die Verknüpfung von Hinweisen mit Elementen verwendet |
| Ausschließen | Das angegebene Merkmal soll nicht zur Wiedererkennung genutzt werden | Verhindert instabile oder automatisch generierte Merkmale als Grundlage |
Status
| Wert | Bedeutung |
|---|---|
| Aktiv | Die Regel wird angewendet |
| Inaktiv | Die Regel wird ignoriert, bleibt aber gespeichert |
Häufige Fragen
Wofür brauche ich diese Regeln überhaupt?
Sie sorgen dafür, dass Hinweise und Guide-Schritte zuverlässig am richtigen Element im Shop erscheinen, auch wenn sich das Erscheinungsbild der Seite später leicht ändert.
Was passiert, wenn ich eine Regel lösche?
Sie wird endgültig entfernt. Wenn Sie eine Regel nur vorübergehend abschalten möchten, deaktivieren Sie sie stattdessen.
Was bedeutet die Priorität genau?
Wenn mehrere Regeln zutreffen könnten, wird zuerst die Regel mit der höheren Priorität berücksichtigt.
Muss ich das Muster-Feld ausfüllen?
Nein, es ist optional. Ohne Muster gilt die Regel für das gesamte angegebene Merkmal.