Schnittstellen-Dokumentation & Datenintegration

1. Übersicht #

SMART-Pedigree unterstützt die bidirektionale Datenintegration über dateibasierte JSON-Schnittstellen sowie native Import-Module, um eine konsistente Datenhaltung über verschiedene medizinische Software-Plattformen hinweg sicherzustellen.


2. Laborsystem-Anbindung #

  • Labor-Systeme: Native, filebasierte Schnittstelle zu GenLab 8 integriert.
  • Verschlüsselung: Unterstützung für AES-verschlüsselte PDF-Datentransferformate für den Web-Fragebogen.

3. Drittsystem-Anbindung (Data Exchange Bundle) ab Version 2.0.0 #

SMART-Pedigree bietet eine bidirektionale, dateibasierte Schnittstelle zur nahtlosen Integration in Drittsysteme (z. B. KIS, Labormanagement).

  • Mechanismus: Programmaufruf via Kommandozeilenparameter -c <Pfad zur Austauschdatei>.
  • Dateiformat: JSON-basiertes Austauschformat.
  • Workflow:
    1. Übergabe: Das Drittsystem startet SMART-Pedigree und übergibt eine Datei mit der externalId (Fallnummer) und ggf. auch mit Fragebogen-Daten (PDF oder Webfragebogen-JSON).
    2. Synchronisation: SMART-Pedigree aktualisiert während der Sitzung automatisch die Liste der zugehörigen Dateipfade (files) für Stammbäume (.sav), Grafiken (.png) und Exporte (.txt, .doc).
    3. Rückmeldung: Beim Speichern oder Schließen schreibt SMART-Pedigree die .spdx-Datei neu. Der aktualisierte Zeitstempel (Last Modified) signalisiert dem Drittsystem (via File-Watcher), dass die Bearbeitung abgeschlossen ist und die neuen Dateipfade verarbeitet werden können.
  • Vorteil: Kein direkter Datenbankzugriff zwischen den Systemen erforderlich; maximale Stabilität und Nachvollziehbarkeit.

Anhang A: Beispiel einer Austauschdatei #

Die folgende JSON-Struktur zeigt ein typisches Szenario: Ein Drittsystem (KIS) übergibt Fallnummer und Vorab-Daten; SMART-Pedigree ergänzt während der Bearbeitung die Pfade zu den erzeugten Fachdaten und Exporten.

A.1 Beispieldatei (JSON) #

{
  "externalId": "XYZ",
  "files": [
    "C:/Schnittstelle/Input/Fragebogen_digital.pdf"
  ]
}

A.2 Beispieldatei (JSON) nach der Bearbeitung durch SMART-Pedigree: #

{
  "externalId": "XYZ",
  "files": [
    "C:/Schnittstelle/Input/Fragebogen_digital.pdf",
    "C:/SMART-Pedigree/Fragebogen_digital.sav",
    "C:/SMART-Pedigree/Fragebogen_digital_Image_20260803_120553.png",
    "C:/SMART-Pedigree/Fragebogen_digital_CanRisk_20260803_120553.txt",
    "C:/SMART-Pedigree/Fragebogen_digital_Info_20260803_120553.doc" 
  ]
}

A.3 Erläuterung der Datenfelder #

FeldHerkunftBeschreibung
externalIdDrittsystemDie eindeutige Fall- oder Patienten-ID des führenden Systems.
filesHybridEine Liste absoluter Pfade. Enthält initial die vom Drittsystem bereitgestellten Importe (z. B. PDF/JSON-Fragebögen) und wird von SMART-Pedigree um erzeugte Dateien ergänzt.

PLIGU-Import-Schnittstelle #

Letzte Prüfung: Juni 2026

Übersicht #

Die folgenden Datenfelder sind im internen Datenmodell von SMART-Pedigree bereits vollständig angelegt und über entsprechende Getter verfügbar. Zum aktuellen Zeitpunkt werden diese Felder jedoch noch nicht aktiv aus den PLIGU-Quelldateien extrahiert bzw. beim Importvorgang zugewiesen.

Mapping-Logik #

Die Felder in der PLIGU-Importdatei korrespondieren direkt mit den unten gelisteten Gettern. Die Zuordnung erfolgt über ein Case-Insensitive Mapping (Groß-/Kleinschreibung wird ignoriert).

Liste der ausstehenden Felder #

Getter-MethodeBeschreibungWertebereich
schwangerschaften()Anzahl der Schwangerschaften??
firstLiveBirth()Alter bei der ersten Lebendgeburt??
borderlineRechts()Borderline-Tumor Status (rechts)??
borderlineLinks()Borderline-Tumor Status (links)??
festgelegtesAlter()Manuell fixiertes Alter für Berechnungen??
positionInGeneration()Sortierindex innerhalb der Generationsebene??
inDatenbankSpeichern()Flag für Persistierung in klinischer DB??
inDatenbankBekannt()Abgleich-Status mit Bestandssystem??
x(), y()Koordinaten für PositionierungX, Y

Haben Sie keine Antwort gefunden? Kontaktieren Sie unseren Support.

Updated on 8. September 2026