Files
nodeMap/docs/frontend/redux/api/fromWebService.md
ISA 0a046974bc docs: Webservice-ID-Parameter über URL statt .env.local (BREAKING CHANGE)
- Entfernt Fallback für idMap und idUser via .env.local
- Anpassung aller fetchGis*-Funktionen zur Nutzung von URL-Parametern
- Dokumentation entsprechend aktualisiert
- CHANGELOG.md hinzugefügt (Version 1.1.65)
2025-05-15 11:16:39 +02:00

1.9 KiB
Raw Blame History

📡 Webservices Redux Integration (/redux/api/fromWebService)

In diesem Verzeichnis befinden sich alle Webservice-Fetch-Funktionen für die Kommunikation mit TALAS.web über SOAP-Endpunkte.


Aktueller Stand

Jede Funktion liest idMap und idUser ausschließlich aus der URL, wie sie von TALAS.web übergeben werden.

Beispiel:

const params = new URLSearchParams(window.location.search);
const idMap = params.get("idMap");
const idUser = params.get("idUser");

Änderung am 2025-05-15

Vorher wurden Default-Werte über .env.local als Fallback genutzt:

const idMap = params.get("idMap") || process.env.NEXT_PUBLIC_DEFAULT_ID_MAP || "12";

Das wurde entfernt, um folgende Ziele zu erreichen:

  • Keine fest eingetragenen Defaults im Browser sichtbar
  • Verbindlichkeit: TALAS.web übergibt die Werte immer korrekt via URL
  • 🔐 Sicherheit: Kein versehentliches Verwenden eines falschen Users (z.B. ID 484)
  • 🔍 Fehler leichter erkennbar (Parameter nicht gefunden = echter Fehler)

Optional: Validierung einbauen

Falls gewünscht, kann ein expliziter Fehler ausgelöst werden:

if (!idMap || !idUser) {
  throw new Error("Fehlende URL-Parameter: idMap oder idUser");
}

Betroffene Dateien

Diese Änderung betrifft alle Funktionen in:

/redux/api/fromWebService/fetchGisStationsStatic.js
/redux/api/fromWebService/fetchGisStationsStaticDistrict.js
/redux/api/fromWebService/fetchGisStationsStatusDistrict.js
/redux/api/fromWebService/fetchGisStationsMeasurements.js
/redux/api/fromWebService/fetchGisSystemStatic.js

Hinweis zur Konfiguration

Die Webservice-Basisadresse wird weiterhin über .env.local konfiguriert:

NEXT_PUBLIC_API_BASE_URL=http://10.10.0.13/talas5/ClientData/WebServiceMap.asmx

Aber idMap und idUser werden nicht mehr über Umgebungsvariablen gesteuert.