Zum Inhalt springen
Fachebenen als schwebende Glasplatten über einem Stadtmodell — Luftbild, Flurstücke, Höhenlinien, Gebäude, Straßen, Leitungen, Grün und Vermaßung; leuchtende Linien führen sie in einer DXF-Datei zusammen

DXF-Service

Kartografische DXF aus den Layern Ihres Portals: Gebiet in der Karte wählen, Zeichnung herunterladen.

Planungsbüros und CAD-Arbeitsplätze arbeiten mit Zeichnungen. Der DXF-Service macht die WMS- und WFS-Layer eines Masterportals zu genau solchen Zeichnungen: Im Portal wählt die Sachbearbeitung das Gebiet als Kartenausschnitt, Rechteck oder Polygon, legt Layer, Maßstab und DXF-Fassung fest und startet den Export. Der Dienst holt die Daten, baut die Zeichnung und stellt sie als Download bereit.

Überblick

Zwei Teile, vier Endpunkte

Die Bedienung sitzt im Portal, die Rechenarbeit im Dienst daneben. Beide sprechen über eine feste Schnittstelle miteinander.

Add-on im Masterportal

Das Add-on dxfexporter bringt die Bedienung ins Portal: Gebietswahl in der Karte, Formular für Layer, Maßstab und DXF-Fassung, Fortschritt und Download. Es läuft in Vue 3 mit Vuex und zeichnet über OpenLayers aus dem Masterportal-Bundle.

Dienst im Hintergrund

Der Dienst läuft als Node.js-Anwendung mit Express. Er holt die Vektordaten der WFS-Layer und die Bilder der WMS-Layer, baut daraus die Zeichnung und legt das Ergebnis zum Abruf bereit. Das Add-on ist sein Konsument; die Verständigung läuft über vier Endpunkte.

Der Schnitt zwischen beiden Teilen bleibt stabil: die vier Endpunkte und der Aufbau von config/layers.json tragen die Verständigung abwärtskompatibel weiter.

Funktionen

Vom Kartenausschnitt zur Zeichnung

Sieben Funktionen tragen den Weg vom gewählten Gebiet bis zur fertigen Datei.

Was der Export leistet

  • Gebietswahl als Kartenausschnitt, gezeichnetes Rechteck oder gezeichnetes Polygon
  • Auswahl der Layer, des Maßstabs und der DXF-Fassung; der Dienst führt die Fassungen 12 bis 2018 mit der Vorgabe 2018 und die Maßstäbe 500 bis 10.000
  • Layer-Modus logisch oder physisch, je nach gewünschter Ebenenstruktur der Zeichnung
  • Auftragslauf mit Fortschrittsmeldung: der Auftrag liefert sofort eine Auftragsnummer, das Add-on fragt den Stand alle zwei Sekunden ab und zeigt Fortschritt, Meldung und Warnungen
  • ZIP-Paket aus DXF, Rasterbild und Worldfile, sobald WMS-Layer im Auftrag stehen
  • Teilausfälle einzelner Layer laufen als Warnungen mit; der Auftrag liefert die übrigen Layer aus
  • Layer-Varianten als eigene Dateien je Installation, umgeschaltet auf config/layers.json

Die vier Endpunkte

Endpunkt Zweck
GET /api/config Layer, Maßstäbe, DXF-Fassungen und Vorgabe für das Formular
POST /api/export Auftrag anlegen; Antwort mit Auftragsnummer und Stand
GET /api/status/:jobId Stand, Fortschritt, Meldung, Warnungen, Downloadweg
GET /api/download/:jobId Ausgabe der DXF-Datei oder des ZIP-Pakets

Der Auftrag läuft im Hintergrund: Die Antwort kommt sofort mit einer Auftragsnummer zurück, den Rest holt das Add-on über den Stand ab. Die Portaloberfläche bleibt während des Laufs bedienbar.

Einsatz

Stand und Praxis

Der Dienst läuft im Regelbetrieb; diese Punkte beschreiben seinen geprüften Stand.

  • Unit-Tests decken den WFS-Zugriff, die Sicherheits-Middleware und den Auftragslauf; Integrationstests laufen über alle vier Endpunkte
  • Aufträge leben im Arbeitsspeicher des Dienstes; ein Aufräumlauf alle 15 Minuten entfernt Aufträge, die älter als eine Stunde sind, samt ihren Dateien
  • Im Einsatz als DXF-Ausgabe von ALKIS Direkt und im Masterportal-Portal der Stadt Siegburg

IT

Voraussetzungen und Betrieb

Der Dienst läuft auf einem Server Ihres Hauses, neben dem Portal oder auf einer eigenen Maschine.

  • Masterportal 3.x, Webpack- und Vite-Fassung, mit dem Add-on dxfexporter in der Portalkonfiguration; serviceUrl ist das einzige Pflichtfeld
  • Node.js für Dienst und Add-on
  • Standard-Port 3001, über die Umgebungsvariable PORT wählbar
  • Reverse Proxy auf denselben Origin wie das Portal oder eine CORS-Freigabe für den Portal-Origin
  • config/layers.json als Quelle der Layerliste: WFS-Layer führen Id, Name, WFS-Adresse und Feature-Typ, WMS-Layer Id, Name, WMS-Adresse und Layernamen
  • Freigabeliste ALLOWED_PORTAL_ORIGINS: sie beschränkt die Zugriffe auf die Schnittstelle, die CORS-Antworten und die Einbettung der Seite

Läuft auf

Masterportal 3.x, Webpack- und Vite-Fassung Node.js mit Express WMS- und WFS-Dienste des Portals

Für den Produktivbetrieb liegen Anleitungen für Linux mit systemd und Reverse Proxy sowie für Windows-Server bei.

Fragen

Häufige Fragen

Fünf Fragen aus Portalbetrieb und Fachbereich.

Welche Layer stehen im Export zur Wahl?

Die Datei config/layers.json führt die Layerliste je Installation; der Endpunkt für die Konfiguration gibt daraus die freigeschalteten Layer an das Formular. Ein Layer mit dem Merkmal enabled auf false bleibt aus Liste und Auswahl heraus. Für Portale mit eigenem Bestand liegen Layer-Varianten als eigene Dateien bereit und werden je Installation auf config/layers.json umgeschaltet.

Wie kommt ein Rasterbild in die Zeichnung?

WMS-Layer liefern ein Bild samt Worldfile mit der Verortung. Sobald ein WMS-Layer im Auftrag steht, liefert der Dienst ein ZIP-Paket aus DXF, Rasterbild und Worldfile; das CAD-Programm legt das Bild damit lagerichtig unter die Zeichnung.

Wie lange steht ein fertiger Export bereit?

Eine Stunde. Der Aufräumlauf des Dienstes prüft alle 15 Minuten und entfernt ältere Aufträge samt Dateien. Ein neuer Lauf über dasselbe Gebiet dauert wenige Augenblicke.

Was geschieht, wenn ein Layer-Dienst gerade ruht?

Der Auftrag läuft weiter und liefert die übrigen Layer aus; der ausgefallene Layer erscheint als Warnung im Stand des Auftrags und im Add-on. Fallen sämtliche WFS-Layer aus, endet der Auftrag mit einer Meldung.

Wie bindet sich der Dienst an ein vorhandenes Portal?

Das Add-on kommt in die Portalkonfiguration und trägt dort die Adresse des Dienstes als serviceUrl. Der Dienst läuft hinter einem Reverse Proxy auf demselben Origin wie das Portal; alternativ gibt die Freigabeliste den Portal-Origin für CORS frei. Der Austausch läuft allein über die vier Endpunkte.