Berichtserstellung für Excel 2007+ in diaLIMS V8
Zu der Berichtserzeugung in diaLIMS gibt es ab v8 auch die Möglichkeit Inhalte in XLSX Dateien darzustellen. Die Erzeugung findet analog zu Kapitel "Berichtserstellung" statt, doch einige Features werden hier im Detail für Excel beschrieben.
Benennung der Vorlagen
Die Benennung ist analog zu der docX Benennung. Unterschied hier jedoch, dass die Vorlage eine XLSX Datei aus Microsoft Excel 2007+ ist. XLS oder .ods werden nicht unterstützt. Für Berichte im XLS Format finden Sie Informationen im Abschnitt "Module / Abfragen"
Zusätzliche Einstellungen
Neben der Auswahl der Berichtsvorlage können im Druckdialog noch zusätzliche Einstellungen zur Erzeugung eines Berichts vorgenommen werden.
Berichtserstellung - Schritt für Schritt
Nach dem Starten der berichtserzeugung werden nacheinander folgende Funktionen automatisch von diaLIMS durchgeführt, um die Vorlage zu füllen. Wenn die Vorlage mehrere Sheets beinhaltet, wird diese Reihenfolge auf jeden Sheet einzeln erneut angewendet.
- Print First Sheet evaluieren. Der letzte Aufruf muss return null; zurückgeben analog zu den docX Berichten. Der Sheet muss als PRINT_FIRST benannt sein, damit diaLIMS diesen erkennt.
- Run_First Sheet evaluieren. Hier werden die Zellen der ersten Spalte des RUN_FIRST Sheets evaluiert. Auch hier muss ein return null der letzte Aufruf sein.
- Reihenwiederholung anwenden. Siehe Abschnitt Reihenwiederholung
- Spaltenwiederholung anwenden. Siehe Abschnitt Spaltenwiederholung
- Einfügen von Spalten- und Reihennummern.
- Formatierung. Formatierung der Zellen anwenden.
Reihenwiederholung
Mit den Tags {|row:[Integer]} (Anfang der Wiederholung) und {:row|} (Ende der Wiederholung) wird die Reihenwiederholung ausgelöst wie in docX Vorlagen. [Integer] wird ersetzt durch die entsprechende Anzahl an durchzuführenden Wiederholungen. Integer=0 (Zeile löschen) bislang nicht implementiert.
Es ist möglich die Zeilenwiederholung zu schachteln und so Zeilen während einer anderen Zeilenwiederholung wiederholen zu lassen. Dies ist bis zu einer Tiefe von 6 ineinander geschachtelten Schleifen möglich. Die Zählvariablen entsprechend der Tiefe sind dabei wie folgt: 'i', 'j', 'k', 'l', 'm' und 'n'.
-
Beispiel
Probennahmeprotokoll gruppiert nach Analyse-Art:
Das unten aufgezeigte Beispiel zeigt ein Nahmeprotokoll für Proben. Die Messungen sind nach Analyse-Art untereinander gruppiert und die Proben werden spaltenweise ausgegeben. Der Platzhalter für die Spaltenwiederholung ist auf 'a' gestellt.
|
A |
B |
C |
D | |
|---|---|---|---|---|
|
1 |
Probe |
{|col:o.size()}{o.get(a).kurzbezeichnung} | ||
|
2 |
Probe Beschreibung |
{o.get(a).beschreibung} | ||
|
3 |
Produkt |
{o.get(a).produkt.kurzbezeichnung} | ||
|
4 |
{|row:anaArt.size()}{anaArt.get(i)} | |||
|
5 |
Analyse |
Ergebnis |
Messung | |
|
6 |
{|row:anaGroupMap .get(anaArt.get(i)).size()} {anaGroupMap .get(anaArt.get(i)).get(j) .analyse.kurzbezeichnung} |
{anaGroupMap .get(anaArt.get(i)) .get(j).kurzbezeichnung} |
{bc.getEWForXLSX(o.get(a), Printer.getCellAt(<row>,0).toString(), Printer.getCellAt(<row>,1).toString())} {:row|} |
{:row|} |
|
7 |
{:col|} |
1. Wiederholung der Analyse-Art Gruppen
2. In jeder Gruppe werden die Messungen \(mit Analyse und Ergebnis\) wiederholt
Die Proben werden über eine Spaltenwiederholung ausgegeben.
Erzeugter Bericht:
|
A |
B |
C |
D |
E | |
|---|---|---|---|---|---|
|
1 |
Probe |
P2022000001 |
P2022000002 |
P2022000003 | |
|
2 |
Probe Beschreibung |
Probe 1 |
Probe 2 |
Probe 3 | |
|
3 |
Produkt |
Trinkwasser |
Trinkwasser |
Trinkwasser | |
|
4 |
Physik., phys.-chem. und chem. Prüfungen | ||||
|
5 |
Analyse |
Ergebnis |
Messung |
Messung |
Messung |
|
6 |
PH |
PH |
6,6 |
7,2 |
8,3 |
|
7 |
T |
T |
20,0 |
22,2 |
21,7 |
|
8 |
Sensorik | ||||
|
9 |
Analyse |
Ergebnis |
Messung |
Messung |
Messung |
|
10 |
AUSSEHEN |
FORM |
flüssig |
flüssig |
flüssig |
|
11 |
AUSSEHEN |
FARBE |
farblos |
farblos |
farblos |
|
12 |
AUSSEHEN |
GERUCH |
geruchlos |
geruchlos |
geruchlos |
|
13 |
Stoffgehalt | ||||
|
14 |
Analyse |
Ergebnis |
Messung |
Messung |
Messung |
|
15 |
NH4 |
NH4 |
0,0 |
0,0 |
0,0 |
|
16 |
AS |
AS |
0,0 |
0,0 |
0,0 |
|
17 |
PB |
PB |
0,0 |
0,0 |
0,0 |
Analog zu Reihenwiederholung. Verwendet werden {|col:[Integer]} und {:col}.Hier sind jetzt im Vergleich zu docX auch Kreuztabellen möglich mit dynamischen Spaltenanzahlen!
Es ist möglich die Spaltenwiederholung zu schachteln und so Zeilen während einer anderen Spaltenwiederholung wiederholen zu lassen. Dies ist bis zu einer Tiefe von 6 ineinander geschachtelten Schleifen möglich. Die Zählvariablen entsprechend der Tiefe sind dabei wie folgt: 'a', 'b', 'c', 'd', 'e' und 'f'.
Einfügen von Reihen- und Spaltennummern
Die Tags <cell> und <row> werden in diesem Schritt durch die aktuelle Spalten- bzw. Reihennummern ersetzt.
Formatierung der Zellen anwenden
Feld als Double formatieren
Mit dem tag <double ...> können Zellen als Zahl formatiert werden. So können auch Excelformeln vorbereitet werden für dynamische Tabellen.
Für das Attribut "nks" kann der tag erweitert werden, wieviele nachkommastellen das Feld darstellen soll. Ideal zum richtigen Anzeigen von Ergebniswerten.
Beispiel:<double nks=2> formatiert die Zelle als Double mit 2 Nachkommastellen.
Chart einfügen
Mit dem Tag cod<chart XCoord=... YCoord1=...> kann eine Excelgrafik in die Zelle eingefügt werden.
Um die X-Achse und Y-Achse zu definieren, müssen die Koordinaten als Attribut wie folgt übergeben werden:
XCoord =Startreihe, Startspalte, Endreihe, Endspalte
Tip:
Erstellung einer Chart in XLSX
XCoord=0,0,10,0 startet in Zelle x0,y0 und endet in Zelle x0,y10
Hilfsmethoden für Berichtsvorlagen in XLSX
-
BerichtsController.getEWForXLSX Diese Methode schreibt einen String, der den passenden Ergebniswert zusammen mit einem Formatierungsstring um die ExcelZelle nach dem Ergebniswert zu formatieren. Parameter:
- probe Die Probe, aus der der Ergebniswert kommt.
- analyse Die Analysenkruzbezeichnung des gesuchten EWs
- ergebnis die Ergebniskurzbezeichnung des EWs
Zurückgegeben wird ein String mit einem XLSX Tag, um den Ergebniswert zu formatieren.
<double nks=3>13,2534
-
Integer XLSXPrinter.getColumnFromCellWithMatchingtext(String suchtext) Diese Methode liefert zu einem übergebenen Suchtext die entsprechende Spaltennummer zurück. Sehr hilfreich zum erzeugen von dynamischen Kreuztabellen, um herauszufinden, in welcher Spalte mein PH Wert eigentlich gelandet ist.
-
XSSFCell XLSXPrinter.getCellAt(int row,int col) (ADVANCED) Gibt die Zelle an Position row und col an. Methode kann im Bericht verwendet werden um Inhalte vor der Evaluierung der Inhalte einzufügen. So kann man schon im RUN_FIRST Script Inhalte der Zellen bestimmen.