Zum Hauptinhalt springen

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|}

Es gibt zwei Zeilenwiederholungen:
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

## Spaltenwiederholung

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.