App EVIS ID Plus für Google Android NFC- Smartphone

Transkript

1 App EVIS ID Plus für Google Android NFC- Smartphone Version 1.0 Beschreibung Juli 2015

2 2015 EVIS AG, CH-8604 Volketswil Änderungen vorbehalten Bei der Erarbeitung dieser Dokumentation wurde mit grösster Sorgfalt vorgegangen. Trotzdem können Fehler nicht vollständig ausgeschlossen werden. Die Firma EVIS AG kann für fehlerhafte Angaben und deren Folgen weder die Verantwortung noch irgendeine Haftung übernehmen. Sollte in dieser Dokumentation auf andere Dokumentationen, Vorschriften oder Richtlinien Bezug genommen oder aus ihnen zitiert worden sein, kann die Firma EVIS AG keine Gewähr für Richtigkeit, Vollständigkeit oder Aktualität übernehmen. Alle Rechte vorbehalten. Kein Teil dieser Dokumentation darf in irgendeiner Form (Druck, Fotokopie oder einem anderen Verfahren) ohne schriftliche Genehmigung der EVIS AG reproduziert an Dritte weitergegeben oder unter Verwendung elektronischer Systeme verarbeitet, vervielfältigt oder verbreitet werden. Für Verbesserungsvorschläge und Hinweise auf Fehler ist der Herausgeber (EVIS AG) dankbar. EVIS AG, 8604 Volketswil jg, /10

3 Versionsübersicht Version Erstellt, Wer Gilt ab FW Änderung gegenüber letzter Version 1.0 Feb 2015, jg 20031B F01 Erste Version mit folgenden Funktionen EVIS ID: Allgemeine Leserdaten EVIS View: Statistik, Transaktionen auslesen, speichern und anzeigen EVIS Audit: Statistik, Transaktionen löschen EVIS Param: Parameter auslesen, speichern, anzeigen und Parameter setzen Inhaltsverzeichnis 1 Allgemein Funktionen Autorisierung Autorisierkarte Statistik Transaktionen Parameter lesen Parameter setzen EVIS AG, 8604 Volketswil jg, /10

4 1 Allgemein Software Bezeichnung: App EVIS ID Plus Software Nummer: 5035 Die App EVIS ID Plus ist eine Erweiterung der App EVIS ID. Konsultieren Sie daher für die Installation und die grundlegende Bedienung die Dokumentation der App EVIS ID. Folgende Kapitel sind in der Dokumentation der App EVIS ID beschrieben und gelten auch für die App EVIS ID Plus. Voraussetzung Installation Handhabung Smartphone und NFC Bedienung Ansicht Leserdaten Praxis Nebst den allgemeinen EVIS Leserinformationen können in der App EVIS ID Plus zusätzliche Funktionen ausgeführt werden. Siehe dazu die Beschreibung der Funktionen im allgemeinen Kapitel 2 "Funktionen". Beziehungsweise die Beschreibung der einzelnen Funktionen selbst: Statistik anzeigen, löschen Kapitel 4 "Statistik" Transaktionen auslesen, zurücksetzen Kapitel 5 "Transaktionen" Parameter auslesen Kapitel 6 "Parameter lesen" Parameter setzen Kapitel 7 "Parameter setzen" Je nach Firmware werden nicht alle Funktionen unterstützt, siehe untenstehende Tabelle. Firmware ab Version Statistik lesen / löschen Transaktionen lesen / löschen Parameter lesen / setzten Verkauf 20031B01 Ja Ja Ja 3rdparty Nein Nein Ja ZeitZutritt 20050F01 Nein Nein Ja Das Ausführen der Funktionen erfordert eine entsprechende Autorisierung siehe Kapitel 3 "Autorisierung". Alle zusätzlichen Funktionen werden mittels verschlüsselter Kommunikation sicher übertragen. Die App EVIS ID Plus wird in diesem Dokument kurz als App bezeichnet. EVIS AG, 8604 Volketswil jg, /10

5 2 Funktionen Die Funktion Leserdaten, zum Auslesen der allgemeinen EVIS Leserinformationen, ist normalerweise frei verfügbar, alle anderen Funktionen sind durch die Autorisierung geschützt. Das heisst die Funktionen können nur ausgeführt werden, wenn eine entsprechende Autorisierung vorliegt. Nach der Synchronisierung erscheinen alle verfügbaren Funktionen (Button). Es werden nur die Funktionen angezeigt, für welche auch eine Autorisierung vorhanden ist. Die Funktionen können mit den entsprechenden Buttons ausgeführt werden. Die allgemeinen Leserinformationen (Button "Leserinfo") kann normalerweise immer angezeigt werden. Genauere Informationen über die allgemeinen Leserinformationen siehe Dokumentation der App EVIS ID. Hinweis Funktionen: Ob eine Funktion ausgeführt werden kann oder nicht entscheidet schlussendlich der Leser. Es kann sein, dass der Button vorhanden ist, aber die Funktion nicht ausgeführt werden kann, weil die Autorisierung fehlt oder abgelaufen ist. Oder der Button ist inaktiv weil vorweg klar ist, dass die Autorisierung dazu fehlt. Hauptansicht nicht synchronisiert Hauptansicht mit nur der Funktion Hauptansicht mit allen Funktionen allgemeinen Leserinformationen bzw voller Autorisierung EVIS AG, 8604 Volketswil jg, /10

