Ensure ZSCHWEIZ OData mapping seed

2026-05-07 14:55:30 +02:00
parent 34be4a5b49
commit dea171862c
5 changed files with 263 additions and 29 deletions
@@ -2,6 +2,57 @@

 Stand: 2026-05-05

+## Nachtrag 2026-05-07 SAP OData / ZSCHWEIZ / Schweiz-Oesterreich
+
+Aktueller Architekturentscheid:
+
+- `ZSCHWEIZ` wird ueber SAP OData/Gateway gelesen.
+- Direkter HANA-Spezialcode fuer `ZSCHWEIZ` wurde vermieden.
+- Der grafische Quellen- und Feldmapper wird fuer SAP OData verwendet.
+- Fuer direkte HANA-Tabellen/Views gibt es ebenfalls grafisches Mapping; das ist aber nicht der geplante Pfad fuer `ZSCHWEIZ`.
+
+Quellsysteme:
+
+- `SAP` = `SAP OData`, Anschlussart `SAP_GATEWAY`.
+- `SAP_HANA` = `SAP HANA Tables/Views`, Anschlussart `HANA`.
+- `BI1` und `SAGE` bleiben HANA-basierte Quellsysteme.
+- `MANUAL_EXCEL` bleibt Excel/CSV.
+
+ABAP/SAP:
+
+- Datei `report.abap` enthaelt Report `ZTRAFAG_SCHWEIZ_EXPORT`.
+- Ziel-Tabelle in SAP: `ZSCHWEIZ`.
+- `BUKRS 1100` wird als Schweiz (`TRCH`, `CH`) geschrieben.
+- `BUKRS 1200` wird als Oesterreich (`TRAT`, `AT`) geschrieben.
+- `CUSTOMER_LAND` enthaelt das urspruengliche Kundenland.
+- Der Report schreibt paketweise per Upsert.
+
+App-Seed:
+
+- Standort `ZSCHWEIZ` / `Schweiz/Oesterreich` wird inaktiv angelegt bzw. repariert.
+- `SourceSystem = SAP`.
+- Quelle `Z`, EntitySet `ZSCHWEIZSet`.
+- Quelle und Feldmapping werden beim App-Start per Upsert nachgezogen; eine teilweise vorhandene ZSCHWEIZ-Konfiguration bleibt dadurch nicht leer.
+- Initiales Mapping:
+  - `Tsc <- Z.TSC`
+  - `Land <- Z.LAND1`
+  - `InvoiceNumber <- Z.VBELN`
+  - `PositionOnInvoice <- Z.POSNR`
+  - `SalesPriceValue <- Z.NETWR_HC`
+  - `SalesCurrency <- Z.HWAER`
+  - `CustomerCountry <- Z.CUSTOMER_LAND`
+
+Wichtig fuer naechsten Einstieg:
+
+- Wenn die zentrale SAP-Service-URL noch auf `ZPOWERBI_EINKAUF_SRV` zeigt, muss beim Standort `ZSCHWEIZ` ein Service-URL-Override fuer den `ZSCHWEIZ`-OData-Service gesetzt werden.
+- Feldinfos kommen ueber `$metadata`; manuelle Feldliste ist nur noetig, wenn Gateway/Metadata nicht funktioniert.
+- Nach URL-Setzung: `Entity Sets refreshen`, `Felder aus Quellen laden`, Mapping kontrollieren, Standort aktivieren, Export testen.
+
+Verifikation:
+
+- Hauptprojekt Build erfolgreich.
+- Tests `50/50` erfolgreich.
+
 ## Nachtrag 2026-05-05 Aktueller Handoff FinanceProbe / Laenderabgleich

 Der aktuelle Arbeitsstand fuer den naechsten Einstieg ist der lokale FinanceProbe: