Zum Hauptinhalt springen

Exportkonfiguration erstellen

Ausführung einer Exportkonfiguration​

Die Logik, die bei dem Export einer Datei mit einer Exportkonfiguration ausgeführt wird, wird über ihre Felder (Export-Spaltenkonfigurationen) definiert.

Bei einem Export werden der Ordnung nach alle Export-Spaltenkonfigurationen einer Exportkonfiguration ausgeführt.

Aufbau einer Export-Spaltenkonfiguration​

Nachfolgend wird erklärt, wie die einzelnen Export-Spaltenkonfigurationen einer Exportkonfiguration aufgebaut sind und welche Bedeutung ihre individuellen Felder besitzen.

Verfügbare Felder​

  • Konfiguration

    Die Ordnungszahl der Export-Spaltenkonfiguration. Bestimmt die Reihenfolge, in der die Konfigurationen ausgeführt werden.

  • Beschreibung

    Die Beschreibung der Export-Spaltenkonfiguration.

  • Typ

    Der Typ der Konfiguration bestimmt, wie die Information in die Exportdateien geschrieben werden.

    • Property (alle Exportformate)

      Ermittelt einen Wert, der in die Exportdatei geschrieben werden soll.

    • Node (nur XML und JSON)

      Stellt ein Element in der Exportdatei dar.

    • Attribute (nur XML)

      Ähnlich wie Property. Stellt aber ein Attribut eines XML-Elements dar.

  • Feld

    Definiert einen Pfad von Referenzen zu einem Feld aus denen die Rohinformation bezogen werden sollen. Der Pfad geht von dem zu exportierenden Datensatz aus (angegeben an der Exportkonfiguration) und das Feld am Ende bestimmt die Rohinformationen, die bezogen werden sollen. Sind in dem Pfad Felder angegeben, in denen mehrere Werte vorhanden sein können, werden die Rohinformationen pro vorhanden Datensatz aufgefächert und in einer Liste zurückgegeben.

    Beispiele:

    • Datensatz: Angebot, Feld: Angebot

      Gibt die Kurzbezeichnung des Angebots zurück.

    • Datensatz: Auftrag, Feld: Proben -> Probe

      Gibt die Kurzbezeichnung aller Proben des Auftrags zurück.

    • Datensatz: Auftrag, Feld: Proben -> Ergebniszuordnungen -> Analyse Methodennorm

      Gibt die Analyse Methodennorm aller Ergebniszuordnungen aller Proben des Auftrags zurück.

    Je nach Feld und übergeordneten Node, kann bei XML und JSON eine Gruppierung der Werte erfolgen:

    Beispiel:

    Datensatz: Auftrag

    • Typ: Node, Feld: Proben*,
      • Typ: Property, Feld: Proben -> Ergebniszuordnungen -> Analyse Methodennorm*

    Erstellt pro Probe an den Auftrag einen Node für die jeweilige Probe. Darunter werden alle Analyse Methodennorm aller Ergebniszuordnungen der jeweiligen Probe ausgegeben.

  • Name

    Der Name der Information, der abhängig von Exportformat, Kopfzeile erstellen bzw. Typ in der Exportdatei angegeben wird.

    • CSV oder Text mit gesetzten Schalter Kopfzeile erstellen

      Die Spaltenüberschrift.

    • XML mit Typ:

      • Node / Property

        Name des XML-Elements.

      • Attribute

        Name des XML-Attributs.

    • JSON

      • Node

        Name des JSON-Properties unter dem das JSON-Objekt beim Parent angegeben wird. (sofern es ein Parent gibt)

      • Property (Attribute)

        Name des JSON-Properties.

  • Pflichtfeld

    Gibt an, ob der Wert ein Pflichtfeld ist und dieser gesetzt sein muss, damit ein Export erfolgen kann.

  • Filter

    Ähnlich wie Pflichtfeld. Allerdings kann man ein Skript definieren, das bestimmt, ob ein Export erfolgen kann. Dabei kann man auf folgende Kriterien prüfen:

    • der Wert selbst
    • Datensatz (zu dem der Wert gehört)
    • Datensätze (die im Feld ermittelt werden)
    • Index (z.B. bei mehreren Werten)

    Beispiel: return value.startsWith("P2026"); Textwerte werden nur exportiert, wenn diese mit 'P2026' anfangen. (Man sollte darauf achten, dass das Skript zum diaLIMS-Typ passt, da es sonst zu Fehlern kommt und der Wert nicht exportiert werden kann.)

  • Konverter

    Exportwerte können nochmal individuell für den Export angepasst werden. Folgende Informationen können dabei berücksichtigt werden:

    • der Wert selbst
    • Datensatz (zu dem der Wert gehört)
    • Datensätze (die im Feld ermittelt werden)
    • Index (z.B. bei mehreren Werten)

    Beispiel: return new java.text.SimpleDateFormat("yyyy-MM-dd").format(value); Formatiert einen Datumswert in das Format 'yyyy-MM-dd' (z.B.: 2026-05-19) (Man sollte darauf achten, dass das Skript zum diaLIMS-Typ passt, da es sonst zu Fehlern kommt und der Wert nicht exportiert werden kann.)

  • Feldlänge

    Gibt die Anzahl an Zeichen an, die der Wert maximal haben darf. Ist der Wert länger als dieser Wert, wird er auf die Länge verkürzt.

  • diaLIMS-Datentyp

    Informative Angabe, die den Datentyp des Feldes im diaLIMS zurückgibt. (Ohne Berücksichtigung eines möglichen Konverter-Skripts) Die Information kann dazu genutzt werden, um zu entscheiden, wie der Wert in einem Skript behandelt werden muss und ob der Wert für das Zielformat mittels Konverter nochmal umgewandelt werden muss.

  • Zielformat (Info)

    Hier kann man Notizen zum erwarteten Zielformat hinterlegen, als Hilfe, wenn man die Exportkonfiguration erstellt oder nachträglich bearbeitet.

  • Kardinalität (Info)

    Hier kann man Notizen zu der erwarteten Wiederholung von mehreren Werten hinterlegen. Beispielsweise wie oft ein XML-Element vorkommen darf.

  • Bemerkung

    Ein freies Notizfeld für sonstige Bemerkungen.

Verarbeitung einer Exportkonfiguration​

Die zu exportierenden Datensätze werden nacheinander abgearbeitet. Alle folgenden Schritte werden für jeden Datensatz ausgeführt, bevor mit dem Nächsten weitergemacht wird. Lediglich der Abschluss wird nach dem Export aller Datensätze ausgeführt.

Abarbeitungsreihenfolge​

Auf die zu exportierenden Datensätze werden nacheinander die Export-Spaltenkonfigurationen angewendet, um die Exportdaten zu ermitteln. Die Export-Spaltenkonfigurationen werden in Reihenfolge der Ordnung (und Hierarchie) abgearbeitet (Auf gleicher Ebene in direkter Reihenfolge der Ordnung. Wenn eine Export-Spaltenkonfiguration Kinder hat, werden zuerst diese abgearbeitet, bevor mit der nächsten Export-Spaltenkonfiguration auf gleicher Ebene begonnen wird.)

Ermittlung der Rohdaten​

Auf den zu exportierenden Datensätzen werden alle Export-Spaltenkonfigurationen nacheinander angewendet. Pro Export-Spaltenkonfiguration werden zuerst die Rohinformationen anhand der Angabe im Feld ermittelt. Auf Basis der Rohinformationen kann die Struktur aufgebaut werden.

Aufbaue der Struktur​

Sind alle Rohinformationen erfasst, wird die Exportstruktur gemäß dem Exportformat aufgebaut. Wenn eine Rohinformation eine Liste von Werten ist, dann werden die Werte aufgefächert. Die Auffächerung und ggf. eine Gruppierung wird dabei von Exportformat und Aufbau der Export-Spaltenkonfigurationen bestimmt. Dabei werden Pflichtfeld und Filter geprüft. Auf jeden Wert werden ggf. der Konverter und die Feldlänge angewendet.

Umwandlung in das Zielformat​

Zum Schluss wird die fertige Exportstruktur in das endgültige Zielformat umgewandelt und in der Datei festgeschrieben.

Abschluss​

Wurden alle Datensätze verarbeitet, werden alle Logs gesammelt, als Log-Eintrag gebündelt und ggf. dem Anwender das Ergebnis in einer Zusammenfassung dargestellt.