Print 🖨️

Im Masterportal können MapFish Print Servlets angebunden werden. MapFish Print ist eine etablierte JAVA-Software zum Erstellen von Map-Reports. Es werden Jasper Reports Templates unterstützt, hierzu gibt es einen GUI-Editor: Link zur Community Edition.

Features

• Druck von Raster- und Vektorkarten
• Nordpfeil
• Maßstabsleiste
• Koordinatengitter
• Legendendruck
• Tabellendruck
• Grafiken in Bildern
• Hinzufügen freier Layoutlemente (Boxen, Schriftzüge etc.)
• ... 💁‍♂️ Beispielkonfigurationen

Installation des Print Servlets

• Download des WAR-Files, Serve via Tomcat oder Jetty
• Docker: Offizelles Image mit vielen Konfigurationsparamtern

Minimal Beispiel Mapfish Print Docker Service

Voraussetzung: Print Templates

Quickstart:

docker run --rm --name "mapfish-print" -p 8080:8080 -v `pwd`/print_templates/default:/usr/local/tomcat/webapps/ROOT/print-apps/ camptocamp/mapfish_print:3.30

Erläuterung des Befehls:

• Es wird ein neuer Container mit den Namen mapfish-print (--name) auf Basis des Images camptocamp/mapfish_print:3.30 gestartet.
• Der Port 8080 des Containers wird auf den lokalen Port 8080 gemappt (-p)
• Der Container wird beim Beenden automatisch entfernt entfernt (--rm).
• Es wird das Verzeichnis print_templates/default im aktellen Pfad gemounted (-v). Dies wird im Container in den Pfad /usr/local/tomcat/webapps/ROOT/print-apps gemounted.

Service in einem docker compose File:

  print:
    image: camptocamp/mapfish_print:3.30
    container_name: print
    volumes:
      - ./print_templates/default:/usr/local/tomcat/webapps/ROOT/print-apps:Z
    ports:
      - 8080:8080

Konfiguration MapFish Print

1. Ein MapFish Print Servlet kann mehrere Print Apps haben. In den meisten Fällen reicht eine Print App, diese wird standardmäßig default genannt.
2. In der Printapp befindet sich die Konfigurationsdatei config.yaml, diese kann auch eine JSON Datei sein.
3. In der config.yaml werden verschiedene Templates konfiguriert, z.B. für DIN A4 Querformat oder DINA4 Hochformat:

templates:
  A4 Querformat: !template
    reportTemplate: a4_landscape.jrxml
    attributes:
      title: !string
        default: "Countries"
      map: !map
        maxDpi: 400
        width: 786
        height: 539
        zoomLevels: !zoomLevels
          scales: [250, 500, 1000, 2500, 5000, 10000, 25000, 50000, 100000]
      northArrowDef: !northArrow
        size: 25
        default:
          backgroundColor: "rgba(214, 214, 214, 0)"
      scalebar: !scalebar
        width: 195
        height: 20
        createSubReport: true
        default:
          backgroundColor: "rgba(214, 214, 214, 0)"
          align: "center"
          barBgColor: "rgba(255, 255, 255, 255)"
          fontSize: 7
          barSize: 3
          color: "rgba(0, 0, 0, 255)"
          geodetic: false
          intervals: 4
          lineWidth: 1
          unit: "m"
      showLegend: !boolean
        default: false
      legend: !jsonDatasource {}
    processors:
      - !reportBuilder
        directory: "."
      - !createMap {}
      - !createNorthArrow
        inputMapper:
          northArrowDef: northArrow
      - !createScalebar {}

1. Der Key reportTemplate verweist auf ein konkretes Template, z.B. a4_portrait.jrxml. Diese liegt in diesem Fall imselben Ordner wie die config.yaml.
2. Darüber hinaus können hier Geodaten abgelegt werden, die für Testdrucke genutzt werden können (ausführbar auf der Startseite bzw. Landingpage des Druck-Servlets).
3. Schriftarten und weitere Assets, wie etwa Grafiken für Logos, können in Unterordnern oder auch direkt auf der Ebene der Templates ablegt werden.

Defintion eines Druck Templates

Die Templates sind in jrxml verfasst und können wie jedes XML mit jedem Texteditor editiert werden. Eine Software mit GUI zur Verwaltung und Bearbeitung der Templates kann als Community-Edition heruntergeladen weden: Link zur Community Edition.

Aus Zeitgründen wird in diesem Workshop nicht genauer auf die Templates eingegangen.
📪 Meldet euch gern bei den Workshop-Leitern, wenn ihr mehr Infos oder generell mehr Input hierzu benötigt.

Konfiguration im Masterportal

rest-services.json

  {
    "id": "print",
    "name": "Print Service Test",
    "url": "http://localhost:8080/print/",
    "typ": "Print"
  }

config.json

    "print": {
    "name": "translate#common:menu.tools.print",
    "printServiceId": "print",
    "printAppId": "default",
    "filename": "Süderbrarup Ausdruck ${dd-MM-yyyy-HH-ss}",
    "title": "Mein Titel",
    "onlyDesktop": false
    }

Vollständige Konfigurationsparameter (doc/config.json.md):