Kartenleser

Es besteht die Möglichkeit, einen Kartenleser zu verwenden, um Personendaten von der elektronischen Gesundheitskarte für Testergebnisse zu erfassen. Auf dem PC, an dem der Kartenleser angeschlossen werden soll, muss hierfür eine zusätzliche Hilfsapplikation laufen.

Lesen Sie bitte VOR der ersten Verwendung! aufmerksam die Hinweise zur Einrichtung durch.

Aktuell unterstützt werden folgende Kartenleser:

• Cherry SmartTerminal ST-2100
• Cherry SmartTerminal ST-1144

Mittels der PC/SC-Schnittstelle ist es möglich, dass weitere Kartenleser angesprochen werden können, welche dann in der Applikation im entsprechenden Auswahlmenü zur Verfügung stehen. Eine solche Konfiguration kann funktionieren, jedoch erfolgt der Betrieb auf eigene Verantwortung. Für Probleme bei dieser Zugriffsart wird keinerlei Support bereitgestellt; lediglich der Zugriff mittels (CT-API) wird offiziell unterstützt.

Von uns getestet wird die schnelltest.click-Kartenleser-Applikation mit einer aktuellen Version von Windows 10. Die Verwendung älterer Versionen bis einschließlich Windows 8.1 sollte möglich sein. Windows 7 wird nicht unterstützt. Bitte bachten Sie auch, dass diese Version von Microsoft ebenfalls nicht mehr unterstützt wird.

Verwendung

Nachfolgend wird die grundlegende Verwendung der schnelltest.click-Kartenleser-Applikation in Verbindung mit laufenden Testsitzungen sowie der Austausch des Zugriffsschlüssels erläutert. Es wird vorausgesetzt, dass die Einrichtung bereits erfolgreich abgeschlossen wurde und die Applikation zwei grüne Indikatoren aufweist. Sollte dies nicht der Fall sein, versuchen Sie bitte zunächst, eine Problembehandlung durchzuführen.

Einlesen von Kartendaten

Sofern die Applikation gestartet wurde und alle Indikatoren grün sind, kann einfach mit dem Einlesen von Karten begonnen werden. Die Applikation selbst muss dabei geöffnet bleiben, kann jedoch minimiert werden. In der Web-Applikation sollte zu einer laufenden Sitzung navigiert werden.

Nun kann eine elektronische Gesundheitskarte in den Leser eingeschoben werden. Kurz nach dem Einschub sollte auf der Seite eine Benachrichtigung über den Empfang der Kartendaten sichtbar werden. Die Karte kann dann entfernt werden.

Nach Klick auf die Benachrichtigung öffnet sich ein Dialog, auf dem die eingelesene Karte verifiziert werden kann und die zu importierenden Daten ausgewählt werden können. Standardmäßig sollte die Vorauswahl bereits gesetzt sein und nur ein Klick auf Speichern ist erforderlich.

Sofern nur ein Datensatz angelegt wurde, öffnet sich automatisch das Fenster zur Bearbeitung dessen.

Wurde dieselbe Karte mehrfach eingelesen (z.B. weil Sie nach Abgriff länger als eine Minute stecken gelassen wurde), so wird dies als Duplikat entsprechend markiert. Duplikate werden für den Import standardmäßig nicht angewählt, müssen jedoch in der Standardkonfiguration manuell gelöscht werden. In den Organisationseinstellungen kann alternativ auch konfiguriert werden, dass diese automatisch beim Import -- sofern nicht ihrerseits ausgewählt -- mit gelöscht werden.

Zu beachten ist, dass die Duplikat-Erkennung nur zum Zeitpunkt des Imports abläuft auf Basis der Kartennummer, welche nur temporär beim Einlesen gespeichert wird. Dieselbe Karte kann also mehrfach eingelesen werden, wenn die Importe einzeln erfolgen.

Es ist ebenfalls möglich, mehrere unterschiedliche Karten hintereinander einzulesen und gemeinsam zu importieren. Alle Nicht-Duplikate sind dabei automatisch vorausgewählt. Bitte beachten Sie, dass beim Import von mehr als einem Datensatz das Bearbeitungsfenster nicht automatisch geöffnet wird; die normale Editieren-Funktion aus der Liste heraus funktioniert jedoch wie gewohnt.

