Release‑Hinweise Version 3.28.0

Die neueste Version 3.28.0 des Masterportals bringt ein umfangreiches Set an Neuerungen, Verbesserungen und Fehlerkorrekturen. Ziel ist es, die tägliche Arbeit mit dem Portal zu erleichtern, die Systemstabilität zu erhöhen und aktuelle Sicherheitsstandards zu erfüllen.

Neue Funktionen und Erweiterungen für Anwender

• Im StatisticDashboard wird nun ein Karten‑View angeboten, der die Werte der ausgewählten Statistik direkt auf der Karte darstellt.
• Beschriftungen und Tooltips lassen sich im StatisticDashboard flexibel ein‑ und ausschalten, wodurch die Kartenansicht an individuelle Anforderungen angepasst werden kann.
• Die Dropdown‑Komponenten (DropdownSelect und DropdownAutocomplete) unterstützen jetzt die Sortierung von Einträgen (prop sortable) und das Anzeigen ausgewählter Einträge zuerst (prop selectedFirst). Das Autocomplete‑Element bietet zudem die Möglichkeit, den Titel der „Select all“-Option (prop selectAllTitle) anzupassen.
• Das neue Draw‑Modul (type="draw") ersetzt das veraltete draw_old und bietet verbesserte Zeichenwerkzeuge; ein Fehler bei der Bearbeitung importierter Multi‑Geometrien (z. B. aus KML) wurde behoben, sodass das Mess‑Tooltip korrekt positioniert wird.
• In der LayerTree‑Ansicht erhalten gesicherte Layer einen Login‑Hinweis, wenn nicht eingeloggt, sowie ein aktualisiertes Schloss‑Symbol (offen bei Login, geschlossen sonst).
• WMS‑Layer können jetzt über die zusätzlichen Parameter sld und gfi_template konfiguriert werden, was erweiterte Styling‑Möglichkeiten eröffnet.
• Der Button im WMS‑Time‑Modul wurde umbenannt, um Verwechslungen zu vermeiden.
• Das Accordion‑Component beinhaltet jetzt Untertitel und ein optionales Rahmen‑Styling für eine klarere Strukturierung von Inhalten.
• Das SearchInterfaceTopicTree bietet den neuen Parameter foldersFirst, um die Reihenfolge der Ergebnis‑Kategorien zu steuern.

Verbesserungen und Änderungen (Bedienung & Performance)

• Die Dropdown‑Listen im StatisticDashboard sowie die Auswahlfelder für Kategorien, Statistiken und Regionen werden alphabetisch sortiert und zeigen ausgewählte Einträge zuerst an.
• Beim Öffnen des StatisticDashboard wird ein Lade‑Spinner angezeigt; bei Ladeproblemen erscheint eine Fehlermeldung.
• Anfragen für mehrere Layer werden jetzt parallel gesendet, was die Ladezeiten deutlich reduziert.
• Das „Alle Gebiete“-Element im Regionen‑Dropdown wurde zu einer „Select all“-Option erweitert, die alle Gebiete auswählt bzw. bei manueller Auswahl automatisch aktiviert wird.
• Das Modul‑Caching (keep‑alive) funktioniert nun auch für Lazy‑Loaded‑Kernmodule wie das StatisticDashboard, wodurch ein erneutes Laden und Datenabruf bei jedem Öffnen entfallen.
• Legend‑Bilder gesicherter Services werden jetzt mit dem Auth‑Token des Login‑Moduls geladen, sodass keine 401‑Fehler mehr auftreten.
• Das GetFeatureInfo‑Addon lädt fehlende gfiTheme-Addons bei Bedarf nach, anstatt auf das Standard‑Theme zurückzugreifen.
• Beim Import von WMS‑Diensten wird, falls das Root‑Layer keine BoundingBox besitzt, die BoundingBox des ersten Child‑Layers verwendet, um die Service‑Gültigkeit zu prüfen; fehlt diese komplett, wird der Service ohne Fehlermeldung importiert.

Fehlerbehebungen und Stabilität

