Simplify finance dashboard overview

TrafagSalesExporter/docs/SAGE_SPAIN_RCLONE_UPLOAD_ANLEITUNG_2026-06-03.md

@@ -0,0 +1,258 @@
+# Sage Spanien Rclone Upload Anleitung
+
+Stand: 2026-06-03
+
+Ziel: Der Sage-Server in Spanien erzeugt die Sales-CSV lokal und lädt die Datei danach automatisch in den SharePoint-Ordner fuer den Dashboard-Import.
+
+## Zielordner
+
+SharePoint URL:
+
+```text
+https://trafagag.sharepoint.com/sites/WorldwideBIPlatform/Shared%20Documents/Import/Finance/Spanien
+```
+
+Technischer Ordner:
+
+```text
+Shared Documents/Import/Finance/Spanien
+```
+
+Empfohlener rclone-Zielpfad:
+
+```text
+trafag-bi:Import/Finance/Spanien
+```
+
+Dabei zeigt `trafag-bi` auf die Dokumentbibliothek `Shared Documents` der SharePoint-Site:
+
+```text
+https://trafagag.sharepoint.com/sites/WorldwideBIPlatform
+```
+
+## Benötigte Dateien Auf Dem Spanien-Server
+
+Empfohlener Ordner:
+
+```text
+C:\Trafag\SageSpain
+```
+
+Dateien:
+
+```text
+Export-SageSpainSalesCsv.ps1
+Run-SpainExportAndUpload.ps1
+```
+
+Die Dateien liegen im Paket:
+
+```text
+SageSpainFinalExportPackage.zip
+```
+
+## rclone Installieren
+
+Falls `winget` vorhanden ist:
+
+```powershell
+winget install Rclone.Rclone
+```
+
+Alternativ rclone ZIP manuell installieren, z.B. nach:
+
+```text
+C:\Tools\rclone\rclone.exe
+```
+
+Danach testen:
+
+```powershell
+rclone version
+```
+
+Falls `rclone` nicht im PATH ist, später den vollständigen Pfad verwenden:
+
+```powershell
+C:\Tools\rclone\rclone.exe version
+```
+
+## rclone Remote Einrichten
+
+Auf dem Spanien-Server:
+
+```powershell
+rclone config
+```
+
+Empfohlene Eingaben:
+
+```text
+n
+name> trafag-bi
+Storage> onedrive
+```
+
+Danach Microsoft Login durchführen.
+
+Wichtig:
+
+- Site: `WorldwideBIPlatform`
+- Dokumentbibliothek: `Shared Documents`
+- Der rclone-Remote `trafag-bi` soll auf die Dokumentbibliothek `Shared Documents` zeigen.
+
+## rclone Testen
+
+```powershell
+rclone lsd trafag-bi:
+rclone lsd trafag-bi:"Import"
+rclone lsd trafag-bi:"Import/Finance"
+rclone lsd trafag-bi:"Import/Finance/Spanien"
+```
+
+Wenn der letzte Befehl den Ordner ohne Fehler zeigt, ist der Zielpfad korrekt.
+
+## Manueller Export Ohne Upload
+
+Full Export 2025:
+
+```powershell
+Set-ExecutionPolicy -Scope Process Bypass
+cd C:\Trafag\SageSpain
+.\Export-SageSpainSalesCsv.ps1 -ExportMode Full -Year 2025 -OutputDirectory C:\Trafag\SageSpain\out
+```
+
+Delta/Range Export:
+
+```powershell
+Set-ExecutionPolicy -Scope Process Bypass
+cd C:\Trafag\SageSpain
+.\Export-SageSpainSalesCsv.ps1 -ExportMode Range -DateFilter LineRegistrationDate -FromDate "2026-06-02" -ToDate "2026-06-03" -OutputDirectory C:\Trafag\SageSpain\out
+```
+
+Hinweis:
+
+- `ToDate` ist exklusiv.
+- Der Zeitraum `"2026-06-02"` bis `"2026-06-03"` exportiert den 2. Juni.
+- Für tägliche Deltas ist `LineRegistrationDate` sinnvoll, weil neue oder geänderte Zeilen nach Registrierungsdatum kommen.
+
+## Export Und Upload Zusammen Starten
+
+Standard: täglicher Delta-Lauf, gestern bis heute:
+
+```powershell
+Set-ExecutionPolicy -Scope Process Bypass
+cd C:\Trafag\SageSpain
+.\Run-SpainExportAndUpload.ps1
+```
+
+Expliziter Zeitraum:
+
+```powershell
+.\Run-SpainExportAndUpload.ps1 -ExportMode Range -DateFilter LineRegistrationDate -FromDate "2026-06-02" -ToDate "2026-06-03"
+```
+
+Full Export mit Upload:
+
+```powershell
+.\Run-SpainExportAndUpload.ps1 -ExportMode Full -Year 2025
+```
+
+Wenn rclone nicht im PATH ist:
+
+```powershell
+.\Run-SpainExportAndUpload.ps1 -RcloneExe "C:\Tools\rclone\rclone.exe"
+```
+
+Wenn der rclone-Remote anders heisst:
+
+```powershell
+.\Run-SpainExportAndUpload.ps1 -RcloneRemote "MEIN_REMOTE_NAME"
+```
+
+## Was Wird Hochgeladen?
+
+Das Wrapper-Script lädt aus dem neuesten Exportordner:
+
+```text
+*.csv
+*_summary.txt
+```
+
+Ziel:
+
+```text
+trafag-bi:Import/Finance/Spanien
+```
+
+Das Script ändert keine Daten in Sage und keine Daten in SQL Server.
+
+## Windows Task Scheduler
+
+Empfohlener täglicher Lauf, z.B. 02:00 Uhr:
+
+```powershell
+$action = New-ScheduledTaskAction `
+  -Execute "powershell.exe" `
+  -Argument "-NoProfile -ExecutionPolicy Bypass -File C:\Trafag\SageSpain\Run-SpainExportAndUpload.ps1"
+
+$trigger = New-ScheduledTaskTrigger -Daily -At 02:00
+
+Register-ScheduledTask `
+  -TaskName "Trafag Spain Sage Export Upload" `
+  -Action $action `
+  -Trigger $trigger `
+  -Description "Exports Sage Spain sales CSV and uploads it to SharePoint via rclone"
+```
+
+Wenn rclone nicht im PATH ist:
+
+```powershell
+$action = New-ScheduledTaskAction `
+  -Execute "powershell.exe" `
+  -Argument "-NoProfile -ExecutionPolicy Bypass -File C:\Trafag\SageSpain\Run-SpainExportAndUpload.ps1 -RcloneExe C:\Tools\rclone\rclone.exe"
+```
+
+## Kontrolle Nach Dem Lauf
+
+Lokal:
+
+```powershell
+Get-ChildItem C:\Trafag\SageSpain\out -Directory | Sort-Object LastWriteTime -Descending | Select-Object -First 1
+Get-ChildItem C:\Trafag\SageSpain\logs
+```
+
+SharePoint:
+
+```powershell
+rclone ls trafag-bi:"Import/Finance/Spanien"
+```
+
+Im Browser prüfen:
+
+```text
+https://trafagag.sharepoint.com/sites/WorldwideBIPlatform/Shared%20Documents/Import/Finance/Spanien
+```
+
+## Fehlerbilder
+
+`rclone: command not found`
+
+- rclone ist nicht im PATH.
+- Lösung: `-RcloneExe "C:\Tools\rclone\rclone.exe"` verwenden.
+
+`directory not found`
+
+- Remote zeigt nicht auf `Shared Documents` oder Zielordner ist anders.
+- Mit `rclone lsd trafag-bi:` und `rclone lsd trafag-bi:"Import/Finance"` prüfen.
+
+`Access denied`
+
+- Microsoft Login oder SharePoint-Berechtigung fehlt.
+- Der Windows-User des geplanten Tasks muss Zugriff auf rclone-Konfiguration und SharePoint haben.
+
+Leere Delta-Datei:
+
+- Zeitraum prüfen.
+- `ToDate` ist exklusiv.
+- Bei täglichem Lauf für gestern bis heute ist das korrekt.