Zum Hauptinhalt springen
Administration · Karten und Geodienste

Masterportal-Konfiguration ausliefern

Masterportal-Inhalte werden in der UDSP als versionierte Konfiguration gepflegt. Änderungen an Diensten, Themenbaum und Werkzeugen durchlaufen einen Branch, ein Review und den vereinbarten Auslieferungsweg.

Ein geprüfter Geo- oder Kartendienst ist in der vorgesehenen Portal-Konfiguration registriert, verständlich im Themenbaum eingeordnet und nach einem nachvollziehbaren Review in der richtigen Umgebung verfügbar.

Änderung

Branch anlegen

Die Änderung wird isoliert im vereinbarten Konfigurationsrepository vorbereitet.

Dienst

Quelle registrieren

Endpunkt, Layer, Legende und technische Kennung werden konsistent erfasst.

Portal

Themenbaum pflegen

Sichtbarer Titel, Reihenfolge, Startansicht und Werkzeuge werden abgestimmt.

Freigabe

Review und Auslieferung

Merge Request, Pipeline und Zielumgebung werden geprüft.

1. Änderung vorbereiten​

Verwenden Sie das für den Mandanten vereinbarte Geodaten-Customizing-Repository. Legen Sie einen kurzen Branch ohne / im Namen an und ändern Sie keine gemeinsam genutzte Zielumgebung direkt. Halten Sie Dienst, Layer, Zielgruppe und erwartete Darstellung bereits in der Änderung oder im Merge Request fest.

2. Dienst und Layer registrieren​

Erfassen Sie den Dienst in der dafür vorgesehenen Service-Konfiguration. Im etablierten UDSP-Customizing ist dies typischerweise portal-config/services-internet.json. Verwenden Sie den später tatsächlich erreichbaren Plattformendpunkt und stimmen Sie IDs, Layernamen, Legende sowie Zugriffsweg mit GeoServer ab.

Bearbeitung einer Masterportal-Servicekonfiguration in GitLab
Die historische Ansicht illustriert die versionierte Pflege im Repository. Dateipfad und Struktur sind gegen die im jeweiligen Projekt eingesetzte Masterportal-Version zu prüfen.

3. Sichtbare Portalstruktur pflegen​

Ordnen Sie den registrierten Dienst in der Portal-Konfiguration ein. Im etablierten Customizing wird der Themenbaum typischerweise in portal-config/config.json gepflegt. Sichtbare Namen sollen fachlich verständlich sein und keine internen Tabellen- oder Projektnamen übernehmen.

Bearbeitung des Themenbaums einer Masterportal-Konfiguration
Dienstregistrierung und sichtbarer Themenbaum sind zwei getrennte Schritte: Erst die Portal-Konfiguration bestimmt, wo und wie ein Layer für Nutzer erscheint.

4. Review und Auslieferung​

  1. Prüfen Sie die Konfigurationsdateien lokal oder über die Projektvorschau.
  2. Erstellen Sie einen Merge Request in den für die Zielumgebung vereinbarten Branch.
  3. Lassen Sie Dienstzugang, Benennung, Rechte und Darstellung fachlich sowie technisch reviewen.
  4. Prüfen Sie Pipeline und erzeugten Image-Stand.
  5. Warten Sie die konfigurierte Aktualisierung der Zielumgebung ab und testen Sie das Portal ohne Browser-Cache.
Merge einer geprüften Masterportal-Konfigurationsänderung
Welche Branches Entwicklung, Staging oder Produktion beliefern, wird projektspezifisch festgelegt. Entscheidend ist der nachvollziehbare Merge- und Pipelineweg – nicht ein historischer Branchname.
Konfiguration statt manueller Produktionsänderung

Masterportal, Portal-Backend und MapFish werden aus versionierten Artefakten ausgeliefert. Änderungen direkt in einem laufenden Container sind nicht dauerhaft, nicht reviewbar und werden bei der nächsten Aktualisierung überschrieben.

Ergebnis prüfen​

  • Der richtige Dienst und Layer werden über den vorgesehenen Plattformpfad geladen.
  • Themenbaum, Titel, Legende und Startansicht sind fachlich verständlich.
  • Geschützte Layer bleiben für nicht berechtigte Nutzer unsichtbar oder gesperrt.
  • Pipeline und Zielumgebung verwenden den geprüften Artefaktstand.
  • Änderung, Review und Rückfallweg sind im Repository nachvollziehbar.

Weiterarbeiten​

Prüfen Sie die ausgelieferte Konfiguration anschließend aus Benutzersicht mit Geodaten anzeigen und teilen. So wird sichtbar, ob Layer, Legende, Werkzeuge und Freigaben im tatsächlichen Arbeitsweg verständlich funktionieren.

Referenzen​