Zum Hauptinhalt springen

Beispiele

Nachfolgend werden mehrere Anwendungsbeispiele vorgestellt und Schritt für Schritt erklärt. Ein Beispiel-Fall setzt sich aus der Analyse der zu importierenden Datei und der Erklärung der zugehörigen Importkonfigurationsanweisungen zusammen.

Im Anschluss werden Groovy-Skripte für häufige Anwendungsfälle aufgelistet.

Beispiel 1: Import von einer variablen Anzahl von Ergebnissen für eine Probe​

Importdatei​

Ein Screenshot einer Excel-Datei mit Messwerten

In diesem Beispiel wollen wir eine Excel-Datei mit mehreren Seiten importieren. Auf jeder Seite sind zu importierende Ergebniswerte für eine einzelne Probe festgehalten. In der oberen Abbildung ist ein Screenshot der ersten Seite zu sehen, in der die relevanten Bereiche der Datei farblich markiert sind. In der oberen Hälfte der Seite sind folgende markierte Felder zu sehen:

  • Sample name : Die Kurzbezeichnung der Probe, deren Ergebniswerte eingetragen werden sollen
  • Sequence Name : Soll in das Bemerkungsfeld der Probe eingetragen werden
  • Acquired on : Das Analysedatum, das an allen Ergebniszuordnungen eingetragen werden soll

Weiterhin sind in der unteren Hälfte der Seite die zu importierenden Ergebnisse aufgelistet. Für jede Zeile gilt zu importieren:

  • Compound Name : Die Import-ID des zu importierenden Ergebnisses. Der importierte Wert soll einem Attribut entsprechen, das an dem Stammdatenergebnis der gesuchten Ergebniszuordnung zu finden ist. Auf diese Weise können zu importierende Ergebnisse identifiziert werden.
  • Compound Concentration : Der einzutragende Ergebniswert

Insgesamt ergibt sich aus diesen Vorgaben der folgende grobe Import-Verlauf:

Für jede Seite soll je eine Probe importiert werden, deren eindeutige Kurzbezeichnung in der Zelle (5,4) zu finden ist. Bevor die Probe weiterverarbeitet wird, sollte sie anhand ihres Status darauf geprüft werden, ob sie bearbeitet werden darf. An dieser Probe soll die Bemerkung gesetzt werden, die sich in der Zelle (5,1) befindet. Weiterhin soll für jede Zeile ab Zeile 12 ein Ergebnis an einer Ergebniszuordnung der Probe eingetragen werden. Die Anzahl der zu importierenden Ergebnisse kann von Seite zu Seite variieren, daher legen wir fest, dass der Import der Ergebnisse beendet werden kann, sobald die Summenzeile ("Sum") erreicht wurde. Die einzelnen Zeilen sollen wie folgt importiert werden: Die Import-ID des gesuchten Ergebnisses befindet sich in Spalte 4. Diese wird verwendet, um die korrekte Ergebniszuordnung an der Probe zu finden. Diese sollte analog zu der Probe selbst auf ihren Status geprüft werden. Sobald dies geschehen ist, kann der Ergebniswert aus Spalte 5 gesetzt werden. Anschließend wird das Analysedatum gesetzt, welches für alle Ergebnizuordnung gleich ist. Dieses steht in der Zelle (10,5).

Importkonfiguration​

Schauen wir uns nun an, wie eine Importkonfiguration aussieht, die die oben gezeigte Datei importieren kann.

Ein Screenshot der Name-Seite der Importkonfiguration MS1464

Auf der Name -Seite der Konfiguration wird folgendes eingestellt: Format wird auf Excel gesetzt, da dies das vorliegende Datei- Format ist. Die Datei besitzt drei Seiten, die alle importiert werden sollen. Hierfür können in das Feld Excel-Seiten entweder alle Seitenindizes Komma-getrennt eingetragen werden oder gar keine. Keine Excel-Seiten anzugeben hätte zur Folge, dass immer alle vorhandenen Seiten importiert werden. Dies bietet sich an, wenn die Anzahl der Seiten variabel ist.

Ein Screenshot der Anweisungen-Seite der Importkonfiguration MS1464

Auf der Anweisungen -Seite benötigen wir insgesamt acht Anweisungen, um die oben gezeigte Datei zu importieren.

1 Suche Proben

Die erste Anweisung dient dazu, die Probe zu ermitteln, die in der Datei hinterlegt ist. Basierend darauf können dann die Ergebniszuordnungen gefunden und die Ergebnisse eingetragen werden. Das relevante Feld für die Anweisung ist eine einzelne Zelle, in der die Kurzbezeichnung der gesuchten Probe steht.

Feld

Inhalt

Beschreibung

Beschreibungen sind in diesem Beispiel eindeutige Bezeichnungen für die Anweisungen, die beschreiben, was ihre Funktion ist. In diesem Fall "Suche Probe".

Anweisungstyp

Da wir einen Datensatz finden wollen, ist der korrekte Typ SEARCH .

Bereich

Es müssen keine Bereiche durchiteriert werden, da wir nur einen einzigen Wert aus einer konkreten Zelle importieren möchten. Daher bleibt dieses Feld leer.

Position

Um die gesuchte Zelle zu definieren reicht ein


Cell

-Aufruf mit den entsprechenden Koordinaten (Spalte = 5, Zeile = 4).