Auswahl einer Sitzung

Standardmäßig erfolgt der Export der Kartendaten aus der Applikation heraus in alle laufenden Testsitzungen. Manchmal kann ist es jedoch sinnvoller, gezielt eine Ziel-Sitzung auszuwählen, etwa beim Parallelbetrieb mehrerer Teststrecken in derselben Einrichtung mit getrennten Sitzungen und Anmelde-Arbeitsplätzen.

Auch dieser Anwendungsfall wird von der schnelltest.click-Kartenleser-Applikation unterstützt. Es ist möglich unter Sitzung gezielt eine Testsitzung, statt dem Standardwert (alle Aktiven) auszuwählen.

Der Name setzt sich dabei aus dem Datum und der zusätzlichen Bezeichnung, sowie der Testeinrichtung in Klammern zusammen. Wird keine zuätzliche Bezeichnung verwendet, wird stattdessen nur Datum und Einrichtung ausgewiesen.

Bitte beachten Sie, dass die Sitzungsliste nicht automatisch aktualisiert wird. Somit stehen nur die Sitzungen zur Auswahl, welche bei der letzten Aktualisierung (geschieht automatisch bei Start der Applikation) vorhanden und gestartet waren. Mit einem Klick auf Aktualisieren kann dies manuell erfolgen.

Austausch des Schlüssels

Soll ein neuer Zugangsschlüssel für den Kartenleser verwendet werden, beispielsweise bei Wechsel der Testorganisation oder wegen Austausch aus Sicherheitsgründen, so muss dieser zunächst gemäß Anleitung abgerufen werden. Mit dem entsprechenden Button ist dieser dann in die Zwischenablage zu kopieren.

Anschließend muss dieser mittels des Einfügen-Buttons in der schnelltest.click-Kartenleser-Applikation eingefügt werden. Die Nutzung des Buttons ist dabei zwingend erforderlich, um die Neuverbindung anzustoßen; ein Einfügen mittels Tastenkombination reicht nicht aus.

Die Applikation verbindet sich neu, was bis zu 30s in Anspruch nehmen kann. Im Anschluss sollte die Arbeit wie gewohnt fortgesetzt werden können.

Betrieb mit Terminal-Server bzw. Remote-Desktop-Diensten

Teschnisch ist die Verwendung des Kartenlesers durch Cherry auch innerhalb einer Remote-Desktop-Sitzung möglich, sofern der Kartenleser am Endgerät eingerichtet ist und die Treiber zusätzlich auf dem Sitzungs-Host/Terminalserver ebenfalls installiert sind. Jedoch zeigte sich bei internen Tests, dass selbst vorher problemlos funktionierende Konfigurationen sporadisch und ohne ersichtlichen Grund den Dienst verweigerten und keine weiteren Kartendaten übertragen werden konnten. Der Betrieb ist somit auf eigene Verantwortung möglich, wir jedoch bieten keinerlei technische Unterstützung dieser Konfiguration.

Wir empfehlen stattessen, unabhängig von der Art des Zugriffs auf die Webapplikation, die schnelltest.click-Kartenleser-Applikation stets auf einem physischen Endgerät einzurichten und zu betreiben. Generell ist für die korrekte Übertragung von Kartendaten unerheblich, ob die Bedienung der schnelltest.click-Webwanwendung auf demselben Gerät erfolgt, auf dem die Kartenleser-Hilfsapplikation betrieben wird, oder nicht. Ebenso ist es nicht erfodderlich, dass die schntelltest.click-Kartenleser-Applikation nach dem Start sichtbar gehalten wird oder den Fokus behält, sodass es unproblematisch ist, wenn im Vollbildmodus vordergründig auf einer Remote-Desktop-Sitzung gearbeitet wird.

Einrichtung

Hinweis: Uns liegen Informationen vor, dass das Verbinden des Kartenlesers mit dem USB-Port vor der Treiberinstallation zu Problemen führen kann.

Hinweis: Windows 7 wird von der schnelltest.click-Kartenleser-Applikation nicht mehr unterstützt. Die Applikation kann starten, jedoch keine sichere Verbindung zur Webapplikation aufbauen. Bitte bachten Sie auch, dass diese Version von Microsoft ebenfalls nicht mehr unterstützt wird.