6 3 Autorisierung Um zu verhindern, dass unberechtigte Zugriffe auf den Leser via NFC stattfinden, muss eine Autorisierung gemacht werden. In diesem Kapitel wird beschrieben wie der Leser für die Funktionen Autorisiert werden kann. Im Moment ist dies nur durch die Autorisierkarte möglich, kostenpflichtig bei der EVIS AG anzufordern. 3.1 Autorisierkarte Die Autorisierkarte berechtigt den EVIS Leser für NFC Funktionen. Die Autorisierkarte wird an den EVIS Leser hingehalten. Eine gültige Autorisierungskarte wird vom Leser mit einem kurzen Piepston und der grünen LED quittiert. Bei einer gültigen Autorisierkarte wird der Leser für eine gewisse Zeit (5 Minuten) für NFC Funktionen freigeschaltet. Ist die Zeit abgelaufen kann die Autorisierungskarte wieder hingehalten werden. Dieser Vorgang kann beliebig wiederholt werden. Die Merkmale einer Autorisierkarte sind: Version, Level, Smartphone ID, und Funktion. Version Mit der Versionsnummer können ältere Autorisierkarten ungültig gemacht werden. Beispiel: Die Versionsnummer ist eins (Defaultwert). Geht die Karte verloren kann eine neue Karte mit Versionsnummer zwei erstellt werden. Wird die neue Karte an den EVIS Leser hingehalten, so funktioniert die alte Karte bei diesem Leser ab sofort nicht mehr. Level Der Level definiert für welche EVIS Leser die Autorisierkarten gilt. Es gibt die Level Disti, Firma und Gerät. Beim Level Disti gilt die Karte für alle Leser eines Distributors. Beim Level Firma gilt die Karte für alle Leser des Distributors mit entsprechender Firmennummer und beim Level Gerät gilt die Karte nur für einen bestimmten Leser mit entsprechender Gerätenummer. Smartphone ID Wird eine Smartphone ID definiert, so funktioniert nur das Smartphone mit dieser ID am EVIS Leser. Funktionsgruppen Über die Funktionsgruppe wird definiert welche Funktion(en) am EVIS Leser zugelassen sind. Dabei kann eine Autorisierkarten eine, mehrere oder alle Funktionsgruppen beinhalten. Untenstehende Tabelle zeigt die aktuell möglichen Funktionsgruppen. Gruppe EVIS ID EVIS View EVIS Audit EVIS Parameter Funktion Auslesen von allgemeinen Leserdaten Statistik, Transaktionen lesen ohne löschen Statistik, Transaktionen lesen und löschen Parameter auslesen und setzen EVIS AG, 8604 Volketswil jg, /10

7 4 Statistik Die Statistikdaten werden als Rohdaten (Binärdatei) auf dem Smartphone gespeichert und in der Ansicht "Statistik Lesen" angezeigt. Über die Funktion Statistik löschen (Button) kann die periodische Statistik gelöscht werden. Statistikdatei: Speicherort: GGGGGGGG_YYYYMMDD_HHMMSS.evistat GGGGGGGG = Leser Hardware-Nummer (8-Stellig rechtsbündig mit Vorlaufnull) YYYYMMDD = Datum in Jahr, Monat und Tag HHMMSS = Zeit in Stunden, Minuten und Sekunden...\Download\EVIS\STATISTIK\ Hinweis Teilen: Die Ansicht kann als Textdatei (Statistikdaten.txt) mit der Statistikdatei geteilt werden. Hinweis Leser: Die Statistik-Löschfunktion muss im EVIS Leser eingeschaltet sein. Ansicht Statistik Lesen EVIS AG, 8604 Volketswil jg, /10