Cell(5,4)

Rückgabetyp

Dieser ist Probe, da nach einer Probe gesucht wird. Der Name des Business-Typs ist in diesem Fall gleich.

Rückgabe-Alias

Hier reicht als eindeutige Bezeichnung der Rückgabe-Typ, da dies die einzige SEARCH -Anweisung für eine Probe in dieser Konfiguration ist.

Spaltenname

Der Spaltenname ist die Kurzbezeichnung, da dies das Attribut ist, nach dem wir bei der Suche filtern.

Konverter

Für den Fall, dass die Kurzbezeichnung kein Präfix in Form eines Buchstabens enthält, ist es ratsam, ein Konverter-Skript einzurichten. Denn Zellen, die ausschließlich Zahlen enthalten können unter Umständen als Double-Werte importiert werden. Das folgende Konverter-Skript konvertiert ggf. Doubles zurück zu Strings:


if (value instanceof Double) {
java.text.NumberFormat format = java.text.NumberFormat.getIntegerInstance();
format.setGroupingUsed(false);
return com.dialog.util.StringUtil.getFormattedNumberString(value, 0, null, null, false, format);
}
else {
return com.dialog.util.StringUtil.valueOf(value);
}

Skript

An dieser Stelle ist kein Skript nötig, da die interne Logik anhand der gegebenen Kurzbezeichnung die Probe eindeutig bestimmen kann und keine weitere Logik vonnöten ist.

Suchverhalten

Wenn die Probe nicht gefunden wurde, ist die Anweisung fehlgeschlagen. Daher soll eine Fehlermeldung geloggt werden. Hierzu wird das Suchverhalten auf ERROR gesetzt.

Aktualisierungsverhalten

Validierungsverhalten

Da alle nachfolgenden Schritte von dem Erfolg dieser Anweisung abhängen, kann der Import abgebrochen werden, wenn sie fehlschlägt. Daher ist das Validierungsverhalten ABORT .

**1.1 Validiere Probenstatus**

Nun, da eine Probe für den Import vorhanden ist, gilt es, diese zu validieren. Diese Anweisung dient dazu, sicherzustellen, das die Probe im richtigen Status ist und bearbeitet werden darf. Wenn dies nicht der Fall ist, wird der Benutzer in den Logs darauf hingewiesen.

Feld

Inhalt

Beschreibung

Entsprechend der Funktion "Validiere Probenstatus"

Anweisungstyp

Da wir einen Datensatz validieren wollen, ist der korrekte Typ VALIDATE .

Bereich

Es muss kein Bereich angegeben werden, da wir für die Validierung lediglich die Probe der Oberanweisung benötigen, die als Variable zur Verfügung steht.

Position

Es muss keine Position angegeben werden, da wir für die Validierung lediglich die Probe der Oberanweisung benötigen, die als Variable zur Verfügung steht.

Rückgabetyp

Rückgabe-Alias

Spaltenname

Für Logging-Zwecke wird dieses Feld mit dem zu validierenden Feld belegt, also "status". Abgesehen davon hat es in diesem Fall keine Funktion.

Konverter

Skript

Das Skript greift auf die probe -Variable der Suche Probe -Anweisung zu. Die Probe wird darauf geprüft, ob sie in einem Status ist, in dem sie editiert werden darf. Ist dies der Fall, so wird ein String mit einer Fehlermeldung zurückgegeben, die in dem Log auftauchen wird.:


if (probe != null && probe instanceof Probe) {
var object = (Probe) probe;
if (!object.isChangeable()) {
return "Die Probe "
+object.getKurzbezeichnung()
+" ist im Status "
+object.getStatus()
+" und darf nicht geändert werden.";
}
}
return null;


Suchverhalten

Aktualisierungsverhalten

Validierungsverhalten

Da nicht mit der Probe weitergearbeitet werden kann, wenn diese Anweisung fehlschlägt, sollte das Validierungsverhalten entweder SKIP_ANWEISUNG oder ABORT sein. Ersteres delegiert den Abbruch an die Oberanweisung, während die Anweisung bei Letzterem den Abbruch selbst veranlasst.

**1.2 Suche Analysedatum**

In dieser Anweisung wird das Analysedatum initial aus der Datei bezogen und von einem String- in ein Date-Objekt konvertiert.

Feld

Inhalt

Beschreibung

Der Funktion entsprechend "Suche Analysedatum"

Anweisungstyp

Da wir ein Objekt anhand einer Zelle erstellen und in Folgeanweisungen weiterverarbeiten wollen, ist der korrekte Typ "SEARCH".

Bereich

Es müssen keine Bereiche durchiteriert werden, da wir nur einen einzigen Wert aus einer konkreten Zelle importieren möchten. Daher bleibt dieses Feld leer.

Position

Um die gesuchte Zelle zu definieren reicht ein


Cell

-Aufruf mit den entsprechenden Koordinaten (Spalte = 10, Zeile = 5).


Cell(10,5)

Rückgabetyp

Dieser ist Date da ein Date-Objekt erstellt wird.

Rückgabe-Alias

Hier reicht als eindeutige Bezeichnung "datum", da dies die einzige SEARCH Anweisung für ein Datums-Objekt in dieser Konfiguration ist.

Spaltenname

Für Logging-Zwecke wird dieses Feld mit "datum" belegt. Abgesehen davon hat es in diesem Fall keine Funktion.

