892 lines
26 KiB
Plaintext
892 lines
26 KiB
Plaintext
# CSV-Processor v2.0 - Benutzerhandbuch
|
|
|
|
## Inhaltsverzeichnis
|
|
|
|
1. [Überblick](#überblick)
|
|
2. [Installation](#installation)
|
|
3. [Programmversionen](#programmversionen)
|
|
4. [CLI-Version: Schritt-für-Schritt](#cli-version)
|
|
5. [GUI-Version: Schritt-für-Schritt](#gui-version)
|
|
6. [Voreinstellungen nutzen](#voreinstellungen-nutzen)
|
|
7. [Mapping-Dateien erstellen](#mapping-dateien-erstellen)
|
|
8. [Häufige Anwendungsfälle](#häufige-anwendungsfälle)
|
|
9. [Tipps & Tricks](#tipps--tricks)
|
|
10. [Fehlerbehebung](#fehlerbehebung)
|
|
|
|
---
|
|
|
|
## Überblick
|
|
|
|
Der CSV-Processor ist ein professionelles Werkzeug zur Verarbeitung und Konvertierung von CSV- und Excel-Dateien. Er ermöglicht:
|
|
|
|
✅ **Import** von CSV, Excel (XLSX/XLS)
|
|
✅ **Export** als CSV, Excel (XLSX), OpenDocument (ODS)
|
|
✅ **Spaltennamen-Mapping** (z.B. "btr" → "Betrag")
|
|
✅ **Datenbereinigung** (leere Zeilen/Spalten entfernen)
|
|
✅ **Spaltenauswahl** (nur gewünschte Spalten exportieren)
|
|
✅ **Sortierung** nach beliebigen Spalten
|
|
✅ **Voreinstellungen** für wiederkehrende Aufgaben
|
|
|
|
---
|
|
|
|
## Installation
|
|
|
|
Das Programm wurde bereits auf Ihrem System installiert. Falls nicht, wenden Sie sich an die IT.
|
|
|
|
### Programme starten:
|
|
|
|
**CLI-Version (Terminal):**
|
|
```bash
|
|
csv-processor-cli
|
|
```
|
|
|
|
**GUI-Version (Grafisch):**
|
|
- Im Anwendungsmenü unter "Office" → "CSV-Processor"
|
|
- Oder im Terminal: `csv-processor-gui`
|
|
|
|
---
|
|
|
|
## Programmversionen
|
|
|
|
### CLI-Version (Terminal)
|
|
- **Für wen:** Fortgeschrittene Benutzer, Automatisierung
|
|
- **Vorteile:** Schnell, scriptfähig, volle Kontrolle
|
|
- **Start:** `csv-processor-cli`
|
|
|
|
### GUI-Version (Grafisch)
|
|
- **Für wen:** Alle Benutzer, besonders Einsteiger
|
|
- **Vorteile:** Intuitiv, visuelle Vorschau, einfache Bedienung
|
|
- **Start:** `csv-processor-gui` oder über Anwendungsmenü
|
|
|
|
**Empfehlung:** Für tägliche Arbeit die GUI-Version, für wiederkehrende Aufgaben mit Voreinstellungen beide geeignet.
|
|
|
|
---
|
|
|
|
## CLI-Version: Schritt-für-Schritt
|
|
|
|
### Programmstart
|
|
|
|
```bash
|
|
csv-processor-cli
|
|
```
|
|
|
|
Sie sehen das Hauptmenü:
|
|
```
|
|
╔═══════════════════════════════════════════════════════╗
|
|
║ CSV-PROCESSOR v2.0 - Dateiverarbeitung ║
|
|
╚═══════════════════════════════════════════════════════╝
|
|
|
|
Verfügbare Features:
|
|
Import: CSV, Excel (XLSX/XLS)
|
|
Export: CSV, Excel (XLSX), OpenDocument (ODS)
|
|
|
|
══════════════════════════════════════════════════════════
|
|
HAUPTMENÜ
|
|
══════════════════════════════════════════════════════════
|
|
1. Neue Datei verarbeiten
|
|
2. Voreinstellungen verwalten
|
|
0. Beenden
|
|
|
|
Ihre Wahl:
|
|
```
|
|
|
|
### Erste Verwendung (ohne Voreinstellung)
|
|
|
|
#### Schritt 1: Datei verarbeiten wählen
|
|
```
|
|
Ihre Wahl: 1
|
|
```
|
|
|
|
#### Schritt 2: Keine Voreinstellung
|
|
```
|
|
Möchten Sie eine Voreinstellung laden? [j/n]: n
|
|
```
|
|
|
|
#### Schritt 3: Quelldatei angeben
|
|
```
|
|
Pfad zur Quelldatei (CSV/XLSX/XLS/ODS): /home/benutzer/Downloads/daten.csv
|
|
```
|
|
|
|
**Bei CSV:** Sie sehen eine interaktive Konfiguration:
|
|
```
|
|
══════════════════════════════════════════════════════════
|
|
CSV-IMPORT KONFIGURATION
|
|
══════════════════════════════════════════════════════════
|
|
|
|
Datei: daten.csv
|
|
Erkanntes Encoding: utf-8
|
|
Erkannter Delimiter: Semikolon (;)
|
|
Erkanntes Quoting: MINIMAL
|
|
|
|
──────────────────────────────────────────────────────────
|
|
VORSCHAU DER ERSTEN ZEILEN:
|
|
──────────────────────────────────────────────────────────
|
|
|
|
Zeile 1:
|
|
Rohtext: Name;Betrag;Datum;Kategorie...
|
|
Geparst: 4 Felder
|
|
Feld 1: 'Name'
|
|
Feld 2: 'Betrag'
|
|
...
|
|
|
|
──────────────────────────────────────────────────────────
|
|
AKTUELLE EINSTELLUNGEN:
|
|
──────────────────────────────────────────────────────────
|
|
1. Encoding: utf-8
|
|
2. Delimiter: Semikolon (;)
|
|
3. Quoting: MINIMAL
|
|
|
|
0. ✓ Diese Einstellungen verwenden
|
|
──────────────────────────────────────────────────────────
|
|
|
|
Was möchten Sie ändern? [0-3]: 0
|
|
```
|
|
|
|
**Tipp:** Prüfen Sie die Vorschau! Wenn die Felder korrekt getrennt sind, drücken Sie `0`.
|
|
|
|
#### Schritt 4: Kopfzeile bestätigen
|
|
```
|
|
Hat die CSV-Datei eine Kopfzeile mit Spaltennamen? [j/n]: j
|
|
```
|
|
|
|
#### Schritt 5: Mapping anwenden (optional)
|
|
```
|
|
Möchten Sie Spaltennamen umbenennen? [j/n]: j
|
|
Pfad zur Mapping-JSON-Datei: /usr/share/csv-processor/mietermerkmale.json
|
|
✓ 5 Spaltennamen umbenannt
|
|
```
|
|
|
|
#### Schritt 6: Leere Zeilen
|
|
```
|
|
Sollen komplett leere Zeilen entfernt werden? [j/n]: j
|
|
✓ 3 leere Zeilen entfernt
|
|
```
|
|
|
|
#### Schritt 7: Unvollständige Zeilen (optional)
|
|
```
|
|
Möchten Sie Zeilen mit zu wenig Informationen analysieren/entfernen? [j/n]: n
|
|
```
|
|
|
|
#### Schritt 8: Leere Spalten
|
|
```
|
|
Sollen leere Spalten entfernt werden? [j/n]: j
|
|
✓ 2 leere Spalten entfernt
|
|
```
|
|
|
|
**Wichtig:** Leere Spalten werden VOR der Spaltenauswahl entfernt!
|
|
|
|
#### Schritt 9: Spaltenauswahl
|
|
|
|
Sie sehen eine Liste aller verfügbaren (nicht-leeren) Spalten:
|
|
|
|
```
|
|
══════════════════════════════════════════════════════════
|
|
SPALTENAUSWAHL
|
|
══════════════════════════════════════════════════════════
|
|
● = Angewählt | ○ = Abgewählt
|
|
──────────────────────────────────────────────────────────
|
|
● 1. btr → Betrag
|
|
● 2. dat → Datum
|
|
● 3. kto → Kontonummer
|
|
● 4. empf → Empfänger
|
|
● 5. verw → Verwendungszweck
|
|
──────────────────────────────────────────────────────────
|
|
Aktuell ausgewählt: 5 von 5 Spalten
|
|
══════════════════════════════════════════════════════════
|
|
|
|
Optionen:
|
|
[Nummern] - Spalten an/abwählen (z.B. '1,2,3' oder '1-5,10-15')
|
|
+ [Nummern] - Spalten ANwählen (z.B. '+1,2,3')
|
|
- [Nummern] - Spalten ABwählen (z.B. '-1,2,3')
|
|
alle - Alle Spalten anwählen
|
|
keine - Alle Spalten abwählen
|
|
q - Auswahl beenden und fortfahren
|
|
|
|
Ihre Wahl:
|
|
```
|
|
|
|
**Beispiele:**
|
|
- `3` - Spalte 3 umschalten (an→ab oder ab→an)
|
|
- `-3,5` - Spalten 3 und 5 ABwählen (rot)
|
|
- `+1-10` - Spalten 1 bis 10 ANwählen (grün)
|
|
- `1-5,10-15` - Spalten 1-5 und 10-15 umschalten
|
|
- `q` - Fertig
|
|
|
|
```
|
|
Ihre Wahl: -3
|
|
✓ 1 Spalte(n) abgewählt
|
|
|
|
Ihre Wahl: q
|
|
```
|
|
|
|
#### Schritt 10: Kopf-/Fußzeile (optional)
|
|
```
|
|
Möchten Sie eine Kopf- oder Fußzeile hinzufügen? [j/n]: j
|
|
Kopfzeile (Enter für keine): Export vom 19.10.2025
|
|
Fußzeile (Enter für keine): Erstellt mit CSV-Processor
|
|
```
|
|
|
|
#### Schritt 11: Sortierung (optional)
|
|
```
|
|
Möchten Sie die Daten sortieren? [j/n]: j
|
|
|
|
Verfügbare Spalten zum Sortieren:
|
|
1. Betrag
|
|
2. Datum
|
|
3. Empfänger
|
|
4. Verwendungszweck
|
|
|
|
Nummer der Spalte: 2
|
|
|
|
Datentyp für Sortierung:
|
|
1. Text (string)
|
|
2. Datum
|
|
3. Zeit
|
|
4. Dezimalzahl
|
|
|
|
Ihre Wahl [1-4]: 2
|
|
✓ Daten nach 'Datum' sortiert
|
|
```
|
|
|
|
#### Schritt 12: Ausgabeformat wählen
|
|
```
|
|
Verfügbare Ausgabeformate:
|
|
1. CSV
|
|
2. Excel (XLSX)
|
|
3. OpenDocument (ODS)
|
|
|
|
Ihre Wahl: 1
|
|
```
|
|
|
|
**Bei CSV-Export:**
|
|
```
|
|
CSV-EXPORT KONFIGURATION
|
|
|
|
Delimiter wählen:
|
|
1. Semikolon (;) - Standard für deutsche Excel-Versionen
|
|
2. Komma (,) - Internationaler Standard
|
|
3. Tab - Gut für Import in andere Programme
|
|
|
|
Ihre Wahl [1-3]: 1
|
|
|
|
Quoting (Anführungszeichen) wählen:
|
|
1. MINIMAL - Nur Felder mit Sonderzeichen (empfohlen)
|
|
2. ALLE - Alle Felder in Anführungszeichen
|
|
3. NICHT_NUMERISCH - Nur Text-Felder
|
|
4. KEINE - Keine Anführungszeichen
|
|
|
|
Ihre Wahl [1-4]: 1
|
|
```
|
|
|
|
#### Schritt 13: Zieldatei speichern
|
|
```
|
|
Name/Pfad der Zieldatei (ohne Endung): ausgabe
|
|
✓ CSV-Datei erfolgreich gespeichert: ausgabe.csv
|
|
```
|
|
|
|
#### Schritt 14: Als Voreinstellung speichern
|
|
```
|
|
Möchten Sie diese Einstellungen als Voreinstellung speichern? [j/n]: j
|
|
Name für die Voreinstellung: meine_standard_export
|
|
✓ Voreinstellung 'meine_standard_export' gespeichert.
|
|
```
|
|
|
|
**Fertig!** Sie sind zurück im Hauptmenü.
|
|
|
|
### Mit Voreinstellung arbeiten
|
|
|
|
Beim nächsten Mal:
|
|
|
|
```
|
|
Ihre Wahl: 1
|
|
|
|
Verfügbare Voreinstellungen:
|
|
1. meine_standard_export
|
|
2. mietermerkmale
|
|
|
|
Möchten Sie eine Voreinstellung laden? [j/n]: j
|
|
Nummer oder Name der Voreinstellung: 1
|
|
✓ Voreinstellung 'meine_standard_export' geladen.
|
|
```
|
|
|
|
Dann nur noch:
|
|
1. Quelldatei angeben
|
|
2. Zieldatei angeben
|
|
3. **Fertig!**
|
|
|
|
Alle anderen Schritte werden automatisch durchgeführt! 🚀
|
|
|
|
---
|
|
|
|
## GUI-Version: Schritt-für-Schritt
|
|
|
|
### Programmstart
|
|
|
|
```bash
|
|
csv-processor-gui
|
|
```
|
|
|
|
Oder über das Anwendungsmenü: **Office** → **CSV-Processor**
|
|
|
|
### Hauptfenster
|
|
|
|
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────┐
|
|
│ Datei Voreinstellungen Hilfe │
|
|
├─────────────────────────────────────────────────────────┤
|
|
│ ┌─ Quelldatei ────────────────────────────────────────┐ │
|
|
│ │ Datei: [________________] [Durchsuchen] [Laden] │ │
|
|
│ └─────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
│ ┌─ Verarbeitungseinstellungen ─────────────────────────┐│
|
|
│ │ ☑ Datei hat Kopfzeile ││
|
|
│ │ ☑ Leere Zeilen entfernen ││
|
|
│ │ ☑ Leere Spalten entfernen (vor Spaltenauswahl) ││
|
|
│ │ Mapping-Datei: [________________] [...] ││
|
|
│ │ Ausgabeformat: ⦿ CSV ○ Excel ○ ODS ││
|
|
│ └─────────────────────────────────────────────────────┘│
|
|
│ │
|
|
│ ┌─ Spaltenauswahl ─────────────────────────────────────┐│
|
|
│ │ [Alle auswählen] [Alle abwählen] [Auswahl umkehren] ││
|
|
│ │ ┌──────────────────────────────────────────────────┐││
|
|
│ │ │ ☑ btr → Betrag │││
|
|
│ │ │ ☑ dat → Datum │││
|
|
│ │ │ ☑ empf → Empfänger │││
|
|
│ │ │ ☐ alte_spalte (nicht gemappt) │││
|
|
│ │ └──────────────────────────────────────────────────┘││
|
|
│ └─────────────────────────────────────────────────────┘│
|
|
│ │
|
|
│ ┌─ Status ──────────────────────────────────────────────┐│
|
|
│ │ 12:34:56 - Datei geladen: 5 Spalten, 100 Zeilen ││
|
|
│ │ 12:34:57 - Leere Spalten entfernt: 2 ││
|
|
│ └─────────────────────────────────────────────────────┘│
|
|
│ │
|
|
│ [Vorschau] [Verarbeiten & Speichern] │
|
|
└─────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
### Schritt-für-Schritt Anleitung
|
|
|
|
#### 1. Datei laden
|
|
|
|
**Option A: Durchsuchen**
|
|
1. Klick auf **[Durchsuchen]**
|
|
2. Datei auswählen (CSV oder Excel)
|
|
3. **[Öffnen]** klicken
|
|
|
|
**Option B: Pfad eingeben**
|
|
1. Pfad ins Feld eingeben: `/home/benutzer/Downloads/daten.csv`
|
|
2. **[Laden]** klicken
|
|
|
|
**Ergebnis:**
|
|
```
|
|
Status:
|
|
12:34:56 - Lade Datei: daten.csv
|
|
12:34:56 - Erfolgreich geladen: 8 Spalten, 234 Zeilen
|
|
```
|
|
|
|
#### 2. Einstellungen prüfen
|
|
|
|
Alle wichtigen Einstellungen sind als Checkboxen verfügbar:
|
|
|
|
- **☑ Datei hat Kopfzeile** - Fast immer aktiviert
|
|
- **☑ Leere Zeilen entfernen** - Empfohlen
|
|
- **☑ Leere Spalten entfernen** - Empfohlen (passiert vor Spaltenauswahl!)
|
|
|
|
#### 3. Mapping-Datei wählen (optional)
|
|
|
|
1. Klick auf **[...]** neben "Mapping-Datei"
|
|
2. Datei auswählen (z.B. `mietermerkmale.json`)
|
|
3. **[Öffnen]**
|
|
4. Datei neu laden mit **[Laden]**
|
|
|
|
**Ergebnis:** Spaltennamen werden umbenannt, z.B.:
|
|
- `btr → Betrag`
|
|
- `dat → Datum`
|
|
|
|
#### 4. Spalten auswählen
|
|
|
|
Im Bereich "Spaltenauswahl" sehen Sie alle verfügbaren Spalten.
|
|
|
|
**Alle Spalten sind standardmäßig ausgewählt (☑).**
|
|
|
|
**Spalten abwählen:**
|
|
- Klick auf Spalte → wird abgewählt (☐)
|
|
- Klick nochmal → wird wieder ausgewählt (☑)
|
|
|
|
**Schnellaktionen:**
|
|
- **[Alle auswählen]** - Alle Spalten auf ☑
|
|
- **[Alle abwählen]** - Alle Spalten auf ☐
|
|
- **[Auswahl umkehren]** - ☑↔☐
|
|
|
|
**Mehrfachauswahl:**
|
|
- **Strg + Klick** - Mehrere Spalten einzeln auswählen
|
|
- **Shift + Klick** - Bereich auswählen
|
|
|
|
**Wichtig:** Nur grüne Spalten (☑) werden exportiert. Zusätzlich werden leere Spalten automatisch übersprungen!
|
|
|
|
#### 5. Vorschau (optional)
|
|
|
|
Klick auf **[Vorschau]** um die verarbeiteten Daten zu sehen:
|
|
|
|
```
|
|
┌─ Datenvorschau ──────────────────────────────────────┐
|
|
│ Betrag │ Datum │ Empfänger │ Verwendung │
|
|
├───────────┼────────────┼──────────────┼─────────────┤
|
|
│ 150.50 │ 01.10.2025 │ Müller GmbH │ Miete │
|
|
│ 75.00 │ 03.10.2025 │ Stadtwerke │ Strom │
|
|
│ ... │ ... │ ... │ ... │
|
|
└──────────────────────────────────────────────────────┘
|
|
Zeige erste 100 von 234 Zeilen
|
|
[Schließen]
|
|
```
|
|
|
|
#### 6. Verarbeiten & Speichern
|
|
|
|
Klick auf **[Verarbeiten & Speichern]**
|
|
|
|
1. Dateiname eingeben: `ausgabe`
|
|
2. Speicherort wählen
|
|
3. **[Speichern]**
|
|
|
|
**Status-Meldungen:**
|
|
```
|
|
12:45:10 - Leere Zeilen entfernt: 3
|
|
12:45:10 - Leere Spalten entfernt: 2
|
|
12:45:10 - - alte_spalte1 (leer)
|
|
12:45:10 - - temp_field (leer)
|
|
12:45:11 - Übersprungene Spalten (leer): 1
|
|
12:45:11 - Abgewählte Spalten (rot): 2
|
|
12:45:11 - Finale Verarbeitung: 5 Spalten, 231 Zeilen
|
|
12:45:12 - Datei gespeichert: ausgabe.csv
|
|
```
|
|
|
|
**Erfolgsmeldung:**
|
|
```
|
|
┌─ Erfolg ─────────────────────────────────┐
|
|
│ │
|
|
│ Datei erfolgreich gespeichert: │
|
|
│ /home/benutzer/Documents/ausgabe.csv │
|
|
│ │
|
|
│ [OK] │
|
|
└───────────────────────────────────────────┘
|
|
```
|
|
|
|
#### 7. Voreinstellung speichern
|
|
|
|
**Menü** → **Voreinstellungen** → **Speichern**
|
|
|
|
```
|
|
┌─ Voreinstellung speichern ──────────────┐
|
|
│ Name der Voreinstellung: │
|
|
│ [meine_export_einstellung_________] │
|
|
│ │
|
|
│ [OK] [Abbrechen] │
|
|
└──────────────────────────────────────────┘
|
|
```
|
|
|
|
Name eingeben → **[OK]**
|
|
|
|
```
|
|
Status:
|
|
12:50:00 - Voreinstellung gespeichert: meine_export_einstellung
|
|
```
|
|
|
|
### Voreinstellung laden
|
|
|
|
**Menü** → **Voreinstellungen** → **Laden**
|
|
|
|
```
|
|
┌─ Voreinstellung laden ──────────────────┐
|
|
│ Voreinstellung auswählen: │
|
|
│ ┌─────────────────────────────────────┐ │
|
|
│ │ meine_export_einstellung │ │
|
|
│ │ mietermerkmale │ │
|
|
│ │ │ │
|
|
│ └─────────────────────────────────────┘ │
|
|
│ [OK] [Abbrechen] │
|
|
└──────────────────────────────────────────┘
|
|
```
|
|
|
|
Voreinstellung auswählen → **[OK]**
|
|
|
|
**Alle Einstellungen werden automatisch geladen!**
|
|
|
|
---
|
|
|
|
## Voreinstellungen nutzen
|
|
|
|
### Was wird gespeichert?
|
|
|
|
Eine Voreinstellung enthält:
|
|
- ☑ Kopfzeile ja/nein
|
|
- ☑ Leere Zeilen entfernen
|
|
- ☑ Leere Spalten entfernen
|
|
- 📄 Pfad zur Mapping-Datei
|
|
- 📊 Spaltenauswahl
|
|
- 💾 Ausgabeformat (CSV/Excel/ODS)
|
|
- 🔧 CSV-Export-Einstellungen (Delimiter, Quoting)
|
|
- 📏 Sortierung (Spalte & Datentyp)
|
|
|
|
### Wann sind Voreinstellungen sinnvoll?
|
|
|
|
✅ **Monatliche Berichte** - Immer gleiche Verarbeitung
|
|
✅ **Standard-Exporte** - Wiederkehrende Aufgaben
|
|
✅ **Team-Workflows** - Einheitliche Formate
|
|
✅ **Verschiedene Datenquellen** - Unterschiedliche Mappings
|
|
|
|
### Voreinstellung bearbeiten (nur CLI)
|
|
|
|
**Hauptmenü** → **2** (Voreinstellungen verwalten)
|
|
|
|
```
|
|
╔═══════════════════════════════════════════════════════╗
|
|
║ VOREINSTELLUNGEN VERWALTEN ║
|
|
╚═══════════════════════════════════════════════════════╝
|
|
|
|
Verfügbare Voreinstellungen:
|
|
1. meine_export_einstellung
|
|
2. mietermerkmale
|
|
|
|
Optionen:
|
|
1. Voreinstellung bearbeiten
|
|
2. Voreinstellung löschen
|
|
0. Zurück zum Hauptmenü
|
|
|
|
Ihre Wahl: 1
|
|
```
|
|
|
|
**Voreinstellung bearbeiten:**
|
|
1. Voreinstellung auswählen
|
|
2. Alle Schritte durchgehen (mit aktuellen Werten vorausgefüllt)
|
|
3. Bei Schritt 6 (Spaltenauswahl): Beispieldatei laden
|
|
4. Spalten wie gewohnt aus-/abwählen
|
|
5. Am Ende: Überschreiben oder neu speichern
|
|
|
|
---
|
|
|
|
## Mapping-Dateien erstellen
|
|
|
|
### Was ist ein Mapping?
|
|
|
|
Ein Mapping übersetzt technische Spaltennamen in lesbare Namen:
|
|
|
|
```
|
|
"btr" → "Betrag"
|
|
"dat" → "Datum"
|
|
"empf" → "Empfänger"
|
|
```
|
|
|
|
### Format
|
|
|
|
Mapping-Dateien sind JSON-Dateien:
|
|
|
|
```json
|
|
{
|
|
"btr": "Betrag",
|
|
"dat": "Datum",
|
|
"kto": "Kontonummer",
|
|
"blz": "Bankleitzahl",
|
|
"empf": "Empfänger",
|
|
"verw": "Verwendungszweck"
|
|
}
|
|
```
|
|
|
|
### Eigenes Mapping erstellen
|
|
|
|
1. Texteditor öffnen (z.B. `nano`, `gedit`)
|
|
2. JSON-Format verwenden (siehe oben)
|
|
3. Als `.json` speichern (z.B. `mein_mapping.json`)
|
|
|
|
**Beispiel:**
|
|
```bash
|
|
nano ~/Dokumente/bank_mapping.json
|
|
```
|
|
|
|
Inhalt:
|
|
```json
|
|
{
|
|
"alt1": "Neuer Name 1",
|
|
"alt2": "Neuer Name 2",
|
|
"xyz": "Beschreibung XYZ"
|
|
}
|
|
```
|
|
|
|
Speichern: **Strg+O**, **Enter**, **Strg+X**
|
|
|
|
### Mitgeliefertes Mapping
|
|
|
|
Das System enthält bereits: `/usr/share/csv-processor/mietermerkmale.json`
|
|
|
|
Dieses können Sie als Vorlage verwenden oder direkt nutzen.
|
|
|
|
---
|
|
|
|
## Häufige Anwendungsfälle
|
|
|
|
### 1. Monatlicher Export aus Buchhaltung
|
|
|
|
**Situation:** Jeden Monat CSV-Export aus Buchhaltungssoftware → Excel-Datei für Chef
|
|
|
|
**Lösung:**
|
|
1. **Einmalig:** Voreinstellung "Buchhaltung_Export" erstellen
|
|
- Mapping: Spaltennamen übersetzen
|
|
- Spalten: Nur relevante auswählen
|
|
- Format: Excel
|
|
- Sortierung: Nach Datum
|
|
|
|
2. **Jeden Monat:**
|
|
- Programm starten
|
|
- Voreinstellung laden
|
|
- Neue CSV-Datei angeben
|
|
- Ausgabename: `Bericht_Oktober_2025.xlsx`
|
|
- **Fertig in 30 Sekunden!**
|
|
|
|
### 2. Daten für verschiedene Abteilungen
|
|
|
|
**Situation:** Gleiche Quelldaten, aber unterschiedliche Spalten für verschiedene Teams
|
|
|
|
**Lösung:**
|
|
- Voreinstellung "Export_Vertrieb" - Nur Vertriebsspalten
|
|
- Voreinstellung "Export_Buchhaltung" - Nur Finanzspalten
|
|
- Voreinstellung "Export_Geschäftsführung" - Übersicht
|
|
|
|
### 3. Excel zu CSV konvertieren
|
|
|
|
**Situation:** Excel-Datei von Kunde → Eigenes System braucht CSV
|
|
|
|
**Lösung (GUI):**
|
|
1. Excel-Datei laden
|
|
2. Alle Einstellungen auf Standard lassen
|
|
3. Ausgabeformat: CSV
|
|
4. Delimiter: Semikolon
|
|
5. Speichern
|
|
|
|
### 4. CSV bereinigen
|
|
|
|
**Situation:** CSV-Datei mit vielen leeren Zeilen/Spalten
|
|
|
|
**Lösung:**
|
|
1. Datei laden
|
|
2. ☑ Leere Zeilen entfernen
|
|
3. ☑ Leere Spalten entfernen
|
|
4. Alle Spalten ausgewählt lassen
|
|
5. Speichern
|
|
|
|
### 5. Spaltennamen vereinheitlichen
|
|
|
|
**Situation:** Verschiedene Systeme, unterschiedliche Spaltennamen, sollen gleich sein
|
|
|
|
**Lösung:**
|
|
1. Mapping-Datei erstellen mit allen Varianten:
|
|
```json
|
|
{
|
|
"btr": "Betrag",
|
|
"betrag": "Betrag",
|
|
"amount": "Betrag",
|
|
"sum": "Betrag"
|
|
}
|
|
```
|
|
2. Voreinstellung mit diesem Mapping
|
|
3. Auf alle Dateien anwenden
|
|
|
|
---
|
|
|
|
## Tipps & Tricks
|
|
|
|
### Performance
|
|
|
|
**Große Dateien (>10.000 Zeilen):**
|
|
- Verarbeitung kann 5-30 Sekunden dauern
|
|
- Bei Excel: Erstes Tabellenblatt ist schneller
|
|
- GUI: Status-Log beobachten
|
|
|
|
**Sehr große Dateien (>100.000 Zeilen):**
|
|
- CLI-Version ist etwas schneller
|
|
- Leere Spalten vorher entfernen spart Zeit
|
|
- Ggf. Datei vorher splitten
|
|
|
|
### Spaltenauswahl
|
|
|
|
**Trick: Schnell viele Spalten abwählen (CLI):**
|
|
```
|
|
Ihre Wahl: -10-50
|
|
```
|
|
Wählt Spalten 10 bis 50 ab (rot)
|
|
|
|
**Trick: Nur wenige Spalten behalten (GUI):**
|
|
1. **[Alle abwählen]**
|
|
2. **Strg+Klick** auf gewünschte Spalten
|
|
|
|
### Mappings
|
|
|
|
**Tipp:** Verwenden Sie sprechende Ziel-Namen:
|
|
- ✅ "Betrag in Euro"
|
|
- ✅ "Datum (Format: TT.MM.JJJJ)"
|
|
- ❌ "btr_eur"
|
|
|
|
**Tipp:** Ein Mapping pro Datenquelle:
|
|
- `system_a_mapping.json`
|
|
- `system_b_mapping.json`
|
|
- `kunde_xy_mapping.json`
|
|
|
|
### CSV-Export
|
|
|
|
**Für Excel (deutsche Version):**
|
|
- Delimiter: Semikolon
|
|
- Quoting: Minimal
|
|
|
|
**Für andere Software:**
|
|
- Delimiter: Komma oder Tab
|
|
- Quoting: Alle (sicherer)
|
|
|
|
**Für Datenbanken:**
|
|
- Delimiter: Tab
|
|
- Quoting: Minimal
|
|
- Keine Kopf-/Fußzeile
|
|
|
|
### Voreinstellungen
|
|
|
|
**Namenskonvention:**
|
|
```
|
|
[Zweck]_[Format]_[Besonderheit]
|
|
```
|
|
|
|
Beispiele:
|
|
- `Mietermerkmale_Excel_monatlich`
|
|
- `Buchhaltung_CSV_Vertrieb`
|
|
- `Datenbank_Import_Tab`
|
|
|
|
### Datensicherheit
|
|
|
|
✅ **Original-Dateien bleiben unverändert**
|
|
✅ **Keine Daten werden ins Internet gesendet**
|
|
✅ **Voreinstellungen enthalten keine Daten, nur Konfiguration**
|
|
|
|
---
|
|
|
|
## Fehlerbehebung
|
|
|
|
### "Datei nicht gefunden"
|
|
|
|
**Problem:** Pfad falsch oder Datei existiert nicht
|
|
|
|
**Lösung:**
|
|
- Pfad nochmal prüfen
|
|
- In GUI: **[Durchsuchen]** verwenden
|
|
- Tippfehler korrigieren
|
|
- Bei Netzlaufwerken: Verbindung prüfen
|
|
|
|
### "Fehler beim Lesen der CSV"
|
|
|
|
**Problem:** Encoding oder Format nicht erkannt
|
|
|
|
**Lösung (CLI):**
|
|
- Im Import-Dialog verschiedene Encodings probieren
|
|
- Delimiter manuell wählen
|
|
|
|
**Lösung (GUI):**
|
|
- Datei in Excel öffnen
|
|
- Als CSV mit UTF-8 speichern
|
|
- Erneut laden
|
|
|
|
### "Keine Spalten ausgewählt"
|
|
|
|
**Problem:** Alle Spalten abgewählt oder alle leer
|
|
|
|
**Lösung:**
|
|
- Prüfen ob Spalten grün (☑) sind
|
|
- Ggf. "Leere Spalten entfernen" deaktivieren
|
|
- Quelldatei prüfen: Enthält sie Daten?
|
|
|
|
### "Excel-Support nicht verfügbar"
|
|
|
|
**Problem:** Bibliothek `openpyxl` fehlt
|
|
|
|
**Lösung:**
|
|
```bash
|
|
pip3 install openpyxl
|
|
```
|
|
|
|
Oder IT kontaktieren.
|
|
|
|
### "Programm reagiert nicht" (GUI)
|
|
|
|
**Problem:** Große Datei wird verarbeitet
|
|
|
|
**Lösung:**
|
|
- Warten (Status-Log beobachten)
|
|
- Bei >100.000 Zeilen: 1-2 Minuten normal
|
|
- Ggf. CLI-Version verwenden
|
|
|
|
### Voreinstellung lädt nicht alle Spalten
|
|
|
|
**Grund:** Gespeicherte Spalten sind in aktueller Datei leer oder nicht vorhanden
|
|
|
|
**Das ist normal!** Das Programm überspringt automatisch:
|
|
1. Leere Spalten (wenn "Leere Spalten entfernen" aktiv)
|
|
2. Nicht vorhandene Spalten
|
|
|
|
**Status-Meldung beachten:**
|
|
```
|
|
Übersprungene Spalten (leer oder nicht vorhanden): 3
|
|
- alte_spalte1
|
|
- leere_spalte2
|
|
- nicht_vorhanden
|
|
```
|
|
|
|
---
|
|
|
|
## Support
|
|
|
|
Bei Problemen oder Fragen:
|
|
|
|
1. **Diese Anleitung durchlesen** 📖
|
|
2. **Status-/Log-Meldungen beachten** 📋
|
|
3. **IT-Abteilung kontaktieren** 💻
|
|
|
|
---
|
|
|
|
## Schnellreferenz
|
|
|
|
### CLI-Befehle
|
|
|
|
| Aktion | Befehl |
|
|
|--------|--------|
|
|
| Programm starten | `csv-processor-cli` |
|
|
| Datei verarbeiten | Hauptmenü → `1` |
|
|
| Voreinstellungen | Hauptmenü → `2` |
|
|
| Beenden | Hauptmenü → `0` oder `Strg+C` |
|
|
|
|
### GUI-Shortcuts
|
|
|
|
| Aktion | Shortcut |
|
|
|--------|----------|
|
|
| Programm starten | `csv-processor-gui` |
|
|
| Datei öffnen | **Strg+O** |
|
|
| Speichern | **Strg+S** |
|
|
| Voreinstellung laden | **Strg+L** |
|
|
|
|
### Spaltenauswahl (CLI)
|
|
|
|
| Eingabe | Bedeutung |
|
|
|---------|-----------|
|
|
| `q` | Fertig |
|
|
| `alle` | Alle auswählen |
|
|
| `keine` | Alle abwählen |
|
|
| `3` | Spalte 3 umschalten |
|
|
| `1,2,3` | Spalten 1,2,3 umschalten |
|
|
| `+5` | Spalte 5 ANwählen |
|
|
| `-5` | Spalte 5 ABwählen |
|
|
| `1-10` | Spalten 1-10 umschalten |
|
|
| `+1-10` | Spalten 1-10 ANwählen |
|
|
| `-1-10` | Spalten 1-10 ABwählen |
|
|
|
|
---
|
|
|
|
**Version:** 2.0
|
|
**Stand:** Oktober 2025
|
|
**Erstellt für:** Interne Nutzung
|