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

Letzte Prüfung: 29.10.2026

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

• Mechanismus: Programmaufruf via Kommandozeilenparameter -c . Läuft SMART-Pedigree bereits, wird der Aufruf an das geöffnete Programm weitergegeben – ab Version 3.0 nur innerhalb desselben Benutzerkontos. Das Drittsystem muss SMART-Pedigree daher in der Sitzung des angemeldeten Benutzers aufrufen; Aufrufe aus einem anderen Konto (z. B. einem Dienstkonto) werden ignoriert.
• Dateiformat: JSON-basiertes Austauschformat.
• Workflow:
• Übergabe: Das Drittsystem startet SMART-Pedigree und übergibt eine Datei mit der externalId (Fallnummer) und ggf. auch mit Fragebogen-Daten (PDF oder Webfragebogen-JSON).
• Rückmeldung: Nach jedem Speichern und jedem Export schreibt SMART-Pedigree die Austauschdatei neu. In files stehen dann die Dateien, die in diesem Schritt neu angelegt oder geändert wurden: der Stammbaum (.sav), eine Grafik (.png), ein Export (.txt, .doc) oder beim Mehrfach-Export alle dabei erzeugten Dateien. Übergebene Dateien, die SMART-Pedigree nicht verändert hat, stehen danach nicht mehr in der Liste. externalId und metadata bleiben unverändert.
• Verarbeitung: Der aktualisierte Zeitstempel (Last Modified) signalisiert dem Drittsystem (via File-Watcher), dass neue oder geänderte Dateien vorliegen. Liest es die Liste nach jeder Änderung, erfährt es jede geschriebene Datei.
• Absturz: Die Austauschdatei wird atomar geschrieben; ein Absturz während des Schreibens hinterlässt die bisherige, vollständige Fassung. Stellt SMART-Pedigree nach einem Absturz einen Stammbaum aus der automatischen Sicherung wieder her, ist er wieder mit seiner Austauschdatei verbunden; das nächste Speichern meldet sich dort wie gewohnt (ab Version 3.1).
• Kennung: Die Fall- oder Patienten-ID steht als externalId in der Austauschdatei. Der ältere Parameter -i <ID> ist veraltet; wird er zusammen mit -c übergeben, gilt die externalId der Austauschdatei.
• 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 trägt nach jedem Speichern bzw. Export die dabei geschriebenen Dateien ein.

A.1 Beispieldatei (JSON)

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

A.2 Beispieldatei (JSON) nach einem Mehrfach-Export in SMART-Pedigree

{
  "externalId": "XYZ",
  "files": [
    "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

Feld	Herkunft	Beschreibung
externalId	Drittsystem	Die eindeutige Fall- oder Patienten-ID des führenden Systems.
files	Hybrid	Eine Liste absoluter Pfade. Beim Aufruf die vom Drittsystem bereitgestellten Importe (z. B. PDF/JSON-Fragebögen), die SMART-Pedigree öffnet; nach jedem Speichern bzw. Export die in diesem Schritt geschriebenen Dateien.
metadata	Drittsystem	Optional, Liste von key/value-Paaren; SMART-Pedigree gibt sie unverändert zurück.

4. PLIGU-Import-Schnittstelle

Letzte Prüfung: 29.10.2026

SMART-Pedigree liest PLIGU-XML-Dateien über Datei → Importieren → Pligu XML ein. Die Namen der Attribute müssen dabei genau so geschrieben sein wie in der PLIGU-Datei, einschließlich Groß- und Kleinschreibung.

• Infotext (Infos): Er kommt vollständig und unverändert in die Notiz der Person; er legt keine Erkrankung an. Erkennt SMART-Pedigree darin mögliche Erkrankungen mit Alter, zeigt es sie nach dem Import zur Auswahl an („Übernehmen“ oder „Nicht übernehmen“, voreingestellt ist „Nicht übernehmen“). Übernommenes wird Erkrankung und aus der Notiz entfernt; alles andere bleibt in der Notiz (ab Version 3.1).
• Erkrankungen und Symbole: Erkrankungen kommen aus den Diagnosefeldern (BrCaDiag, BrCa2Diag, dcisalter, dcisalterkontralateral, OvCaDiag, ProCaDiag, PanCaDiag, DarmCaDiag, jeweils mit Alter) und aus ICD1–ICD3 mit Alter. Das Symbol folgt dem PLIGU-Status; gleicher Status ergibt dasselbe Symbol.
• Zwillinge: Verweisen zwei Personen über Zwillinge aufeinander, werden sie als ein Zwillingspaar übernommen; eineiig="True" als eineiig, "False" als zweieiig.
• Unbekannter Wert: Enthält ein Attribut einen Wert, den SMART-Pedigree nicht kennt (z. B. einen neuen Code beim Rezeptorstatus), bricht der Import ab. Die Meldung nennt Person, Attribut und Wert; bitte senden Sie den Fehlerbericht, damit der Wert ergänzt werden kann.

Felder ohne eigenes Gegenstück

Für einige PLIGU-Attribute gibt es in SMART-Pedigree kein eigenes Feld. Sie gehen trotzdem nicht verloren:

Attribut in der PLIGU-Datei	Behandlung
OtherCaDiag (Alter bei einer anderen Krebserkrankung)	als Vorschlag „andere Krebserkrankung“ mit Alter in der Auswahl nach dem Import
borderlineRechts, borderlineLinks	als Vorschlag „Borderline-Tumor rechts“ bzw. „links“ in der Auswahl
Rauchen (ältere Dateien)	„ja“ wird als „jemals geraucht“ übernommen, wenn everSmoker nichts angibt; „N“ ist dort der Standardwert und bleibt unberücksichtigt; andere Werte kommen in die Notiz
schwangerschaften	SMART-Pedigree zählt Schwangerschaften als Personen im Stammbaum; nennt PLIGU mehr, als im Stammbaum stehen, kommt die Zahl mit dem Vergleich in die Notiz
firstlivebirth	SMART-Pedigree berechnet das Alter bei der ersten Lebendgeburt aus den Kindern; fehlt deren Geburtsdatum oder weicht der Wert ab, kommt er in die Notiz
Gtest, Mutn (ältere Dateien), festgelegtesAlter	wörtlich in die Notiz
alle übrigen, auch unbekannte Attribute	wörtlich in die Notiz, wenn sie einen Wert haben („PLIGU Attribut: Wert“)
PositionInGeneration, x, y, inDatenbankSpeichern, inDatenbankBekannt	nicht übernommen (Lage und Datenbank-Kennzeichen in PLIGU)

Was in die Notiz kam, listet SMART-Pedigree nach dem Import je Person auf; tragen Sie es bei Bedarf im Eigenschaftenfenster nach.

Reihenfolge und Position berechnet SMART-Pedigree beim Import neu; der Stammbaum wird automatisch angeordnet.