Konverter

Obwohl an dieser Anweisung lediglich ein Text zu einem Datum konvertiert wird, darf dies nicht im Konverter-Skript geschehen, da ein leeres Skript-Feld zu der Verwendung der internen Logik führen würde, die für Business-Objekte (Proben, Chargen etc.) gedacht ist.

Skript

Der importierte Datums-Text wird zu einem Date-Objekt konvertiert und zurückgegeben. Ein besonderes Augenmerk gilt hierbei dem Formats-String, der für die Interpretation des Importwertes verwendet wird:


//value -> Der Importwert, ein Datum in Text-Form

if (!StringUtil.isBlank(value)) {
Date date = (new java.text.SimpleDateFormat("yyyy-MM-dd HH:mm:ssX")).parse(value);
return date;
}
return null;

Suchverhalten

Aktualisierungsverhalten

Validierungsverhalten

Da das Analysedatum nicht von kritischer Wichtigkeit für die nachfolgenden Anweisungen ist, reicht hier WARN .

**1.3 Setze Proben-Bemerkung**

Diese Anweisung soll die Bemerkung für die Probe aus einer Zelle der Datei beziehen und diese über die interne Logik setzen.

Feld

Inhalt

Beschreibung

Der Funktion entsprechend "Setze Proben-Bemerkung".

Anweisungstyp

Da wir ein Attribut an der Probe setzen wollen, ist der korrekte Typ UPDATE .

Bereich

Es müssen keine Bereiche durchiteriert werden, da wir nur einen einzigen Wert aus einer konkreten Zelle importieren möchten. Daher bleibt dieses Feld leer.

Position

Um die gesuchte Zelle zu definieren reicht ein


Cell

-Aufruf mit den entsprechenden Koordinaten (Spalte = 5, Zeile = 1).


Cell(5,1)

Rückgabetyp

Rückgabe-Alias

Spaltenname

Der Spaltenname ist bemerkung , da dies dieses Attribut an der Probe gesetzt werden soll. In diesem Fall ist der Inhalt dieses Feldes kritisch für die korrekte Verarbeitung der Anweisung, da hierüber die Logik für die Ermittlung des Attributs an der Probe und für das Setzen des Wertes definiert wird.

Konverter

Da der Wert in der Importdatei hauptsächlich aus Ziffern besteht, wird an dieser Stelle eine optionale Konvertierung verwendet, um ggf. importierte Zahlenwerte als Strings weiterverwenden zu können:


if (value instanceof Double) {
java.text.NumberFormat format = java.text.NumberFormat.getIntegerInstance();
format.setGroupingUsed(false);
return com.dialog.util.StringUtil.getFormattedNumberString(value, 0, null, null, false, format);
}
return com.dialog.util.StringUtil.valueOf(value);


Skript

Da für das Setzen der Bemerkung die interne Logik ausreicht, wird kein Skript benötigt.

Suchverhalten

Aktualisierungsverhalten

Sollte eine Bemerkung bereits existieren, soll sie überschrieben werden. Daher ist der Wert an dieser Stelle OVERWRITE .

Validierungsverhalten

Da die Bemerkung nicht von kritischer Wichtigkeit für die nachfolgenden Anweisungen ist, reicht hier WARN .

**1.4 Suche Ergebniszuordnungen**

Nun gilt es, die Ergebniszuordnungen zu ermitteln, an denen die Ergebniswerte eingetragen werden sollen.

Feld

Inhalt

Beschreibung

Der Funktion entsprechend "Suche Ergebniszuordnungen"

Anweisungstyp

Da wir einen Datensatz finden wollen, ist der korrekte Typ "SEARCH".

Bereich

In dieser Anweisung und ihren Unteranweisungen werden die Import-IDs und Ergebniswerte verwendet, die in den Zeilen ab Zeile zwölf der Datei tabellarisch aufgelistet sind. Unser gewünschter Bereich muss die relevanten Zellen umfassen und dabei durch die Zeilen durchiterieren, um bei jeder Iteration eine Ergebniszuordnung verarbeiten zu können.

Eine Besonderheit hierbei ist, dass das Iterationsende variabel ist, da die Anzahl der Ergebniszeilen von Seite zu Seite in der Importdatei unterschiedlich sein kann. Daher wird das Ende des Bereiches dadurch definiert, dass darauf die Summenzeile der Tabelle folgt. Sie Summenzeile identifizieren wir dadurch, dass sie eine Zelle mit dem Inhalt "Sum"- enthält. Dies sieht als Bereichsdefinion wie folgt aus:


From(Row(12)).until(Cell("Sum").row)

Position

Da wir in dieser Anweisung keinen einzelnen Wert haben, sondern dynamisch mehrere Zellen innerhalb einer Iteration durch die Zeilen einer Tabelle ermitteln, ist die Positionsdefinition keine einzelne absolute Zelle, sondern relativ zu der aktuellen Zeile unserer Iteration. Bei jeder Iteration befindet sich die Import-ID in unserer aktuellen Zeile in der vierten Spalte, daher sieht die Positionsdefinition wie folgt aus:


currentRow.Col(4)

Rückgabetyp

Dieser ist ZuordnungProbeAnalyseErgebnis, da nach einer Ergebniszuordnung gesucht wird.

Rückgabe-Alias

