Zum Inhalt springen
Aufgefächerte Ebenen über einem Masterportal-Bildschirm: Werkzeugkacheln, Formularfelder, Farbfelder und Kartenkacheln schweben über dem Portal mit Menü, Karte und Suche

Portal Builder

Der No-Code-Builder für Masterportal: Portale erweitern und neu anlegen, jeder Schritt im Formular.

Portal Builder ist die Anwendung für Ihre Masterportale: ein vorhandenes Portal erweitern oder ein neues anlegen, komplett im Formular. Menüs, Module, Themenbaum und Dienste entstehen per Klick; die JSON-Dateien schreibt das Werkzeug. Die Felder kommen aus der Masterportal-Doku selbst — mit Typen, Vorgaben und Pflichtfeldern. Vor dem Speichern zeigt eine Diff-Vorschau jede Änderung, die Vorfassung wandert in die Sicherung, das Zurückschreiben bleibt formattreu.

Überblick

Drei Säulen

Formulare aus der Doku, ein Prüflauf vor dem Schreiben und eine Sicherung mit Rückweg tragen jeden Klick im Builder.

Formulare aus der Doku

Der Doku-Baustein des Masterportal-Projekts macht aus der Konfigurationsdoku einen Graphen; aus dem Graphen entstehen die Formulare. Ein Schlüssel eines neuen Masterportal-Stands erscheint mit dem nächsten Doku-Stand von selbst. Die eingelagerte Doku steht unter MIT-Lizenz.

Prüfen vor dem Schreiben

Der Prüflauf meldet jeden Schlüssel, dem eine Doku-Entsprechung fehlt, jeden Layer, dem der Eintrag in der Dienstedatei des Portals fehlt, und jeden offenen Verweis auf Style- und REST-Dienste. Vor dem Speichern zeigt eine Diff-Vorschau jede Zeile, die sich ändert.

Sicherung und Rückweg

Vor jedem Schreibvorgang wandert die Vorfassung in die Sicherungswurzel des Bereichs. Gesicherte Stände lassen sich ansehen und zurückholen, die Werkseinstellung wiederherstellen und das Portal mit seiner Vorlage vergleichen.

Aus der Doku zu bauen hält das Werkzeug am Masterportal-Stand: Ein Update bringt seine neuen Schlüssel über den Doku-Stand mit, und der Graph-Lauf zeigt sie unmittelbar.

Funktionen

Was der Builder umfasst

Zehn Funktionen decken Portale, Menüs, Themenbaum, Dienste und den Weg zurück ab.

  • Portale eines Bereichs erkennen: jeder Ordner mit einer Konfigurationsdatei unmittelbar darin, als Vorlage mit eigener Endung oder als Datei im Masterportal-Namen
  • Mehrere Portal-Bereiche nebeneinander, jeder mit eigener Vorlagenendung, eigenem Schreibrecht und eigener Sicherungswurzel
  • Generische Formulare für Text, Zahl, Wahrheitswert, Auswahl, Koordinate und Ausschnitt, Layer-Id, Unterobjekte und Objektlisten, mit Kennzeichnung von Pflicht- und Expertenfeldern
  • Module je Menüabschnitt anlegen, entfernen und umsortieren; eigene Add-ons stehen hervorgehoben in derselben Auswahl
  • Themenbaum der Layer mit Sichtbarkeit, Ordnern und dem Einfügen von Layern aus der Dienstedatei
  • Diensteliste aller Layer eines Portals, durchsuchbar; WMS und VectorTile im vollen Formular, die übrigen elf Layertypen als Roh-JSON
  • Formattreues Zurückschreiben: Einrückung und Reihenfolge bleiben, der Versionsverlauf zeigt allein die geänderten Zeilen
  • Platzhalter der Vorlagen überstehen den Weg durch das Formular unverändert
  • Assistent in sechs Schritten für ein neues Portal, mit Bauplan aus einer Vorlage und einer Herkunftsdatei
  • Verweis auf die laufende Portalseite aus dem Adressmuster des Servers

Einsatz

Stand und Praxis

