AI Auto-Map

AI Auto-Map verwendet künstliche Intelligenz, um automatisch passende Feld-Zuordnungen zwischen Import-Dateien (Quellsystem) und Shopware-Produktfeldern vorzuschlagen.

Was ist Auto-Map?

Auto-Map analysiert die CSV-Überschriften (Header) Ihrer Import-Datei und schlägt automatisch passende Zuordnungen zu Shopware-Feldern vor.

Vorteile:

• ⚡ Schnell: Automatische Zuordnungen in Sekunden
• 🎯 Präzise: KI analysiert Feldnamen und Inhalte
• 🔧 Anpassbar: Vorschläge können manuell überarbeitet werden

Auto-Map verwenden

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: Auto-Map starten

1. Klicken Sie auf den Button "Auto-Map" (KI-Icon, Zauberstab)
2. Der Editor analysiert die CSV-Header
3. Automatische Zuordnungen werden erstellt

Schritt 3: Vorschläge prüfen

Nach dem Auto-Map sehen Sie:

• ✅ Automatisch zugeordnete Felder: Grün markiert
• ⚠️ Unklare Zuordnungen: Gelb markiert (manuelle Überprüfung empfohlen)
• ❌ Nicht zugeordnete Felder: Rot markiert (erfordern manuelle Zuordnung)

Schritt 4: Anpassen (optional)

1. Überprüfen Sie die automatischen Zuordnungen
2. Passen Sie bei Bedarf manuell an:
   • Falsche Zuordnungen korrigieren
   • Fehlende Zuordnungen ergänzen
   • Unerwünschte Zuordnungen entfernen

Schritt 5: Speichern

1. Klicken Sie auf "Speichern"
2. Das Mapping wird der Verbindung zugeordnet

Wie funktioniert Auto-Map?

Auto-Map verwendet folgende Strategien:

1. Feldname-Analyse: Vergleicht CSV-Header mit Standard-Shopware-Feldnamen

   • Titel-1 → name
   • Artikelnr → productNumber
   • Vk-Preis → price

2. Synonym-Erkennung: Erkennt alternative Bezeichnungen

   • Preis, Price, VK-Preis → price
   • Artikelnummer, SKU, EAN → productNumber

3. Inhalts-Analyse: Analysiert Beispielwerte aus der CSV

   • Zahlen → price, stock, weight
   • URLs → image_1, images
   • Lange Texte → description

Unterstützte Zuordnungen

Auto-Map erkennt typische Quellfelder (Beispiel HQS-Adapter):

Quellfeld (z. B. HQS)	Shopware-Feld	Erkannt
Artikelnr	productNumber	✅
Titel-1	name	✅
Vk-Preis	price	✅
MwSt	tax	✅
Bestand	stock	✅
Kurzbeschreibung	description	✅
BildName	image_1	✅
Artikelmultimediadateien	images	✅

Häufige Probleme

Problem: Auto-Map findet keine Zuordnungen

Ursachen:

• CSV-Header nicht im Standard-Format
• Unbekannte Feldnamen

Lösung:

• Manuelle Zuordnung über Dropdown oder Drag-and-Drop
• CSV-Header anpassen (falls möglich)

Problem: Falsche Zuordnungen

Ursachen:

• Mehrdeutige Feldnamen (z.B. "Preis" für verschiedene Preisarten)
• Ungewöhnliche Bezeichnungen

Lösung:

• Manuelle Korrektur der Zuordnungen
• Überprüfen Sie die Vorschau-Werte

Problem: Einige Felder werden nicht zugeordnet

Ursachen:

• Felder existieren nicht im Standard-Mapping
• Benutzerdefinierte Felder erfordern manuelle Zuordnung

Lösung:

• Manuelle Zuordnung ergänzen
• Transformationen für spezielle Fälle verwenden

Auto-Map vs. Manuelles Mapping

Auto-Map

Vorteile:

• ✅ Schnell: Automatisch in Sekunden
• ✅ Bequem: Weniger manuelle Arbeit
• ✅ KI-gestützt: Lernerfolg mit der Zeit

Nachteile:

• ⚠️ Nicht immer 100% korrekt
• ⚠️ Erfordert Überprüfung
• ⚠️ Bei ungewöhnlichen Feldern weniger zuverlässig

Manuelles Mapping

Vorteile:

• ✅ Vollständige Kontrolle
• ✅ 100% korrekt
• ✅ Flexibel für alle Fälle

Nachteile:

• ⚠️ Zeitaufwändig
• ⚠️ Erfordert Kenntnis der Feldnamen

Empfohlener Workflow

Optimaler Workflow:

1. Auto-Map starten: Automatische Basis-Zuordnungen erstellen
2. Vorschläge prüfen: Überprüfen Sie automatische Zuordnungen
3. Manuelle Anpassung: Korrigieren Sie Fehler und ergänzen Sie fehlende Zuordnungen
4. Testen: Führen Sie einen Test-Import durch
5. Finalisieren: Bei Bedarf weitere Anpassungen

Nächste Schritte

• Mapping-Editor nutzen
• Transformationen konfigurieren
• Bilder zuordnen