Zum Hauptinhalt springen

Berichtscontroller

Der Berichtscontroller enthält viele Funktionen, die für die Erstellung von Berichtsvorlagen verwendet werden können.

Allgemeine Informationen​

Um eine Methode aus dem Berichtscontroller in einer Vorlage nutzen zu können muss dieser dort instanziiert werden. Dazu genügt ein Aufruf, der etwa so aussehen kann:

bc = com.dialog.dialims.printing.BerichtsController.getInstance();

Am Berichtscontroller können pro Vorlage gewisse Verhaltensweisen eingestellt werden. Bis jetzt sind folgende Einstellungen implementiert:

NameDatentypDefaultFunktionverwendet in
eWissenschaftlichbooleantrueSteuert wie exponentiale Ergebniswerte formatiert werden. Bei eWissenschaftlich=true werden sie so ausgegeben, wie sie im LIMS angezeigt werden (z.B. 5,3E04 für 53000). Bei eWissenschaftlich=false werden sie mit Hochzahlen formatiert (z.B. 5,3x10“4” für 53000).Alle getErgebnisWert()-Methoden, formatGWDouble()

Variablenkonstanten​

Über Konstanten kann auf bestimmte Datensätze oder den Printer, dem z.B. der Speicherort übergeben werden kann, zugegriffen werden.

Konstante

Beschreibung

Schlüssel zur Einstellung

Printer

Printer, der die Berichtserstellung durchführt

PRINTER

Objekt

Der Datensatz, für den der Bericht ausgeführt wird

kann auch eine Liste von mehreren Datensätzen sein

OBJEKT

Benutzer

angemeldeter Benutzer

BENUTZER

Bearbeiter

Ansprechpartner zum angemeldeten Benutzer

BEARBEITER

Die Konstanten können individuell im Modul Einstellungen gepflegt werden. Sie sind in der zwingend globalen Einstellungskategorie *AbstractPrinter.ConstantsForVariables* gespeichert und sind für alle Benutzer und Benutzergruppen sowie für alle Sprachen gültig.

CAUTION:

Eine individuelle Einstellung sollte nur einmalig erfolgen, da nach Änderung ggf. alle vorhandenen Berichtsvorlagen nicht mehr funktionieren bzw. angepasst werden müssen.

Methoden zur Darstellung von Messwerten​

Ergebniswert​

getErgebniswert(ZuordnungProbeAnalyseErgebnis zpae), getErgebniswert(Probe probe, Ergebnis ergebnis), getErgebniswert(Probe probe, String ergebnis)

Gibt den Mittelwert der übergebenen ZPAE zurück. Gibt es keinen Mittelwert, so wird das erste Ergebnis der ZPAE zurückgegeben, das kein Ausreißer ist.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • zpae

    Die ZPAE deren ErgebnisWert geholt werden soll.

  • probe

    Probe deren ErgebnisWert geholt werden soll.

  • ergebnis

    Ergebnis oder Ergebnis.kurzbezeichnung zu der der ErgebnisWert der Probe geholt werden soll.

Wenn probe und ergebnis übergeben wurden, wird zunächst die zpae ermittelt. Dann wird mit Hilfe der Methode getFirstCorrectResult() der erste ErgebnisWert ermittelt, der kein Ausreißer ist. Wenn es an der zpae einen Mittelwert gibt, wird dieser zusammen mit der Vorsilbe des vorher ermittelten ErgebnisWerts als Rückgabewert gesetzt. Gibt es keinen Mittelwert wird der ermittelte ErgebnisWert als Rückgabewert gesetzt.

Wenn es sich um ein exponentiales Ergebnis handelt, und eWissenschaftlich=false ist, wird der Rückgabewert noch umformatiert.

Diese Methode sollte immer verwendet werden, wenn ErgebnisWerte auszugeben sind.

Ergebniswerte einer Probe​

getErgebniswertVector(Probe probe, String ergebnis)

Gibt einen Vector zurück mit allen Ergebniswerten zu den ZPAEs mit Probe probe und Ergebnis mit Kurzbezeichnung ergebnis. Der Ergebniswert ist jeweils der Mittelwert der ZPAE. Gibt es keinen Mittelwert, so wird das erste Ergebnis der ZPAE genommen, das kein Ausreißer ist.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • probe

    Die Probe deren Messwerte ausgegeben werden sollen

  • ergebnis

    Kurzbezeichnung des Ergebnisses für das die Messwerte ausgegeben werden sollen.

Ruft für jede Probe getErgebniswert() auf und gibt die Rückgabewerte in einem Vector zurück.

Erster gültiger Messwert​

getFirstCorrectResult(ZuordnungProbeAnalyseErgebnis zpae)

Gibt den ersten ErgebnisWert einer ZPAE zurück, der nicht als Ausreißer markiert ist. Gibt null zurück, wenn alle ErgebnisWerte Ausreißer sind.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • zpae

    ZPAE, deren erster nicht als Ausreißer markierter ErgebnisWert zurückgegeben wird

Alle Ergebniswerte der zpae werden einzeln durchgegangen. Wird ein Ergebniswert gefunden, der kein Ausreißer ist, wird er zurück gegeben. Sind alle Ergebniswerte durchgegangen ohne dass ein passender Ergebniswert ermittelt wurde, wird null zurückgegeben.

Anwendungsbeispiel

Sollte nur verwendet werden, wenn an einem Ergebnis die Mittelwert-Berechnung eingeschaltet ist, aber explizit der erste gültige Messwert gesucht wird.

Ansonsten immer getErgebniswert() verwenden.

Mittelwerte​

getMittelwertToString(ZuordnungProbeAnalyseErgebnis zpae)

Gibt den Mittelwert als Text zurück.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • zpae

    Das Probenergebnis dessen Mittelwert ausgegeben werden soll.

Ermittelt den Mittelwert des Probenergebnisses und formatiert ihn wie die Messwerte. Dazu wird die Methode formatGWDouble verwendet.

Anwendungsbeispiel

In den meisten Prüfberichten ist es sinnvoll den Mittelwert auszugeben, statt eines bestimmten oder aller Einzelwerte.

Grenzwertsymbole​

getSymbolForGrenzwertVerletzung(ErgebnisWert ew, String grenzwertTyp, boolean mitMesswert), getSymbolForGrenzwertVerletzung(ZuordnungProbeAnalyseErgebnis zpae, String grenzwertTyp, boolean mitMesswert)

