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.
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:
- Start- und Endzeile des dargestellten Bereiches in der Datei (absolute Angabe)
- Start- und Endspalte des dargestellten Bereiches in der Datei (absolute Angabe)
- 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.
- Ă–ffnen Sie das Modul
Schnittstellen. - Erstellen Sie einen neuen Schnittstellen-Datensatz.
- FĂĽgen Sie der erstellten Schnittstelle einen neuen Worker auf der
WorkerSeite hinzu. - Wählen Sie als LIMSWorker den Eintrag
ImportKonfigurationProcessaus und bestätigen Sie den Dialog. - 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.