Document finance and Spain rclone updates

This commit is contained in:
2026-06-05 06:26:51 +02:00
parent 3fd19a8bb5
commit 195b430836
6 changed files with 247 additions and 34 deletions
+3 -1
View File
@@ -1,6 +1,6 @@
# RAG Router
Stand: 2026-05-27
Stand: 2026-06-05
Zweck: Diese Datei zuerst laden. Danach nur die Dateien aus dem passenden Themenblock laden.
@@ -49,6 +49,8 @@ Zweck: Diese Datei zuerst laden. Danach nur die Dateien aus dem passenden Themen
| `TRUK`, `UK_B1`, `Delta`, `Manual Excel` | Manual Import / Finance Spezialfaelle |
| `TRDE`, `Alphaplan`, `NettoPreisGesamtX` | Finance Cockpit / Manual Import |
| `TRSE`, `Spain`, `Sage`, `ImporteNeto` | Finance Spezialfaelle |
| `Spain rclone`, `Spanien SharePoint`, `Run-SpainRangeExportAndUpload-AllInOne`, `trafag-bi` | `docs/SAGE_SPAIN_RCLONE_UPLOAD_GUIDE_2026-06-03.md` |
| `3D Datenanalyse`, `Experten`, `Schnelluebersicht`, `Simulation`, `Wechselkurs-Schieberegler` | Finance Cockpit |
| `HR KPI`, `Rexx`, `Austritte`, `Absenzen` | HR KPI |
| `IIS`, `BiDashboard`, `Publish`, `TLS`, `Client certificate` | Deployment/IIS |
| `Upgreat`, `Firewall`, `Freigabe`, `10.120.1.17`, `30015`, `8000` | Deployment/IIS |
@@ -1,6 +1,6 @@
# Sage Spain Rclone Upload Guide
Status: 2026-06-03
Status: 2026-06-05
Purpose: The Sage server in Spain creates the sales CSV locally and then automatically uploads the file to the SharePoint folder used by the dashboard import.
@@ -32,25 +32,26 @@ https://trafagag.sharepoint.com/sites/WorldwideBIPlatform
## Required Files On The Spain Server
Recommended folder:
Recommended folder for export output and logs:
```text
C:\Trafag\SageSpain
```
Required files:
Recommended script folder:
```text
Export-SageSpainSalesCsv.ps1
Run-SpainExportAndUpload.ps1
C:\Tools\rclone
```
The files are included in:
Required file for the current single-file workflow:
```text
SageSpainFinalExportPackage.zip
Run-SpainRangeExportAndUpload-AllInOne.ps1
```
This all-in-one script does not require `Export-SageSpainSalesCsv.ps1` or `Run-SpainExportAndUpload.ps1`.
## Install rclone
If `winget` is available:
@@ -59,10 +60,11 @@ If `winget` is available:
winget install Rclone.Rclone
```
Alternatively, install the rclone ZIP manually, for example to:
Alternatively, install the rclone ZIP manually, for example to one of these paths:
```text
C:\Tools\rclone\rclone.exe
C:\Tools\rclone\rclone\rclone.exe
```
Test the installation:
@@ -77,6 +79,14 @@ If `rclone` is not in the PATH, use the full path later:
C:\Tools\rclone\rclone.exe version
```
The current all-in-one script auto-detects rclone in:
```text
C:\Tools\rclone.exe
C:\Tools\rclone\rclone.exe
C:\Tools\rclone\rclone\rclone.exe
```
## Configure The rclone Remote
On the Spain server:
@@ -138,36 +148,39 @@ Notes:
## Run Export And Upload Together
Default: daily delta run, yesterday until today:
Current recommended command: one file, range export and upload.
Default: last 7 days until today. `ToDate` is exclusive.
```powershell
Set-ExecutionPolicy -Scope Process Bypass
cd C:\Trafag\SageSpain
.\Run-SpainExportAndUpload.ps1
cd C:\Tools\rclone
.\Run-SpainRangeExportAndUpload-AllInOne.ps1
```
Explicit date range:
```powershell
.\Run-SpainExportAndUpload.ps1 -ExportMode Range -DateFilter LineRegistrationDate -FromDate "2026-06-02" -ToDate "2026-06-03"
.\Run-SpainRangeExportAndUpload-AllInOne.ps1 -FromDate "2026-06-01" -ToDate "2026-06-04"
```
Full export with upload:
If rclone is in a non-standard location:
```powershell
.\Run-SpainExportAndUpload.ps1 -ExportMode Full -Year 2025
.\Run-SpainRangeExportAndUpload-AllInOne.ps1 -RcloneExe "C:\Tools\rclone\rclone\rclone.exe"
```
If rclone is not in the PATH:
Older two-file wrapper, only use if both scripts are present in the same folder:
```powershell
.\Run-SpainExportAndUpload.ps1 -RcloneExe "C:\Tools\rclone\rclone.exe"
.\Run-SpainExportAndUpload.ps1
```
If the rclone remote has another name:
This older wrapper requires:
```powershell
.\Run-SpainExportAndUpload.ps1 -RcloneRemote "YOUR_REMOTE_NAME"
```text
Export-SageSpainSalesCsv.ps1
Run-SpainExportAndUpload.ps1
```
## What Gets Uploaded?
@@ -194,7 +207,7 @@ Recommended daily run, for example at 02:00:
```powershell
$action = New-ScheduledTaskAction `
-Execute "powershell.exe" `
-Argument "-NoProfile -ExecutionPolicy Bypass -File C:\Trafag\SageSpain\Run-SpainExportAndUpload.ps1"
-Argument "-NoProfile -ExecutionPolicy Bypass -File C:\Tools\rclone\Run-SpainRangeExportAndUpload-AllInOne.ps1"
$trigger = New-ScheduledTaskTrigger -Daily -At 02:00
@@ -210,7 +223,7 @@ If rclone is not in the PATH:
```powershell
$action = New-ScheduledTaskAction `
-Execute "powershell.exe" `
-Argument "-NoProfile -ExecutionPolicy Bypass -File C:\Trafag\SageSpain\Run-SpainExportAndUpload.ps1 -RcloneExe C:\Tools\rclone\rclone.exe"
-Argument "-NoProfile -ExecutionPolicy Bypass -File C:\Tools\rclone\Run-SpainRangeExportAndUpload-AllInOne.ps1 -RcloneExe C:\Tools\rclone\rclone\rclone.exe"
```
## Check After The Run
@@ -239,7 +252,18 @@ https://trafagag.sharepoint.com/sites/WorldwideBIPlatform/Shared%20Documents/Imp
`rclone: command not found`
- rclone is not in the PATH.
- Use `-RcloneExe "C:\Tools\rclone\rclone.exe"`.
- Use `-RcloneExe "C:\Tools\rclone\rclone.exe"` or `-RcloneExe "C:\Tools\rclone\rclone\rclone.exe"`.
`Export script not found`
- You started the older wrapper `Run-SpainExportAndUpload.ps1`.
- For the single-file workflow start `Run-SpainRangeExportAndUpload-AllInOne.ps1`.
`CRITICAL: Can't set -v and --log-level`
- The server is running an old copy of the script that still contains `--verbose`.
- Remove the line `--verbose \`` from the rclone `copy` block, or replace the file with the current all-in-one script.
- The corrected upload block keeps `--log-level INFO` and does not use `--verbose`.
`directory not found`
+19 -1
View File
@@ -1,12 +1,14 @@
# RAG Finance
Stand: 2026-06-01
Stand: 2026-06-05
## Kurzstand
- Fuehrende Sicht: `Finance Summary`.
- `Finance Summary` nutzt dieselbe `FinanceRuleEngine` wie das zentrale Excel.
- `Management Analyse` bleibt Diagnose-/Plausibilitaetssicht, nicht fuehrende Finance-Zahl.
- Nach UX-Vereinfachung gibt es links eine schnellere Finance-Uebersicht; tiefe Diagnosefunktionen sind unter `Experten` gebuendelt.
- Neuer Expertenpunkt: `3D Datenanalyse` fuer interaktive visuelle Analyse und Simulation.
- `Management Analyse` hat zusaetzliche Finance-Reiter fuer Laender, Datenstatus, Abweichungen, Gutschriften-Kandidaten und Datenqualitaet.
- `Management Analyse` ist links aufklappbar; direkte Navigationspunkte springen in die einzelnen Reiter.
- Neu: `Spartenanalyse` mit Unterreitern `Finanzanalyse` und `Zentrale Zuordnung`.
@@ -19,6 +21,8 @@ Stand: 2026-06-01
- Management Analyse zeigt in `Laender` jetzt IC/2nd-party und `Ist ohne IC` als Diagnose.
- Wechselkurs-Anwendungsdatum ist in Settings konfigurierbar und wird in der Rohdaten-Diagnose angezeigt.
- Spartenanalyse war mit >90% nicht zugeordnet fachlich unplausibel; Materialabgleich normalisiert fuehrende Nullen und warnt bei >=90% ungeklaerter Abdeckung.
- Budgetkurse wurden als Finance-Kurse behandelt; CHF-Sicht bleibt getrennte Reporting-/Kontrollsicht, nicht stiller Ersatz fuer Hauswaehrungsabgleich.
- Browser-Hinweis: 3D-Ansicht wurde in Chrome als korrekt bestaetigt; Firefox zeigte auf dem Client Interaktions-/Zoomprobleme.
## Wichtige Regeln
@@ -47,6 +51,20 @@ Stand: 2026-06-01
- `Spartenanalyse > Zentrale Zuordnung`: Materialnummern aller Laender gegen TR-AG-Stamm pruefen.
- `Rohdaten Diagnose`: direkte Plausibilitaets-/Rohdatensicht auf `CentralSalesRecords`.
## Experten / 3D Datenanalyse
- Unter `Experten` gibt es den Punkt `3D Datenanalyse`.
- Zweck: Verlauf und Kennzahlen im Raum betrachten, nicht Ersatz fuer den offiziellen Soll/Ist-Wert.
- Funktionen:
- drehbare 3D-Ansicht mit Maus.
- Achsenbeschriftung fuer Zeit/Wert/Indikator.
- Auswahl sinnvoller Finance-Indikatoren.
- Diagrammarten wie Balken/Linien/weitere Analyseformen.
- einstellbare Labelgroesse.
- Schieberegler fuer Szenarien, u. a. Wechselkursveraenderungen.
- Realtime-Neuberechnung bei Szenarioaenderungen.
- Bekannter Hinweis: Wenn Interaktion/Zoom in Firefox fehlerhaft ist, mit Chrome pruefen.
## Spartenanalyse Kurzlogik
- Statuswerte:
+9 -6
View File
@@ -1,15 +1,18 @@
# RAG Project
Stand: 2026-05-29
Stand: 2026-06-05
## Kurzstand
- Fuehrende App: `TrafagSalesExporter`, publiziert als `BiDashboard`.
- Letzter dokumentierter Stand: alle Aenderungen bis `36ca822 Add browser favicon` umgesetzt und deployed.
- Validierung laut Doku: `80/80` Tests gruen, letzter Testlauf mit Artefaktpfad `C:\TMP\trafag-test-artifacts-favicon`.
- Letzter Deploy: 2026-05-29 13:47 auf `\\trch-webapp-bidashboard.trafagch.local\BiDashboard$\`.
- Neu im Finance/Management-Cockpit: aufklappbare Management-Navigation, Spartenanalyse-Unterreiter, Gruppierung/Top-10/Flaggen/Icon-UX und Finance-Schulungserweiterung.
- Neu im Browser: eigenes SVG-Favicon `wwwroot/favicon.svg`.
- Letzter dokumentierter Stand: Finance-Schnelluebersicht, Expertenbereich, 3D-Datenanalyse und Spanien-Sage-All-in-one-rclone-Upload.
- Validierung laut Doku: Finance-Sitzungsstand `82/82` Tests gruen; spaetere UI-/Deploy-Schritte wurden einzeln umgesetzt und deployed.
- Letzter dokumentierter Finance-Deploy: 2026-06-04 auf `\\trch-webapp-bidashboard.trafagch.local\BiDashboard$\`.
- Neu im Finance/Management-Cockpit: einfache Schnelluebersicht links sichtbar; tiefere Funktionen bleiben unter `Experten`.
- Neu im Expertenbereich: `3D Datenanalyse` mit drehbarer 3D-Grafik, Achsen, Diagrammarten, Indikatorauswahl, Labelgroesse und Simulation per Schieberegler.
- Spanien: `Run-SpainRangeExportAndUpload-AllInOne.ps1` exportiert Sage-Range direkt und laedt CSV/Summary via rclone nach SharePoint `trafag-bi:Import/Finance/Spanien`.
- Spanien: Default-Range ist heute minus 7 Tage bis heute; `ToDate` ist exklusiv.
- Spanien: rclone-Fehler `Can't set -v and --log-level` im All-in-one-Script behoben; aktuelle Datei enthaelt kein `--verbose` im Upload.
- Fuer normale Weiterarbeit diese Datei plus den passenden Themen-RAG laden.
## Aktive Themen