Merkmale sind die Eigenschaften, die deine Kunden im Konfigurator festlegen – Farbe, Breite, Material, Antrieb. Bei einem diskreten Merkmal wählen sie aus festen Werten (z. B. Weiß, Anthrazit, RAL 7016), bei einer freien Eingabe tippen sie selbst etwas ein (z. B. 1200 mm). Dazu kommen Merkmale, die selbst rechnen oder Inhalte zeigen. Dieser Artikel erklärt alle Datentypen, alle Einstellungen eines Merkmals und eines Werts und wie du viele Werte auf einmal per CSV pflegst.
Merkmal anlegen
- Öffne die Komponente. Links im Reiter Merkmale siehst du den Strukturbaum mit Gruppen und Merkmalen.
- Gibt es noch keine Gruppe, klicke unten im Baum auf Gruppe hinzufügen. Merkmale liegen immer in einer Gruppe.
- Klicke an der Gruppe auf + (Merkmal hinzufügen). Es entsteht ein neues Merkmal vom Typ Auswahl und ist sofort ausgewählt.
- Stelle rechts unter Grundeinstellungen die Bezeichnung, den Internen Namen (ID), die Datenkategorie und den Datentyp ein.
- Bei diskreten Merkmalen legst du im Abschnitt Werte die Auswahlmöglichkeiten an.
Ein Klick auf ein Merkmal im Strukturbaum oder in der mittleren Spalte öffnet rechts seine Einstellungen. Ist nichts ausgewählt, steht dort „Merkmal in der Vorschau oder im Strukturbaum auswählen“.
Datenkategorien und Datentypen
Zuerst wählst du die Datenkategorie, dann innerhalb der Kategorie den Datentyp. Wechselst du die Kategorie, springt der Datentyp auf den ersten Typ, den dein Tarif erlaubt.
Diskretes Merkmal
Der Kunde wählt aus Werten, die du vorgibst.
| Datentyp | Darstellung | Typischer Einsatz |
|---|---|---|
| Auswahl | Dropdown, ein Wert | Farbe, Material – viele Werte, wenig Platz |
| Mehrfachauswahl | Liste, mehrere Werte gleichzeitig | Zubehör, das sich kombinieren lässt |
| Radio Buttons | Alle Werte sichtbar, ein Wert | Wenige Werte, die man auf einen Blick vergleichen soll |
| Checkbox | Alle Werte sichtbar, mehrere Werte gleichzeitig | Extras zum An- und Abwählen |
| Liste mit Bildern | Werte als Bilder (wahlweise mit Bezeichnung), ein Wert | Stoffe, Dekore, Formen |
| Mehrfachauswahl mit Mengen | Mehrere Werte, je Wert eine Menge | Stückzahlen pro Variante, z. B. Größen |
| Autovervollständigung | Suchfeld, das passende Werte vorschlägt; gewählt werden kann nur ein vorhandener Wert | Sehr lange Listen, z. B. Artikel- oder Typennummern |
Freie Eingabe
Der Kunde gibt selbst etwas ein.
| Datentyp | Darstellung | Typischer Einsatz |
|---|---|---|
| Kleines Eingabefeld | Einzeiliges Feld; mit Erlaubte Eingabe auf Zahlen, Text, E-Mail usw. eingeschränkt | Maße, Mengen, Gravurtext |
| Großes Eingabefeld | Mehrzeiliges Textfeld | Anmerkungen, längere Texte |
| Datum | Datumsfeld mit Kalender | Liefer- oder Wunschtermin |
Berechnung
Diese Merkmale füllt der Konfigurator selbst – der Kunde gibt nichts ein.
| Datentyp | Was es tut |
|---|---|
| Formel | Rechnet aus anderen Merkmalen ein Ergebnis, z. B. eine Fläche – siehe Formeln & Berechnungen |
| Preisliste | Liest einen Wert aus einer Tabelle, z. B. Breite × Höhe – siehe Preismatrizen aus Excel/CSV |
| Einfache Kombination | Verknüpft die Werte mehrerer Merkmale, z. B. als Summe, Produkt oder zusammengesetzter Text |
| Produktattribut | Übernimmt einen Wert vom Shop-Produkt, z. B. ein Gewicht |
| Webservice | Holt einen Wert von einer externen Adresse (URL) |
| Paket | Schalter, der eine vorgegebene Zusammenstellung von Werten in anderen Merkmalen auswählt |
Frontend
Inhalte und Aktionen ohne eigene Auswahl.
| Datentyp | Was es tut |
|---|---|
| Statisches Feld | Zeigt Text, Bilder oder Hinweise an deiner Stelle im Konfigurator |
| Dateiupload | Kunde lädt Dateien hoch, z. B. eine Druckvorlage |
| Diagramm | Zeigt ein Diagramm. Die Einstellungen dafür folgen in einer späteren Version. |
| Aktions-Button | Button für „Angebot anfordern“, PDF oder E-Mail – siehe Der Aktions-Button |
| Captcha (nur V3) | Schützt einen Aktions-Button mit E-Mail-Versand vor Spam |
Tarif und Frontend-Engine
- Webservice, Dateiupload, Diagramm und Paket gibt es nur im Tarif Ultimate. In kleineren Tarifen sind sie in der Liste mit 🔒 markiert, und unter den Einstellungen steht, welcher Tarif aktiv ist. Ein bereits vorhandenes Merkmal eines gesperrten Typs bleibt erhalten und bearbeitbar.
- Autovervollständigung und Datum mit Kalender funktionieren nur in der Frontend-Engine Legacy. In V3 erscheint die Autovervollständigung als normale Auswahlliste und das Datum als einfaches Textfeld.
- Captcha funktioniert nur in der Frontend-Engine V3.
Alle Unterschiede: Frontend-Engine: Legacy oder V3.
Die Einstellungen eines Merkmals
Rechts oben hat jedes Merkmal drei Reiter: Einstellungen, Referenziert in und Medien. Im Reiter Einstellungen stehen die Abschnitte – welche du siehst, hängt vom Datentyp ab.
Grundeinstellungen
| Feld | Bedeutung |
|---|---|
| Bezeichnung | Was deine Kunden sehen. Wird je Inhaltssprache gepflegt. |
| Interner Name (ID) | Eindeutiger Name, über den Formeln, Regeln, Kombinationen und Preislisten das Merkmal ansprechen, z. B. breite. Benennst du ihn um, ziehen die Verweise auf dieses Merkmal mit. |
| Datenkategorie | Diskretes Merkmal, Freie Eingabe, Berechnung oder Frontend |
| Datentyp | Konkrete Darstellung innerhalb der Kategorie (siehe oben) |
Verhalten
| Feld | Bedeutung |
|---|---|
| Pflichtfeld | Ja: Der Kunde muss etwas auswählen oder eingeben. Fehlt bei Typen, die der Kunde nicht selbst ausfüllt (z. B. Formel, Statisches Feld). |
| Sichtbarkeit | Ja (sichtbar): im Konfigurator und in der Zusammenfassung. Nein (versteckt): nirgends sichtbar, rechnet aber mit – typisch für Hilfsformeln und Preislisten. Nur Shop: im Konfigurator, aber nicht in der Zusammenfassung. Nur Backend: nicht im Konfigurator, aber in der Zusammenfassung und damit in der Bestellung. |
| Reihenfolge | Position innerhalb der Gruppe. Einfacher: Merkmal im Strukturbaum verschieben (siehe unten). |
| CSS-Klasse | Eigene CSS-Klasse für individuelles Styling |
Auswahl-Einstellungen (diskrete Merkmale)
| Feld | Bedeutung |
|---|---|
| Standardwert | Wert, der beim Öffnen des Konfigurators schon gewählt ist. kein Standardwert lässt das Merkmal leer. |
| Artikelnummer | Artikelnummer des Merkmals, z. B. für Stücklisten im Shop |
| Bildreihenfolge | Ebene im kombinierten Produktbild: Bilder mit höherer Zahl liegen über Bildern mit niedrigerer |
| Menge | Nur bei Auswahl, Radio Buttons, Checkbox, Liste mit Bildern und Mehrfachauswahl mit Mengen: Nein, Freie Eingabe oder Bereich. Bei Freie Eingabe und Bereich legst du Min. Menge und Max. Menge fest. Der Kunde sieht vor dem Wert ein Mengenfeld (bei Checkbox je angehaktem Wert), der Aufpreis wird mit der Menge multipliziert. |
| Tooltip für Werte aktivieren | Nur bei Radio Buttons und Checkbox: zeigt die Informationen eines Werts als Tooltip |
Kombination & Darstellung (diskrete Merkmale)
| Feld | Bedeutung |
|---|---|
| Kombination | Ja verknüpft dieses Merkmal mit anderen Merkmalen zu einem gemeinsamen Ergebnis. Dann erscheinen Kombinierte Werte, Wert-Operator (+, *, String, Formel), Preis-Operator und Dezimalstellen. |
| Preise für Wert aus Matrix | Ja holt die Aufpreise der Werte aus einer Preisliste, z. B. je nach Größe – siehe Preismatrizen aus Excel/CSV |
| Bilder für Werte | Ob die Bilder der Werte angezeigt werden: Ausblenden, Bei Auswahl oder – nur bei Radio Buttons und Checkbox – Immer |
| Darstellung | Nur bei Liste mit Bildern: Nur Bilder oder Bild mit Bezeichnung |
| Stil | Nur bei Liste mit Bildern: Inline, Einklappbar oder Overlay |
| Autovervollst. – Suche nach | Nur bei Autovervollständigung: Suche in Bezeichnung, Wert oder Beide |
| Autovervollst. – Eintrag-Template | Nur bei Autovervollständigung: wie ein Vorschlag angezeigt wird, z. B. {{label}} ({{value}}) |
Textfeld-Einstellungen (Kleines Eingabefeld, Datum)
Erlaubte Eingabe schränkt ein, was der Kunde eintippen darf: Keine Einschränkung, Zahl, Ganzzahl, Größer als 0, 0 oder größer, Buchstaben, Kleinbuchstaben, Großbuchstaben, Code (a-z, 0-9, _), Buchst., Ziffern, _, Buchstaben & Ziffern, Postleitzahl, Telefonnummer, E-Mail, URI, IBAN, BIC und Umsatzsteuer-ID.
| Feld | Bedeutung |
|---|---|
| Mindestwert, Höchstwert, Exakter Wert | Bei Zahlen: erlaubter Bereich bzw. genau ein erlaubter Wert. Bei Größer als 0 und 0 oder größer entfällt der Mindestwert. |
| Min. Zeichenlänge, Max. Zeichenlänge | Bei Buchstaben- und Code-Eingaben |
| Standardwert | Vorbelegung, je Inhaltssprache |
| Standardwert anzeigen als | Als Standardwert anzeigen (echter Inhalt, wird übernommen) oder Als Platzhalter anzeigen (grauer Hinweis, der beim Tippen verschwindet) |
Beim Datum gibt es stattdessen Vergangene Tage erlauben, Datum-Einschränkung (Alle Tage erlauben oder Wochentage deaktivieren mit Deaktivierte Wochentage) und als Standardwert Nächstmögliches Datum.
Das Große Eingabefeld hat im Abschnitt Textarea-Einstellungen Min. Zeichenlänge, Max. Zeichenlänge, Standardwert und Standardwert anzeigen als.
Einstellungen der übrigen Typen
| Datentyp | Abschnitt | Was du einstellst |
|---|---|---|
| Formel | Formel-Einstellungen, Staffelpreis | Berechnung (Formel), Dezimalstellen, Preis-Operator – siehe Formeln & Berechnungen und Preisberechnung einrichten |
| Preisliste | Matrix-Einstellungen, Matrixdaten, Staffelpreis | Siehe Preismatrizen aus Excel/CSV |
| Einfache Kombination | Kombinations-Einstellungen, Staffelpreis | Kombinierte Werte, Wert-Operator, Preis-Operator, Mindestwert, Höchstwert, Dezimalstellen |
| Produktattribut | Produktattribut-Einstellungen | Welches Produktattribut des Shop-Produkts übernommen wird |
| Webservice | Webservice-Einstellungen | Webservice-URL (feste Adresse, wird einmal beim Laden abgerufen – Platzhalter für Merkmalswerte gibt es nicht) und Rückgabe-Format (JSON mit JSPath oder XML mit XPath) |
| Dateiupload | Upload-Einstellungen | Erlaubte Dateitypen/-endungen, Max. Dateigröße (MB), Min. Dateien, Max. Dateien |
| Statisches Feld | Inhalt | Text mit Formatierung, Bildern und Links |
| Aktions-Button | Button-Einstellungen | Siehe Der Aktions-Button |
| Captcha (nur V3) | Captcha-Einstellungen | Captcha-Anbieter und Captcha-Komplexität (Einfach, Mittel (Standard), Stark) |
Bild, Informationen, Benutzerdefinierte Felder
- Bild: Ein Bild für das Merkmal selbst, z. B. eine Maßskizze neben dem Eingabefeld. Wo es erscheint, stellst du in den Komponenten-Einstellungen ein. Mehr: Bildvisualisierung & Bilder hochladen.
- Informationen und Zusätzliche Informationen: Hinweistexte zum Merkmal mit Formatierung, je Inhaltssprache.
- Benutzerdefinierte Felder: erscheinen nur, wenn du sie für die Komponente angelegt hast.
Werte anlegen und bearbeiten
Bei diskreten Merkmalen steht unten der Abschnitt Werte mit der Anzahl der Werte.
- + Wert legt einen neuen Wert an und öffnet ihn.
- + Gruppe legt eine Wertegruppe an – damit gliederst du lange Listen, z. B. Farben nach Farbfamilie. In einer Gruppe legst du Werte mit + Wert an der Gruppe an.
- Über das Suchfeld findest du Werte in langen Listen.
- Alle Werte und Gruppen löschen (Papierkorb) leert die Liste nach einer Rückfrage.
Ein Klick auf einen Wert öffnet seine Einstellungen; mit dem Pfeil oben links kommst du zurück zum Merkmal.
| Abschnitt | Feld | Bedeutung |
|---|---|---|
| Grundeinstellungen | Bezeichnung | Was der Kunde sieht, je Inhaltssprache, z. B. „Anthrazit“ |
| Wert | Interner Wert, z. B. anthrazit. Diesen Wert verwenden Regeln, Formeln und Preislisten – nicht die Bezeichnung. |
|
| Preis | Aufpreis, wenn der Kunde diesen Wert wählt, z. B. 15 |
|
| Artikelnummer | Optional, z. B. für Stücklisten im Shop | |
| Reihenfolge | Position in der Liste | |
| Vorschaubild | Kleines Bild neben dem Wert, mit Breite und Höhe in Pixeln | |
| Bild | Ebene für das kombinierte Produktbild, mit Versatz X/Y. Bei einer 360°-Ansicht heißt der Abschnitt 360°-Bilder. | |
| Informationen | Informationen, Zusätzliche Informationen | Hinweistexte zum Wert |
| Benutzerdefinierte Felder | Nur, wenn für die Komponente angelegt |
Wie Aufpreise im Konfigurator angezeigt werden (absolut oder relativ, mit welchem Preismuster), stellst du für die ganze Komponente ein – siehe Erste Komponente anlegen.
Werte importieren und exportieren
Bei vielen Werten pflegst du die Liste bequemer in Excel.
- Klicke auf ↓ Werte exportieren. Du bekommst eine CSV-Datei mit allen Werten. Haben Werte Bilder, bekommst du eine ZIP-Datei mit der CSV und den Bildern.
- Bearbeite die Datei und speichere sie wieder als CSV (bzw. packe sie mit den Bildern wieder als ZIP).
- Klicke auf ↑ Werte importieren und wähle die Datei.
- Wähle, wie die importierten Werte übernommen werden: Alte Werte löschen ersetzt die Liste, Werte zusammenfügen hängt die importierten Werte an die vorhandenen an.
- Prüfe das Ergebnis und speichere die Komponente.
Die CSV hat diese Spalten, getrennt durch Komma:
| Spalte | Inhalt |
|---|---|
type |
value für einen Wert, group für eine Wertegruppe |
group_id |
Nummer der Gruppe, zu der ein Wert gehört; 0 = keine Gruppe |
id |
Kennung des Werts – bei neuen Werten leer lassen |
alt_title |
Interner Name (nur bei Gruppen relevant) |
value |
Der interne Wert |
price |
Aufpreis |
sort_order |
Reihenfolge |
thumbnail_filelink, thumbnail_original, image_filelink, image_original |
Dateinamen von Vorschaubild und Bild (beim ZIP-Import) |
title_de_DE, title_en_US, … |
Bezeichnung je Sprache |
info_…, additional_info_… |
Informationen und Zusätzliche Informationen je Sprache |
Am einfachsten exportierst du zuerst ein Merkmal mit ein, zwei Werten und nimmst die Datei als Vorlage. Die Artikelnummer der Werte ist im Export nicht enthalten und muss nach einem Import von Hand gepflegt werden.
Werte aus Datenblättern oder Tabellen kann auch der KI-Assistent anlegen – siehe KI-Agent: Produktdaten importieren.
Reihenfolge ändern
Im Strukturbaum verschiebst du Merkmale per Drag & Drop – innerhalb einer Gruppe und auch in eine andere Gruppe. Gruppen lassen sich genauso verschieben. Die Reihenfolge im Baum ist die Reihenfolge im Konfigurator. Wie Gruppen angezeigt werden (ohne Gruppen, Tabs, Accordion, Wizard), erklärt Merkmalsgruppen & Wizard.
Referenziert in und Medien
- Referenziert in zeigt, wo das Merkmal verwendet wird – gegliedert nach Regeln, Formeln, Kombinationen und Preismatrizen. Ein Klick springt zur jeweiligen Stelle. Die Zahl am Reiter sagt, wie viele Verweise es gibt.
- Medien zeigt alle Bilder der Komponente auf einen Blick. Ein Klick öffnet das Merkmal, zu dem das Bild gehört.
Merkmal löschen
Ganz unten in den Einstellungen steht Merkmal löschen. Wird das Merkmal noch in Regeln, Formeln, Kombinationen oder Preislisten verwendet, listet die Rückfrage diese Stellen auf – die Verweise werden beim Löschen zurückgesetzt. Mit Ja, löschen bzw. Trotzdem löschen wird das Merkmal sofort und unwiderruflich gelöscht. Im Shop verschwindet es nach dem nächsten Veröffentlichen.
Einzelne Werte löschst du in der Werteliste. Auch hier warnt der Admin, wenn Regeln den Wert verwenden.
Fehlersuche
- Ich finde keinen Knopf für ein neues Merkmal – Merkmale brauchen eine Gruppe. Zuerst Gruppe hinzufügen, dann an der Gruppe +.
- Ein Datentyp ist nicht wählbar (🔒) – er gehört zum Tarif Ultimate.
- Eine Formel oder Regel findet das Merkmal nicht – sie verwenden den Internen Namen (ID), nicht die Bezeichnung. Prüfe die Schreibweise und schau unter Referenziert in, ob die Verbindung besteht.
- Eine Regel oder Preisliste greift bei einem Wert nicht – sie vergleicht den Wert, nicht die Bezeichnung. „Anthrazit“ mit dem Wert
ral7016muss in der Regel alsral7016stehen. - Das Merkmal fehlt im Konfigurator – prüfe die Sichtbarkeit (Nein (versteckt) und Nur Backend blenden es aus) und ob eine Regel es ausblendet.
- Autovervollständigung oder Datumskalender sieht im Shop anders aus – die Komponente läuft mit der Frontend-Engine V3, die beides nicht kennt. Siehe Frontend-Engine: Legacy oder V3.
- Der Import meldet „Die hochgeladene CSV-Datei enthält Fehler“ – die Datei muss Komma als Trennzeichen und die Spaltennamen der ersten Zeile haben. Exportiere ein Merkmal als Vorlage.
- Änderungen sind im Shop nicht zu sehen – speichern und veröffentlichen.