Zum Inhalt

Profile anlegen

Ein Profil ist die zentrale Konfigurationseinheit von Import Export Pro: Es bündelt Datei-Format, Quelle, Ziel, Feld-Mapping und Zeitplan zu einem wiederverwendbaren Workflow.

Ein neues Profil anlegen

  1. Im Admin Einstellungen → Kommora → Import Export Pro öffnen.
  2. Tab Profile wählen.
  3. Oben rechts Neues Profil.
  4. Die folgenden Felder ausfüllen (Schritt für Schritt unten).

Schritt 1: Allgemein

Feld Beschreibung
Name Beliebiger Anzeigename, z.B. „Lieferant ACME – täglicher Bestands-Import".
Beschreibung Optional, für Backoffice-Hinweise.
Profil aktiv Wenn deaktiviert, läuft der Cron-Plan nicht. Manuelle Auslösung weiter möglich.
Modus Import (Datei → Shopware) oder Export (Shopware → Datei).
Entity Was wird importiert/exportiert? Auswahl: product, product_variant, order, customer, category, manufacturer, media, custom_field_value.

Schritt 2: Datei

Feld Beschreibung
Dateiformat csv, xlsx oder xml.
Quelle / Ziel Dateipfad (relativ zum Import-/Export-Verzeichnis aus der globalen Konfig) oder absoluter Pfad.
Datei-Pattern Wildcard-Pattern für wechselnde Dateinamen, z.B. lieferant_acme_*.csv. Das Plugin nimmt die jüngste Datei.
Encoding (nur CSV) Standard aus globaler Konfig, kann übersteuert werden.
Trenner / Quote / Escape (nur CSV) Standard aus globaler Konfig.
Sheet-Name / Header-Zeile / Daten-ab-Zeile (nur XLSX) Workbook-spezifisch.
XPath für Datensätze (nur XML) z.B. /products/product oder //Article – pro Treffer ein Datensatz.
Namespace-Aliase (nur XML) Falls die Quelle Namespaces nutzt.
FTP-/SFTP-Anbindung

Das Plugin selbst zieht keine Dateien per FTP. Lass den Lieferanten per FTP/SFTP auf Dein var/import/-Verzeichnis schreiben (oder lass einen Cron-Sync laufen). Die Datei muss bei Job-Start einfach physisch vorliegen.

Schritt 3: Verhalten

Feld Default Beschreibung
Match-Strategie productNumber (bei Products) Wie ein bestehender Datensatz identifiziert wird: id, productNumber, ean, manufacturerNumber, oder eigene customField-Variante.
Modus bei Treffer update update: Vorhandenen Datensatz aktualisieren. skip: Treffer überspringen. replace: Komplett ersetzen.
Modus ohne Treffer create create: Neuen Datensatz anlegen. skip: Überspringen.
Validation-Mode strict strict: Bei Validierungsfehler Datensatz überspringen, Fehler ins Job-Log. loose: Fehler ignorieren, Datensatz trotzdem schreiben (nur für vertraute Quellen).
Dry-Run aus Wenn aktiv, werden keine DB-Schreibvorgänge ausgeführt – nur die Validierung läuft. Ideal für erste Tests.

Schritt 4: Mapping

Das Mapping ist visuell – siehe eigene Seite: Feld-Mapping.

Schritt 5: Zeitplan

Feld Beschreibung
Cron-Plan Cron-Ausdruck wie 0 2 * * * (täglich 02:00). Leer = nur manuell.
Zeitzone Default: Shop-Zeitzone aus Shopware.
Maximale Laufzeit Sekunden. Überschreibt den globalen Default aus der Plugin-Konfig.
Cron-Hilfe
Ausdruck Bedeutung
0 2 * * * täglich um 02:00
*/15 * * * * alle 15 Minuten
0 0 * * 0 sonntags um Mitternacht
0 23 1 * * am 1. jedes Monats um 23:00

Speichern und testen

  1. Speichern oben rechts.
  2. Test-Lauf manuell starten über den Button „Jetzt ausführen" in der Profil-Liste.
  3. Job-Log öffnen und prüfen:
    • Status: success, partial oder failed?
    • Anzahl Datensätze: gelesen / verarbeitet / Fehler?
    • Fehlerdetails bei einzelnen Datensätzen.
  4. Wenn alles passt: „Profil aktiv" auf ein und Cron-Plan greifen lassen.

Profil duplizieren

Im Profil-Listen-Kontextmenü auf „Duplizieren" klicken – kopiert alle Felder inklusive Mapping. Nützlich für ähnliche Lieferanten oder Test-/Production-Varianten.

Profil exportieren / importieren

Über den Button „Profil als JSON exportieren" lässt sich ein Profil samt Mapping als JSON-Datei speichern. Auf einer anderen Shopware-Instanz kann es über „Profil aus JSON importieren" wieder eingelesen werden. Praktisch für Stage→Production-Sync oder Backup.

Weiter