Importschnittstellen Übersicht

Importschnittstellen ermöglichen den strukturierten Import von Daten aus externen Systemen, Geräten oder Dateien in die Labordatenbank. Sie unterstützen zahlreiche Datentypen, Dateiformate (CSV, JSON, XML, LDT, HL7) sowie verschiedene Übertragungswege wie manuellen Upload, HTTPS, SFTP und E-Mail-Empfang. Mittels JavaScript-Code kann die Dateistruktur individuell transformiert werden, um nahezu alle beliebigen Quelldatenformate zu verarbeiten.

Video

In diesem Onboarding-Video erhalten Sie einen kompakten Einstieg in die Parameterverwaltung der Labordatenbank:

Navigation

Öffnen Sie die Importschnittstellen-Verwaltung über:
Navigationsleiste → Proben → Importschnittstellen

Überblick

Importschnittstellen ermöglichen den strukturierten Datenimport aus externen Systemen, Geräten oder Dateien in die Labordatenbank. Die Schnittstellen sind für fast alle Datentypenverfügbar und unterstützen verschiedene Übertragungswege sowie Dateiformate.

Unterstützte Datentypen

Folgende Datentypen können über Importschnittstellen importiert werden. Dabei könne neue Einträge angelegt oder bestehende Einträge aktualisiert werden.

Messwerte
Proben
Aufträge
Dateien
Kunden
Kontakte
Prüfmittel
Rechnungen
Angebote
Anlagen
Anlagenteile
Entnahmestellen
Materialien
Chargen
Berichte
Spezifikationen
Tasks
Vorlagen
Notizen
Rezepturen
Bestandteile
Zeiterfassung

Unterstützte Dateiformate

Daten können in textbasierten Formate wie z.B. CSV, JSON, XML, HL7, LDT importiert werden, sowie Dateien in Dokumenten- und Bildformaten wie PDF, PNG, JPG.
Darüber hinaus können die in z.B. PDF's enthaltenen Informationen automatisch per KI-gestützter Texterkennung extrahiert und für die weitere Verarbeitung aufbereitet werden. Weiterführende Informationen finden Sie unter: KI Erweiterung der Importschnittstellen
Tabellenformate wie Excel (.xlsx) werden nicht unterstützt. Jedoch hat Excel die Funktion zur Verfügung, die Datei in csv umzuwandeln.

Transformation der Dateistruktur mittels JavaScript

Es besteht die Möglichkeit, die Struktur und den Inhalt der zu importierenden Daten mittels JavaScript-Code individuell zu transformieren. Dies ermöglicht eine flexible Anpassung an nahezu alle textbasierten Quelldatenformate.

Typische Anwendungsfälle sind:

Umbenennung oder Zusammenführung von Spalten/Feldern
Berechnung oder Ableitung neuer Felder aus vorhandenen Werten
Filterung oder Bereinigung von Datensätzen vor dem Import
Umwandlung von Datums- oder Zahlenformaten
Aufsplitten oder Zusammenführen von Datensätzen
individuell konfigurierte Fehlermeldungen

Unsere Empfehlung: Sprechen Sie mit Ihrer Kundenbetreuung bezüglich der JavaScript-Transformation, wenn das Quellformat nicht direkt über das Standard-Mapping abgebildet werden kann. So lassen sich nahezu alle externen Systeme anbinden.

Übertragungswege / Anbindungen

Die Daten können auf verschiedenen Wegen an die Importschnittstelle übermittelt werden:

Manueller Upload: Datei direkt bei der jeweiligen Importschnittstelle hochladen (Drag & Drop wird unterstützt).
HTTPS PUSH: Daten als HTTP POST an die Labordatenbank senden (die Schnittstelle wird mit dem Badge HTTPS gekennzeichnet).
HTTPS PULL: Daten via HTTPS von einer vordefinierten URL abrufen. (die Schnittstelle wird mit dem Badge HTTPS gekennzeichnet).
SFTP: Automatisierter Dateiimport über SFTP-Server (die Schnittstelle wird mit dem Badge SFTP gekennzeichnet). Weiterführende Informationen: Automatischer FTP/SFTP Import
E-Mail-Empfang: Jede Importschnittstelle verfügt über eine eigene E-Mail-Adresse und kann Dateien als E-Mail-Anhang empfangen (die Schnittstelle wird mit dem Badge Email gekennzeichnet)

Anbindung externer Systeme (Auszug)

Die Labordatenbank unterstützt die Anbindung zahlreicher externer Systeme mittels REST, SFTP und HTTP POST/GET.