Hier reicht als eindeutige Bezeichnung der Rückgabe-Typ (abgekürzt als "zpae").

Spaltenname

Der Spaltenname ist "importId", da dies der aus der Datei bezogene Wert ist. Dies ist nur für das Logging relevant.

Konverter

Skript

Anhand der Import-ID in der Variable value werden die Ergebniszuordnungen an der probe gefiltert. Existiert eine Zuordnung mit der korrekten ID an ihrem Ergebnis, so wird diese zurückgegeben.


if (value == null){
return null;
}

return probe.getZuordnungProbeAnalyseErgebnisVector().stream().filter(zpae ->
value.equals(zpae.getErgebnis().getImportId())).findFirst().orElse(null);

Suchverhalten

Aktualisierungsverhalten

Validierungsverhalten

Sobald bei der Ermittlung der Ergebniszuordnungen ein Fehler auftritt, soll eine Warnung ausgegeben werden. Daher ist das Validierungsverhalten WARN.

**1.4.1 Validiere Zuordnungsstatus**

Die Ergebniszuorgnungen müssen analog zu der Probe selbst auf ihren Status überpüft werden. Wenn dieser nicht korrekt ist, wird der Benutzer in den Logs darauf hingewiesen.

Feld

Inhalt

Beschreibung

Entsprechend der Funktion "Validiere Zuordnungsstatus"

Anweisungstyp

Da wir einen Datensatz validieren wollen, ist der korrekte Typ VALIDATE .

Bereich

Es muss kein Bereich angegeben werden, da wir für die Validierung lediglich die Zuordnung der Oberanweisung benötigen, die als Variable zur Verfügung steht.

Position

Es muss keine Position angegeben werden, da wir für die Validierung lediglich die Zuordnung der Oberanweisung benötigen, die als Variable zur Verfügung steht.

Rückgabetyp

Rückgabe-Alias

Spaltenname

Für Logging-Zwecke wird dieses Feld mit dem zu validierenden Feld belegt, also "status". Abgesehen davon hat es in diesem Fall keine Funktion.

Konverter

Skript

Das Skript greift auf die zpae -Variable der Suche Ergebniszuordnungen -Anweisung zu. Die Zuordnung wird darauf geprüft, ob sie in einem Status ist, in dem sie editiert werden darf. Ist dies der Fall so wird ein String mit einer Fehlermeldung zurückgegeben, die in den Logs auftauchen wird.:


if (zpae != null && zpae instanceof ZuordnungProbeAnalyseErgebnis) {
var object = (ZuordnungProbeAnalyseErgebnis) zpae;
if (!object.isChangeable()) {
return "Die ZPAE "
+ object.toString()
+ " ist im Status "
+ object.getStatus()
+ " und darf nicht geändert werden";
}
}
return null;

Suchverhalten

Aktualisierungsverhalten

Validierungsverhalten

Ist die Zuordnung nicht änderbar, so soll mit der nächsten Zuordnung fortgefahren werden. Daher ist das Validierungsverhalten SKIP_BEREICH .

**1.4.2 Setze Ergebniswert**

Nun da die Ergebniszuordnung vorhanden ist, kann der Ergebniswert gesetzt werden.

Feld

Inhalt

Beschreibung

Der Funktion entsprechend "Setze Ergebniswert"

Anweisungstyp

Da wir einen Datensatz verändern wollen, ist der korrekte Typ UPDATE .

Bereich

An dieser Stelle soll auf die aktuelle Iterationszeile zugegriffen werden. Da die Bereichsdefinition der Oberanweisung jedoch keine Zeilen sondern den Gesamtbereich liefert, muss er an dieser Stelle in Zeilen aufgeteilt werden.


bereich().repeat(1)

Position

Hier kann nun bei der Iteration durch die Zeilen auf die aktuelle Zeile zugegriffen und der Importwert aus der entsprechenden Zelle bezogen werden.


Row_Bereich(1).Col(6)

Rückgabetyp

Rückgabe-Alias

Spaltenname

Für das Logging wird an dieser Stelle "wert" eingetragen.

Konverter

Hier werden ggf. String-Werte in Doubles konvertiert.


if (value instanceof Double) {
return value;
}
else if (value != null) {
return StringUtil.getDouble(value,java.util.Locale.ENGLISH);
}
return null;

Skript

Der Importwert value wird als Messwert an der verfügbaren Zuordnung ( zpae ) gesetzt.


if (value instanceof String && "Sum".equals(value)) {
return zpae;
}
else if (value != null) {
com.dialog.dialims.business.ErgebnisWertController.getInstance()
.getOrCreateFirstFreeErgebniswert(zpae).setWert((Double) value,st);
return null;
}

return "Importwert ist null";

Suchverhalten

Aktualisierungsverhalten

Validierungsverhalten

Analog zu Validiere Zuordnungsstatus soll mit der nächsten Zuordnung fortgefahren werden, wenn bei dem Setzen des Ergebniswertes ein Fehler auftritt.

**1.4.3 Setze Analysedatum**

In der letzten Anweisung wird das Analysedatum gesetzt, welches wir in der Anweisung Suche Analysedatum ermittelt haben.

Feld

Inhalt

Beschreibung

Der Funktion entsprechend "Setze Analysedatum"

Anweisungstyp

Da wir ein Attribut an der Ergebniszuordnung setzen wollen, ist der korrekte Typ UPDATE .

