Die folgenden Diagramme zeigen Zeitreihen-Plots (am Beispiel von Umweltdaten) mit "Rangeslider" auf Basis des JavaScript Plot-Frameworks Plotly.js. Die Zeitreihen behandele ich als eine Einheit, wobei ich folgende Bedienlogik realisiert habe:

• In dem Diagramm, dessen Rangeslider aktiviert ist (siehe Checkbox am jeweiligen Diagramm), kann mit der linken Maustaste im Plot ein Zeitbereich ausgewählt und anschließend mit dem Rangeslider durch den Gesamtbereich gescrollt werden. Das Zoomen und Scrollen findet dabei über allen Diagrammen synchron statt. Bei Doppelklick in den Plot-Breich wird der ursprüngliche Zustand über allen Diagrammen wieder hergestellt.

• Mit dem Button "Scale Y Axis" kann die Y-Achse auf den Wertebereich der sichtbaren Daten skaliert werden. Dies ist nützlich, wenn in einen Zeitbereich mit geringen Wertänderungen hineingezoomt wurde. Bei einer zweiten Betätigung wird der ursprünglche Zustand der Y-Skalierung wieder hergestellt. Bei Doppelklick in irgendein Diagramm werden alle Y-Achsen gemeinsam wieder hergestellt.

• Beim Überfahren der Plots mit der Maus wird das Koordinatenpaar des nächstgelegenen Punktes angezeigt.

• Im Menü "Shape" kann die Kurvendarstellung eingestellt werden. Spline: Die Messwerte werden durch eine Spline-Approximation verbunden. Linear: Die Messwerte werden durch eine gerade Linie verbunden. Marker: Die Messwerte werden nicht verbunden, sondern durch einen Punkt dargestellt. Quality: Wie Marker, nur dass in der Farbe des Punktes eine dritte Dimension (hier: die Qualität des Messwerts) kodiert ist.

• Mittels des Buttons "Download as PNG" kann das Diagramm als Grafik heruntergeladen werden. Soll er Rangeslider darauf nicht erscheinen, bietet es sich an, diesen vorher wegzuschalten.

• Die geplotteten Daten sind nicht Teil der HTML-Seite (!), sondern werden per Ajax-Request von einer anderen Site via Cross-Origin Resource Sharing asynchron geladen.

• Sonderfall "Keine Daten": Das letzte Diagramm (GlobalRadiation) zeigt die Darstellung, wenn im gegebenen Zeitbereich keine Daten vorliegen.

In einer Webanwendung, die Daten über Formulare pflegt/verwaltet, ist es essentiell, die Eingabedaten vor der Speicherung akribisch zu prüfen.

Im Falle einer Regelverletzung wird mit einer aussagekräftigen Fehlermeldung zum ausgefüllten Formular zurückgekehrt und auf das betreffende Eingabefeld positioniert (also der Eingabefokus gesetzt).

Wie lässt sich dies effektiv erreichen?

• Die Prüfmethoden sind in der Klasse Quiq::Assert enthalten

• Wir führen die Tests in einem eval-Block durch

• Im Falle einer Regelverletzung wird eine Exception ausgelöst, der Prüfblock sofort verlassen und mit Fehlermeldung zum Formular zurückgekehrt

if ($aktion eq 'Speichern') {
    my $field;
    eval {
        my $val;

        my $a = Quiq::Assert->new;

        $field = 'NAME1';
        $val = $self->param($field)
        if (!$a->METHOD1($val)) {
            die "FEHLER: $field verletzt METHOD1\n";
        }
        if (!$a->METHOD2($val)) {
            die "FEHLER: $field verletzt METHOD2\n";
        }
        ...
        $field = 'NAME2';
        $val = $self->param($field);
        if (!$a->METHOD3($val)) {
            die "FEHLER: $field verletzt METHOD3\n";
        }
    };
    if ($@) {
        $@ =~ s/\n$//;
        my $url = '/FORMULAR?'."navMsg=$@&navFocus=$field&".
            $self->req->params->to_string;
        $self->redirect_to($url);
        return;
    }
    ...
}

Ausgangslage: Wir möchten hochstrukturierte XML-Dateien erzeugen, beispielsweise E-Rechnungen nach den Standards ZUGFeRD und XRechnung.

Ablauf

1. Einlesen des betreffenden XML-Templates mit Platzhaltern

2. Wandlung des XML-Templates in eine hierarchische Datenstruktur der Programmiersprache (XML-Baum)

3. Ersetzen der Platzhalter im XML-Baum durch konrete Werte

4. Entfernen aller unersetzten Platzhalter

5. Entfernen aller leeren Knoten des Baums (rekursiv)

6. Wandeln des resultierenden Baums in XML-Code

XML::Compile

Als wichtigstes Hilfsmittel zur Durchführung der Aufgabe verwenden wir das Perl-Package XML::Compile. Es leistet (unter Rückgriff auf die betreffende XML Schemadefinition) Folgendes:

• Es generiert ein XML-Template zur Schemadefinition

• Es übersetzt XML-Code (z.B. das Template) in eine Datenstruktur (XML-Baum), die mit Mitteln der Programmiersprache (Perl) bearbeitet werden kann

• Es rückübersetzt den finalen XML-Baum in XML-Code