Das Kommandozeilen-Modul (CLI)

Zielgruppe: Power-User, Entwickler, Agenturen und alle, die wiederkehrende Import-Aufgaben vollständig automatisieren möchten.

Das Kommandozeilen-Modul (CLI) ist eine separate Anwendung, die mit dem CSV Mapping-Tool ausgeliefert wird. Sie ermöglicht es Ihnen, den gesamten Konvertierungsprozess, den Sie in der grafischen Benutzeroberfläche (GUI) konfiguriert haben, über die Kommandozeile (z.B. cmd.exe unter Windows oder das Terminal unter macOS/Linux) auszuführen.

Der Hauptvorteil: Sie können den Prozess in Skripte, geplante Aufgaben (Cronjobs) oder andere Systeme (z.B. Warenwirtschaft, PIM) integrieren, um Ihre Datenimporte vollautomatisch und ohne manuelle Interaktion durchzuführen.

Wo finde ich das CLI-Modul?

Die ausführbare Datei csv-mapping-tool-cli.exe befindet sich im selben Verzeichnis, in dem Sie das Hauptprogramm (csv-mapping-tool-gui.exe) installiert haben. (Bekommen Sie von uns auf Nachfrage)

Voraussetzungen

Um das CLI-Modul zu nutzen, benötigen Sie ein gespeichertes Projekt (.json-Datei). Alle Regeln, Mappings und Quell-Konfigurationen, die Sie in der GUI erstellt und im Projekt gespeichert haben, werden vom CLI-Modul für die Konvertierung verwendet.

Aufbau eines Befehls

Ein typischer Befehl für das CLI-Modul besteht aus dem Programmnamen, gefolgt von mehreren Argumenten (Parametern).

Grundstruktur: csv-mapping-tool-cli.exe --project "Pfad\zum\Projekt.json" --output "Pfad\zur\Ausgabedatei.csv"

Die verfügbaren Argumente

• --project "Pfad\zur\Projektdatei.json"
  • (Erforderlich) Gibt den Pfad zu Ihrer Projektdatei an. Das CLI-Modul lädt diese Datei, um alle notwendigen Informationen über Ihre Quellen und Regeln zu erhalten.
  • Wichtig: Setzen Sie den Pfad in Anführungszeichen, besonders wenn er Leerzeichen enthält.
• --output "Pfad\zur\Ausgabedatei"
  • (Erforderlich) Gibt den Pfad und den Namen der zu erstellenden Ausgabedatei an.
  • Die Dateiendung bestimmt das Format:
    • .csv: Erstellt eine CSV-Datei.
    • .json: Erstellt eine JSON-Datei.
    • .xml: Erstellt eine XML-Datei.
• --no-validation
  • (Optional) Deaktiviert den „Daten-Inspektor“, der die Daten vor dem Export auf potenzielle Fehler (z.B. ungültige Preisformate) prüft. Die Verwendung dieses Parameters kann den Export beschleunigen, wird aber nicht empfohlen, wenn die Datenqualität unsicher ist.