Schließen Sie den Kartenleser daher erst an, wenn die Installationsanleitung dazu auffordert!

1. Herunterladen der benötigten Dateien: Navigieren Sie zum Menüpunkt Schlüssel und laden Sie die Treiber- und Kartenleser-Tool-Installationsdateien herunter.

   2. Installieren Sie zunächst den Treiber. Im Installationsassistenen können Sie dabei die Standardwerte ohne Veränderung übernehmen. 3. Verbinden Sie jetzt den Kartenleser mit einem freien USB-Port des Rechners. 4. Verifizieren Sie mit dem im Zuge der Treiberinstallation ebenfalls installierten Programm Read eGK die Funktion des Kartenlesers. Wählen Sie dabei Terminalserver-Betrieb aus und stellen als Port-Nummer 1 ein.

   

   Mit einem Klick auf Einstellungen testen und nach Einstecken einer Karte sollten deren Daten fehlerfrei gelesen werden können.

   5. Installieren Sie die schnelltest.click-Kartenleser-Applikation. Abermals können Sie im Installationsassistenten alle Werte auf ihrer Voreinstellung belassen.

   

   6. Starten Sie die schnelltest.click-Kartenleser-Applikation. 7. Nach dem ersten Start sollte die Kartenleser-Applikation wie folgt aussehen, mit leerem Key-Feld. Beachten Sie, dass die Applikation sich nach kurzer Zeit versuchen wird, automatisch zu verbinden. Wenn der Internet-Indikator entsprechend rot wird, ist dies kein Fehler.

   8. Rufen Sie den Zugriffsschlüssel in der Webapplikation gemäß der Anleitung zum entsprechenden Menüpunkt ab. 9. Fügen Sie den Schlüssel aus der Zwischenablage mit dem Einfügen-Button ein. Die Applikation sollte sich nun Verbinden. Beachten Sie, dass dieser Prozess bis zu 30s in Anspruch nehmen kann, in der der Status noch als gelb oder rot angezeigt wird.

   

Der Kartenleser ist nun einsatzbereit. Zur weiteren Verwendung, sehen Sie den Abschnitt Verwendung ein. Sollten die beiden Status-Indikatoren nicht binnen einer Minute grün werden, gehen Sie nach der entsprechenden Problembehandlung vor.

Auswahl eines anderen Kartenlesers

Bitte beachten Sie, dass für andere Kartenleser-Konfigurationen, als (CT-API), KEINERLEI Unterstützung oder Support seitens schnelltest.click geleistet wird. Es ist möglich, dass weitere Kartenleser so funktionieren, jegliche Garantie wird jedoch abgewiesen; der Betrieb erfolgt auf eigene Verantwortung.

Wählen Sie in der Auswahlbox Leser den zu ihrem Gerät passenden Eintrag aus. Das Programm sollte die am System angeschlossenen Leser fortwährend überwachen sich beim Anschließen oder Trennen von Geräten von selbst aktualisieren. Sie können jedoch auch manuell eine Listenaktualisierung mit dem rechts nebenstehenden Button erzwingen.

Es wird nun versucht, mit dem Gerät zu kommunizieren und im Erfolgsfall sollte die Status-Meldung den Verbundenen Gerätenamen widerspiegeln. Wurde nun ein Kartenleser ausgewählt und war die Verbindung mit diesem mindestens einmal erfolgreich, bleibt dieses Gerät als Standard hinterlegt und die Applikation bevorzugt dieses nun. Wird das Gerät jedoch im laufenden Betrieb getrennt oder ist beispielsweise bei einem weiteren Start der Applikation nicht angeschlossen, so erfolgt ein automatischer Rückfall auf (CT-API). Wenn der bevorzugte Leser wieder verbunden wird, wird die schnelltest.click-Kartenleser-Applikation automatisch versuchen, sich stattdessen wieder mit diesem zu verbinden; eine entsprechende Status-Meldung sollte darauf hinweisen.

