Ai/TrafagSalesExporter/docs/SAGE_SPAIN_RCLONE_UPLOAD_ANLEITUNG_2026-06-03.md

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:

https://trafagag.sharepoint.com/sites/WorldwideBIPlatform/Shared%20Documents/Import/Finance/Spanien

Technischer Ordner:

Shared Documents/Import/Finance/Spanien

Empfohlener rclone-Zielpfad:

trafag-bi:Import/Finance/Spanien

Dabei zeigt trafag-bi auf die Dokumentbibliothek Shared Documents der SharePoint-Site:

https://trafagag.sharepoint.com/sites/WorldwideBIPlatform

Benötigte Dateien Auf Dem Spanien-Server

Empfohlener Ordner:

C:\Trafag\SageSpain

Dateien:

Export-SageSpainSalesCsv.ps1
Run-SpainExportAndUpload.ps1

Die Dateien liegen im Paket:

SageSpainFinalExportPackage.zip

rclone Installieren

Falls winget vorhanden ist:

winget install Rclone.Rclone

Alternativ rclone ZIP manuell installieren, z.B. nach:

C:\Tools\rclone\rclone.exe

Danach testen:

rclone version

Falls rclone nicht im PATH ist, später den vollständigen Pfad verwenden:

C:\Tools\rclone\rclone.exe version

rclone Remote Einrichten

Auf dem Spanien-Server:

rclone config

Empfohlene Eingaben:

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

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:

Set-ExecutionPolicy -Scope Process Bypass
cd C:\Trafag\SageSpain
.\Export-SageSpainSalesCsv.ps1 -ExportMode Full -Year 2025 -OutputDirectory C:\Trafag\SageSpain\out

Delta/Range Export:

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:

Set-ExecutionPolicy -Scope Process Bypass
cd C:\Trafag\SageSpain
.\Run-SpainExportAndUpload.ps1

Expliziter Zeitraum:

.\Run-SpainExportAndUpload.ps1 -ExportMode Range -DateFilter LineRegistrationDate -FromDate "2026-06-02" -ToDate "2026-06-03"

Full Export mit Upload:

.\Run-SpainExportAndUpload.ps1 -ExportMode Full -Year 2025

Wenn rclone nicht im PATH ist:

.\Run-SpainExportAndUpload.ps1 -RcloneExe "C:\Tools\rclone\rclone.exe"

Wenn der rclone-Remote anders heisst:

.\Run-SpainExportAndUpload.ps1 -RcloneRemote "MEIN_REMOTE_NAME"

Was Wird Hochgeladen?

Das Wrapper-Script lädt aus dem neuesten Exportordner:

*.csv
*_summary.txt

Ziel:

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:

$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:

$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:

Get-ChildItem C:\Trafag\SageSpain\out -Directory | Sort-Object LastWriteTime -Descending | Select-Object -First 1
Get-ChildItem C:\Trafag\SageSpain\logs

SharePoint:

rclone ls trafag-bi:"Import/Finance/Spanien"

Im Browser prüfen:

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.