Laborgeräte (Auszug): Agilent, Chromeleon, Bio-Rad, Bruker, Leco, Tecan, Thermo Fisher, TiAmo, SybrGreen, Zwick u. v. m.

CRM/ERP-Systeme: AS400, Business One, MS Dynamics/Navision, ProAlfa, Salesforce, SAP

Behörden: DEMIS-RK, EMS, EPI BRZ EU-Grüner Pass, TEIS/NiWaDaB/Octoware/TWISTweb

Fremdlabore & Meldenetzwerke: Caritasnet, Novid20, neolution, 2weeks

Arzt- und Praxissoftware: eTermin, M1, Tomedo

Beschreibung der Importschnittstellen Übersicht

Die Importschnittstellen werden nach Datentypen gruppiert in einer Übersicht dargestellt.

Hinweis: Alle blau hinterlegten Namen in der Liste sind anklickbare Links zur jeweiligen Importschnittstelle. Importschnittstellen mit automatischem Übertragungsweg (HTTPS, SFTP, Email) werden mit einem farbigen Badge gekennzeichnet.

Spalte	Beschreibung
Name	Bezeichnung der Importschnittstelle. Blau hinterlegt und anklickbar – führt zur Detailansicht. Daneben wird bei konfigurierten Übertragungswegen ein farbiges Badge angezeigt (HTTPS, SFTP, Email).
Letzter Import	Datum und Uhrzeit des zuletzt durchgeführten Imports (mit Stiftsymbol). Wurde noch kein Import durchgeführt, erscheint noch kein Import.
Anzahl Importe	Gesamtanzahl der bisher durchgeführten Importe für diese Schnittstelle.

Funktionen

Neue Importschnittstelle anlegen

Erstellen Sie eine neue Importschnittstelle direkt über die Verwaltung.

Klicken Sie rechts neben dem jeweiligen Datentyp auf die graue Schaltfläche + Importschnittstelle anlegen.

Bestehende Importschnittstelle bearbeiten

Ändern Sie die Konfiguration einer bereits angelegten Importschnittstelle.

Klicken Sie auf das Stiftsymbol neben dem Namen der Importschnittstelle.
Alternativ: Klicken Sie auf den blau hinterlegten Namen der Importschnittstelle und anschließend auf die orange Schaltfläche Importschnittstelle bearbeiten.

Importschnittstelle anzeigen / Import durchführen

Klicken Sie auf den blau hinterlegten Namen der Importschnittstelle, um in die Detailansicht zu wechseln.
In der Detailansicht können Sie abhängig von der Konfiguration:
- eine Datei manuell hochladen (Drag & Drop wird unterstützt)
- Daten über ein Formular oder Textfeld eingeben
- einen Import vom konfigurierten SFTP- oder HTTP-Server auslösen
Imports von einem SFTP-Server können bei Bedarf automatisiert alle 10 min durchgeführt werden.

Reihenfolge ändern

Passen Sie die Anzeigereihenfolge der Importschnittstellen innerhalb eines Datentyps an.

Klicken Sie rechts oben auf die Schaltfläche Reihenfolge ändern.
Klicken Sie daraufhin auf das Pfeil-Symbol neben der Importschnittstelle und ziehen Sie den Eintrag an die gewünschte Position.
Die neue Reihenfolge wird automatisch gespeichert.

Import-Verlauf einsehen

Für jede Importschnittstelle wird ein vollständiger Verlauf aller durchgeführten Importe geführt.

Klicken Sie auf den Namen der Importschnittstelle, um in die Detailansicht zu gelangen.
In der Detailansicht werden die bisherigen Importe tabellarisch mit Datum, Benutzer, importierter Datei und Ergebnis (Erfolg/Fehler) angezeigt.
Über die farbigen Links erfolgreich (grün) bzw. ehlgeschlagen (rot) können Sie die Importe entsprechend filtern.

Änderungen an der Importschnittstelle einsehen

Änderungen an einer Importschnittstelle werden im Audit-Trail der Labordatenbank protokolliert und können jederzeit nachvollzogen werden.

Import wiederholen

Einen bereits durchgeführten Import könne Sie erneut ausführen.

Klicken Sie beim relevanten Import auf nochmal importieren.
Alternativ: Öffnen Sie den gewünschten Import über die Schaltfläche anzeigen.
Klicken Sie daraufhin auf nochmal importieren, um den Import mit den ursprünglichen Daten erneut auszuführen.

Hinweis: Die Import-Wiederholung ist nur verfügbar, wenn die Rohdaten des ursprünglichen Imports gespeichert wurden und kein Importvorschau-Modus aktiv ist.