Mapping-Editor

Der Mapping-Editor ist das zentrale Tool zur Konfiguration von Feld-Zuordnungen zwischen Import-Dateien (Quellsystem) und Shopware-Produktfeldern.

Mapping-Editor öffnen

1. Navigieren Sie zu Verbindungen
2. Wählen Sie die gewünschte Verbindung aus
3. Klicken Sie auf "Mapping bearbeiten" oder das Mapping-Icon

Übersicht

Der Mapping-Editor zeigt:

• Linke Seite: Quellfelder (CSV-Header aus der Import-Datei)
• Rechte Seite: Zielfelder (Shopware-Produktfelder)
• Vorschau: Beispielwerte aus der ersten CSV-Zeile
• Transformationen: Optionale Datenumwandlungen

Feld-Zuordnungen erstellen

Methode 1: Dropdown-Auswahl

1. Klicken Sie auf ein Zielfeld (z.B. name)
2. Wählen Sie das entsprechende Quellfeld aus dem Dropdown (z.B. Titel-1)
3. Die Zuordnung wird automatisch gespeichert

Methode 2: Drag-and-Drop

1. Ziehen Sie ein Quellfeld auf das entsprechende Zielfeld
2. Die Zuordnung wird automatisch erstellt

Methode 3: Auto-Map

Verwenden Sie Auto-Map, um automatische Zuordnungen erstellen zu lassen:

1. Klicken Sie auf "Auto-Map" (KI-Icon)
2. Der Editor analysiert die CSV-Header
3. Vorschläge werden automatisch zugeordnet
4. Passen Sie bei Bedarf manuell an

Mehr über Auto-Map →

Erforderliche Felder

Folgende Felder sind erforderlich und müssen zugeordnet werden:

• ✅ name: Produktname
• ✅ productNumber: Artikelnummer (SKU)
• ✅ price: Preis (Brutto)

Alle anderen Felder sind optional.

Hinweis

Ohne die erforderlichen Felder kann der Import nicht durchgeführt werden.

Feld-Vorschau

Der Editor zeigt für jedes Quellfeld eine Vorschau mit Beispielwerten aus der Import-Datei:

Beispiel:

• Quellfeld: Titel-1
• Vorschau: "AP 0663-028 R/T Plate cream"
• Zielfeld: name

So sehen Sie sofort, welche Daten zugeordnet werden.

Transformationen hinzufügen

Für einige Felder können Sie Transformationen hinzufügen:

1. Klicken Sie auf "Transformation hinzufügen" neben einem Zielfeld
2. Wählen Sie den Transformations-Typ:
   • Wert-Mapping: Konvertierung von Werten
   • Contains: Teilstring-Prüfung
   • Regex: Reguläre Ausdrücke
   • Switch: Bedingte Logik
   • AI-generiert: KI-generierte Inhalte
3. Konfigurieren Sie die Transformation
4. Speichern Sie die Änderungen

Mehr über Transformationen →

Bilder zuordnen

Für Produktbilder können Sie folgende Felder zuordnen:

Einzelne Bilder:

• image_1: Erstes Bild (wird als Cover gesetzt)
• image_2: Zweites Bild (Galerie)
• image_3: Drittes Bild (Galerie)

Mehrere Bilder:

• images: Komma- oder doppelpunkt-separierte Liste (z.B. "123.jpg,456.jpg,789.jpg")

Mehr über Bild-Zuordnungen →

Optionen

Trennzeichen für Bilder

Konfigurieren Sie das Trennzeichen für mehrere Bilder:

• Standard: Komma (,)
• Alternativen: Doppelpunkt (:), Semikolon (;)

Beispiel:

• CSV: "JS4A17351.jpg:JS4A17352.jpg:JS4A17353.jpg"
• Trennzeichen: :
• Ergebnis: 3 Bilder werden zugeordnet

Mehr über Trennzeichen →

Force-Upload

Bilder immer neu hochladen (image_force):

• ✅ Aktiviert: Bilder werden immer neu hochgeladen (auch wenn unverändert)
• ❌ Deaktiviert: Bilder werden nur hochgeladen, wenn neuer als in Shopware

Mehr über Force-Upload →

Mapping speichern

Nach der Konfiguration:

1. Klicken Sie auf "Speichern" (oben rechts)
2. Das Mapping wird der Verbindung zugeordnet
3. Bei jedem Import wird dieses Mapping verwendet

Wichtig: Änderungen werden erst beim nächsten Import wirksam.

Mapping zurücksetzen

Falls Sie Änderungen rückgängig machen möchten:

1. Klicken Sie auf "Zurücksetzen"
2. Bestätigen Sie die Aktion
3. Das Mapping wird auf die Standard-Werte zurückgesetzt

Achtung

Beim Zurücksetzen gehen alle benutzerdefinierten Zuordnungen verloren.

Häufige Zuordnungen

Typische Zuordnungen für Import-Dateien (Beispiel HQS):

Quellfeld (z. B. HQS)	Zielfeld (Shopware)	Beschreibung
Artikelnr	productNumber	Artikelnummer (SKU)
Titel-1	name	Produktname
Vk-Preis	price	Verkaufspreis (Brutto)
MwSt	tax	Mehrwertsteuersatz
Bestand	stock	Lagerbestand
Kurzbeschreibung	description	Produktbeschreibung
BildName	image_1	Produktbild
Artikelmultimediadateien	images	Mehrere Bilder

Nächste Schritte

• Auto-Map verwenden
• Transformationen konfigurieren
• Bilder zuordnen