Diese Methode stellt eine vorliegende Grenzwertverletzung als Pfeilspitze dar.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • ew

    Der ErgebnisWert dessen Grenzwertverletzung angezeigt werden soll.

  • grenzwertTyp

    Die Art des Grenzwerts, für den die Verletzung angezeigt werden soll. Mögliche Werte: "SOLL", "GRENZ"

  • mitMesswert

    Wenn true, wird vor dem Symbol für die Verletzung der Messwert formatiert mit ausgegeben.

Wenn eine ZPAE übergeben wird, wird zunächst der zu prüfende ErgebnisWert mit Hilfe der Methode getFirstKorrektResults() ermittelt.

Wenn die ersten beiden Übergabeparameter nicht null oder leer sind, ermittelt die Funktion ob am ErgebnisWert eine Grenzwertverletzung für den übergebenen GrenzwertTyp vorliegt.

Wenn ja, dann wird das passende Symbol (Pfeilspitze nach oben oder unten) ermittelt. Ist mitMesswert == true wird der formatierte Messwert mit angehängtem Symbol als Text zurückgegeben. Falls nicht, wird nur das Symbol als Text zurückgegeben. Sind die Übergabewerte leer oder liegt keine passende GrenzwertVerletzung vor wird ein leerer Text zurückgegeben.

Anwendungsbeispiel

Die Methode kann zum Beispiel in der Messwertspalte einer Ergebnistabelle verwendet werden.

Methoden zur Darstellung von Grenzwerten​

Grenzwerte für numerische Ergebnisse​

formatGWDouble(Object ergebnis, Double gwWert)

Formatiert den Grenzwert eines Double-Ergebnisses.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • ergebnis

    ZuordnungProbeAnalyseErgebnis, ErgebnisWert (dessen Ergebnis bestimmt wird) oder das Ergebnis selbst, das für die Bestimmung der parameter für die Formatierung verwendet wird

  • gwWert

    Der Grenzwert, der verletzt wurde

Als erstes wird geprüft, was als Ergebnis übergeben wurde. Wenn es sich um eine ZPAE oder einen ErgebnisWert handelt, wird zunächst das zugehörige Ergebnis ermittelt. Wurde etwas anderes als ZPAE, ErgebnisWert oder Ergebnis übergeben, wird ein Leerstring zurückgegeben.

Dann wird der Ergebnis-Typ geprüft. Handelt es sich um ein Text-Ergebnis, das eine Wertemenge besitzt, wird das zum Grenzwert gehörende Element bestimmt und zurückgegeben.

Wenn es sich um ein Zeitdauer-Ergebnis handelt wird der Grenzwert als solches formatiert und zurückgegeben.

Wenn nicht, wird die Anzahl an Nachkomma- und signifikanten Stellen ermittelt und ob es sich um ein exponentiales Ergebnis handelt. Wenn das Ergebnis vom Format "wie eingegeben" ist, wir der Grenzwert unformatiert zurückgegeben. Ansonsten wird er mit Hilfe der vorher ermittelten Format-Merkmale formatiert. Bei exponentialen Ergebnissen wird die Einstellung EWissenschaftlich berücksichtigt. Anschließend wird der formatierte Grenzwert zurückgegeben.

Anwendungsbeispiel

Sollte verwendet werden, um die zu Messwerten angezeigten Grenzwerte zu formatieren, damit sie das gleiche Format wie die Messwerte haben. Wird in den getGrenzwert-Methoden verwendet.

Grenzwertbereich: Grenz_U - Grenz_O​

getGrenzwerteToString(ZuordnungProbeAnalyseErgebnis zpae)

Gibt einen formatierten Text mit den Grenzwerten zurück.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • zpae

    Das Probenergebnis, zu dem die Grenzwerte ausgegeben werden sollen

Wenn nur der untere Grenzwert eingetragen ist, wird dieser ausgegeben. Wenn es sich nicht um ein Wertemengenergebnis handelt, wird das in den Optionen definierte Größer-Zeichen vorangestellt.

Wenn nur der obere Grenzwert eingetragen ist, wird dieser ausgegeben. Wenn es sich nicht um ein Wertemengenergebnis handelt, wird das in den Optionen definierte Kleiner-Zeichen vorangestellt.

Sind beide Grenzwerte vorhanden wird ein Text ausgegeben der aus folgenden Teilen besteht: Unterer Grenzwert, in den Optionen eingetragenes Von-Bis-Zeichen, oberer Grenzwert.

Alle Werte werden mit Hilfe der Methode formatGWDouble() auf das Format der Messwerte gebracht.

Anwendungsbeispiel

Ausgabe der Grenzwerte.

Grenzwertbereich Grenz_U - Zielwert - Grenz_O​

getGrenzwerteUndZielwertToString(ZuordnungProbeAnalyseErgebnis zpae)

Gibt einen formatierten Text mit dem Zielwert und den Grenzwerten zurück.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • zpae

    Das Probenergebnis, zu dem die Grenzwerte und der Zielwert ausgegeben werden sollen

Wenn nur oberer und unterer Grenzwert aber kein Zielwert eingetragen ist, wird ein Text ausgegeben der aus folgenden Teilen besteht: Unterer Grenzwert, in den Optionen eingetragenes Von-Bis-Zeichen, oberer Grenzwert.

Wenn beide Grenzwerte und Zielwert gepflegt sind, wird ein Text ausgegeben der aus folgenden Teilen besteht: Unterer Grenzwert, in den Optionen eingetragenes Von-Bis-Zeichen, Zielwert, noch ein Von-Bis-Zeichen, oberer Grenzwert.

Wenn nur einer der Grenzwert vorhanden ist, wird dieser mit dem passenden eingestellten Zeichen (größer oder kleiner) ausgegeben. Ist der Zielwert eingetragen, wird dieser in runden Klammern dahinter aufgeführt.

Alle Werte werden mit Hilfe der Methode formatGWDouble() auf das Format der Messwerte gebracht.

Anwendungsbeispiel

Ausgabe der Grenzwerte und des Zielwerts.

Sollwerte​

getSollwerteToString(ZuordnungProbeAnalyseErgebnis zpae)

Gibt einen formatierten Text mit den Sollwerten zurück.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • zpae

    Das Probenergebnis, zu dem die Sollwerte ausgegeben werden sollen

Wenn nur der untere Sollwert eingetragen ist, wird dieser ausgegeben. Wenn es sich nicht um ein Wertemengenergebnis handelt, wird das in den Optionen definierte Größer-Zeichen vorangestellt.

Wenn nur der obere Sollwert eingetragen ist, wird dieser ausgegeben. Wenn es sich nicht um ein Wertemengenergebnis handelt, wird das in den Optionen definierte Kleiner-Zeichen vorangestellt.

Sind beide Sollwerte vorhanden wird ein Text ausgegeben der aus folgenden Teilen besteht: Unterer Sollwert, in den Optionen eingetragenes Von-Bis-Zeichen, oberer Sollwert.