Funktioniert Kommunikation mit einem Kartenleser nicht wie gewünscht, besteht unter dem Menüpunkt Test im Menü Leser die Möglichkeit, einen Testdialog aufzurufen, welcher unter Umständen mehr Informationen liefern kann. Bei Selektion eines Kartenlesers in der oberen Liste werden unten den Kommunikationsprozess umschreibende Statusmeldungen sichtbar. Unsachgemäße Benutzung des Dialoges kann u.U. die Konfiguration von Kartenlesern beeinträchtigen und sollte daher nur von qualifiziertem Personal durchgeführt werden. Es wird keinerlei Gewährleistung übernommen oder Unterstützung für diesen Dialog geleistet.

Problembehandlung

An dieser Stelle werden uns bekannte Fehlersituationen behandelt und mögliche Lösungsansätze dargelegt. Diese Sektion wird beim Bekanntwerden neuer Probleme und Lösungen stets aktualisiert und erweitert, bitte rufen Sie daher beim Auftreten von Fehlern immer die aktuelle Version der Hilfe auf.

Aktualisiert: 27.03.2021 11:45 Uhr

Keine Verbindung

Stand: 15.03.2021 12:00 Uhr

Symptom: Die Kartenleser-Applikation verbindet sich beim Start nicht oder die Verbindung ging trotz erfolgreichem Start im laufenden Betrieb verloren, mindestens eine der Status-Indikationen ist gelb oder rot.

Ursache: Das Problem kann durch unterschiedliche Umstände verursacht werden, unter anderem instabiler Internet-Verbindung, neu erzeugtem Zugriffsschlüssel oder Fehler bei der Kommunikation mit dem Kartenleser. Auch ein Fehler bei der Kartenleserkommunikation führt zu einer vollständigen Neuverbindung, weshalb sich dies als ebenfalls als gelbe Statusanzeige bei Internet äußern kann.

Behebung:

1. Stellen Sie sicher, dass Ihr System die Mindestsystemanforderungen erfüllt.
2. Warten Sie bis zu einer Minute. Im Fehlerfall versucht die Applikation automatisch die Neuverbindung zur Web-Applikation und zum Kartenleser, sodass kurzzeitige Unterbrechungen sich unter Umständen von selbst behebn. Beachten Sie, dass auch nach Eintragen eines neuen Schlüssels bis zu 30s notwendig sind, ehe die Verbindung wiederhergestellt ist.

3. Verifizieren Sie ihre Internetverbindung. Rufen Sie hierzu eine beliebige Web-Adresse, etwa https://schnelltest.click/ im Browser auf. Schlägt dies fehl oder wird die Seite nur teilweise geladen, ist ihre Internetverbindung eingeschränkt.

   Für die korrekte Funktion der Kartenleser-Applikation ist eine stabile Internetverbindung zwingend erforderlich. Wenden Sie sich an ihren Internet-Anbieter bzw. die die Verbindung bereitstellende Institution (etwa, wenn Ihnen der Internetzugang von der Gesundheitsbehörde eingerichtet wurde). 4. Verifizieren Sie die korrekte Anbindung des Kartenlesers.

   Schließen Sie hierfür zunächst die schnelltest.click-Kartenleser-Applikation. Prüfen Sie dann die Erreichbarkeit des Kartenlesers gemäß Punkt 4 der Installationsanleitung.

   Schlägt der Test mit Read eGK fehl, trennen Sie den Kartenleser vom USB-Port und verbinden Sie diesen erneut. Sollte der Fehler weiter bestehen, starten Sie Ihren Rechner neu und wiederholen Sie den Prüfschritt.

   Wenn der Fehler noch immer besteht, existieren womöglich Probleme mit dem Treiber. Befolgen Sie dann bitte die Anweisungen zu Problemen mit dem Kartenleser-Treiber zur vollständigen Entfernung. 5. Starten Sie die Kartenleser-Applikation neu. 6. Pflegen Sie den Zugriffsschlüssel neu ein. Gehen Sie hierfür gemäß des entsprechende Abschnitts in der Verwendung ein. 7. Falls die Verbindung noch immer fehlschlägt, wenden Sie sich an den technischen Support.

Probleme mit dem Kartenleser-Treiber

Stand: 27.03.2021 11:45 Uhr

Symptom: Die Kartenleser-Applikation kann sich nicht verbinden oder schließt sich ohne Fehlermeldung direkt nach dem Start wieder, wobei der Zugriff mittels Read EGK ebenfalls nicht funktioniert. Sofern sie sich direkt schließt, mittels Read EGK jedoch der Zugriff möglich ist, überprüfen Sie bitte das Vorliegen einer leeren Benutzerkonfiguration.