Prüfläufe, Testläufe und der Weg auf den Kundenserver beschreiben den heutigen Stand.

  • Prüfläufe auf der Kommandozeile: der Graph-Lauf baut den Portal-Graphen und meldet Doku-Warnungen, der Formattreue-Lauf liest und schreibt jede Vorlage und vergleicht den Text
  • Testlauf über Vitest zu Prüfmaß, Whitelists, Doku-Normalisierer, Bauplan, Anlegeweg und den Zwillingen aus Oberfläche und Dienst
  • Der Schreibdienst führt einen eigenen Testlauf mit 2066 Fällen, der allein mit lokalen Dateien arbeitet
  • Der Graph-Lauf ist der erste Test nach einem Masterportal-Update: er zeigt die Schlüssel, die der neue Doku-Stand mitbringt
  • Auslieferung mit einem Befehl auf den Kundenserver
  • Zwei Beispielportale liegen im Repo und dienen zugleich als Testgrundlage

IT

Voraussetzungen und Betrieb

Eine statische Oberfläche, ein schmaler Schreibdienst daneben und eine Konfigurationsdatei, die beide führt.

  • Node für Bau und Betrieb der Oberfläche
  • Die Oberfläche entsteht als statische Seite; ein gewöhnlicher Webserver liefert sie aus, im Entwicklungsbetrieb hört sie auf Port 9004 an der lokalen Adresse
  • Der Schreibweg läuft als Python-Dienst; jeder Aufruf verlangt ein Token mit der konfigurierten Rolle
  • Konfiguration in einer eigenen Datei: die Portal-Bereiche mit Kennung, Wurzel und Vorlagenendung, dazu Schreibrecht, Sicherungswurzel und die Zahl der behaltenen Stände mit der Vorgabe 30
  • Eingelagerte Masterportal-Doku für die beiden Graphen; mehrere Stände liegen nebeneinander, die Konfiguration wählt einen aus

Läuft auf

Masterportal 3.x, Webpack- und Vite-Fassung Masterportal-Doku und Masterportal-Konfiguration Node.js Python-Dienst für den Schreibweg

Der Schreibdienst bleibt schmal: Er nimmt den fertigen Dateitext entgegen, prüft ihn gegen Kennung, Pfadklammer und Dateiliste, sichert den alten Stand und schreibt. Formular, Diff und Bauplan rechnet der Browser.

Fragen

Häufige Fragen

Fünf Fragen aus Portalbetrieb und IT.

Woher kommen die Felder der Formulare?

Aus der Masterportal-Doku. Der Doku-Baustein des Masterportal-Projekts macht daraus einen Graphen mit Schlüsseln, Typen, Vorgaben und der Kennzeichnung als Pflicht- oder Expertenfeld; die Oberfläche baut ihre Formulare daraus. Ein neuer Doku-Stand bringt neue Schlüssel selbsttätig mit.

Wie sicher ist das Zurückschreiben einer laufenden Konfiguration?

Drei Stufen tragen den Schritt: die Diff-Vorschau vor dem Speichern, die Sicherung der Vorfassung mit Zeitstempel und das formattreue Schreiben. Jeder gesicherte Stand lässt sich zurückholen; der Stand aus dem Anlegen bleibt als Werkseinstellung dauerhaft stehen.

Läuft das Werkzeug auch als reines Leseinstrument?

Ja. Solange der Schreibweg zubleibt, antwortet der Server auf einen Speicherversuch mit einer Klartextmeldung, und der Speichern-Knopf bleibt unbedienbar; die Diff-Vorschau rechnet der Browser und steht weiterhin bereit. Dasselbe Schalten gibt es je Portal-Bereich.

Wie kommt ein eigenes Add-on in die Modulauswahl?

Über ein Doku-Kapitel im Format der Masterportal-Doku, deutsch und englisch, mit der Tabelle seiner Schlüssel. Der Graph-Lauf nimmt es auf, danach steht das Modul mit eigenem Formular in der Auswahl beider Menüs.

Wie läuft die Auslieferung auf den Kundenserver?

Der Bau erzeugt die statische Seite samt den beiden vorberechneten Doku-Graphen und der Drittanbieterliste; ein Befehl kopiert sie an ihren Ort auf dem Server. Die Anmeldedatei der Installation bleibt dabei stehen.