Alle Werte werden mit Hilfe der Methode formatGWDouble() auf das Format der Messwerte gebracht.

Anwendungsbeispiel

Ausgabe der Sollwerte.

Verletzter Grenzwert​

getVerletztenGrenzwertAlsString(OIDObject wert)

Bestimmt den verletzten Grenzwert eines ErgebnisWerts oder Mittelwerts.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • wert

    ErgebnisWert oder Statistikwert dessen Grenzwertverletzung bestimmt werden soll.

Zunächst wird die Art der Grenzwertverletzung am ErgebnisWert/Statistikwert bestimmt. Aus dieser Art wird dann der Methodenname geparsed, mit dem anschließend der passende Grenzwert an der zugehörigen ZPAE ermittelt wird.

Anwendungsbeispiel

Sollte verwendet werden, wenn nicht alle Grenzen ausgegeben werden, sondern nur der verletzte Grenzwert.

Verletzter Grenzwert, mit Angabe von Typ und Art​

getVerletztenGrenzwertAlsString(ErgebnisWert ew, boolean zeigeTyp, boolean zeigeWert)

Diese Methode bestimmt den verletzten Grenzwert eines Ergebniswerts und gibt diesen zurück. Optional können

  1. nur der Grenzwerttyp oder
  2. nur der verletzte Grenzwert oder
  3. beide zusammen

zurückgegeben werden.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • ew

    Der ErgebnisWert dessen Grenzwert bestimmt wird

  • zeigeTyp

    Bestimmt ob der Grenzwert-Typ ausgegeben werden soll

  • zeigeWert

    Bestimmt ob der Grenzwert-Wert ausgegeben werden soll

Abhängig von den Werten der beiden booleans verhält sich die Methode anders:

zeigeTyp = true, zeigeWert = true

Als erstes wird mit Hilfe der Methode getVerletztenGrenzwertAlsString(Object) der Wert des verletzten Grenzwerts ermittelt. Wenn dieser ein Zahlenwert ist, wird er mit Hilfe der Methode formatGWDouble() wie der ErgebnisWert formatiert. Der Grenzwert-Typ wird aus dem ErgebnisWert ermittelt und mit Hilfe der properties-Datei formatiert. Es wird ein Text im Format: formatierter Grenzwert-Wert'('formatierter Grenzwert-Typ')' zurückgegeben. Ist kein Grenzwert-Wert gefunden worden wird stattdessen '-' verwendet. Ist kein Grenzwert-Typ gefunden worden, wird er weggelassen.

zeigeTyp = true, zeigeWert = false

Der Grenzwert-Typ wird aus dem ErgebnisWert ermittelt, mit Hilfe der properties-Datei formatiert und zurückgegeben. Ist kein Grenzwert-Typ gefunden worden, wird ein leerer Text zurückgegeben.

zeigeTyp = false, zeigeWert = true

Als erstes wird mit Hilfe der Methode getVerletztenGrenzwertAlsString(Object) der Wert des verletzten Grenzwerts ermittelt. Wenn dieser ein Zahlenwert ist, wird er mit Hilfe der Methode formatGWDouble() wie der ErgebnisWert formatiert und zurückgegeben. Ist kein Grenzwert-Wert gefunden worden wird stattdessen '-' verwendet.

zeigeTyp = false, zeigeWert = false

Es wird '-' zurückgegeben.

Anwendungsbeispiel

Wird verwendet, wenn zusätzlich zum verletzten Grenzwert noch die Art der Grenzwertverletzung angezeigt werden soll (oder nur die Art ohne Wert).

Verletzter Mittelwert-Grenzwert, mit Angabe von Typ und Art​

getVerletztenMWGrenzwertAlsString(Statistikwert ew, boolean zeigeTyp, boolean zeigeWert)

Diese Methode bestimmt den verletzten Grenzwert eines Statistikwerts und gibt diesen zurück. Optional können

  1. nur der Grenzwerttyp oder
  2. nur der verletzte Grenzwert oder
  3. beide zusammen

zurückgegeben werden.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • ew

    Der Statistikwert dessen Grenzwert bestimmt wird

  • zeigeTyp

    Bestimmt ob der Grenzwert-Typ ausgegeben werden soll

  • zeigeWert

    Bestimmt ob der Grenzwert-Wert ausgegeben werden soll

Abhängig von den Werten der beiden booleans verhält sich die Methode anders:

zeigeTyp = true, zeigeWert = true

Als erstes wird mit Hilfe der Methode getVerletztenGrenzwertAlsString(Object) der Wert des verletzten Grenzwerts ermittelt. Wenn dieser ein Zahlenwert ist, wird er mit Hilfe der Methode formatGWDouble() formatiert. Der Grenzwert-Typ wird aus dem Statistikwert ermittelt und mit Hilfe der properties-Datei formatiert. Es wird ein Text im Format: formatierter Grenzwert-Wert'('formatierter Grenzwert-Typ')' zurückgegeben. Ist kein Grenzwert-Wert gefunden worden wird stattdessen '-' verwendet. Ist kein Grenzwert-Typ gefunden worden, wird er weggelassen.

zeigeTyp = true, zeigeWert = false

Der Grenzwert-Typ wird aus dem Statistikwert ermittelt, mit Hilfe der properties-Datei formatiert und zurückgegeben. Ist kein Grenzwert-Typ gefunden worden, wird ein leerer Text zurückgegeben.

zeigeTyp = false, zeigeWert = true

Als erstes wird mit Hilfe der Methode getVerletztenGrenzwertAlsString(Object) der Wert des verletzten Grenzwerts ermittelt. Wenn dieser ein Zahlenwert ist, wird er mit Hilfe der Methode formatGWDouble() formatiert und zurückgegeben. Ist kein Grenzwert-Wert gefunden worden wird stattdessen '-' verwendet.

zeigeTyp = false, zeigeWert = false

Es wird '-' zurückgegeben.

Anwendungsbeispiel

Wird verwendeet, wenn bei der Angabe von Mittwlert-Grenzen zusätzlich zum verletzten Grenzwert noch die Art der Grenzwertverletzung angezeigt werden soll (oder nur die Art ohne Wert).

Methoden zur Ausgabe von ZPAE​

gefiltert, gruppiert, bestimmte ZPAE, ...

Ermitteln einer bestimmten ZPAE​

getZPAEZuProbe(Probe probe, String anaString, String ergString)

