Zum Hauptinhalt springen

Importkonfigurationen

Fachlicher Hintergrund​

Der Import von Daten aus Excel- und CSV-Dateien ist ein häufiger Anwendungsfall, vor allem für das Einpflegen von Messdaten. Mit dem Importkonfigurationen-Modul können nun Importvorgänge eingerichtet werden, die bisherige von Hand programmierte Schnittstellen ablösen können.

Modulaufbau​

Name-Seite​

Auf dieser Seite können grundsätzliche Einstellungen zu dem Import vorgenommen werden.

VerfĂĽgbare Felder

  • Kurzbezeichnung

    Kurzbezeichnung der Importkonfiguration

  • Beschreibung

    Bezeichnung der Importkonfiguration. Wird fĂĽr das Logging verwendet, um Anweisungen zu identifizieren.

  • Format

    Datei-Format, das mit dieser Konfiguration importiert werden soll. Es kann ein Datentyp vorgegeben werden, wobei Excel (XLS oder XLSX ) oder CSV zur Verfügung stehen. Alternativ kann (ab Version 2024.1) der Typ "Text" ausgewählt werden, der keine Beschränkungen besitzt. Auf diese Weise importierte Dateien werden behandelt wie CSV-Dateien.

  • Dezimaltrennzeichen

    Nur fĂĽr CSV. Das zu verwendende Dezimaltrennzeichen fĂĽr Zahlenwerte.

  • Codepage

    Nur fĂĽr CSV. Die Kodierung der zu importierenden Dateien.

  • Texttrennzeichen

    Nur für CSV. Das zu verwendende Texttrennzeichen. (z.B. mit Anführungszeichen „Beispieltext, mit Komma“)

  • Feldtrennzeichen

    Nur fĂĽr CSV. Das zu verwendende Feldtrennzeichen.

  • Excel-Seiten

    Nur fĂĽr Excel. Definiert die zu importierenden Excel-Seiten. Hierbei werden Komma-getrennt die Indizes der gewĂĽnschten Seiten angegeben (z.B. 1,2,3). Wenn dieses Feld leer gelassen wird, werden alle verfĂĽgbaren Excel-Seiten importiert.

Anweisungen-Seite​

Hier werden die Anweisungen zu der Importkonfiguration in einer Baumansicht aufgelistet.

Die Verschachtelungstiefe kann in den Optionen unter Module -> Importkonfigurationen -> 'ImportKonfigurationAnweisungMaxHierarchyDepth'1 eingestellt werden.

warnung

Eine komplexe Baumstruktur kann sich negativ auf die Leistung auswirken!

Schaltflächen

  • Importanweisung erzeugen

    Es wird eine neue Anweisung auf höchster Ebene erstellt.

  • Unteranweisung erzeugen

    Es wird eine Unteranweisung zu der aktuell selektierten Anweisung erstellt. Sie erhält die nächsthöhere verfügbare Ordnung.

  • Anweisung löschen

    Löscht die selektierte(n) Anweisung(en)

  • Anweisung duplizieren

    Erstellt ein Duplikat der ausgewählten Anweisung

  • Bereichs- und Positionendaten testen

    Hiermit lässt sich testen, ob die an der ausgewählten Anweisungen gesetzten Bereichs- und Positionendefinitionen auf die korrekten Bereiche und Zellen verweisen.

  • Anweisungen sortieren

    Ermöglicht das Sortieren der Anweisungen. Die Sortierung bestimmt, in welcher Reihenfolge die Anweisungen ausgeführt werden. Die Abarbeitungsreihenfolge verläuft aufsteigend nach der Ordnung.

  • Anweisungen kopieren/einfĂĽgen

    Kopiert die ausgewählte Anweisung in die Zwischenablage, bzw. fügt eine kopierte Anweisung aus der Zwischenablage ein.

Bereichs- und Positionendaten testen

Bei Ausführung der Funktion wird zunächst eine Datei ausgewählt. Diese Datei muss hinsichtlich ihres inhaltlichen Aufbaus zu der Importkonfiguration passen.

AnschlieĂźend erscheint ein Dialog mit zwei Komponenten. Auf der linken Seite ist eine Tabelle der Bereiche, wie sie bei dem Import der Datei durchiteriert werden wĂĽrden.

Es gibt folgende Spalten:

  1. Start- und Endzeile des dargestellten Bereiches in der Datei (absolute Angabe)
  2. Start- und Endspalte des dargestellten Bereiches in der Datei (absolute Angabe)
  3. Iterationsrichtung, in die iteriert wird (Spaltenweise oder Zeilenweise)

Jede Zeile stellt hierbei den Bereich fĂĽr eine Iteration dar.

Auf der rechten Seite ist eine visuelle Darstellung der Daten der ausgewählten Datei als Tabelle zu sehen. Der links ausgewählte Bereich wird in der Tabelle hellblau markiert. Die für den gewählten Bereich definierte Zelle (Position) wird wiederum in dunkelblau markiert.

Der Dialog lässt sich mit einem Klick auf die OK -Schaltfläche schließen.

Log-Einträge-Seite​

Auf dieser Seite können Logeinträge eingesehen werden, die erstellt werden, wann immer ein Import mit der Importkonfiguration erfolgt. Sollte der entstandene Log eines Importprozesses zu lang werden, werden mehrere Einträge auf einmal erstellt. Die Log-Einträge enthalten Logs, die mindestens dem an der Importkonfiguration eingestellten Logging-Level entsprechen.

Schaltflächen

  • Log-Eintrag löschen

    Löscht selektierte(n) Log-Einträg(e)

Importkonfigurationen als Schnittstelle einrichten​

Mit der Funktion können Sie eine zuvor erstellte Importkonfiguration als Schnittstelle einrichten.

  1. Ă–ffnen Sie das Modul Schnittstellen.
  2. Erstellen Sie einen neuen Schnittstellen-Datensatz.
  3. FĂĽgen Sie der erstellten Schnittstelle einen neuen Worker auf der Worker Seite hinzu.
  4. Wählen Sie als LIMSWorker den Eintrag ImportKonfigurationProcess aus und bestätigen Sie den Dialog.
  5. Konfigurieren Sie den Worker. Die einzelnen Einstellungen werden in der folgenden Tabelle beschrieben.
  • Bestimmung des Ablageordners

    Gibt das Verhalten bei der Ermittlung des Ablageordners an.

  • Datei-Endung

    Legt die Dateiendung der zu importierenden Dateien fest. Bitte beachten Sie, dass das angegebene Dateiformat zu der Importkonfiguration passt.

  • endless_sleeptime_minutes

    Dauer, nach der der Worker erneut ausgeführt wird, wenn 'ständig Ausführen' gewählt ist.

  • Error-Log Move File to directory

    Angabe des Unterordners, in das die verarbeitete Datei verschoben werden soll, wenn im Log Fehler enthalten sind.

  • ImportKonfigurationKBZ

    Gibt die Kurzbezeichnung der Importkonfiguration an, die ausgefĂĽhrt werden soll.

  • PATH

    Legt den Importpfad fest.

  • status_mail_address

    E-Mail-Adressen, an die die Status-E-Mail gesendet wird. Mehrere E-Mail-Adressen mĂĽssen mit dem "EmailAdressatenTrenner" (in den Optionen einstellbar) getrennt werden.

  • status_mail_min_loglevel

    Log-Stufe, ab der eine Status-E-Mail versendet wird.

  • status_mail_subject

    Betreff fĂĽr die Status-E-Mail.

  • status_mail_template

    Dateipfad und Dateiname der E-Mail-Vorlage fĂĽr die Status-E-Mail.

  • Verhalten bei doppelten Dateinamen

    Legt fest, wie eine Datei gespeichert bzw. verschoben werden soll, die mit identischem Dateinamen bereits importiert wurde.

  • wait_behavior

    Gibt an, ab welchem Zeitpunkt die Berechnung des nächsten Durchlauf-Zeitpunktes erfolgt.

  • Warn-Log Move File to directory

    Angabe des Unterordners, in das die verarbeitete Datei verschoben werden soll, wenn im Log Warnungen enthalten sind.

Die erzeugten Logeinträge beim Ausführen der Schnittstelle können über die Importkonfiguration eingestellt werden. Dazu kann der Wert in der Spalte Logging-Level im Importkonfigurationen-Modul verwendet werden.

Footnotes​

  1. Ab Version 2027.1 ↩