Praktische Beispiele (CLI)

Vorbereitung: Pfade finden

Öffnen Sie den Windows Explorer, navigieren Sie zum Installationsordner des Tools, halten Sie die Shift-Taste gedrückt, klicken Sie mit der rechten Maustaste auf die Datei csv-mapping-tool-cli.exe und wählen Sie „Als Pfad kopieren“. So erhalten Sie den vollständigen Pfad zur ausführbaren Datei.

Beispiel 1: Manuelle Konvertierung über die Kommandozeile

Dies ist der einfachste Anwendungsfall. Sie öffnen die Windows-Eingabeaufforderung (cmd.exe) und fügen den Befehl direkt ein.

"C:\Programme\CSV Mapping Tool\csv-mapping-tool-cli.exe" --project "D:\Shop-Daten\Projekte\Lieferant_A.json" --output "D:\Shop-Daten\Import\gambio_import.csv"

• Ergebnis: Das CLI-Modul startet, verarbeitet alle im Projekt Lieferant_A.json definierten Quellen und Regeln und speichert das Ergebnis in der Datei gambio_import.csv.

Beispiel 2: Automatisierung mit einer Windows Batch-Datei (.bat)

Ideal, um einen wiederkehrenden Prozess per Doppelklick zu starten.

1. Öffnen Sie einen Texteditor (z.B. Notepad).
2. Fügen Sie den Befehl aus Beispiel 1 in die leere Datei ein.
3. Speichern Sie die Datei unter einem aussagekräftigen Namen mit der Endung .bat, z.B. Lagerbestands-Update.bat.

Inhalt der Lagerbestands-Update.bat:

@echo off
echo Starte CSV-Konvertierung...
"C:\Programme\CSV Mapping Tool\csv-mapping-tool-cli.exe" --project "D:\Shop-Daten\Projekte\Lieferant_A.json" --output "D:\Shop-Daten\Import\gambio_import.csv"
echo Konvertierung abgeschlossen.
pause

• Ergebnis: Wenn Sie diese .bat-Datei nun doppelt anklicken, wird der Befehl automatisch ausgeführt. pause sorgt dafür, dass sich das Fenster am Ende nicht sofort schließt, sodass Sie eventuelle Fehlermeldungen sehen können.

Beispiel 3: Tägliche Automatisierung mit der Windows-Aufgabenplanung

Dies ist der häufigste Anwendungsfall für die vollständige Automatisierung (z.B. für tägliche Lagerbestands-Updates).

1. Erstellen Sie eine Batch-Datei wie in Beispiel 2 (jedoch ohne die pause-Zeile).
2. Öffnen Sie die Aufgabenplanung (suchen Sie im Startmenü danach).
3. Klicken Sie rechts auf „Einfache Aufgabe erstellen…“.
4. Name: Geben Sie einen Namen ein, z.B. „Tägliches CSV-Mapping“.
5. Trigger: Wählen Sie, wie oft die Aufgabe ausgeführt werden soll, z.B. „Täglich“, und legen Sie eine Uhrzeit fest (z.B. 03:00 Uhr nachts).
6. Aktion: Wählen Sie „Programm starten“.
7. Programm/Skript: Klicken Sie auf „Durchsuchen…“ und wählen Sie Ihre .bat-Datei (z.B. Lagerbestands-Update.bat) aus.
8. Schließen Sie den Assistenten ab.

• Ergebnis: Windows führt nun jeden Tag zur festgelegten Zeit Ihr Skript automatisch aus. Das Mapping-Tool verarbeitet die Daten im Hintergrund, ohne dass Sie eingreifen müssen.

Beispiel 4: Verwendung in einem Shell-Skript (Linux/macOS)

Das Prinzip ist identisch, nur die Syntax des Skripts ist anders.

1. Erstellen Sie eine Datei, z.B. run_mapping.sh.
2. Fügen Sie folgenden Inhalt hinzu (passen Sie die Pfade an):

#!/bin/bash
echo "Starte CSV-Konvertierung..."

# Pfad zur ausführbaren Datei (Beispiel für macOS)
CLI_TOOL="/Applications/CSVMappingTool.app/Contents/MacOS/csv-mapping-tool-cli"
PROJECT_FILE="/Users/IhrName/Dokumente/Projekte/Lieferant_A.json"
OUTPUT_FILE="/Users/IhrName/Dokumente/Import/gambio_import.csv"

"$CLI_TOOL" --project "$PROJECT_FILE" --output "$OUTPUT_FILE"

echo "Konvertierung abgeschlossen."

3. Machen Sie das Skript ausführbar: chmod +x run_mapping.sh.
4. Führen Sie es aus: ./run_mapping.sh.