Gibt die ZPAE der Probe zurück, deren Methode und Ergebnis mit den übergebenen Kurzbezeichnungen übereinstimmen.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • probe

    Die Probe, deren ZPAE durchsucht werden.

  • anaString

    Kurzbezeichnung der Methode der gesuchten ZPAE, keine Pflichtangabe.

  • ergString

    Kurzbezeichnung des Ergebnisses der gesuchten ZPAE, keine Pflichtangabe.

Falls anaString nicht leer ist wird die passende Methode gesucht. Wenn ergString nicht leer ist und eine Methode gefunden wurde, wird das passende Ergebnis der Methode ermittelt.

Wenn keine Methode gefunden wurde oder keine Methoden-Kurzbezeichnung angegeben war, werden alle ZPAE der Probe durchsucht und die erste zurückgegeben die die passende Ergebnis-Kurzbezeichnung hat. Ist ein Ergebnis gefunden worden wird die ZPAE der Probe ermittelt und zurückgegeben an der dieses Ergebnis zugeordnet ist. Wenn eine Methode, aber kein Ergebnis in den Stammdaten gefunden wurde, wird die erste ZPAE der Probe zurückgegeben der diese Methode zugeordnet ist.

Anwendungsbeispiel

Diese Methode kann verwendet werden, wenn die ZPAE nicht tabellarisch untereinander aufgelistet sind, sondern an fest definierten Positionen stehen. Außerdem ist sie nützlich, wenn man außerhalb einer Messwert-Tabelle auf Attribute einer bestimmten ZPAE zugreifen möchte. Um zum Beispiel die Rahmenbedinungen einer Untersuchung (die ggf. als Messwerte abgelegt sind) auszugeben.

Gefilterte ZPAE einer Probe​

getZPAEsForReport(Probe probe)

Gibt alle ZPAE der übergebnen Probe zurück die nicht storniert sind und bei denen der Schalter "drucken" gesetzt ist.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • probe

    Die Probe, deren ZPAE ausgegeben werden sollen

Es werden alle ZPAE einzeln durchgegangen und diejenigen gesammelt, die den Bedingungen entsprechen. Diese ZPAE werden dann als Vector zurückgegeben.

Anwendungsbeispiel

Diese Methode kann für eine einfache Ergebnistabelle in einem Einzel-Prüfbericht verwendet werden.

Erweiterte Filterung von ZPAE​

getZPAEsGroupForAttribute( ZuordnungProbeAnalyseErgebnisVector zpaeInputVec, HashMap<String, Object> attributeValueMap, boolean stringUseContains, boolean stringIgnoreCase)

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • zpaeInputVec

    Der Vector mit ZPAEs

  • attributeValueMap

    Eine HashMap mit Attribut-Value-Paaren. Anhand dieser Paare werden die ZPAEs gefiltert.

    Beispiel: {"Beschreibung", "ABC"; "Kurzbezeichnung", "A11"} fasst alle ZPAEs zusammen, die "ABC" in der Beschreibung und "A11" in der Kurzbezeichnung enthalten (wenn useContains=false) oder den Werten gleichen (wenn useContains=true).

  • stringUseContains

    stringUseContains Wenn true, wird beim Vergleich von Strings die Methode String.contains() und nicht String.equals() verwendet

  • stringIgnoreCase

    Wenn true, werden String nicht case-sensitiv verglichen

Es werden alle ZPAE einzeln durchgegangen. Für jedes Attribut wird der Wert der ZPAE ermittelt und mit dem übergebenen verglichen. Wenn stringUseContains == true wird dabei mit "enthalten in" geprüft, wenn stringIgnoreCase == true wird Groß- und Kleinschreibung ignoriert. Alle ZPAE die allen übergebenen Kriterien entsprechen werden vom Rückgabe-Vector hinzugefügt.

Anwendungsbeispiel

So können z.B. die ZPAE ermittelt werden die eine bestimmte Vorbehandlung und einen bestimmten Status haben.

ZPAE eines Auftrags​

getZPAEsForAuftrag(Auftrag auftrag, boolean groupByErgebnis)

Sammelt alle ZPAE der Proben des Auftrags und gibt sie in einem Vector zurück. Dabei sind die ZPAE entweder nach Probe oder nach Ergebnis sortiert.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • auftrag

    Auftrag, dessen ZPAEs zurückgegeben werden sollen

  • groupByErgebnis

    Wenn true, werden die Einträge anhand des Ergebnisses gruppiert, sonst anhand der Proben

Es werden die ZPAE aller Proben des Auftrags einzeln durchgegangen. Wenn nach Ergebnis gruppiert werden soll, werden die ZPAE zunächst in einer HashMap (Ergebnis.oid, ZPAEVector) zwischengespeichert. Hinterher wird die HashMap in den RückgabeVector geschrieben. Wenn nicht werden die einzeln ZPAE direkt in den Rückgabevector geschrieben.

ZPAE gruppiert nach einem Attribut​

getZPAEsGroupedByAttribute( ZuordnungProbeAnalyseErgebnisVector zpaeInputVec, String attributeName, boolean ignoreEmptyValues, boolean ignoreSwitchDrucken)

Diese Methode gruppiert alle ZPAEs im Vector zpaeInputVec anhand des Attributs.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • zpaeInputVec

    Der Vector mit ZPAEs

  • attributeName

    Der Name des direkten Attributs, anhand dessen gruppiert werden soll

  • ignoreEmptyValues

    Wenn true, werden alle ZPAEs ignoriert, bei denen der Attributwert leer ist

  • ignoreSwitchDrucken

    Wenn true, werden auch ZPAEs gruppiert, die nicht gedruckt werden sollen

Es werden alle ZPAE einzeln durchgegangen. Zunächst wird ermittelt welchen Wert das Attribut an der jeweiligen ZPAE hat.

Wenn ignoreSwitchDrucken == false und an der ZPAE kein drucken-Häkchen gesetzt ist, wird mit der nächsten ZPAE weitergemacht.

Wenn ignoreEmptyValues == true und der Wert des Attributs leer ist, wird die ZPAE ebenfalls nicht berücksichtigt.

Es wird eine Hashmap aufgebaut, die pro vorkommendem Attributs-Wert einen Vector mit den entsprechenden ZPAE enthält.

Anwendungsbeispiel

Wenn pro Prüfplan eine eigene Tabelle erzeugt werden soll, können so die ZPAE nach Prüfplan sortiert werden.

Methoden zu Grenzwertkatalogen​

Grenzwertverletzungen​

getGrenzwertVerletzungFor(ZuordnungProbeAnalyseErgebnis zpae, ProbeGrenzwertKatalogZuordnung probe GwKZuo)

Diese Methode gibt die Grenzwertverletzung (falls eine solche vorliegt) für eine ZPAE eines Grenzwertkatalogs zurück.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • zpae

    Die ZPAE

  • probeGwKZuo

    Die Probenzuordnung des Grenzwertkatalogs dessen Grenzwertverletzung ausgegeben werden soll.