• Issue #1629: Legend‑URLs werden nun bei Bedarf mit dem Autorisierungs‑Header abgerufen.
• Issue #1646: WMTS‑Druck wurde mit Raster‑Reprojektion, korrekter Opazitäts‑Handhabung und zuverlässigeren Raster‑Fallbacks verbessert; 3D‑Druck‑Payloads wurden reduziert.
• Issue #1655 / #1663: Es ist jetzt möglich, Module desselben Typs mehrfach zu konfigurieren, sofern sie unterschiedliche Namen besitzen und im gleichen Menü (mainMenu oder secondaryMenu) eingetragen sind. Nur ein solches Modul kann gleichzeitig geöffnet sein.
• Issue #1664: Geometrien, die von wfsSearch mit einer anderen CRS als die Portal‑CRS zurückgeben, werden nun automatisch transformiert; die neue Konfiguration dataProjection steht dafür bereit.
• Im StatisticDashboard wird das „Hover‑Info“‑Panel beim Schließen des Moduls entfernt, um Speicher zu schonen.
• Beim Alerting‑Component werden HTML‑Tags nicht mehr über DOMPurify gesäubert, sodass Listen korrekt dargestellt werden.

Technische Aktualisierungen und Sicherheitsaspekte

• Die Mindest‑Node.js‑Version wurde auf 22.23.4 (LTS) und 24.22.1 (LTS) erhöht, um bekannte Sicherheitslücken zu schließen.
• Das Masterportal‑API‑Package wurde von 2.64.0 auf 2.66.0 aktualisiert.
• Dev‑Dependencies wurden aktualisiert: vitest, @vitest/ui, @vitest/web‑worker, jsdom und dompurify (jetzt Version 3.4.17).
• CustomMenuElement nutzt jetzt DOMPurify, um HTML‑Inhalte zu säubern und XSS‑Risiken zu reduzieren.
• In den Utils‑Bibliotheken wurden vier neue Funktionen zur Konvertierung von GeoJSON in Feature‑ und Geometry‑Objekte sowie eine sichere Popup‑Funktion (ohne XSS‑Risiko) eingeführt.

Veraltete Funktionen und Hinweise

• Der WMTS‑Parameter transparent ist veraltet; stattdessen sollte transparency verwendet werden.
• Das alte Draw‑Modul (draw_old) ist ab November 2027 vollständig entfernt; alle Implementierungen sollten auf das neue Draw‑Modul umgestellt werden.

Abschließender Überblick

Version 3.28.0 erweitert das Masterportal um nutzerfreundliche Kartenvisualisierungen, verbessert die Bedienung durch neue UI‑Optionen und erhöht die Systemstabilität durch umfassende Bugfixes. Gleichzeitig werden Sicherheitsaspekte wie XSS‑Prävention und aktuelle Node.js‑Vorgaben umgesetzt. Administratoren und Entwickler sollten die aktualisierten Mindestvoraussetzungen prüfen und veraltete Funktionen ggf. ersetzen.

Redaktionelle Hinweise

• Prüfen Sie, ob Ihre Server‑Umgebung mindestens Node.js 22.23.4 (LTS) oder 24.22.1 (LTS) bereitstellt.
• Aktualisieren Sie das Masterportal‑API‑Package auf Version 2.66.0, um Kompatibilitätsprobleme zu vermeiden.
• Ersetzen Sie alle Verwendungen von draw_old nach spätestens November 2027 durch das neue Draw‑Modul (type="draw").
• Passen Sie WMTS‑Layer‑Konfigurationen an, indem Sie den Parameter transparent durch transparency ersetzen.
• Beachten Sie die neuen Konfigurationsparameter sortable, selectedFirst, selectAllTitle für Dropdown‑Komponenten sowie foldersFirst für das Topic‑Tree‑Interface.
• Nutzen Sie das neue dataProjection-Parameter in WFS‑Konfigurationen, um CRS‑Transformationen korrekt zu handhaben.
• Überprüfen Sie, ob benutzerdefinierte HTML‑Inhalte im CustomMenuElement mit DOMPurify gesäubert werden, um XSS‑Risiken zu minimieren.