Bilder im Mapping zuordnen

Im Mapping-Editor können Sie CSV-Felder zu Bildfeldern in Shopware zuordnen.

Unterstützte Bildfelder

Shopware unterstützt folgende Bildfelder:

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

Bild-Zuordnungen erstellen

Schritt 1: Mapping-Editor öffnen

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

Schritt 2: Bildfelder zuordnen

Einzelbilder zuordnen

Beispiel: CSV-Feld BildName → image_1

1. Suchen Sie das Zielfeld image_1 (Cover)
2. Wählen Sie das Quellfeld BildName aus dem Dropdown
3. Die Zuordnung wird automatisch gespeichert

Ergebnis: Der Wert aus BildName (z.B. "12345.jpg") wird als erstes Bild (Cover) zugeordnet.

Mehrere Bilder zuordnen

Beispiel: CSV-Feld Artikelmultimediadateien → images

1. Suchen Sie das Zielfeld images
2. Wählen Sie das Quellfeld Artikelmultimediadateien aus dem Dropdown
3. Konfigurieren Sie das Trennzeichen (z.B. , oder :)

Ergebnis: Mehrere Bildnamen werden automatisch aufgeteilt und zugeordnet.

Mehr über Trennzeichen →

Schritt 3: Trennzeichen konfigurieren

Für das Feld images können Sie das Trennzeichen konfigurieren:

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

Beispiel:

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

Typische Zuordnungen

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

Quellfeld (z. B. HQS)	Zielfeld (Shopware)	Beschreibung
BildName	image_1	Erstes Bild (Cover)
Artikelmultimediadateien	images	Mehrere Bilder (komma/doppelpunkt-separiert)

Beispiel-CSV:

Artikelnr;BildName;Artikelmultimediadateien
12345;12345.jpg;12345_1.jpg,12345_2.jpg,12345_3.jpg

Zuordnungen:

• BildName → image_1 (Cover: 12345.jpg)
• Artikelmultimediadateien → images (Galerie: 12345_1.jpg, 12345_2.jpg, 12345_3.jpg)

Bild-Reihenfolge

Die Reihenfolge der Bilder:

1. image_1: Erstes Bild (Cover, Hauptbild)
2. image_2: Zweites Bild (Galerie, zweite Position)
3. image_3: Drittes Bild (Galerie, dritte Position)
4. images: Alle weiteren Bilder (Galerie, nach Position 3)

Empfehlung: Verwenden Sie image_1 für das Cover und images für die Galerie.

Fallback-Logik

Falls keine Bilder in den zugeordneten Feldern gefunden werden, versucht ReadySync automatisch:

1. SKU-basiert: ${SKU}.jpg (z.B. 12345.jpg)
2. Alternativen: ${SKU}.jpeg, ${SKU}.png

Beispiel:

• SKU: 12345
• Fallback: 12345.jpg wird automatisch versucht, wenn kein Bildname in der CSV vorhanden ist

Nächste Schritte

• Trennzeichen konfigurieren
• Bild-Upload-Optionen
• Mapping-Editor nutzen