8 5 Transaktionen Die Transaktionen werden als Rohdaten (Binärdatei) auf dem Smartphone gespeichert und in der Ansicht "Transaktionen Lesen" angezeigt. Falls neue Transaktionen erfolgreich gespeichert wurden, so kann der Empfang mittels Funktion Transaktionen Löschen (Button Bestätigen) quittiert werden. Transaktionsdatei: GGGGGGGG_YYYYMMDD_HHMMSS.eviact (Auslesung neue Transaktionen) GGGGGGGG = Leser Hardware-Nummer (8-Stellig rechtsbündig mit Vorlaufnull) YYYYMMDD = Datum in Jahr, Monat und Tag HHMMSS = Zeit in Stunden, Minuten und Sekunden Es wird jeweils immer der Header, gefolgt von allfälligen Transaktionen, gespeichert. Speicherort: Hinweis Teilen: Hinweis Leser:...\Download\EVIS\TRANSAKTIONEN\ Die Ansicht kann als Textdatei (Transaktionsdaten.txt) mit der Transaktionsdatei geteilt werden. Der Transaktionsspeicher muss im Leser eingeschaltet sein. Art der Auslesung Es gibt drei Arten der Auslesung von Transaktionen: - Neue (act) noch nicht abgeholte Transaktionen - Nochmals neue (prev) Wiederholung der letzten Auslesung Neue - Alle (all) Alle gespeicherten Transaktionen unabhängig der letzten Auslesungen. Normalerweise werden die neuen Transaktionen ausgelesen und auf dem Smartphone mit der Dateiendung.eviact gespeichert. Im Notfall können die neuen Transaktionen nochmals ausgelesen werden. Es wird in diesem Fall eine Datei mit der Endung.eviprev erzeugt. Im schlimmsten Fall kann auch der gesamte Transaktionsspeicher des Lesers ausgelesen werden mit der Dateiendung.eviall. Da jede Transaktion eine eigene Nummer erhält (fortlaufender Zähler) kann schlussendlich festgestellt werden, welche Transaktionen mehrmals ausgelesen wurden oder sogar fehlen. Ansicht Transaktionen Lesen Kopfdaten Ansicht Transaktionen Lesen Transaktionen EVIS AG, 8604 Volketswil jg, /10

9 6 Parameter lesen Mit dieser Funktion kann die Leser-Parameterierung ausgelesen werden. Im Gegensatz zum EVIS PC Tool WinService werden hier nur die abweichenden Parameter ausgelesen (geringe Auslesezeit). Die Auslesung wird im Smartphone als Parameterdatei gespeichert und in der Ansicht "Parameter Lesen" angezeigt. Parameterdatei: GGGGGGGG_YYYYMMDD_HHMMSS.eviparam GGGGGGGG = Leser Hardware-Nummer (8-Stellig rechtsbündig mit Vorlaufnull) YYYYMMDD = Datum in Jahr, Monat und Tag HHMMSS = Zeit in Stunden, Minuten und Sekunden Hinweis Parameterdatei: Die Parameterdatei ist verschlüsselt und dient zur allfälligen Leser Umkonfigurierung durch EVIS AG. Speicherort: Hinweis Teilen: Hinweis Parameter:...\Download\EVIS\PARAMETER\ Die Ansicht kann als Textdatei (Parameter.txt) mit der Parameterdatei geteilt werden. Die Bezeichnung der Parameter ist in der App hinterlegt. Falls ein neuer Parameter ausgelesen wurde, welcher nicht definiert ist erscheint als Bezeichnung "?" und der Wert wird in hexadezimal angezeigt. Ein aktuelles Parameterfile kann auch von der APP extern eingelesen werden. Das Parameterfile "WinParameter.txt" muss im Smartphone Verzeichnis...\Download\EVIS\EINSTELLUNGEN befinden. Parameter und Systemparameter Alle Parameter die vom Defaultwert abweichen werden unter dem Reiter Parameter aufgelistet. Alle Parameter die keinen Defaultwert besitzen (Hardware abhängige Parameter und Grundeinstellungen) werden im Reiter Systemparameter aufgelistet. Ansicht Parameter Lesen Ansicht Parameter Lesen Ansicht Parameter Lesen Allgemein Parameter System EVIS AG, 8604 Volketswil jg, /10

10 7 Parameter setzen Mit dieser Funktion kann der EVIS Leser parametrisiert werden. Die gewünschte Parameterdatei kann über den Dateiauswahl-Dialog gewählt werden. In der Ansicht "Parameter Setzen" werden die auszuführenden Funktionen angezeigt und falls vorhanden die zu setzenden Parameter aufgelistet. Hinweis Parameterdatei: Die Parameterdatei ist verschlüsselt und kann nur von EVIS AG erstellt werden. Ausgelesene Leserkonfigurationen können nicht zum Konfigurieren von Leser verwendet werden. Hinweis Parameterdatei verknüpft mit App: Die App kann auch direkt über die Parameterdatei gestartet werden. In diesem Fall wird die Parameterdatei direkt von der App eingelesen ohne den Dateiauswahl-Dialog. Über den Anhang oder in einem Datei-Explorer die Parameterdatei wählen und via App-Auswahl die App EVIS ID Plus wählen. Ob die App zur Auswahl steht kann nicht gewährleistet werden. Ansicht Parameter Setzen Ansicht Parameter Setzen Ansicht Parameter Setzen Dateiauswahl-Dialog Funktion Parameter EVIS AG, 8604 Volketswil jg, /10