HTML Reporting Framework

HTML Reporting im LIMS-Kontext

Ein kontextsensitives Reporting-Konzept für LabWare/LIMS, das HTML, SQL, JavaScript und LIMS-Kontext gezielt zusammenführt.

Das Framework wurde als Alternative zu klassischen Crystal-Reports aufgebaut: mit stärkerer Integration in LIMS, höherer Wartbarkeit und deutlich besseren Möglichkeiten für interaktive, kontextbezogene Auswertungen.

Im Kern ist es kein einzelner Report, sondern ein Framework : Templates, Parser, Kommandos, SQL, User-Dialoge und Browser-Ausgabe greifen ineinander und erzeugen aus einem HTML-Template einen konkreten Report für den aktuellen Fachkontext.

Spotfire-Integration innerhalb des HTML Reporting Frameworks
Einbettung externer Analysen in den HTML-Main-Frame. Das Framework steurt Anzeige und Kontext der verlinkten Inhalte.

Warum dieses Framework entstanden ist

  • Unzureichende Integration klassischer Crystal-Reports in LIMS-Prozesse
  • Schwierige Wartbarkeit und proprietäre Reportdateien
  • Schwache Unterstützung für heterogene Kontexte und interaktive Use Cases
  • Bedarf an tiefer Einbettung in Menüs, Folder, Result Entry, Info Rules und Visual Workflows

Ziel: Eine belastbare Reporting-Plattform, die fachlichen Kontext, Datenzugriff und UI-Verhalten zusammenführt.

Technologischer Zuschnitt

HTML, CSS und JavaScript für Darstellung und Interaktion, SQL/PL-SQL für Datenzugriff sowie LIMS Basic als Parser- und Orchestrierungsschicht.

Damit lassen sich einfache Reports ebenso wie interaktive Seiten mit Diagrammen, eingebetteten Web-Anwendungen oder kontextangereicherten Links umsetzen.

Bausteine: HTML Templates, LIMS Basic Parser, SQL/PL-SQL, CSS/JavaScript, EJS Charts, Spotfire Integration.

Konzept: Template + Kontext + Parser

Ein HTML-Template enthält Platzhalter, Selektoren und Kommandos. Beim Aufruf lädt das Framework die Datei, interpretiert Befehle, ersetzt Variablen und rendert eine fertige Seite.

  • Template: HTML mit Platzhaltern wie <<TABLE.FIELD>>
  • Kontext: Projekt-, Sample-, Result-, User- oder Multi-Selection-Kontext
  • Parser: Führt SQL/Subroutinen aus und ersetzt Kommandos rekursiv
  • Ausgabe: Browser, Dialog, eingebettete Anzeige, Druck oder Clipboard
Template mit Platzhaltern und Reporting-Kommandos
Templates kombinieren HTML-Struktur mit Platzhaltern, Include-Dateien und Reporting-Kommandos.

Requirements Engineering

  • Reports müssen den aktüllen Arbeitskontext korrekt aufnehmen
  • Wiederverwendbare Templates statt Einmallösungen
  • Fehlender Kontext über parametrisierbare User-Dialoge
  • Integrierbar in bestehende LIMS-Module
  • Interaktive und externe Inhalte ohne Medienbruch
Parameterdialog für HTML-Reporting
User-Dialoge ergänzen oder präzisieren den Reportkontext.

Fachlicher Mehrwert

  • Reportdefinitionen bleiben nah an der Fachsicht
  • Kontextlogik ist explizit und nachvollziehbar
  • SQL, Layout und Interaktion sind modular erweiterbar
  • Neu Reports entstehen schneller durch bekannte Muster

Architektur auf einen Blick

  • Präsentationsschicht: Templates, CSS, JavaScript, Tabellen, Charts, eingebettete Web-Inhalte
  • Steurungs-/Parserschicht: Subroutinen laden Templates, interpretieren Selektoren und setzen Kontextvariablen
  • Daten-/Fachlogikschicht: SQL, PL/SQL und REP-Package liefern angereicherte Daten
  • Integrationsschicht: Einbindung in Project Manager, Folder, Result Entry, Info Rules und Visual Workflows

Die Architektur ist evolutiv: kein harter Plattform-Neubau, sondern systematische Erweiterung vorhandener LIMS-Mechanismen.

Diagrammausgabe im HTML Reporting Framework
Typische Reportausgabe mit Charts im eingebetteten HTML-Umfeld.

Interaktion und Visualisierung

Die Reports sind nicht auf Tabellen beschränkt: Charts, CSV-basierte Visualisierung, Barcode-Einbindung, Tree-Views und Web-Embedding sind möglich.

CHARTX-/CHARTY-Konventionen, Formatierungsattribute und wiederverwendbare Bibliotheken reduzieren den Implementierungsaufwand und fördern Konsistenz.

So entsteht ein flexibler Reporting-Stil ohne Zerfall in isolierte Einzellösungen.

Spotfire als Integrationsmuster

Das Framework stellt einen HTML-Main-Frame bereit, der externe Inhalte per IFrame hostet. Eine Combobox steurt die Ziel-URL.

Der Mehrwert liegt in kontextangereicherten Links : LIMS-Werte wie Produktcode, Analyse oder Status werden zur Laufzeit in Ziel-URLs eingesetzt.

Damit wird aus einem statischen Link ein kontrollierter Integrationspunkt zwischen LIMS und Analyseplattform.

Spotfire-Auswahl über Dropdown mit kontextangereicherten Links
Kontextsensitive Zielauswahl: Dropdown + Laufzeitparameter aus dem LIMS-Kontext.

Wesentliche Integrationspunkte

  • Project Manager für Standard- und Spezialreports
  • Folder-Kontext mit Multi-Sample/Test/Result-Selektionen
  • Standard Reagent Manager für HTML-Reports und Rezeptlogik
  • Result Entry und Info Rules für Kontextinformationen
  • Visual Workflow Pane als Host für interaktive HTML-Seiten

Fazit

Das HTML Reporting Framework verbindet Requirements Engineering, pragmatische Architektur und konkrete Implementierbarkeit auf direktem Weg.

Die Stärke liegt in der gezielten Passung zum Problemraum: kontextsensitives Reporting, Wiederverwendung, Integration und schrittweise Erweiterbarkeit.

Gerade in komplexen Labor- und Prozesslandschaften ist diese Kombination oft wertvoller als ein formal moderner, aber schlecht integrierter Reporting-Stack.