Ursache: Bekannt ist dieses Problem, wenn der Kartenleser mit dem Rechner verbunden wurde, bevor die Installation des Treibers erfolgt ist. Jedoch ist es nicht auszuschließen, dass auch nach korrekter Installation und vorigem Funktionieren durch Veränderungen der Systemkonfiguration ebendieser Fehler auch später unerwartet auftritt.

Behebung:

1. Versuchen Sie zunächst, ob ein Neuverbinden des Kartenlesers das Problem löst: Klicken Sie hierzu im Menü Leser auf Neuverbinden. Kontrollieren Sie, ob der Leser nun korrekt verbunden ist (rechte Ampel grün) und wieder wie erwartet funktioniert durch Einführen einer Karte. Falls dies nicht der Fall ist, fahren Sie mit der Problembehandlung fort.
2. Verifizieren Sie nun die Natur des Fehlers, indem Sie die schnelltest.click-Kartenleser-Applikation, sofern noch offen, schließen und dann Read eGK gemäß Punkt 4 der Installationsanleitung verwenden. Schließt sich der nach Klick auf Einstellungen testen geöffnete Dialog nach kurzer Zeit ohne Fehlermeldung von selbst, liegt der hier beschriebene Fehler vor. Funktioniert der Zugriff mittels Read eGK dagegen wie erwartet, befolgen Sie zunächst die Anweisungen zu Keine Verbindung, sofern die schnelltest.click-Kartenleser-Applikation mit sichtbarem Fenster startet oder zur leeren Benutzerkonfiguration, wenn diese sich direkt wieder schließt.

3. Verifizieren Sie, dass als Kartenleser (CT-API) eingestellt ist.

   

4. Starten Sie den Rechner neu. Versuchen Sie anschließend die schnelltest.click-Kartenleser-Applikation regulär zu betreiben; falls dies nicht erfolgreich ist, fahren Sie hier fort.

5. Installieren Sie den Treiber vollständig neu.

   1. Trennen Sie den Kartenleser vom PC und schließen ihn erneut an.

   2. Navigieren Sie zum Geräte-Manager von Windows (z.B indem Sie im Startmenü nach Gerät suchen).

      

   3. Identifizieren Sie den Kartenleser in der Kategorie Smartcard-Lesegeräte. Hier gibt es zwei Möglichkeiten: Entweder wird dieser korrekt als SmartTerminal ST-2xxx identifiziert und gemeldet, dann fahren Sie bitte mit 4. fort. Bei fehlendem Treiber wird dieser jedoch zum Teil auch als Microsoft Usbccid-Smartcard-Leser (WUDF) gemeldet; manchmal ist auch mehr als ein solches Gerät vorhanden.

      

      Identifizieren bzw. Verifizieren Sie bitte in diesem Fall durch Rechtsklick, Eigenschaften unter Details die Vom Bus gemeldete Gerätebeschreibung das korrekte Gerät SmartTerminal ST-2xxx.

      

   4. Wählen Sie auf dem entsprechend identifizierten Gerät nach Rechtsklick Treiber deinstallieren

      

      

   5. Sofern die Auswahl-Box Treibersoftware für dieses Gerät löschen sichtbar ist, aktiveren Sie diese. Bestätigen Sie anschließend durch Klick auf Deinstallieren.

      

   6. Trennen Sie den Kartenleser vom PC.

   7. Starten Sie den Rechner neu.
   8. Führen Sie die Installationsschritte 1.-4. in der angegebenen Reihenfolge aus.

Sitzung steht nicht zur Auswahl

Stand: 15.03.2021 12:00 Uhr

Symptom: Es sollen Kartendaten an eine spezifische Testsitzung, welche in der Web-Applikation korrekt angezeigt werden kann, gesendet werden, welche jedoch in der Sitzungs-Liste nicht auftaucht.

Ursache: Die wahrscheinlichste Ursache ist, dass die Sitzungs-Liste nicht aktualisiert wurde (muss manuell geschehen) oder die Sitzung nicht gestartet wurde, weshalb sie nicht als Kartenleserziel gilt.

Behebung:

1. Verifizieren Sie in der Web-Applikation, dass die Sitzung wirklich gestartet ist (eine entsprechende Meldung sollte in der Erfassungsliste angezeigt werden).

2. Aktualisieren Sie die Sitzungen. Prüfen Sie anschließend, ob die gewünschte Sitzung nun zur Auswahl steht.

   

Installation meldet "weitere Version ist bereits installiert"

Stand: 15.03.2021 12:00 Uhr

Symptom: Die Installation liefert beim Start eine Fehlermeldung, das Produkt sei bereits installiert.

Text-Inhalt für Suchfunktion: Eine weitere Version dieses Produkts ist bereits installiert. Die Installation dieser Version kann nicht fortgesetzt werden. Verwenden Sie die Systemsteuerungsoption "Programme und Funktionen, um die installierte Version dieses Produktes zu konfigurieren oder so entfernen.

Ursache: Eine ältere Version des Kartenleser-Tools ist noch installiert oder eine vorige Installation lief unvollständig durch.

Behebung:

1. Quittieren Sie die Meldung und brechen Sie die Installation ab.

2. Entfernen Sie die installierte Version.

   

3. Versuchen Sie die Installation erneut. Sofern der Fehler noch immer auftritt, fahren Sie mit 4. fort.

4. Starten Sie den Rechner neu und versuchen Sie die Installation abermals.
5. Sollte es noch immer Probleme geben, wenden Sie sich an den Support.

Leere Benutzerkonfiguration

Stand: 27.03.2021 11:45 Uhr

Symptom: Die Kartenleser-Applikation schließt sich ohne Fehlermeldung direkt nach dem Start wieder, wobei der Zugriff mittels Read EGK fehlerfrei funktioniert. Sofern der Zugriff mittels Read EGK ebenfalls nicht möglich ist, überprüfen Sie bitte das Vorliegen von Treiberproblemen.

Ursache: Eine vollkommen leere Benutzerkonfiguration kann nicht eingelesen werden, da sie nicht dem XML-Standard entspricht und verursacht somit einen Absturz der Applikation. Eine unterliegende Ursache ist bisweilen nicht bekannt, da die Applikation selbst nie eine solche Datei erzeugen sollte.

Behebung:

1. Verifizieren Sie zunächst die Natur des Fehlers, indem SieRead eGK gemäß Punkt 4 der Installationsanleitung verwenden. Funktioniert der Abruf der Kartendaten, so liegt möglicherweise das hier beschriebene Problem vor. Schlägt der Zugriff mittels Read eGK dagegen fehl, befolgen Sie zunächst die Anweisungen zu Problemen mit dem Kartenleser-Treiber.
2. Navigieren Sie in den Ordner AppData\Local, indem Sie mittels Win + R zunächst den Ausführen-Dialog öffnen. Geben Sie in diesen %LOCALAPPDATA% als Ausführungsziel ein und bestätigen Sie die Eingabe. Alternativ können Sie von ihrem Benutzerprofil (standardmäßig C:\Users\<IhrName> oder C:\Benutzer\<IhrName>) in den Ordner AppData und in dessen Unterordner Local navigieren, wobei diese in der Standardkonfiguration von Windows ggf. versteckt sind.
3. Navigieren Sie in den Unterordner Simba_n³_GmbH. In diesem sollte sich ein Ordner STT-Card-Tool.exe_Url_... befinden, wobei dem Namen noch ein versionsabhängiger zufälliger Identifikator anhängt. Sollten hier wider Erwarten mehrere Ordner vorliegen, sortieren Sie bitte nach Änderungsdatum und wählen den zuletzt modifizierten.
4. In diesem Ordner befindet sich wiederum ein Unterordner 1.0.0.0, welcher eine Datei user.config beinhaltet. Benennen Sie diese Datei in user.config.bak um; falls Sie diese Anleitung schon einmal befolgt haben, löschen Sie ggf. vorher gleichnamige Dateien.
5. Starten Sie die schnelltest.click-Kartenleser-Applikation, welche sich nun wieder öffnen lassen sollte. Der hier beschriebene Problemlösungsansatz sorgt für ein komplettes Zurücksetzen aller getroffenen Einstellungen, d.h. Sie müssen die Einrichtung des Schlüssels wiederholen.