Bereich

Da wir lediglich auf verfügbare Variablen zugreifen wollen, ist keine Bereichsdefinition nötig.

Position

Analog zu dem Bereich ist hier keine Positionsdefinition nötig.

Rückgabetyp

Rückgabe-Alias

Spaltenname

Der Spaltenname ist "analysedatum", da dies das Attribut ist, das wir an der Zuordnung setzen.

Konverter

Skript

Hier wird nun das Analysedatum( datum ) an der Zuordnung ( zpae ) gesetzt.


if (zpae != null) {
zpae.setAnalysedatum(datum);
zpae.markForSaving(st);
return null;
}
return "Keine ZPAE";


Suchverhalten

Aktualisierungsverhalten

Validierungsverhalten

Da das Setzen des Analysedatums nicht kritisch für den Import ist, kann hier WARN gesetzt werden.

## Beispiel 2: Import von mehreren Ergebnissen für mehrere Proben mit horizontaler Iteration

Importdatei​

Ein Screenshot der Importdatei

In diesem Beispiel wollen wir eine CSV-Datei mit Messwerten für mehrere Proben importiert. Die Proben sind zeilenweise aufgelistet und in jeder Zeile finden sich folgende Daten:

  • Name : Die Kurzbezeichnung der Probe, deren Ergebniswerte eingetragen werden sollen
  • Acq. Date-Time : Das Analysedatum, das an allen Ergebniszuordnungen eingetragen werden soll

In den nachfolgenden Spalten sind die Daten für die Messungen aufgelistet. Hierbei gehört ein Block von vier Spalten zu einem Ergebnis. In der ersten Zeile über jedem Block ist die Import-ID des Ergebnisses.:

  • Erste Zeile : Die Import-ID des zu importierenden Ergebnisses. Anhand dieser an dem Stammdatenergebnis gesetzter ID soll die Ergebniszuordnung an der Probe identifiziert werden, an der der Ergebniswert eingetragen werden soll.
  • Final Conc. : Der einzutragende Ergebniswert

Importkonfiguration​

Ein Screenshot der Name-Seite einer Importkonfiguration

Auf der Name -Seite der Konfiguration wird folgendes eingestellt: Format wird auf CSV gesetzt, da dies das vorliegende Datei Format ist. Codepage ist die Kodierung der Datei, also UTF-8. Als Dezimaltrennzeichen wird Punkt verwendet. Das Texttrennzeichen ist das Anführungszeichen und das Feldtrennzeichen ist Komma.

Ein Screenshot der Anweisungen-Seite der Importkonfiguration PAK

Auf der Anweisungen -Seite benötigen wir insgesamt sieben Anweisungen, um die oben gezeigte Datei zu importieren.

1 Suche Proben

Die erste Anweisung dient dazu, die Proben zu ermitteln, die in der Datei hinterlegt ist. Basierend darauf können dann die Ergebniszuordnungen gefunden und die Ergebnisse eingetragen werden. Das relevante Feld für die Anweisung befindet sich in jeder Zeile ab Zeile 3 in der ersten Spalte.

Feld

Inhalt

Beschreibung

Beschreibungen sind in diesem Beispiel eindeutige Bezeichnungen für die Anweisungen, die beschreiben, was ihre Funktion ist. In diesem Fall "Suche Proben".

Anweisungstyp

Da wir einen Datensatz finden wollen, ist der korrekte Typ SEARCH .

Bereich

Die relevanten Bereiche für die Proben sind je eine Zeile ab Zeile 3. Die Bereichsdefinition für eine Probe muss hier die gesamte Zeile und nicht nur die erste Zelle in jeder Zeile (die die Kurzbezeichnung enthält) umfassen, da die nachfolgenden Unteranweisungen auf die restlichen Zellen der Zeile zugreifen müssen.


From(Row(3)).repeat(1)

Position

Hier wird die relevante Zelle für diese Anweisung angegeben. In diesem Fall ist dies die erste Spalte in Zeile der definierten Bereiche.


currentRow.Col(1)

Rückgabetyp

Dieser ist Probe, da nach einer Probe gesucht wird. Der Name des Business-Typs ist in diesem Fall gleich.

Rückgabe-Alias

Hier reicht als eindeutige Bezeichnung der Rückgabe-Typ, da dies die einzige SEARCH -Anweisung für eine Probe in dieser Konfiguration ist.

Spaltenname

Der Spaltenname ist die Kurzbezeichnung, da dies das Attribut ist, nach dem wir bei der Suche filtern.

Konverter

Für den Fall, dass die Kurzbezeichnung kein Präfix in Form eines Buchstabens enthält, ist es ratsam, ein Konverter-Skript einzurichten. Denn Zellen, die ausschließlich Zahlen enthalten können unter Umständen als Double-Werte importiert werden. Das folgende Konverter-Skript konvertiert ggf. Doubles zurück zu Strings:


if (value instanceof Double) {
java.text.NumberFormat format = java.text.NumberFormat.getIntegerInstance();
format.setGroupingUsed(false);
return com.dialog.util.StringUtil.getFormattedNumberString(value, 0,null ,null ,false ,format);
}

return com.dialog.util.StringUtil.valueOf(value);


Skript

An dieser Stelle ist kein Skript nötig, da die interne Logik anhand der gegebenen Kurzbezeichnung die Probe eindeutig bestimmen kann und keine weitere Logik vonnöten ist.

