Transformationen

Transformationen ermöglichen die Umwandlung von Daten während des Imports. So können Sie Werte konvertieren, prüfen oder berechnen, bevor sie in Shopware gespeichert werden.

Was sind Transformationen?

Transformationen werden auf Quellfelder angewendet, bevor sie Zielfeldern zugeordnet werden.

Beispiel:

Quellwert: "Ja" (aus CSV)
Transformation: Wert-Mapping "Ja" → true
Zielwert: true (in Shopware als Boolean)

Transformations-Typen

1. Wert-Mapping

Konvertiert bestimmte Werte in andere Werte.

Verwendung:

Text → Boolean: "Ja" → true, "Nein" → false
Text → Zahl: "Aktiv" → 1, "Inaktiv" → 0
Einheiten: "Stk" → "Stück"

Konfiguration:

Quellwert: "Ja"  → Zielwert: true
Quellwert: "Nein" → Zielwert: false

2. Contains (Teilstring-Prüfung)

Prüft, ob ein Wert einen bestimmten Text enthält.

Verwendung:

Bedingte Aktivierung: Wenn name "Test" enthält → active: false
Kategorisierung: Wenn beschreibung "Premium" enthält → category: "premium"

Konfiguration:

Enthält: "Test"  → Ergebnis: false (nicht aktiv)
Sonst:           → Ergebnis: true (aktiv)

3. Regex (Reguläre Ausdrücke)

Verwendet reguläre Ausdrücke zur Mustererkennung und Umwandlung.

Verwendung:

Datums-Format: "01.01.2024" → "2024-01-01"
Zahlen extrahieren: "Preis: 19,99 €" → 19.99
Text bereinigen: Leerzeichen entfernen, Sonderzeichen ersetzen

Konfiguration:

Pattern: /(\d{2})\.(\d{2})\.(\d{4})/
Replacement: "$3-$2-$1"  // DD.MM.YYYY → YYYY-MM-DD

4. Switch (Bedingte Logik)

Mehrfache Bedingungen mit verschiedenen Ergebnissen.

Verwendung:

Komplexe Wert-Konvertierung: Verschiedene Eingaben → verschiedene Ausgaben
Fallunterscheidung: if X then Y else if Z then W

Konfiguration:

Wert = "A": → Ergebnis: "Premium"
Wert = "B": → Ergebnis: "Standard"
Sonst:      → Ergebnis: "Basic"

5. AI-generiert (KI-generierte Inhalte)

Verwendet KI, um Inhalte zu generieren oder zu erweitern.

Verwendung:

Beschreibungen: KI generiert Produktbeschreibungen aus kurzen Angaben
Übersetzungen: Automatische Übersetzung von Texten
SEO-Texte: KI-generierte Meta-Beschreibungen

Konfiguration:

Eingabe: Kurzbeschreibung (aus CSV)
Ausgabe: Vollständige Produktbeschreibung (KI-generiert)

Transformation hinzufügen

Schritt 1: Mapping-Editor öffnen

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

Schritt 2: Transformation erstellen

Klicken Sie auf "Transformation hinzufügen" neben einem Zielfeld
Wählen Sie den Transformations-Typ:
- Wert-Mapping
- Contains
- Regex
- Switch
- AI-generiert

Schritt 3: Transformation konfigurieren

Je nach Typ:

Wert-Mapping:

Fügen Sie Zuordnungspaare hinzu: Quellwert → Zielwert
Hinweis: Leerer Wert = nicht zugeordnet

Contains:

Geben Sie den zu suchenden Text ein
Definieren Sie das Ergebnis bei Treffer/keinem Treffer

Regex:

Geben Sie das Muster ein (z.B. /(\d+)/)
Definieren Sie den Ersatz (z.B. "$1")

Switch:

Fügen Sie Bedingungen hinzu
Definieren Sie Ergebnisse pro Bedingung

AI-generiert:

Beschreiben Sie die gewünschte Transformation (z.B. "Erweitere die Kurzbeschreibung zu einer vollständigen Produktbeschreibung")

Schritt 4: Speichern

Klicken Sie auf "Speichern" (in der Transformations-Konfiguration)
Die Transformation wird dem Mapping hinzugefügt
Speichern Sie das gesamte Mapping

Beispiele

Beispiel 1: Boolean-Konvertierung

Ziel: "Ja" / "Nein" → true / false

Transformation: Wert-Mapping

"Ja"   → true
"Nein" → false

Beispiel 2: Preisbereinigung

Ziel: "19,99 €" → 19.99

Transformation: Regex

Pattern: /(\d+),(\d+)\s*€/
Replacement: "$1.$2"

Beispiel 3: Bedingte Aktivierung

Ziel: Produkt aktiv, außer wenn Name "Test" enthält

Transformation: Contains

Enthält "Test": → false
Sonst:          → true

Beispiel 4: Einheiten-Konvertierung

Ziel: "Stk" → "Stück", "kg" → "Kilogramm"

Transformation: Wert-Mapping

"Stk" → "Stück"
"kg"  → "Kilogramm"
"m"   → "Meter"