Benutzer-Werkzeuge

Webseiten-Werkzeuge


javagraticule3d:report

Report der Ausgleichung

Der Ausgleichungsreport wird durch ein sogenanntes Template-System im HTML-Format erzeugt. HTML (Hypertext Markup Language) ist eine Auszeichnungssprache, die eine strukturierte Ausgabe von Inhalten ermöglicht und vorrangig im World Wide Web eingesetzt wird. Zur Darstellung von HTML-Dokumenten wird i.A. ein Browser verwendet. Die meisten Betriebssysteme liefern mindestens einen Webbrowser von hause aus mit, sodass keine zusätzliche Software zu installieren ist. Bei Linux ist es meist Mozillas Firefox und auf Windowsplattformen ist es Microsofts Internet Explorer.

Allgemeine Struktur eines HTML-Dokuments

Beim Erstellen von HTML-Dokumenten wird häufig versucht, Inhalt, Layout und Interaktionen zu trennen. Die inhaltliche Semantik wird durch die Struktur des HTML-Dokuments vorgegeben. Hierfür stehen Überschriften, Absätze, Tabellen oder Listen zur Verfügung. Zur Darstellung dieser Elemente wird i.d.R. auf CSS (Cascading Style Sheets) zurückgegriffen. CSS definiert somit die Größe, Farbe oder Ausrichtung von Inhalten im Dokument. Da HTML statisch ist, sind keine Interaktionen möglich. Abhilfe schafft hier die clientseitige Programmiersprache JavaScript. Alle drei Techniken kommen im Report zur Anwendung. Anpassungen in diesen Bereichen setzt somit ein gewisses Grundverständnis in diesen webbasierten Techniken voraus. Einen guten Einstieg bietet die deutschsprachige Onlinedokumentation SELFHTML.

Template-System

Das Template-System agiert auf der HTML-Ebene und liefert die eigentlichen Inhalte des Dokuments. Hierzu werden in den Template-Dateien Schlüsselwörter als Platzhalter eingefügt, die beim Export durch die entsprechenden Werte vom Programm ersetzt werden. Die Templates sind somit vollwertige HTML-Dateien, denen lediglich der Inhalt und die Formatierung fehlen. Zum Bearbeiten der ftlh-Files genügt somit ein einfacher Texteditor. Als Template-Engine kommt FreeMarker zum Einsatz, welches über eine umfangreiche Online-Dokumentation mit Beispielen verfügt.

Organisation eines Templates

Es können beliebig viele eigene Templates erzeugt werden. Damit die Ausgleichungssoftware die Templates findet, sind diese im Verzeichnis resources/ftl/ abzulegen. Jedes Template besteht aus einer Haupttemplatedatei und kann optional beliebig viele Subtemplates besitzen. Sowohl Haupt- als auch Subtemplatedateien haben die Endung *.ftlh. Befinden sich mehrere Templates im ftl-Verzeichnis, so werden diese als eigenständige Templates interpretiert und in der Applikation beim Erstellen eines Reports zur Auswahl gestellt. Es ist somit möglich, neben dem Default-Template eigene Vorlagen zu erstellen.

javagraticule3d/report.txt · Zuletzt geändert: 08.07.2017 20:13 von Michael Loesler