Suchverhalten

Wenn die Probe nicht gefunden wurde, ist die Anweisung fehlgeschlagen. Daher soll eine Fehlermeldung geloggt werden. Hierzu wird das Suchverhalten auf ERROR gesetzt.

Aktualisierungsverhalten

Validierungsverhalten

Wenn eine Probe nicht gefunden wurde, soll die nächste Zeile verarbeitet werden. Daher ist das Validierungsverhalten WARN .

**1.1 Validiere Probenstatus**

Nun, da eine Probe für den Import vorhanden ist, gilt es, diese zu validieren. Diese Anweisung dient dazu, sicherzustellen, dass die Probe im richtigen Status ist und bearbeitet werden darf. Wenn dies nicht der Fall ist, wird der Benutzer in den Logs darauf hingewiesen.

Feld

Inhalt

Beschreibung

Entsprechend der Funktion "Validiere Probenstatus"

Anweisungstyp

Da wir einen Datensatz validieren wollen, ist der korrekte Typ VALIDATE .

Bereich

Es muss kein Bereich angegeben werden, da wir für die Validierung lediglich die Probe der Oberanweisung benötigen, die als Variable zur Verfügung steht.

Position

Es muss keine Position angegeben werden, da wir für die Validierung lediglich die Probe der Oberanweisung benötigen, die als Variable zur Verfügung steht.

Rückgabetyp

Rückgabe-Alias

Spaltenname

Für Logging-Zwecke wird dieses Feld mit dem zu validierenden Feld belegt, also "status". Abgesehen davon hat es in diesem Fall keine Funktion.

Konverter

Skript

Das Skript greift auf die probe -Variable der Suche Probe -Anweisung zu. Die Probe wird darauf geprüft, ob sie in einem Status ist, in dem sie editiert werden darf. Ist dies der Fall so wird ein String mit einer Fehlermeldung zurückgegeben, die in den Logs auftauchen wird. Ist die Validierung erfolgreich, wird null zurückgegeben.:


if (probe != null && probe instanceof Probe) {
var object = (Probe) probe;
if (!object.isChangeable()) {
return "Die Probe "
+ object.getKurzbezeichnung()
+ " ist im Status "
+ object.getStatus()
+ " und darf nicht geändert werden.";
}
}
return null;


Suchverhalten

Aktualisierungsverhalten

Validierungsverhalten

Wenn die Validierung der aktuellen Probe fehlschlägt, soll mit der nächsten Probe fortgefahren werden. Daher ist das Validierungsverhalten SKIP_BEREICH .

**1.2 Suche Analysedatum**

In dieser Anweiung wird das Analysedatum initial aus der Datei bezogen und von einem String- in ein Date-Objekt konvertiert.

Feld

Inhalt

Beschreibung

Der Funktion entsprechend "Suche Analysedatum"

Anweisungstyp

Da wir ein Objekt anhand einer Zelle erstellen und in Folgeanweisungen weiterverarbeiten wollen, ist der korrekte Typ "SEARCH".

Bereich

Da in dieser Anweisung der aktuelle Bereich der Oberanweisung weiterverwendet werden kann, muss hier keine Definition angegeben werden.

Position

Hier kann analog zu Suche Proben auf die zweite Spalte der aktuellen Iterationszeile zugegriffen werden.


currentRow.Col(2)

Rückgabetyp

Dieser ist Date, da ein Date-Objekt erstellt wird.

Rückgabe-Alias

Hier reicht als eindeutige Bezeichnung "datum", da dies die einzige SEARCH Anweisung für ein Datums-Objekt in dieser Konfiguration ist.

Spaltenname

Für Logging-Zwecke wird dieses Feld mit dem zu validierenden Feld belegt, also "datum". Abgesehen davon hat es in diesem Fall keine Funktion.

Konverter

Obwohl an dieser Anweisung lediglich ein Text zu einem Datum konvertiert wird, darf dies nicht im Konverter-Skript geschehen, da ein leeres Skript-Feld zu der Verwendung der internen Logik führen würde, die für Business-Objekte (Proben, Chargen etc.) gedacht ist.

Skript

Der importierte Datums-Text wird zu einem Date-Objekt konvertiert und zurückgegeben. Ein besonderes Augenmerk gilt hierbei dem Formats-String, der für die Interpretation des Importwertes verwendet wird:


if (!StringUtil.isBlank(value)) {
Date date = (new
java.text.SimpleDateFormat("MM/dd/yyyy HH:ss")).parse(value);
return date;
}
return null;


Suchverhalten

Aktualisierungsverhalten

Validierungsverhalten

Da das Analysedatum nicht von kritischer Wichtigkeit für die nachfolgenden Anweisungen ist, reicht hier WARN .

**1.3 Suche Ergebniszuordnungen**

Nun gilt es, die Ergebniszuordnungen zu ermitteln, an denen die Ergebniswerte eingetragen werden sollen.

Feld

Inhalt

Beschreibung

Der Funktion entsprechend "Suche Ergebniszuordnungen"

Anweisungstyp

Da wir einen Datensatz finden wollen, ist der korrekte Typ "SEARCH".

Bereich

