← Alle Module |
💳
eGK-Kartenleser
Hilfswerkzeug

eGK-Kartenleser

Die eGK-Anwendung liest Stammdaten von der Elektronischen Gesundheitskarte (eGK) und stellt sie dem Browser lokal zur Verfügung. Sie läuft als unauffälliges Tray-Icon im Hintergrund und wird vom Patienten- und vom Shelter-Modul genutzt, um Personendaten per Knopfdruck statt per Tastatur zu erfassen.

Läuft lokal auf deinem PC Kein Server nötig Optionale Erweiterung
💳

Überblick

Was die eGK-Anwendung macht und wie sie eingebunden ist

💳
Kartenleser
USB, per PC/SC angesprochen
→
🖥️
eGK-Anwendung
Tray-Icon, läuft auf deinem PC
→
🌐
Browser
ws://localhost:9971

Die eGK-Anwendung benötigt keinen IuK-Backend-Server — sie spricht direkt mit dem angeschlossenen Kartenleser und stellt die ausgelesenen Daten über eine lokale WebSocket-Verbindung (localhost:9971) bereit. Jede Anfrage liest die Karte frisch aus, es werden keine Daten gespeichert.

Wichtig: Da die Verbindung über localhost läuft, muss die eGK-Anwendung auf jedem Arbeitsplatz installiert und gestartet sein, an dem ein Kartenleser genutzt werden soll — nicht zentral auf dem Server. Ein Browser kann nur die eGK-Anwendung erreichen, die auf demselben Rechner läuft.
🖥️

Start & Tray-Icon

Nach dem Start erscheint ein Icon in der Taskleiste

eGK Tray-Icon

Die eGK-Anwendung öffnet kein Fenster. Beim Start erscheint lediglich ein kleines Icon im Tray-Bereich der Taskleiste. Beim Überfahren mit der Maus zeigt der Tooltip die Adresse, unter der die Anwendung erreichbar ist: eGK Kartenleser - ws://localhost:9971.

Schritt für Schritt

  1. Kartenleser per USB anschließen, bevor die Anwendung gestartet wird.
  2. eGK-Anwendung starten (z. B. per Verknüpfung oder Autostart-Eintrag).
  3. Icon erscheint im Tray — die Anwendung läuft jetzt im Hintergrund weiter.
  4. Browser öffnen und das Patienten-Modul des IuK-Backends aufrufen.
Tipp: Damit die Karte beim Klick auf „Beenden" im Tray-Menü nicht versehentlich verfügbar bleibt, sollte die Anwendung nach Einsatzende geschlossen werden.
🔌

Kartenleser wählen

Rechtsklick auf das Tray-Icon öffnet das Kontextmenü

Kontextmenü der eGK-Anwendung

Sind mehrere Kartenleser angeschlossen, listet das Untermenü Kartenleser wählen alle erkannten Geräte einzeln auf. Der aktuell aktive Leser ist mit einem Häkchen markiert — jede „Karte auslesen"-Anfrage aus dem Browser greift auf genau dieses Gerät zu.

Menüpunkte

  • → Status-Zeile (oben, ausgegraut): zeigt „Bereit: <Lesername>" oder „Kein Kartenleser gefunden", falls kein Gerät erkannt wurde.
  • → Kartenleser wählen: Untermenü mit allen erkannten Lesegeräten, zum Umschalten anklicken.
  • → Aktualisieren (oberster Eintrag im Untermenü „Kartenleser wählen"): liest die angeschlossenen Kartenleser neu ein — nötig, wenn ein Lesegerät erst nach dem Start der Anwendung per USB angeschlossen wurde.
  • → Debug-Fenster: öffnet das Debug-Dashboard im Standardbrowser.
  • → Beenden: schließt die Anwendung — der Karte-auslesen-Button verschwindet danach aus dem Browser.
Tipp: Wurde ein Kartenleser erst nach dem Start der Anwendung angeschlossen, ist kein Neustart nötig — ein Klick auf Aktualisieren im Untermenü „Kartenleser wählen" liest die Geräte neu ein.
🐞

Debug-Fenster

Erreichbar über: Tray-Menü → Debug-Fenster

eGK Debug-Dashboard

Das Debug-Fenster öffnet sich als normale Webseite im Browser und zeigt den aktuellen Zustand der eGK-Anwendung in Echtzeit — nützlich, wenn der „Karte auslesen"-Button im Patienten-Modul nicht erscheint oder eine Karte nicht gelesen werden kann.

Inhalte der Seite

  • → Status-Karten: ausgewählter Kartenleser, Anzahl aktiver Browser-Verbindungen, Laufzeit der Anwendung.
  • → Live-Log-Tabelle: jede Aktion (Verbindungsaufbau, Karte gelesen, Fehler) mit Zeitstempel, Schweregrad und Details.
  • → Logs leeren: setzt die Log-Tabelle zurück, z. B. vor einem erneuten Testversuch.
  • → Debug-Info kopieren: kopiert die aktuellen Statusdaten in die Zwischenablage — praktisch, um sie für eine Fehlermeldung weiterzugeben.
Hinweis: Die Seite aktualisiert sich automatisch alle 1,5 Sekunden, ein manuelles Neuladen ist nicht nötig.
🏥

Verwendung im Patienten-Modul

Menüpfad: Patienten → Patient hinzufügen / bearbeiten

Karte-auslesen-Button im Patienten-Modul

Ist die eGK-Anwendung auf demselben Rechner aktiv, erscheint im Formular „Patient anlegen/bearbeiten" automatisch der Button e-Health Karte auslesen. Ohne laufende eGK-Anwendung bleibt der Button verborgen — das Formular funktioniert dann ganz normal per Tastatureingabe weiter.

Schritt für Schritt

  1. eGK in den angeschlossenen Kartenleser einlegen.
  2. Formular „Patient anlegen" öffnen (oder ein bestehendes „Bearbeiten" aufrufen).
  3. Auf e-Health Karte auslesen klicken — oder die Taste F4 drücken, solange das Formular geöffnet ist.
  4. Vorname, Nachname, Geburtsdatum und Geschlecht werden automatisch übernommen.
  5. Restliche Felder (Diagnose, UHS, Transport, Bemerkung) wie gewohnt ergänzen und speichern.
