MHH-Pneumologie-Online-Patientenformular: automatisiert befüllt per AppleScript

Hans Jörg Baumann

Moin,

gute Nachricht für alle Zuweiser der Pneumologischen Ambulanz in der Medizinischen Hochschule Hannover (MHH). Es gibt dort bereits seit längerer Zeit ein Onlineportal, auf dem man (bisher in allseits bekannt nervig händischer Weise) Patienten mit allen relevanten Daten anmelden kann (https://webext.mh-hannover.de/soscisurvey/admission/).

PD Dr. Jan Fuge, PD Dr., MPH, B.A., Datascientist / Statistician / Datamanagement Platform Group Leader aus dem Deutschen Zentrum für Lungenforschung ist die Befüllung dieses Fragebogens aus tomedo heraus mittels AppleScript möglich. Ein ganz großes Dankeschön nocheinmal für das Erarbeiten dieses Service und das freie zur Verfügung stellen. Großartig!

Formularbefüllung direkt mittels "Payload" des URL-Aufrufs (Textinformationen, die an die URL "drangehängt" werden, bei Verwendung von https datenschutzkonform) befüllt, so dass es bei Aufruf der URL komplett befüllt ist. Dr. Fuge hat der Veröffentlichung im tomedo-Forum ausdrücklich zugestimmt,

Das AppleScript erzeugt aus den angeforderten Informationen den URL mit den angehängten Informationen

Beim Aufruf der URL wird das Formular mit den transferierten Daten vorbefüllt, fertig.

Großartig wäre es, wenn die zahlreichen Radiologie-Portal einen Patientenzugriff auf diese Weise erlauben würden (URL + Patientencode + Geburtsdatum). Hallo Radiologie-Praxen, hört Ihr das?

Das technische Dokument (von Dr. Fuge erstellt) folgt (aufgrund der Zeichenbegrenzung im Forum) in einem Kommentar.

Das AppleScript ist im Tauschcenter zu finden: MHH-Pneumologie-Onlinepatientenformular.

Hans Jörg Baumann

Hier das technische Dokument (Teil 1) von Dr. Fuge:

Technische Beschreibung zur Vorbefüllung des Online-Anmeldeformulars

Projekt und Zielsetzung

Die Medizinische Hochschule Hannover (MHH) stellt ein webbasiertes Formular zur Anmeldung von Patientinnen und Patienten bereit.

Zur Vereinfachung des Anmeldeprozesses können bereits im Praxisverwaltungssystem (PVS) vorhandene Patienten- und Arztdaten beim Aufruf des Formulars automatisiert übergeben werden. Dadurch können die entsprechenden Formularfelder vorausgefüllt werden. Ziel ist es, doppelte Dateneingaben zu vermeiden, den manuellen Aufwand zu reduzieren und Übertragungsfehler zu minimieren.

Die Datenübergabe erfolgt über GET-Parameter in der URL. Eine separate API-Anbindung oder Authentifizierung ist für die Vorbefüllung nicht erforderlich. Das PVS erzeugt hierzu eine URL nach dem nachfolgend beschriebenen Schema und öffnet diese im Webbrowser.

Die Basis-URL des Formulars lautet:

https://webext.mh-hannover.de/soscisurvey/admission/

Die zu übertragenden Daten werden als Query-Parameter an die URL angehängt:

?variablenname=wert&variablenname=wert&...

Beispiel:

https://webext.mh-hannover.de/soscisurvey/admission/?pat_name=Mustermann&pat_firstname=Max&pat_dob=01.01.1990

Die Namen der unterstützten Parameter, die erwarteten Datentypen und zulässigen Werte sind in der nachfolgenden Variablenbeschreibung aufgeführt.

Technische Hinweise

Die Parameterwerte müssen URL-kodiert (Percent-Encoding) übertragen werden. Dies betrifft insbesondere Leerzeichen, Umlaute, Sonderzeichen und reservierte URL-Zeichen.

Beispiel:

Musterstraße 1 → Musterstra%C3%9Fe%201

Die Reihenfolge der Parameter ist nicht relevant.

Nicht vorhandene Daten sollten entweder als Parameter weggelassen oder mit einem leeren Wert übergeben werden. Nicht übergebene Felder können anschließend im Online-Formular manuell ergänzt werden.

Bei Variablen mit vorgegebenen Auswahlwerten müssen die in der Variablenbeschreibung angegebenen numerischen Codes verwendet werden. Beispielsweise wird das Geschlecht über pat_gender=1, pat_gender=2 oder pat_gender=3 übertragen.

Die Übergabe der Daten dient ausschließlich der Vorbefüllung des Formulars. Das Öffnen der URL stellt noch keine Anmeldung bzw. Übermittlung des ausgefüllten Formulars dar. Die Angaben können vor dem Absenden im Online-Formular geprüft und gegebenenfalls korrigiert oder ergänzt werden.

Beispiel einer vollständigen Übergabe

https://webext.mh-hannover.de/soscisurvey/admission/?pat_name=Mustermann&pat_firstname=Max&pat_dob=01.01.1990&pat_gender=1&pat_street=Musterstra%C3%9Fe%201&pat_zip=12345&pat_city=Musterstadt&pat_phone_01=015711234667&pat_phone_02=017472185343&pat_mail=maxmustermann%40mail.de&pat_insurance=1&pat_insurance_nr=A123456789&pat_insurance_name=Musterversicherung&pat_bodyheight=180&pat_bodyweight=80&phy_title=Dr.&phy_firstname=Erika&phy_name=Musterfrau&phy_mail=musterpraxis%40mail.de&phy_kim=pneumologie%40MHH.KIM.Telematik&phy_phone=051112345667&phy_fax=051112345677&phy_street=Musterstra%C3%9Fe&phy_zip=12345&phy_city=Musterstadt

Hans Jörg Baumann

Technisches Dokument Dr. Fuge (Teil 2):

Variablenbeschreibung

Beschreibung	Variablen-Name	Typ	Beispiel
Patientendaten
Name	pat_name	Text	Mustermann
Vorname	pat_firstname	Text	Max
Geburtsdatum	pat_dob	Datum (dd.mm.yyyy)	01.01.1950
Geschlecht	pat_gender	Zahl (1=male, 2=female, 3=diverse)	1
Straße und Hausnummer	pat_street	Text	Musterstrasse 1
Postleitzahl	pat_zip	Text Text (RegEx erlaubt nur Zahlen)	30625
Stadt	pat_city	Text	Hannover
Telefon 01	pat_phone_01	Text (RegEx erlaubt nur Zahlen)	015731231567
Telefon 02	pat_phone_02	Text (RegEx erlaubt nur Zahlen)	017332145326
E-Mail-Adresse	pat_mail	Text (RegEx für E-Mail)	maxmustermann@mail.de
Versicherungsart	pat_insurance	Zahl (1 = gesetzlich, 2 = privat, 3 = andere)	1
KV-Nummer	pat_insurance_nr	Text (RegEx für einen Großbuchstaben und 9 Zahlen) ^[A-Z][0-9]{9}$	W283504316
Name der Versicherung	pat_insurance_name	Text	AOK
Körpergröße in cm	pat_bodyheight	Zahl	175
Körpergewicht kg	pat_bodyweight	Zahl	75
Arztdaten
Klinik/Praxis Name	phy_institution	Text	Pneumologicum
Titel	phy_title	Text	Dr.
Vorname	phy_firstname	Text	Henning
Nachname	phy_name	Text	Geldmacher
E-Mail-Adresse	phy_mail	Text (RegEx für E-Mail)	info@pneumologicum.de
KIM-Adresse	phy_kim	Text (RegEx für KIM-Adressen)	pneumologie@MHH.KIM.Telematik
Telefonnummer	phy_phone	Text (RegEx erlaubt nur Zahlen)	0511805035
Faxnummer	phy_fax	Text (RegEx erlaubt nur Zahlen)	0511805037
Straße und Hausnummer	phy_street	Text	Hildesheimer Str. 98 b
Postleitzahl	phy_zip	Text (RegEx erlaubt nur Zahlen)	30173
Stadt	phy_city	Text	Hannover

Hans Jörg Baumann

AppleScript (kann ohne Änderungen direkt so genutzt werden):

-- ============================================================

-- Patiententransfer an MH Hannover (SoSciSurvey-Aufnahmeformular)

-- ============================================================

-- Baut aus Patientendaten die Aufnahme-URL

--   https://webext.mh-hannover.de/soscisurvey/admission/?...

-- und öffnet sie im Standardbrowser.

--

-- Basiert auf der offiziellen MHH-Variablenbeschreibung (technical_document,

-- Stand 2026-09-20). Damit sind jetzt bestätigt/korrigiert:

--   * pat_gender:    1 = male, 2 = female, 3 = diverse

--   * pat_insurance: 1 = gesetzlich, 2 = privat, 3 = andere

--   * phy_institution existiert als offizielles Feld ("Klinik/Praxis Name") –

--     meine frühere Vermutung, das Feld werde ignoriert, war falsch.

--   * pat_zip, pat_phone_01, pat_phone_02, phy_phone, phy_fax verlangen laut

--     Doku reine Ziffern (RegEx). Werden unten vor dem Versand entsprechend

--     bereinigt (Leerzeichen/Bindestriche entfernt).

--   * pat_phone_01 ist im Formular ein Pflichtfeld: Ist ptel (Tel 1) beim

--     Patienten leer, aber phandy (Tel 2/Handy) gefüllt, wird die Handynummer

--     automatisch nach pat_phone_01 verschoben (pat_phone_02 bleibt dann leer).

--   * pat_insurance_nr erwartet exakt einen Großbuchstaben + 9 Ziffern

--     (^[A-Z][0-9]{9}$) – wird hier nicht automatisch validiert, ggf. bei

--     Abweichung im Formular manuell prüfen/korrigieren.

--

-- DATENSCHUTZ: Der Link überträgt Patientendaten im Klartext als

-- URL-Parameter. HTTPS verschlüsselt zwar die Übertragung selbst, die Werte

-- können aber z.B. im Browser-Verlauf oder in Server-Logs landen. Bitte im

-- Rahmen eurer Datenschutz-Sorgfaltspflicht prüfen, ob das für den

-- Anwendungsfall akzeptabel ist.

-- ============================================================



use framework "Foundation"

use scripting additions



-- ---------- PRAXISDATEN ----------

set phyInstitution to "$[bn]$"

set phyTitle to "$[&p.patientenDetails.arzt.titel]$"

set phyFirstname to "$[&p.patientenDetails.arzt.vorname]$"

set phyLastname to "$[&p.patientenDetails.arzt.nachname]$"

set phyMail to "$[bemail]$"

set phyKim to "$[&p.patientenDetails.arzt.kimEmailAccount.emailAddress]$"

set phyPhone to "$[btel]$"

set phyFax to "$[bfax]$"

set phyStreet to "$[bs]$"

set phyZip to "$[bp]$"

set phyCity to "$[bo]$"



-- ---------- PATIENTENDATEN (aus tomedo-Platzhaltern befüllen) ----------

set patLastname to "$[pn]$"

set patFirstname to "$[pv]$"

set patDobRaw to "$[pg]$" -- erwartet dd.mm.yyyy

set patGenderRaw to "$[pMW]$"

set patStreet to "$[ps]$"

set patZip to "$[patient_plz]$"

set patCity to "$[po]$"

set patPhone1 to "$[ptel]$"

set patPhone2 to "$[phandy]$"

set patMail to "$[pemail]$"

set patInsuranceRaw to "$[patient_versichertenstatus]$"

set patInsuranceNr to "$[pversnr]$"

set patInsuranceName to "$[kasse_name]$"

set patHeight to "$[koerpergroesseAusLetztemBMI]$" -- in cm, nur Zahl

set patWeight to "$[gewichtAusLetztemBMI]$" -- in kg, nur Zahl





-- ---------- Hilfsfunktionen ----------



on toLowerText(t)

	set nsStr to current application's NSString's stringWithString:t

	return (nsStr's lowercaseString()) as text

end toLowerText



on cleanDate(d)

	if (length of d) > 10 then

		set d to text 1 thru 10 of d

	end if

	return d

end cleanDate



on mapGender(genderText)

	set g to my toLowerText(genderText)

	if g contains "w" then

		return "2" -- weiblich (

	else if g contains "d" or g contains "x" or g contains "u" then

		return "3" -- divers 

	else

		return "1" -- männlich 

	end if

end mapGender



on mapInsurance(insuranceText)

	set i to my toLowerText(insuranceText)

	if i contains "privat" then

		return "2" -- privat

	else if i contains "gesetzlich" then

		return "1" -- gesetzlich

	else if i = "" then

		return "" -- unbekannt/leer -> Feld im Formular offen lassen

	else

		return "3" -- andere

	end if

end mapInsurance



-- Entfernt alles außer Ziffern (für pat_zip, pat_phone_*, phy_phone, phy_fax –

-- laut MHH-Doku per RegEx auf reine Zahlen beschränkt)

on onlyDigits(t)

	set outText to ""

	repeat with ch in characters of t

		if "0123456789" contains (ch as text) then set outText to outText & ch

	end repeat

	return outText

end onlyDigits



-- RFC 3986 URL-Encoding (inkl. Umlaute, Leerzeichen etc.)

on urlEncode(theText)

	set nsStr to current application's NSString's stringWithString:theText

	set allowedChars to "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~"

	set allowedSet to current application's NSCharacterSet's characterSetWithCharactersInString:allowedChars

	set encoded to nsStr's stringByAddingPercentEncodingWithAllowedCharacters:allowedSet

	return encoded as text

end urlEncode



on addParam(paramName, paramValue)

	if paramValue is missing value then set paramValue to ""

	if paramValue = "" then return ""

	return paramName & "=" & my urlEncode(paramValue)

end addParam



-- ---------- Werte aufbereiten ----------



set patDob to cleanDate(patDobRaw)

set genderCode to mapGender(patGenderRaw)

set insuranceCode to mapInsurance(patInsuranceRaw)



-- Nur Ziffern, wie von der MHH-Doku für diese Felder verlangt

set patZipClean to onlyDigits(patZip)

set patPhone1Clean to onlyDigits(patPhone1)

set patPhone2Clean to onlyDigits(patPhone2)

set phyPhoneClean to onlyDigits(phyPhone)

set phyFaxClean to onlyDigits(phyFax)

set phyZipClean to onlyDigits(phyZip)



-- Das Formular verlangt pat_phone_01 zwingend. Falls ptel (Tel 1) bei

-- diesem Patienten leer ist, aber phandy (Tel 2/Handy) gefüllt, rückt

-- die Handynummer nach pat_phone_01 auf; pat_phone_02 bleibt dann leer,

-- damit dieselbe Nummer nicht doppelt gesendet wird.

if patPhone1Clean = "" and patPhone2Clean is not "" then

	set patPhone1Clean to patPhone2Clean

	set patPhone2Clean to ""

end if



-- ---------- Query-String zusammenbauen ----------



set paramList to {}

set end of paramList to addParam("pat_name", patLastname)

set end of paramList to addParam("pat_firstname", patFirstname)

set end of paramList to addParam("pat_dob", patDob)

set end of paramList to addParam("pat_gender", genderCode)

set end of paramList to addParam("pat_street", patStreet)

set end of paramList to addParam("pat_zip", patZipClean)

set end of paramList to addParam("pat_city", patCity)

set end of paramList to addParam("pat_phone_01", patPhone1Clean)

set end of paramList to addParam("pat_phone_02", patPhone2Clean)

set end of paramList to addParam("pat_mail", patMail)

set end of paramList to addParam("pat_insurance", insuranceCode)

set end of paramList to addParam("pat_insurance_nr", patInsuranceNr)

set end of paramList to addParam("pat_insurance_name", patInsuranceName)

set end of paramList to addParam("pat_bodyheight", patHeight)

set end of paramList to addParam("pat_bodyweight", patWeight)

set end of paramList to addParam("phy_institution", phyInstitution)

set end of paramList to addParam("phy_title", phyTitle)

set end of paramList to addParam("phy_firstname", phyFirstname)

set end of paramList to addParam("phy_name", phyLastname)

set end of paramList to addParam("phy_mail", phyMail)

set end of paramList to addParam("phy_kim", phyKim)

set end of paramList to addParam("phy_phone", phyPhoneClean)

set end of paramList to addParam("phy_fax", phyFaxClean)

set end of paramList to addParam("phy_street", phyStreet)

set end of paramList to addParam("phy_zip", phyZipClean)

set end of paramList to addParam("phy_city", phyCity)



set queryParts to {}

repeat with p in paramList

	if (p as text) is not "" then set end of queryParts to (p as text)

end repeat



set oldDelims to AppleScript's text item delimiters

set AppleScript's text item delimiters to "&"

set queryString to queryParts as text

set AppleScript's text item delimiters to oldDelims



set baseURL to "https://webext.mh-hannover.de/soscisurvey/admission/"

set fullURL to baseURL & "?" & queryString



-- ---------- Kontrolle & Öffnen ----------



set dlgResult to display dialog "Folgender Link wird im Standardbrowser geöffnet:" & return & return & fullURL buttons {"Abbrechen", "Öffnen"} default button "Öffnen"



if button returned of dlgResult is "Öffnen" then

	set browserApp to "Safari"

	

	try

		tell application browserApp

			activate

			open location fullURL

		end tell

	on error errText number errNum

		display dialog "Der Link konnte nicht automatisch geöffnet werden (Fehler " & errNum & "):" & return & errText & return & return & "Bitte in diesem Fall in Systemeinstellungen ? Datenschutz & Sicherheit ? Automatisierung prüfen, ob tomedo Zugriff auf " & browserApp & " erlaubt ist. Zur Not hier manuell öffnen:" & return & fullURL buttons {"OK"} default button "OK"

	end try

end if