In dieser Anweisung und ihren Unteranweisungen werden die Import-IDs und Ergebniswerte verwendet, die jeweils beginnend ab Spalte drei der Datei in einer beliebigen Anzahl von Bereichen aus vier Spalten aufgelistet sind.

Um durch diese horizontalen Bereiche zu iterieren, teilt die Bereichsdefinition die Spalten der Datei beginnend ab der dritten Spalte in Vierergruppen auf:


From(Col(3)).repeat(4)

Position

Die Import-IDs der Ergebnisse befinden sich in der ersten Zeile der Datei und in der ersten Spalte jedes definierten Bereiches.


Row(1).Col_Bereich(1)

Rückgabetyp

Dieser ist ZuordnungProbeAnalyseErgebnis, da nach einer Ergebniszuordnung gesucht wird.

Rückgabe-Alias

Hier reicht als eindeutige Bezeichnung der Rückgabe-Typ (abgekürzt als "zpae").

Spaltenname

Der Spaltenname ist "importId", da dies der aus der Datei bezogene Wert ist. Dies ist nur für das Logging relevant.

Konverter

Skript

Anhand der Import-ID in der Variable value werden die Ergebniszuordnungen an der probe gefiltert. Existiert eine Zuordnung mit der korrekten ID an ihrem Ergebnis, so wird diese zurückgegeben.


if (value == null) {
return null;
}

return probe.getZuordnungProbeAnalyseErgebnisVector().stream().filter(zpae ->
value.equals(zpae.getErgebnis().getImportId())).findFirst().orElse(null);


Suchverhalten

Aktualisierungsverhalten

Validierungsverhalten

Sollte es bei der Suche der Zuordnungen zu Fehlern kommen, soll eine Warnung ausgegeben und die Verarbeitung mit der nächsten Zuordnung fortgesetzt werden. Daher ist das Validierungsverhalten WARN.

**1.3.1 Validiere Zuordnungsstatus**

Die Ergebniszuordnungen müssen analog zu der Probe selbst auf ihren Status überprüft werden. Wenn dieser nicht korrekt ist, wird der Benutzer in den Logs darauf hingewiesen.

Feld

Inhalt

Beschreibung

Entsprechend der Funktion "Validiere Zuordnungsstatus"

Anweisungstyp

Da wir einen Datensatz validieren wollen, ist der korrekte Typ "VALIDATE".

Bereich

Es muss kein Bereich angegeben werden, da wir für die Validierung lediglich die Zuordnung der Oberanweisung benötigen, die als Variable zur Verfügung steht.

Position

Es muss keine Position angegeben werden, da wir für die Validierung lediglich die Zuordnung der Oberanweisung benötigen, die als Variable zur Verfügung steht.

Rückgabetyp

Rückgabe-Alias

Spaltenname

Für Logging-Zwecke wird dieses Feld mit dem zu validierenden Feld belegt, also "status". Abgesehen davon hat es in diesem Fall keine Funktion.

Konverter

Skript

Das Skript greift auf die zpae -Variable der Suche Ergebniszuordnungen -Anweisung zu. Die Zuordnung wird darauf geprüft, ob sie in einem Status ist, in dem sie editiert werden darf. Ist dies der Fall so wird ein String mit einer Fehlermeldung zurückgegeben, die in den Log auftauchen wird.:


if (zpae != null && zpae instanceof ZuordnungProbeAnalyseErgebnis) {
var object = (ZuordnungProbeAnalyseErgebnis) zpae;
if (!object.isChangeable()) {
return "Die ZPAE "
+ object.toString()
+ " ist im Status "
+ object.getStatus()
+ " und darf nicht geändert werden";
}
}
return null;

Suchverhalten

Aktualisierungsverhalten

Validierungsverhalten

Sollte die Validierung fehlschlagen, soll mit der nächsten Zuordnung fortgefahren werden. Daher ist das Validierungsverhalten SKIP_BEREICH .

**1.3.2 Setze Ergebniswert**

Nun da die Ergebniszuordnung vorhanden ist, kann der Ergebniswert gesetzt werden.

Feld

Inhalt

Beschreibung

Der Funktion entsprechend "Setze Ergebniswert"

Anweisungstyp

Da wir einen Datensatz verändern wollen, ist der korrekte Typ UPDATE .

Bereich

An dieser Stelle soll auf die aktuelle Iterationszeile zugegriffen werden. Daher ist keine eigene Bereichsdefinition nötig.

Position

Hier kann nun bei der Iteration durch die Zeilen auf die aktuelle Zeile zugegriffen und die Spalte relativ zu dem aktuellen Spaltenbereich ermittelt werden:


currentRow.Col_Bereich(2)

Rückgabetyp

Rückgabe-Alias

Spaltenname

Für das Logging wird an dieser Stelle "wert" eingetragen.

Konverter

Hier werden ggf. String-Werte in Doubles konvertiert.


if (value instanceof Double) {
return value;
}
else if (value != null) {
return StringUtil.getDouble(value,java.util.Locale.ENGLISH);
}
return null;


Skript

Der Importwert value wird als Messwert an der verfügbaren Zuordnung ( zpae ) gesetzt.


if (value != null) {
com.dialog.dialims.business.ErgebnisWertController.getInstance()
.getOrCreateFirstFreeErgebniswert(zpae).setWert(value,st);
return null;
}
return "Es gibt keine Ergebniszuordnung";


Suchverhalten

Aktualisierungsverhalten