Automatisch ausgefülltes Patientenformular
Datenschutzhinweis zu diesem Screenshot: Vorname, Nachname und Geburtsdatum wurden für diese Dokumentation nachträglich unscharf gemacht. Im echten Betrieb erscheinen die ausgelesenen Daten normal lesbar im Formular.
Hinweis: Übernommene Werte können vor dem Speichern jederzeit manuell korrigiert werden — das Auslesen ersetzt keine Sichtprüfung.
🏕️

Verwendung im Shelter-Modul

Menüpfad: Shelter → Person anlegen

Karte-auslesen-Button im Shelter-Modul

Neben dem Patienten-Modul nutzt auch das Shelter-Modul die eGK-Anwendung — als eigene, vollständig unabhängige Integration. Ist die eGK-Anwendung auf demselben Rechner aktiv, erscheint auf der Seite Person anlegen automatisch der Button e-Health Karte auslesen oben auf der Seite. Anders als im Patienten-Modul sitzt der Button hier nicht in einem Dialogfenster, sondern direkt auf der ganzen Seite.

Schritt für Schritt

  1. eGK in den angeschlossenen Kartenleser einlegen.
  2. Seite „Person anlegen" im Shelter-Modul öffnen.
  3. Auf e-Health Karte auslesen klicken.
  4. Vorname, Nachname, Geburtsdatum, Geschlecht und Adresse werden automatisch übernommen.
  5. Restliche Felder (Transport, Betreuungsstelle, Besonderheiten) wie gewohnt ergänzen und speichern.
Automatisch ausgefülltes Formular Person anlegen
Datenschutzhinweis zu diesem Screenshot: Vorname, Nachname, Geburtsdatum und Adresse wurden für diese Dokumentation nachträglich unscharf gemacht. Im echten Betrieb erscheinen die ausgelesenen Daten normal lesbar im Formular.
Hinweis: Der Button ist nur auf der Seite Person anlegen verfügbar. Beim nachträglichen Bearbeiten einer bereits angelegten Person gibt es keine Möglichkeit, die eGK erneut auszulesen — und auch kein Tastatur-Shortcut wie im Patienten-Modul: Die Karte wird ausschließlich per Klick auf den Button ausgelesen.
⚠️

Fehlerbehebung

Häufige Probleme und ihre Ursachen

Button „e-Health Karte auslesen" erscheint nicht

Die eGK-Anwendung läuft nicht auf diesem Rechner, oder die WebSocket-Verbindung zu ws://localhost:9971 konnte nicht aufgebaut werden. Prüfen, ob das Tray-Icon sichtbar ist; ggf. Anwendung neu starten.

Tray-Menü zeigt „Kein Kartenleser gefunden"

Kein Kartenleser war beim Start der Anwendung angeschlossen, oder der PC/SC-Dienst (pcscd) läuft nicht. Kartenleser anschließen, pcscd starten und die eGK-Anwendung neu starten.

Fehlermeldung beim Klick auf „Karte auslesen"

Es liegt keine Karte im gewählten Leser, die Karte ist keine gültige eGK, oder es ist ein Lesefehler aufgetreten. Die genaue Fehlermeldung erscheint als Hinweis im Browser; Details liefert das Debug-Fenster.

Verbindung wird sofort nach dem Öffnen wieder getrennt

eGK-Anwendung und IuK-Backend passen nicht zueinander (z. B. sehr unterschiedliche Versionsstände). Beide Komponenten auf die aktuelle Version aktualisieren. Die Adresse, unter der das IuK-Backend im Browser aufgerufen wird, spielt dabei keine Rolle — die Verbindung zur eGK-Anwendung funktioniert unabhängig davon.