Über die Methode getProbeGrenzwertKatalogZPAEZuordnungFor wird die ProbeGrenzwertKatalogZPAEZuordnung für die übergebenen Werte ermittelt. Falls an dieser eine Grenzwertverletzung vorliegt, wird diese zurückgegeben. Sonst wird null zurückgegeben.

Kataloggrenzwerte​

getKatalogGrenzwerteAsStringFor(ZuordnungProbeAnalyseErgebnis zpae, ProbenGrenzwertKatalogZuordnung probeGwKZuo, String prefix, String suffix)

Ermittelt die Kataloggrenzwerte zur übergebenen ZPAE und gibt sie als formatierten Text zurück.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • zpae

    Die ZPAE zu der die Kataloggrenzwerte ermittelt werden sollen.

  • probeGwKZuo

    Die Probenzuordnung des Grenzwertkatalogs dessen Grenzwerte ausgegeben werden sollen.

  • prefix

    Fester Text der vorne an den formatierten Grenzwerttext gesetzt wird.

  • suffix

    Fester Text der hinten an den formatierten Grenzwerttext gesetzt wird.

Sind oberer und unterer Grenzwert vorhanden, wird der Rückgabetext so aufgebaut: prefix formatierter unterer Grenzwert "-" formatierter oberer Grenzwert suffix.

Bei nur unteren Grenzwert lautet der Rückgabewert: prefix ">="formatierter unterer Grenzwert suffix.

Wenn nur der oberere Grenzwert eingetragen ist, lautet der Rückgabewert: prefix "<="" formatierter oberer Grenzwert suffix.

getProbeGrenzwertKatalogZPAEZuordnungFor(ZuordnungProbeAnalyseErgebnis zpae, ProbeGrenzwertKatalogZuordnung probeGwKZuo)

Diese Methode gibt eine ProbeGrenzwertZPAE zurück, die anhand der übergebenen ZPAE und der ProbeKatalogZuordnung bestimmt wird.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • zpae

    Die ZPAE

  • probeGwKZuo

    Die ProbeGrenzwertKatalogZuordnung

Es werden alle ProbeGrenzwertKatalogZPAEZuordnungen der übergebenen ProbeGrenzwertkatalogZuordnung durchgegangen und diejenige ausgewählt, der dasselbe Ergebnis zugeordnet ist wie der übergebenen ZPAE.

ProbeGrenzwertKatalogZuordnungen aufteilen​

splitProbeGrenzwertkatalogeInGroups(ProbeGrenzwertKatalogZuordnungVector probeGwKZuoVector, int groupSize)

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • probeGwKZuoVector

    Der Vector, welcher aufgeteilt werden soll

  • groupSize

    Die maximale Gruppengröße

Der Vector wird durchgegangen und der Reihenfolge nach in Teilvectoren zerlegt, die dann soviel Elemente enthalten wie angegeben ist. Der letzte Teilvector hat ggf. weniger Elemente. Die Teilvectoren werden in einem Vector zurückgegeben.

Methoden für die automatische eMail-Benachrichtigung bei Grenzwertverletzungen​

Diese Methoden werden nur in der Mail-Vorlage für die Benachrichtigung verwendet.

Ergebnis-/Statistikwerte nach Produkt gruppiert​

getWerteGroupedByProdukt(Vector werteVec)

Diese Methode gruppiert ErgebnisWerte und Statistikwerte nach dem Produkt und gibt diese in einer HashMap zurück.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • werteVec

    Die zu gruppierenden Werte, kann Ergebniswerte oder Statistikwerte enthalten.

Es werden alle Werte einzeln durchgegangen. Zunächst wird über die ZPAE des Werts das Produkt ermittelt. Ist kein Produkt vorhanden, wird dieser Wert übergangen. Dann wird geprüft, ob das Produkt schon in der vorher initialisierten Hashmap eingetragen ist. Falls nicht, wird es eingetragen. Dann wird der Wert in der Hashmap zum Produkt einsortiert. Wenn alle Werte durchgegangen sind, wird die Hashmap zurückgegeben. Sie enthält dann pro Produkt einen Vector mit den dazugehörigen Werten.

Ergebnis-/Statistikwerte nach Produkt gruppiert (Statistik- und Ergebniswerte getrennt)​

getSplittedWerteGroupedByProdukt(Vector werteVec)

Diese Methode gruppiert ErgebnisWerte und Statistikwerte nach dem Produkt, trennt EWs von SWs und gibt diese in einer HashMap zurück. Der KeySet der HashMap besteht aus Produkten. Die Values sind "interne" HashMap mit den Schlüsseln "ErgebnisWert.class.getSimpleName()" und "Statistikwert.class.getSimpleName()". Die interne HashMaps beinhalten jeweils einen Vector mit EWs und einen mit SWs.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • werteVec

    Die zu gruppierenden Werte, kann Ergebniswerte oder Statistikwerte enthalten.

Zunächst werden die Werte mit Hilfe der Methode getWerteGroupedByProdukt() nach Produkt gruppiert in eine Hashmap geschrieben. Dann wird der Vector (aus der Hashmap) für jedes Produkt durchgegangen. Jeder Wert im Vector wird einzeln geprüft und danach sortiert, ob es sich um einen ErgebnisWert oder einen Statistikwert handelt. Die Rückgabe-Hashmap enthält zum Schluss pro Produkt eine Hashmap in der sich ein Vector mit Ergebniswerten und einer mit Statistikwerten befinden.

Anzahl Werte​

getAnzahl WerteFor(Produkt produkt, String werteTyp, HashMap groupedAndSplittedWerte)