Validierungsverhalten

Analog zu Validiere Zuordnungsstatus wird hier SKIP_BEREICH gesetzt, sodass ein Abbruch erfolgt, sobald die Verarbeitung fehlschlägt.

**1.3.3 Setze Analysedatum**

In der letzten Anweisung wird das Analysedatum gesetzt, welches wir in der Anweisung Suche Analysedatum ermittelt haben.

Feld

Inhalt

Beschreibung

Der Funktion entsprechend "Setze Analysedatum"

Anweisungstyp

Da wir ein Attribut an der Ergebniszuordnung setzen wollen, ist der korrekte Typ "UPDATE".

Bereich

Da wir lediglich auf verfügbare Variablen zugreifen wollen, ist keine Bereichsdefinition nötig.

Position

Analog zu dem Bereich ist hier keine Positionsdefinition nötig.

Rückgabetyp

Rückgabe-Alias

Spaltenname

Der Spaltenname ist analysedatum , da dies das Attribut ist, das wir an der Zuordnung setzen.

Konverter

Skript

Hier wird nun das Analysedatum( datum ) an der Zuordnung ( zpae ) gesetzt.


zpae.setAnalysedatum(datum);
zpae.markForSaving(st);
return null;


Suchverhalten

Aktualisierungsverhalten

Validierungsverhalten

Da das Setzen des Analysedatums nicht kritisch für den Import ist, kann hier WARN gesetzt werden.

## Beispiele für Groovy-Skripte

Konvertierung eines Textes zu einem Datum​

Das folgende Skript kann verwendet werden, um ein Datum in Textform zu einem Date-Objekt zu konvertieren.


//value -> Importwert und ein Text, der einen Zeitstempel darstellt
if (!StringUtil.isBlank(value)){
//Dieses Pattern anpassen
Date date = (new java.text.SimpleDateFormat("MM/dd/yyyyHH:ss")).parse(value);
return date;
}
return null;


Einen neuen Messwert zu einer Ergebniszuordnung hinzufügen​

Mit diesem Skript kann ein Messwert zu einer Ergebniszuordnung hinzugefügt werden.


//value -> Importwert und ein Double
//zpae -> eine ZuordnungProbeAnalyseErgebnis
//st -> Die SaveTransaction des Importprozesses der Datei

if (value != null && value instanceof Double) {
com.dialog.dialims.business.ErgebnisWertController.getInstance().
getOrCreateFirstFreeErgebniswert(zpae).setWert((Double) value,st);
}
return zpae;

Eine Dezimalzahl in einen Ganzzahl-Text konvertieren​

Mit diesem Skript kann ein Double zu einem Text konvertiert werden, hierbei wird die Zahl so formatiert, dass sie keine Nachkommastellen besitzt. Es werden keine Gruppierungszeichen verwendet.


//value -> Importwert und ein Double

if (value instanceof Double) {
java.text.NumberFormat format =
java.text.NumberFormat.getIntegerInstance();
format.setGroupingUsed(false);
return com.dialog.util.StringUtil.getFormattedNumberString(value, 0, null, null, false, format);
}
return value;


Den Status eines Status-Objektes überprüfen​

Kann überprüft werden, ob ein Objekt geändert werden darf. Die LIMSObject.isChangeable-Methode prüft den Status des Objektes und ggf. auch den Status seines Ober-Objektes.


//probe -> eine Probe

if (probe != null && probe instanceof Probe) {
var object = (Probe) probe;
if (!object.isChangeable()) {

return "Die Probe "
+ object.getKurzbezeichnung()
+ " ist im Status "
+ object.getStatus()
+ " und darf nicht geändert werden";
}
}
return null;


Die Zugriffserlaubnis für ein Objekt überprüfen​

Kann überprüft werden, der aufrufende Benutzer des Import-Tools die Rechte besitzt, um ein Objekt zu ändern.


//probe -> eine Probe

if (probe != null && probe instanceof Probe){
var object = (Probe) probe;
if (!object.isUpdateable()) {

return "Der aktuelle Benutzer besitzt nicht die Berechtigung, um die Probe "
+ object.getKurzbezeichnung()+" zu ändern.";
}
}
return null;


Beispiele für Bereichsdefinitionen​

Ab erster Zeile mit Werten bis letzte Zeile mit Werten​


//Überspringt alle Zeilen, in denen in Spalte 1 nichts steht
From(findRowThatMatches(".+",1)).repeatUntil(findRowWithEmptyCell(1))

Zeilen mit leeren Werten überspringen​


//Beginn: Erste Zeile, die eine Kurzbezeichnung enthält, die mit "P" beginnt.
//Iteriert durch Zeilen und überspringt dabei diejenigen,
//die in Spalte 1 leer sind
From(findRowThatMatches("^P\\d+\$")).repeatUntil(findRowWithEmptyCell(1))

Nur Zeilen mit bestimmten Werten berücksichtigen​


//Beginn: Erste Zeile, die eine Kurzbezeichnung enthält, die mit "P" beginnt und Ziffern enthält.
//Iteriert durch Zeilen und überspringt dabei diejenigen,
//bei denen der Inhalt von Spalte 1 keine Kurzbezeichnung
//im oben genannten Muster ist.
From(findRowThatMatches("^P\\d+\$")).repeatUntil(findRowThatMatches("^((?!P\\d+)).*\$",1))