Mapping

Das Mapping definiert, wie Daten aus Ihrer Import-Datei (Quellsystem) auf Shopware-Produktfelder zugeordnet werden.

Was ist Mapping?

Beim Mapping werden Quellfelder (aus der CSV des Quellsystems) auf Zielfelder (in Shopware) zugeordnet.

Beispiel:

• Quellfeld: z. B. Titel-1 (aus der Quell-CSV)
• Zielfeld: name (Shopware-Produktname)
• Ergebnis: Der Wert aus Titel-1 wird als Produktname in Shopware gespeichert

Übersicht

Das Mapping umfasst:

1. Feld-Zuordnungen: Welche CSV-Felder welchen Shopware-Feldern entsprechen
2. Transformationen: Optional: Daten umwandeln (z.B. Preis-Format, Einheiten)
3. Bild-Zuordnungen: Mehrere Bilder pro Produkt zuordnen
4. Optionen: Zusätzliche Einstellungen (Trennzeichen, Force-Upload)

Mapping-Editor

Der Mapping-Editor ist das zentrale Tool zur Konfiguration von Feld-Zuordnungen:

• Visual: Drag-and-Drop oder Dropdown-Auswahl
• Vorschau: Zeigt Beispielwerte aus der Import-Datei
• Validierung: Prüft, ob alle erforderlichen Felder zugeordnet sind

Zum Mapping-Editor →

Unterstützte Felder

Standard-Produktfelder

• name: Produktname
• productNumber: Artikelnummer (SKU)
• description: Beschreibung
• price: Preis (Brutto)
• stock: Lagerbestand
• weight: Gewicht
• active: Produkt aktivieren/deaktivieren
• ... und viele weitere

Bildfelder

• images: Mehrere Bilder (komma- oder doppelpunkt-separiert)
• image_1: Erstes Bild (Cover)
• image_2: Zweites Bild (Galerie)
• image_3: Drittes Bild (Galerie)

Mehr über Bilder →

Auto-Map (KI-gestützt)

Der Auto-Map verwendet KI, um automatisch passende Feld-Zuordnungen vorzuschlagen:

1. Analysiert die CSV-Überschriften (Header)
2. Vergleicht mit Standard-Shopware-Feldern
3. Vorschlägt automatische Zuordnungen
4. Sie können Vorschläge akzeptieren oder manuell anpassen

Mehr über Auto-Map →

Transformationen

Transformationen ermöglichen die Umwandlung von Daten während des Imports:

• Wert-Mapping: Konvertierung von Werten (z.B. "Ja" → true)
• Contains: Teilstring-Prüfung
• Regex: Reguläre Ausdrücke
• Switch: Bedingte Logik
• AI-generiert: KI-generierte Inhalte (z.B. Beschreibungen)

Mehr über Transformationen →

Mapping speichern

Nach der Konfiguration speichern Sie das Mapping:

1. Klicken Sie auf "Speichern" im Mapping-Editor
2. Das Mapping wird der Verbindung zugeordnet
3. Bei jedem Import wird dieses Mapping verwendet

Wichtig: Jede Verbindung hat genau ein Mapping pro Entity-Typ (z.B. product).

Mapping testen

Nach dem Speichern können Sie das Mapping testen:

1. Führen Sie einen Test-Import durch (Delta-Import mit wenigen Produkten)
2. Prüfen Sie die Ergebnisse in Shopware
3. Passen Sie das Mapping bei Bedarf an

Nächste Schritte

• Mapping-Editor nutzen
• Auto-Map verwenden
• Transformationen konfigurieren
• Bilder zuordnen