Gibt die Anzahl Ergebniswerte, die zu einem Produkt gehören zurück.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • produkt

    Das Produkt für das die Anzahl der Werte ermittelt werden soll

  • werteTyp

    Der Typ Wert der gezählt werden soll, mögliche Werte: ErgebnisWert, Statistikwert

  • groupedAndSplittedWerte

    Die Werte gruppiert nach Produkt und geteilt nach werteTyp (Hashmap mit pro Produkt einer Hashmap, die je einen ErgebnisWert- und einen Statistikwertvector enthält.

Aus der Hashmap wird der Vector ermittelt der die Werte zu Produkt und werteTyp enthält. Die Anzahl der Werte wird zurückgegeben.

Datum der ersten Grenzwertverletzung​

getPruefungsZeitraumVon(Produkt produkt, HashMap groupedAndSplittedWerte)

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • produkt

    Das Produkt für das das Datum der Grenzwertverletzung ausgegeben werden soll

  • groupedAndSplittedWerte

    Die Werte gruppiert nach Produkt und geteilt nach werteTyp (Hashmap mit pro Produkt einer Hashmap, die je einen ErgebnisWert- und einen Statistikwertvector enthält.

Zunächst werden alle ErgebnisWerte für das Produkt durchgegangen und die früheste Änderungszeit ermittelt. Anschließend wird das auch für die Statistikwerte zum Produkt ermittelt. Die früheste Zeit wird dann zurückgegeben. Wird nichts gefunden wird "unbekannt" zurückgegeben.

Datum der letzten Grenzwertverletzung​

getPruefungsZeitraumBis(Produkt produkt, HashMap groupedAndSplittedWerte)

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • produkt

    Das Produkt für das das Datum der Grenzwertverletzung ausgegeben werden soll

  • groupedAndSplittedWerte

    Die Werte gruppiert nach Produkt und geteilt nach werteTyp (Hashmap mit pro Produkt einer Hashmap, die je einen ErgebnisWert- und einen Statistikwertvector enthält.

Zunächst werden alle ErgebnisWerte für das Produkt durchgegangen und die späteste Änderungszeit ermittelt. Anschließend wird das auch für die Statistikwerte zum Produkt ermittelt. Die späteste Zeit wird dann zurückgegeben. Wird nichts gefunden wird "unbekannt" zurückgegeben.

Methoden zu Regelkarten​

Diagrammwerte​

getRegelkartenDiagrammWerte(Regelkarte regelkarte)

Diese Methode gibt die DiagrammWerte der Regelkarte zurück

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • regelkarte

    Die Regelkarte

Die RegelkartenDiagrammWerte werden an der Regelkarte berechnet und in dieser Methode zurückgegeben. Folgende Werte sind in den Diagrammwerten enthalten:

Beispiel für die Definition der Diagrammwerte dw (wobei bc der BerichtsController und o die Regelkarte sind):

dw = bc.getRegelkartenDiagrammWerte(o);

  • dw.mittellinie

    Der Mittelwert des Diagramms

  • dw.sigmaSchaetzwert

    Die Standardabweichung des Diagramms

  • dw.obereEingriffsgrenze

    Die obere Eingriffsgrenze des Diagramms

  • dw.untereEingriffsgrenze

    Die untere Eingriffsgrenze des Diagramms

  • dw.obereWarngrenze

    Die obere Warngrenze des Diagramms

  • dw.untereWarngrenze

    Die untere Warngrenze des Diagramms

Diagrammpunkte​

getRegelkartenDiagrammPunkte(Regelkarte regelkarte)

Diese Methode gibt die DiagrammPunkte der Regelkarte zurück.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • regelkarte

    Die Regelkarte

Die RegelkartenDiagrammPunkte werden an der Regelkarte berechnet und in dieser Methode zurückgegeben. Es handelt sich um die im Diagramm angezeigten Punkte. Folgende Werte sind in den Diagrammpunkten enthalten:

Beispiel für die Definition der Diagrammpunkte dp (wobei bc der BerichtsController und o die Regelkarte sind):

dp = bc.getRegelkartenDiagrammPunkte(o);

  • dp.wertErsteSpur

    Der Wert des Punktes im Diagramm (bei zweispurigen Diagrammen im ersten Diagramm)

  • dp.wertZweiteSpur

    Der Wert des Punktes im zweiten Diagramm (bei zweispurigen Diagrammen)

  • dp.werteZurBerechnung

    Vektor mit allen Werten am Punkt, die zur Berechnung des Punktwertes herangezogen wurden. Die Werte liegen als Zahlenwerte vor.

  • bc.getAusserkontrollsituationen(dp)

    Eine Darstellung in Textform aller Außerkontrollbedingungen, die der Punkt verletzt (bei zweispurigen Diagrammen im ersten Diagramm). Verletzt der Punkt keine Außerkontrollbedingung, so wird der Text "Keine" angezeigt.

  • bc.getAusserkontrollsituationen(dp, false)

    Eine Darstellung in Textform aller Außerkontrollbedingungen, die der Punkt verletzt (bei zweispurigen Diagrammen im ersten Diagramm). Verletzt der Punkt keine Außerkontrollbedingung, so wird kein Text angezeigt.

  • bc.getAusserkontrollsituationenZweiteSpur(dp)

    Eine Darstellung in Textform aller Außerkontrollbedingungen, die der Punkt bei zweispurigen Diagrammen im zweiten Diagramm verletzt. Verletzt der Punkt keine Außerkontrollbedingung, so wird der Text "Keine" angezeigt.

  • bc.getAusserkontrollsituationenZweiteSpur(dp, false)

    Eine Darstellung in Textform aller Außerkontrollbedingungen, die der Punkt bei zweispurigen Diagrammen im zweiten Diagramm verletzt. Verletzt der Punkt keine Außerkontrollbedingung, so wird kein Text angezeigt.

  • bc.getErgebniswertBemerkungen(dp)

    Ein Vektor mit den ErgebniswertBemerkungen zu den am Punkt beteiligten Ergebniswerten. Der Vektor hat in jedem Fall die gleiche Länge wie der Vektor der Werte zur Berechnung. Damit die Ergebniswerte angezeigt werden können, muss die Abfrage an der Regelkarte entsprechend konfiguriert sein (die Spalte Ergebniswert_oid muss enthalten sein).

Diagrammbeschriftungen​

getDiagrammBeschriftungen(Regelkarte regelkarte)

Diese Methode gibt die Diagrammbeschriftungen der Regelkarte zurück

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • regelkarte

    Die Regelkarte

Die Diagrammbeschriftungen werden als String-Array zurückgegeben. Folgende Beschriftungen sind in den Diagrammbeschriftungen enthalten:

Beispiel für die Definition der Diagrammbeschriftungen bs (wobei bc der BerichtsController und o die Regelkarte sind):

bs = bc.getDiagrammBeschriftungen(o);

  • bs[0]

    Überschrift des Diagramms (Diagrammtitel, wenn gesetzt)

  • bs[1]

    X-Achsen-Beschriftung (Gruppierung X-Achse, wenn gesetzt)

  • bs[2]

    Y-Achsen-Beschriftung (Y-Achsenbeschriftung, wenn gesetzt)

  • bs[3]

    Y-Achsen-Beschriftung des zweiten Diagramms bei zweispurigen Diagrammen

sonstige Methoden​

Entfernung leerer Nachkommastellen​

cutNullFromDoubleString(String value)

Diese Methode schneidet die Nachkommastellen einer Zahl, die als String übergeben wird ab, wenn die Nachkommastellen nur aus Nullen bestehen.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • value

    Der Wert der formatiert werden soll.

Zuerst wird das aktuelle Trennzeichen (Komma oder Punkt) ermittelt. Damit werden dann die Nachkommastellen des Werts ermittelt und einzeln betrachtet. Ist ihr Wert kleiner als 1, wird der übergebene Wert ohne Nachkommastellen zurückgegeben. Ansonsten (und auch falls während der Bearbeitung ein Fehler auftritt) wird der übergebene Wert zurückgegeben. Wurde kein Wert übergeben, wird ein leerer Text zurückgegeben.

Anwendungsbeispiel

Ausgabe von Zahlenwerten (keine Messwerte) die ohne Nachkommastellen eingegeben wurden, aber mit ausgegeben werden (weil im Double-Feld gespeichert).

Gruppierung eines Vectors​

sortVectorByReference(DefaultDVector v, String referenceClassName)

Sortiert den übergebenen Vektor in mehrere Vektoren ein. Der Vektor wird dabei anhand der gesetzten Referenz aufgeteilt.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • v

    Der Vektor der gruppiert werden soll

  • referenceClassName

    Name der Referenz, anhand der der Vektor sortiert wird

Es wird für jedes Objekt im Vektor die Referenz ermittelt und für jeden Wert der Referenz ein Vektor mit allen passenden Objekten angelegt. Die gefüllten Vektoren werden in einem Vektor gesammelt der dann zurückgegeben wird.

Anwendungsbeispiel

Kann verwendet werden wenn z.B. pro Probenstelle eine Tabelle mit Proben ausgegeben werden soll (Übergabeparameter: probeVector, "Probenstelle").

Wert eines Attributs​

getObjectProperty(LIMSObject object, String property)

Liefert das Property eines Objekt.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • object

    Das Objekt dessen Attribut ermittelt werden soll.

  • property

    Der Name des Attributs

Ermittelt den Wert des Attributs für das Objekt. Wenn der Wert ein Datum ist, wird er in das Format "dd.MM.yyyy" gebracht. Der Wert wird zurückgegeben. Wenn nichts gefunden wurde oder ein Fehler aufgetreten ist (die Fehlermeldung wird angezeigt) wird ein leerer Text zurückgegeben.

Anwendungsbeispiel

Wird hauptsächlich in anderen BerichtsController-Methoden verwendet.

Datenbank-Benutzer​

getDBUser()

Übergabeparameter, Funktionsweise und Rückgabewert

Gibt den am diaLIMS angemeldeten Benutzer zurück.

Anwendungsbeispiel

Ausgabe des Prüfberichts-Erstellers auf dem Bericht.

Sprache einstellen​

setBerichtSpracheByAsp(AbstractPrinter printer, Ansprechpartner asp), setBereichtSpracheByLIMSObject(AbstractPrinter, LIMSObject lo)

Diese Methode setzt die Sprache des Printers/Berichts auf die Sprache des Ansprechpartners / LIMSObject.Kunde-Ansprechpartner, falls dieser vorhanden und eine Sprache angegeben ist.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • printer

    Das Printer-Objekt. Im Bericht über die Variable printer direkt zu erreichen.

  • asp

    Der Ansprechpartner dessen Sprache gesetzt werden soll

  • lo

    Das Objekt an dessen Ansprechpartner die Sprache gesetzt ist. Es kann ein Auftrag oder eine Probe übergeben werden. Optional zu asp.

Wurde ein LIMSObject übergeben wird zunächst der Ansprechpartner ermittelt. Wenn es sich um einen Auftrag handelt, wird zunächst der Rechnungsempfänger-Ansprechpartner des Auftrags ausgewählt. Ist dieser nicht gesetzt, wird der Auftraggeber-Ansprechpartner verwendet. Falls es sich um eine Probe handelt, wird der Ansprechpartner der Probe verwendet.

Dann (und falls ein Ansprechpartner übergeben wurde) wird die Sprache des Ansprechpartners ermittelt. Wenn die am Ansprechpartner eingetragene Sprache im Sprachenmodul angelegt ist, wird sie an das Printer-Objekt gesetzt.

Anwendungsbeispiel

Benötigt um Berichte automatisch in der zum Kunden passenden Sprache zu erstellen (Zusätzlich sind weitere Änderungen der Vorlagen und Begriffspflege im Wörterbuch-Modul notwendig).

Klassenname​

getSimpleName(Object o)

Gibt den Klassennamen des übergebenen Objekts zurück.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • o

    Das Objekt

Gibt den Klassennamen des übergebenen Objekts zurück. Beispiel: Das Objekt ist eine Lieferung, der Rückgabetext lautet "Lieferung".

Achtung: Diese Methode berücksichtigt keine kundenindividuellen Umbenennungen.

Anwendungsbeispiel

Wird z.B. in getTitleForVorgangsart() verwendet.

Überschrift für Vorgänge​

getTitleForVorgangsart(Vorgang vorgang), getTitleForVorgangsart(Vorgang vorgang, int isProFormaRechnung)

Gibt einen aussagekräftigen Titel für den übergebenen Vorgang zurück. Wenn isProFormaRechnung true ist und es sich bei dem Vorgang um eine Rechnung handelt, die den Businesstyp R hat, so ist der Titel ProformaRechnung, ansonsten einfach nur Rechnung.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • vorgang

    Der Vorgang, es können Aufträge, Angebote, Rechnungen, Lieferungen übergeben werden

  • isProFormaRechnung

    Angabe, ob es sich um eine ProForma-Rechnung handelt (1 = ProFormaRechnung)

Es wird je nach übergebenem Objekt ein Text zurückgegeben:

ObjektZusatzbedingungRückgabe-Text
Angebot Angebot
AuftragKunde seitAuftragsbestätigung
RechnungBusinesstyp == GGutschrift
RechnungBusinesstyp == SStorno
RechnungBusinesstyp == RRechnung
RechnungBusinesstyp == R, isProFormaRechnung == 1Proformarechnung
alle anderen getSimpleName(vorgang)

Anwendungsbeispiel

Überschrift einer flexiblen Vorgangs-Vorlage

Hauptansprechpartner des Benutzers​

getHauptansprechpartnerFromPrinter(AbstractPrinter printer)

Gibt den Hauptansprechpartner des Kunden zurück, zu dem der Bearbeiter gehört, der am übergebenen Printer gesetzt ist.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • printer

    Das Printer-Objekt, kann in der Vorlage mit der Variablen printer direkt zugegriffen werden

Gibt den Hauptansprechpartner des Kunden zurück, zu dem der Bearbeiter gehört, der am übergebenen Printer gesetzt ist.

Anwendungsbeispiel

Wird in der Methode getReportFooter() verwendet.

Ausgabe von Nachweistexten​

parseNachweisToString(Nachweis n)

Gibt den Nachweis als Text zurück.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • n

    Der Nachweis, der ausgegeben werden soll.

Die Methode erstellt einen für jeden Nachweis-Typ individuellen Text aus den Informationen des Nachweises.

Der Text für Nachweise vom Typ "Service" besteht aus folgenden Teilen (jeweils durch einen Zeilenumbruch getrennt):

  • Kurzbezeichnung und Beschreibung der Aktivität, falls vorhanden
  • Teilprojekt und Kennzeichen, falls vorhanden
  • Tätigkeit, vorher eine Leerzeile falls mindestens einer der vorherigen Blöcke mit ausgegeben wird

Anwendungsbeispiel

Rechnung mit Tätigkeitsnachweisen.

Standardisierte Fußzeile​

getReportFooter( AbstractPrinter printer, String amtsgericht, String hrb, String steuernummer, String iban)

Gibt eine standardisierte Fußzeile für eine Vorlage zurück. Diese enthält Informationen zum Kunden, zu dem der Bearbeiter gehört, der am übergebenen Printer gesetzt ist. Die Fußzeile enthält:

  • Namen der Ansprechpartner, die die Position "Geschäftsführer" haben
  • Amtgericht
  • HRB
  • Steuernummer
  • UID
  • Bankverbindung
  • Schlusssatz "Es gelten unsere Allgemeinen Geschäftsbedingungen."

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • printer

    Das Printer-Objekt, kann in der Vorlage mit der Variablen printer direkt zugegriffen werden

  • amtsgericht, hrb, steuernummer, iban

    Informationen, die in der Fußzeile mit ausgegeben werden sollen.

Erstellt einen Standardtext für die Fußzeile eines Dokuments. Dieser Text enthält neben den übergebenen Informationen auch Daten aus dem am Benutzer zugeordneten Kunden. Dieser wird mit Hilfe der Methode getHauptansprechpartnerFromPrinter() ermittelt. Der Text besteht aus folgenden Zeilen:

  • "Geschäftführung:"Die Geschäftsführer mit Vor- und Nachnamen, bei mehreren getrennt durch "|". Als Geschäftsführer gelten alle Ansprechpartner des ermittelten Kunden bei dennen als Position "Geschäftsführer" angegeben ist.
  • "Amtsgericht ", Amtsgericht, "| HRB " und HRB
  • "Steuernummer ", Steuernummer, "| UID " und UID. Die UID wird aus dem Feld UmsatzsteuerID des ermittelten Kunden geholt.
  • "Bankverbindung: ", Bankname, " | BLZ ", Bankleitzahl, " | Kontonummer ", Kontonummer, " | BIC ", BIC " | IBAN" und iban,. Außer iban werden die Daten aus den entsprechenden Feldern des Kunden ermittelt.
  • "Es gelten unsere Allgemeinen Geschäftbedingungen"

Anwendungsbeispiel

Als Fußzeile von Dokumenten, die per Mail verschickt oder auf Blanko-Papier ausgedruckt werden.

Zusammenfassung einer Position​

getArtikelbezeichnung(Vorgangsposition pos)

Gibt einen Artikelbezeichnung-Text der übergebenen Position zurück.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • pos

    Die Position deren Informationen ausgegeben werden sollen

Es wird ein mehrzeiliger Text erstellt, der Informationen zu Position und Artikel enthält. Er besteht aus folgenden Zeilen:

  • "Artikelnummer: ", Artikelnummer und Beschreibung (falls vorhanden) getrennt durch "/"
  • "Art/Typ: " (bzw. "Art: "), Art und Typ (falls vorhanden) des Artikels getrennt durch "/"
  • Das Feld AName2 der Position
  • Das Feld AName3 der Position
  • Das Feld Bemerkung der Position

Anwendungsbeispiel

Ein Positionentabelle in einem detaillierten Angebot oder einer Auftragsbestätigung / Rechnung.

Auswerten von diaLIMS Scripts in diaLIMS Feldern​

getEvaluationFromAttributePerReflection(DefaultPrinter printer, Object object, String attribute)

Gibt die Auswertung eines diaLIMS - Scriptes in einem Attribut zurück von dem übergebenen Objekt.

Übergabeparameter, Funktionsweise und Rückgabewert

Es werden folgende Parameter übergeben:

  • printer

    Das Printerobjekt aus dem Bericht. Meistens "Printer"

  • object

    Das LIMSObject, welches das diaLIMS Script enthält

  • attribute

    Das Attribut des LIMS-Objektes, indem das diaLIMS Script zu finden ist. Zum Beispiel "reserve1"

Der Ausdruck wird ausgewertet und zurückgegeben wird ein Objekt. Das kann zum Beispiel ein Text sein oder auch ein ganz anderes (LIMS)Objekt.

Anwendungsbeispiel

dateiname=getEvaluationFromAttributePerReflection(Printer, Objekt.getAgKunde(),"reserve1");

Möchte man abhängig von bestimmten Informationen aus dem diaLIMS unterschiedliche Inhalte anzeigen, die nicht mit der Standardvorlage abgedeckt werden sollen, hilft diese Funktion. So kann zum Beispiel für jeden Kunden ein individueller Berichtsname generiert werden, indem die Beanshell-Logik für den Berichtsnamen in einem Feld am Kunden notiert wird. Dieses Script kann anschließend von der Methode ausgewertet werden und liefert das Ergebnis. Dies ist vor allem notwendig, da der PrintFirst Bereich nicht zweimal durchlaufen wird um das Beanshell-Skript auszuwerten.

hinweis

In dem Attribut, welches das Script enthält, muss immer die volle Schreibweise verwendet werden, also Objekt.getOID() anstatt Objekt.oid oder o.getAuftrag() anstatt o.auftrag.

Berichtserzeugung abbrechen​

Durch ausprogrammierte Logik kann die Berichtserzeugung sauber abgebrochen werden

Wenn vor der Erzeugung eines Berichts beispielsweise ein Dialog angezeigt werden soll, der zusätzliche Daten abfragt, oder die Berichtserzeugung unter bestimmten Umständen abgebrochen werden soll, ist es möglich dies durch dialogEDV Systementwicklung GmbH programmieren zu lassen. Die Programmierung greift noch bevor der Bericht erzeugt wird, sodass im Falle eines Abbruchs kein nicht-vollständiger Bericht entstehen kann.

Anwendungsbeispiel

Bei der Erstellung eines Berichts zur Grenzwertmeldung soll aus einem Dialog einer von drei möglichen Prüfleitern ausgewählt werden.