Installation KES-ZE-Terminal

Mit dem Kieselstein ERP Zeiterfassungsterminal steht ein praktisches Erfassungsgerät zur Verfügung um mit verschiedenen Lesern die Anwesenheitszeiten und auch die Zeiten auf Losen, Aufträgen, Projekten für Menschen und Maschinen in deren vielfältiger Form zu erfassen.

Wichtig: Auf deinem Kieselstein ERP Server muss auch die RestAPI laufen, was ab Version 0.0.0.8 in der Regel gegeben ist und natürlich muss dein Server über den Port 8080 (https ist in Vorbereitung) erreichbar sein.

Betriebssysteme

Derzeit steht die KES-ZE-App für Windows, Android und Linux zur Verfügung.

Bitte beachte, dass du für die Installation auf Windows- bzw. Linuxrechnern administrative Rechte benötigst. Es werden aktuell nur Windwos-Home und Windwos-Pro (jeweils Win10/11) unterstützt. Ev. andere Versionen, vor allem diejenigen die den Entwicklungsmodus nicht unterstützen, können nicht verwendet werden.

Programmversion

Programmtechnisch sind das Zeiterfassungsterminal und die mobile App identisch. Es wird automatisch anhand des Gerätes, auf welchem das Programm ausgeführt wird, entschieden welche Anwendung nun ausgeführt wird.

Installation

Herunterladen der neuesten Version von https://gitlab.com/kieselstein-erp/sources/kieselstein-terminal-maui/-/releases

Hier je nach Betriebssystem das passende Package auswählen.
Die Ergänzungen für Linux siehe.
Anmerkung: Die weitere Beschreibung geht von Windows aus.

Klick auf Download, die heruntergeladene Datei und

• die neueste Version kopieren und z.B. nach ?\install kopieren.
• den Zielordner notieren.
• Starttaste (Windowstaste) und Eingabe von Power
  Windows Powershell aufrufen und als Administrator ausführen.

In das notierte Zielverzeichnis wechseln.

Install.ps1 starten.

Sollte nun nachstehende Fehlermeldung kommen

so sind die Ausführungsrechte für Powershell Scripts nicht gesetzt.

Kommt die Fehlermeldung ist nicht signiert so siehe.

Um diese zu setzen, im PowerShell

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

eingeben und die Frage nach
mit A (Ja für alle) und anschließendem Enter beantworten.

(Tipp einfach den Text kopieren und mit Strg+V in Powershell einfügen.)

Wichtig: Insbesondere das ändern der Policy erfordert Administrator Rechte. Kommt nach dem Ausführen obigen Befehls wieder die gleiche Abfrage, hast du zuwenig Rechte.

WICHTIG:
Nun Powershell beenden und in normalen Modus starten. Dies ist insbesondere für das Update zukünftiger Versionen wichtig. Siehe aber auch Berechtigungsfehler

Danach die Installation erneut mit .\Install.ps1 starten.

und die Frage mit A (Immer ausführen) und Enter beantworten.

Bei der ersten Installation erscheint nun die Aufforderung den Entwicklermodus zu aktivieren.

D.h. schalte den Entwicklermodus auf Ein / On und beantworte die nachfolgende Frage

mit Ja. Danach bitte das Einstellungenfenster schließen (Klick auf das X rechts oben)

Auch diese Frage mit J (Ja) beantworten.

Am oberen Rand des Powershell Fensters erscheint nun die Fortschrittsanzeige.

Zum Ende der Installation erscheint

Klicke nun auf den Start-Button und füge die neu installierte App zum Start hinzu.
Damit kannst du jederzeit, z.B. zum Testen den Terminal manuell starten.

Zusätzlich kannst du damit das Terminalprogramm auf den Desktop ziehen (aus dem Start auf den Desktop).

.Net Framework

Ab der Terminalversion 0.0.20 ist ein aktuelles DotNet Framework erforderlich. Dies kann hier heruntergeladen werden.

Die Aufforderung zur Installation erscheint beim ersten Start des Terminalprogramms.

Je nach Einstellung des Browsers auf deinem Terminal wird

das zu installierende Framework sofort herunter geladen.
Bitte installieren. Du benötigst dafür entsprechend administrative Rechte.

Tipps zur Installation

Wichtig:
Die Terminalsoftware muss unter dem dann verwendeten Benutzer eingerichtet werden. Je nach Firmenpolitik hilft manchmal folgender Trick.
Gib vorab dem Terminalbenutzer lokale Administrations Rechte (Domain Admin) um die Terminalsoftware installieren und einrichten zu können. Nach der Installation und fertigem Einrichten, kann dieses Recht wieder entfernt werden.

Beachte immer, dass vor einem Update, das Betriebssystem des Terminals aktuell ist.

Trick:
In der Praxis hat sich, gerade in komplexeren Netzwerken, bewährt vor der Installation das Zertifikat des Terminals zu installieren, dafür brauchst du Administratorrechte, und erst danach die eigentliche Terminalsoftware unter dem ausführenden Benutzer.

Einrichten des Terminals

Starten des Terminals über Start

Beim ersten Start kommt in der Regel die Fehlermeldung, dass sich das Terminal nicht verbinden kann.
Bestätige diese Meldung und wähle anschließen das Setup des Terminals durch Klick auf

Eintragen des ComPorts

Feststellen welcher Comport für den Barcodescanner / den RFID Leser zur Verfügung steht, über den Gerätemanager (Rechtsklick auf den Startbutton)

Hier findest du unter den Comport für das / die angeschlossenen Eingabegeräte. In unserem Falle nun Com4 für den Barcodescanner.
Hinweis: Die Nummer des Comports hängt auch vom gewählten USB Anschluss ab. D.h. wenn der Standort des Terminals verändert wird, sollten bei der Aufstellung am neuen Standort die Geräte exakt an den gleichen USB Port angeschlossen werden, anderenfalls muss die Konfiguration wieder neu gemacht werden.
Wichtig: Damit der Comport überhaupt zur Auswahl steht, muss vor dem Start des Terminalprogrammes der Barcodescanner / der RFID Leser bereits angeschlossen sein und im Gerätemanager aufscheinen. Sollte der Scanner beim Scannen eines Barcodes ein grgr Geräusch von sich geben, bedeutet dies, dass der Scanner erkennt, dass er logisch betrachtet, nicht angeschlossen ist.

Trage nun die abgefragten Parameter ein:

Danach Klick auf “Speichern” und anschließend Anwendung beenden, um danach das Terminal neu zu starten.

Kommt nun die Meldung

so sind folgende Fehlermöglichkeiten gegeben, stimmen folgende Werte nicht zu deiner Kieselstein ERP Installation.

• es muss den Benutzer Terminal, terminal geben mit entsprechenden Rechten (siehe unten)
• es muss das Logon Locale mit dem Locale des Mandanten übereinstimmen
• es muss der Logon Mandant mit dem gewünschten Mandanten übereinstimmen Bitte beachte, dass die Sprache des Terminals nur für die Anzeige der verschiedenen Texte (Kommt, Geht usw.) verwendet wird.

Wenn Korrekturen am Setup gemacht wurden, so diese speichern und das Terminal neu starten.

Nach einem erfolgreichen Neustart erscheint in der oberen Statuszeile

Abschalten der Leser

Es kommt immer wieder die Frage, wie man die Leser, die man z.B. zu Testzwecken aktiviert hat, deaktivieren kann. Dazu ganz einfach auf den jeweiligen Port klicken und einen leeren Port zuordnen. Sollte sich aus irgend einem Grund, dieser nicht zuordnen lassen, so bitte die Terminal App deinstallieren

Funktioniert der Barcodescanner?

Die Barcodescanner kommunizieren über die serielle Schnittstelle mit dem Terminal. Die Übertragungsgeschwindigkeit sind 9600 Baud. D.h. du kannst auf den Windowsrechnern z.B. mit Putty prüfen, ob der Barcodescanner funktioniert.

Stelle dazu den putty auf Connection Type Seriell und gib den Com-Port (aus dem Gerätemanager) an.
Wichtig:
Sowohl der Putty als auch das Terminal benötigen einen exklusiven Zugriff auf den Com-Port. D.h. für diesen Test darf das Terminal nicht laufen.

Scannst du nun einen Barcode, z.B. die Ausweisnummer, so muss der Barcode-Inhalt im Putty-Fenster angezeigt werden.
Da jeder Scann mit CR abgeschlossen wird, muss der Cursor wieder am linken Rand stehen.

Solltest du hier zerstörte Zeichen, oder auch keine Zeichen sehen, so ist dein Barcodescanner falsch eingestellt, womit er für das Terminal nicht verwendet werden kann.

Beachte / Prüfe

Sollte das Terminal auf den Barcodescanner nicht reagieren, so prüfe ob du den Com-Port beim richtigen Leser eingetragen hast.

Ist der Comport beim NFC Leser eingetragen, so kann der Scanner seine Daten zwar senden, da die Schnittstelle für den NFC Leser damit aber nichts anfangen kann, passiert auch nichts.
Es wäre nicht das erste Mal, dass wir deswegen das (Remote) Debugging gestartet hätten, nur um dann festzustellen, dass es nur ein Bedienungsfehler war.

Sollte der Barcodescanner noch immer nicht funktionieren, schalte sowohl den Rechner komplett aus und stecke den Barcodescanner auch physikalisch ab. Dann den Rechner einschalten und erst wenn dieser läuft, den Barcodescanner wieder anstecken. Aufgrund der Stromversorgung per USB wird auch bei ausgeschaltetem Rechner der Scanner mit Strom versorgt und macht damit nur beim Reboot, aus / ein des Rechners keinen echten Neustart.

Zeiten buchen

Scan der Ausweisnummer. Bei einer gültigen Ausweisnummer (siehe Personal, Journal, Personalliste, Barcodeliste) wird der Name angezeigt und die derzeit möglichen Funktionen dargestellt.

Wähle nun deine Buchung. Nach erfolgreicher Buchung erscheint kurz die Meldung

In deinem Zeiterfassungsclient findest du nun diese Buchung mit der aktuellen Uhrzeit in der Quelle den Computernamen des erfassenden Rechners.

Wenn “Offline” angezeigt wird, also das Terminal keine Verbindung zu deinem Kieselstein ERP hat, wird der Status alle 30" geprüft. D.h. wenn man alles eingestellt hat, sollte es nach 30" gehen.

Wie sieht man auf welchem Terminal gebucht wurde?

Im Modul Zeiterfassung, bei der jeweiligen Person, sieht man unter Quelle den PC-Name / Hostnamen des Rechners von dem aus gebucht wurde. So kann mit einer sprechenden Namensvergabe sehr leicht die Zuordnung, wo denn der Mitarbeiter / die Mitarbeiterin gebucht hat, treffen.

Rechte

Für das Terminal sollten (nur) die unten angeführten Rechte vergeben werden. In Kombination mit der VDA-SCANN-App ergeben sich daraus folgende Einstellungen:

ACHTUNG: Hier fehlt das Recht: PERS_ZEITERFASSUNG_MONATSABRECHNUNG_DRUCKEN ohne diesem spinnt die Saldo Darstellung im Terminal, was man aktuell nur im LogFile sieht.

Bitte beachte, dass für das Terminal auch die Zuordnung unter Benutzermandant gegeben sein muss. Auch hier bitte nur die unbedingt notwendigen Rechte vergeben. Also:

Denke daran auch die Zuordnung für die RestAPI Systemrolle einzutragen.

Hinweis1: Werden die Rechte für das Terminal angepasst, ist kein Neustart des Terminal-Programms notwendig.
Hinweis2: Wurde die Darstellung der Personen aktiviert, also Anmeldeseite und beim Start des Programms werden keine Personen angezeigt, so fehlen die Rechte für die Personen.
Hinweis3: Es werden nur diejenigen Personen angezeigt, bei denen eine Ausweisnummer hinterlegt ist. Solltest du bei keiner einzigen sichtbaren Person eine Ausweisnummer hinterlegt haben, werden ebenfalls keine Personen angezeigt.

Diese Rechte sind nur für das Zeiterfassungsterminal erforderlich

Also dann, wenn das Terminal nur für die Anwesenheitszeiterfassung verwendet wird.

Diese Rechte sind zusätzlich für die Fertigung erforderlich

Wird das Terminal auch für die Buchung der Fertigungsbegleitscheine verwendet, so sind zusätzlich nachfolgende Rechte erforderlich.

Denke daran, dass bei Material Buchungen bzw. Ablieferbuchungen auch Rechte auf das Lager vergeben werden müssen. Also für die Rolle Terminal auch im Reiter Lager zumindest

Recht, um auf Aufträge zu buchen

Sollte mit dem Terminal auf Aufträge gebucht werden, so muss das Terminal auch das Recht haben, um auf den Auftrag Zeiten zu buchen. Also

Einrichten Autostart des Terminals

Damit dein Zeiterfassungsterminal immer startet, den Autostart einrichten.
Hier muss zwischen Windows 10 und Windows 11 unterschieden werden.

Windows 10

• Die Verknüpfung zum Terminalprogramm muss am Desktop eingerichtet sein.
• Windows-Taste + R und shell:startup
  
• Windows Explorer mit Autostart öffnet sich
• Die Verknüpfung vom Desktop in den Autostartordner ziehen / bzw. mit Strg kopieren.

Windows 11

Idealerweise bringst du zuerst das Terminal Starticon auf den Desktop. Da diese Applikation als versteckte App betrachtet wird, den Windows-Explorer starten (Windowstaste + E) dann in die Adressleiste

%windir%\explorer.exe shell:::{4234d49b-0245-4df3-b780-3893943456e1} einkopieren (danke an Netzwelt). Hier findest du eine Liste ALLER Applikationen, die auf dem Rechner installiert sind.
Hier nach dem Kieselstein-ERP Terminal suchen und dieses auf den Desktop ziehen. Weiter mit:

• Windows-Taste + R und shell:startup
  
• Windows Explorer mit Autostart öffnet sich
• Die Verknüpfung vom Desktop in den Autostartordner ziehen / bzw. mit Strg kopieren.

Daran denken

Bitte denke daran, dass für den Terminalrechner in der Regel jeglicher Standby Betrieb deaktiviert werden sollte. D.h. gerne können sich die Festplatten usw. abschalten, aber die normale Bedienung wie Bildschirm müssen aktiv bleiben.

Bitte denke auch daran, dass das Terminal so eingestellt sein muss, dass es nach einem eventuellen Stromausfall sofort wieder startet.

Einstellungen des Terminals sind Benutzerrechte

Idealerweise installierst du das Terminal unter dem Benutzer, unter dem auch das Terminalprogramm laufen sollte. Wenn du aus verschiedenen Gründen das unter einem anderen Benutzer installieren musst, denke daran, dann für den Terminalbenutzer die Konfiguration erneut durchzuführen.

Neuerungen mit der Version 0.0.8

Mit der Version 0.0.8 des Terminals stehen zusätzlich

• Anmeldeseite anzeigen
• Saldo Button anzeigen

zur Verfügung.

Anmeldeseite anzeigen

Damit werden alle Personen die im Personalstamm eingetragen sind und eine Ausweisnummer eingetragen haben in Form einer Buttonliste angezeigt.
Durch Tipp auf den Button gelangt man weiter zur Buchungsseite des Terminals.

Saldo Button anzeigen

Wird der Saldo Button angezeigt, so wird neben Kommt, Pause, Geht auch noch Saldo angezeigt. Mit Tipp auf Saldo wird der aktuelle Zeitsaldo des laufenden Monates ermittelt und angezeigt.

Tippt man nun auf Detail wird die Monatsabrechnung des aktuellen Monates angezeigt.

Hinweis1: Die Stunden des Zeitsaldos werden immer vom letzten des Vormonates errechnet. D.h. damit diese stimmen, müssen auch die Monatsabrechnungen ausgedruckt worden sein.

Hinweis2: Wird nach dem Klick auf den Saldo Button nichts angezeigt / es erfolgt keine Reaktion, dann fehlt bei der Person das Eintrittsdatum, womit keine Berechnung von gültigen Stunden erfolgen kann.

Neuerungen der Version 0.0.9

Mit der Version 0.0.9 des Terminals stehen zahlreiche weitere Funktionen, vor allem im Bereich Barcode-Scan zur Verfügung. Die wesentlichste Neuerung ist allerdings die offline Fähigkeit. D.h. es können, auch wenn das Terminal vorübergehend keine Verbindung zum Kieselstein ERP Server hat, die wesentlichsten Buchungen zwischengespeichert werden. D.h. diejenigen Buchungen, die ohne Antwort vom Server nur gespeichert werden müssen, werden im Terminal gespeichert. Steht die Serververbindung dann wieder zur Verfügung, werden innerhalb kurzer Zeit die Buchungen an den Server übertragen.

Weitere Funktionsbeschreibungen siehe

Neuerungen der Version 0.0.10

• Anzeige der Maschinenliste mit Datum, sowie Korrektur kleinerer Bugs
• Reconnect des Barcodescanners, falls während des Betriebes die Verbindung verloren gegangen ist (was leider manchmal bei Stromschwankungen und ähnlichem passiert).

Netzwerkverbindung

Für das Terminal muss eine Netzwerkverbindung, also mehr wie ein lokales Netz (nur auf dem einen Rechner) verfügbar sein, damit das Terminal dieses Netzwerk als gültige Verbindung ansieht. Localhost wird speziell behandelt.
Hintergrund: Gerade für die mobilen Geräte, muss man sehr rasch erkennen können, ob noch eine Netzwerkverbindung da ist oder nicht. Es würde sonst das Netzwerk-Timeout jeweils 4-5 Minuten dauern, was sehr unpraktisch wäre.

Weitere Funktionen

Die Konfiguration ist mittels Passwort geschützt

Wenn du auf die Konfiguration klickst, so erscheint gegebenenfalls die Abfrage nach einem Passwort.

Hier muss das hinterlegte Passwort eingegeben werden. Bitte entsprechend ändern / sorgfältig behandeln.

Löschen falscher Comport Zuordnungen

Gerade bei den Tests am Terminal verwendet man schon auch mal andere Erfassungsgeräte. Entfernt man nun diese, z.B. den Barcodescanner, so kommt beim nächsten Start des Terminals Comport xy ist nicht vorhanden. Um diese Meldung abzuschalten, in die Einstellungen gehen und bewusst den Comport z.B. des Barcodescanners auswählen und danach auf “Speichern” tippen. Damit ist die Zuordnung gelöscht.

Anwesenheitsliste, beliebige HTML Seite

Ab der Version 1.2 kann eine beliebige HTML Seite, welche für das jeweilige Terminal erreichbar ist, konfiguriert werden.
Zusätzlich kann das Refersh-Intervall eingerichtet werden.

Gedacht ist dies um die Anwesenheitsliste deiner MitarbeiterInnen anzuzeigen, es kann anstatt dessen auch jegliche andere HTML Seite angezeigt werden.

Um die Anwesenheitsliste passend zu deiner Terminalhardware anzuzeigen muss gegebenenfalls der Report der Anwesenheitsliste angepasst werden.

Die Meldungsbuttons sind zu klein

Je nach Größe des Terminal-Gerätes sind schon mal die Knöpfe bei den Meldungen zu klein. Abhilfe schafft man hier dadurch, dass man über das Betriebssystem die default Darstellung / Vergrößerungsfaktor höher dreht.

Die Monatsabrechnung hat mehr wie eine Seite

Wenn die Monatsabrechnung mehr als eine Seite hat, so wird trotzdem nur die erste Seite dargestellt. Bitte gestalte den Report so, dass er auf einer Seite Platz hat. Denke bitte dabei auch an deine / eure Mitarbeiter:innen die am Terminal den Report lesen wollen. Hier ist meist weniger mehr. Tipp: Stelle den Report auf Hochformat oder wenn wirklich erforderlich auf ein noch höheres Format, sodass alles auf einer Seite dargestellt werden kann.

Timeouts der verschiedenen Anzeigen

Wir haben uns vorerst dazu durchgerungen, die Timeouts auf den verschiedenen Anzeigen nicht zu implementieren. Die bisherigen Erfahrungen haben gezeigt, dass diese immer zu lange oder zu kurz, aber sehr selten richtig sind. Es gibt anstatt dessen einen Button zurück, mit dem man wieder in die normale Erfassung, des Ausweises, kommt.

Einrichten auf einem Windows PC

Mit der Version 0.0.9.0 kann das Terminal auch im Vollbildmodus betrieben werden. Damit auch im Vollbildmodus die Meldungen des Terminals angezeigt werden, muss der Benachrichtigungsmodus entsprechend eingestellt werden.

Windows 10

Windows 10: “System” - “Benachrichtungsassistent” - “Automatische Regeln”: Wenn ich eine App im Vollbildmodus verwende" auf “AUS” setzen.

Für englische Terminals “System” - “Notifications & actions” - “Focus assist” - “Automatic rules” “When i’m using an app in full-screen mode” is switched to “OFF”

Windows 11

• Benachrichtigungen generell ein
• im “Bitte nicht stören”, den Haken bei “Bei Verwendung einer App im Vollbildmodus …” -> raus

• und noch zusätzlich die Benachrichtigung der App Kieselstein-ERP Terminal, einschalten

Solltest du ein Terminal in Englisch nutzen, so findest du diese Einstellungen unter

bzw. dann weiter unten

Hinweis zur Bildschirmtastatur:

Diese steht nur zur Verfügung, wenn auf dem Gerät keine physikalische Tastatur angeschlossen ist. Das gilt auch, wenn eine Fernwartungssitzung zum Terminal aktiv ist. D.h. idealerweise NACH der Fernwartungssitzung den Terminal-PC komplett neu starten (diese Tastatureinstellungen werden nur beim Betriebssystemneustart übernommen).

Unter Windows 10:

• Einstellungen, System, Tablet
• Wenn ich das Gerät als Tablet verwende, immer in den Tablet Modus wechseln
• dann weiter zu:
• Zusätzliche Tablett Einstellungen
• Bildschirmtastatur anzeigen, wenn keine Tastatur angeschlossen ist.
• Zusätzlich: Tablet Modus aus.
  
  oder
  
  

Unter Windows 11

Stelle idealerweise die Bildschirmtastatur auf immer aktiv.

Bedienung der Tastatur

Es ist oft praktisch nur eine kleine Tastatur eingeblendet zu haben.

Dazu einfach rechts oben auf die Tastatur mit Pfeil nach unten tippen, bzw. dann auf die Tastatur mit dem Pfeil nach oben.

Um die Bildschirmtastatur zu aktivieren, müssen folgende Einstellungen getroffen werden:

• Einstellungen, Zeit und Sprache
• auf Eingabe klicken
• Bildschirmtastatur erweitern und Bildschirmtastatur anzeigen auf “Immer” stellen.
  

Swipe Modus abschalten

Wenn das Terminal im Vollbildmodus betrieben wird und man verhindern will, dass durch Wischen von den Ecken das sogenannte Windows Action Center aktiviert wird und damit der Benutzer auf das Betriebssystem kommt, muss diese Funktionalität über die Registry abgeschaltet werden. Dazu sowohl in Windows 10 als auch 11 im Key

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\PolicyManager\default\LockDown\AllowEdgeSwipe

den Wert auf 0 setzen und danach neu starten.

Weitere mögliche Einstellungen

Manche Anwender haben gerne noch weitere Anpassungen. Siehe dazu

Anmeldeseite

Wenn du die Anmeldeseite verwendest, so kann es, je nach Version deines Terminals vorkommen, dass einmal gedrückte MitarbeiterInnen Buttons in einer Kontrastfarbe angezeigt werden, die schlecht lesbar ist.
Dieses Verhalten kann unter System(Einstellungen), Barrierefreiheit, Visuelle Effekte, Animationseffekte EIN abgeschaltet werden.
Bitte beachten: Nach einer Änderung dieser Einstellung bitte das Terminalprogramm neu starten.

Anwesenheitsliste

Mit der Version 1.2 steht neben vielen anderen Dingen auch die Anzeige der Anwesenheitsliste zur Verfügung. In den Betriebssystemen Windows und Android, beide als Tablett, kannst du hier eine beliebige URL eintragen. Z.B.:

http://KIESELSTEIN-ERP-SERVER:8080/ze/ze?cmd=anwesenheitsliste

Leider zeigt aufgrund eines Fehlers in einer Ubuntu-Bibliothek diese Funktion unter Ubuntu und Debian nur eine weisse Seite. Die Ursache ist scheinbar ein Fehler in der libwebkit2gtk-4.1 ab der Ubuntu-Version 2.26.

Anmerkung zur Anzeige der HTML Seiten
Wird z.B. die Anwesenheitsliste angezeigt, so wird die Reportvariante Standard verwendet. Je nach Auflösung deines Terminals kann diese zu klein sein. Passe daher den Report entsprechend an um eine für dich passende Darstellung zu erreichen.

eine bestehende Installation aktualisieren

Update der Terminalinstallation

Für die Aktualisierung des Terminals kannst du in der Regel in der gleichen Weise vorgehen. D.h.

• Herunterladen der aktuellen Terminalversion
• Entpacken der Zip-Datei auf ein temporäres Installationsverzeichnis
• Aufrufen der Windows-Powershell
• Wechsel in das temporäre Installationsverzeichnis
• Starten von install.ps1

Dies sollte unter dem Terminalbenutzer erfolgen.

Sollte es beim Update zu Problemen kommen, so empfiehlt sich die bestehende Terminalversion zu entfernen. Bitte notiere dir vorher die von dir getroffenen Einstellungen.

eine bestehende Installation entfernen

Wenn es beim Update des Terminals zu Problemen kommt, das Update nicht möglich ist, kann es erforderlich sein, dass die bestehende Installation vorher deinstalliert werden muss. Dazu, Start, Einstellungen, Apps, Installierte Apps und dann durch Eingabe der Anfangsbuchstaben die App des Kieselstein-ERP Terminals auswählen.

Denke daran die Einstellungen dokumentiert zu haben.

Nun Klick auf die drei Punkte und Deinstallieren wählen.

das Terminalprogramm anzeigen und anklicken und dann

Deinstallieren auswählen.

Wird eine bestehende Version vor der 0.0.10 aktualisiert, muss diese vor dem Update entfernt werden, womit danach eine Neuinstallation erforderlich ist.

Hinweis: Auch beim Update von 0.0.xx auf die 0.1.xx muss vorher die bestehende Terminal-Installation entfernt werden. So bedeutet auch folgende Fehlermeldung, dass du die Deinstallation durchführen solltest.

Tipps & Tricks

Wenn das Terminal nicht startet, z.B. mit Verbindung verweigert, so prüfe, ob du vom Terminal-Rechner aus die Rest-API-Doku anzeigen kannst. Das Terminal nutzt die Restapi für die Buchungen. Ist diese nicht gestartet, ist natürlich keine Verbindung möglich.

Log-File

Die Terminal-App schreibt auch ein Logfile, in dem wesentliche Schritte z.B. beim Programmstart protokolliert werden. Dieses findest du unter:
c:\Users\Terminalbenutzer\AppData\Local\Packages\cce53e67-e463-4746-bede-e7cae70f832a_5wc6556p9s44j\LocalCache\KieselsteinTerminalLogs c:\Users\keg\AppData\Local\Packages\cce53e67-e463-4746-bede-e7cae70f832a_5wc6556p9s44j\LocalCache\KieselsteinTerminalLogs..

Anstatt des Terminalbenutzer bitte durch den für das Terminal verwendeten Benutzer ersetzen.

Welches Terminal ist das?

Gerade wenn mehrere Terminals im Einsatz sind und man mit den verschiedensten Parametrierungen kämpft, ist es praktisch zu wissen welches Terminal was ist. Auch wenn es z.B. um die Einrichtung des automatischen Ausdruckes von Ablieferetiketten geht.
Du findest diese Info in der Titelleiste des Konfigurationsmenüs.

Uhrzeiten synchronisieren

Siehe dazu bitte

Zertifikats-Fehler

Kommt unmittelbar beim Start der Installation die Fehlermeldung:
Fehler: Das Paket bzw. Bundle ist nicht digital signiert, oder die Signatur ist beschädigt

so sollte herausgefunden werden, was die eigentliche Ursache für den Fehler ist. Üblicherweise kommt der Fehler von einem defekten Download oder einer alten Installation unter falschen Benutzerberechtigungen. In diesem Falle raten wir zu folgender Vorgehensweise:

• Terminal-App komplett deinstallieren
• Terminal-App neu herunterladen

Sollte nun der Fehler trotzdem bestehen, kannst du versuchen die Ursache, warum das Zertifikat nicht installiert werden kann, manuell herauszufinden. Dazu in das Installationsverzeichnis der Terminalsoftware gehen und das Zertifikat manuell installieren:

Dann am besten

Lokaler Computer auswählen.

Danach alles default installieren.
Man sollte dann anhand der Fehlermeldung erkennen können, was die eigentliche Ursache ist, warum die Installation nicht geht. Dann eben diesen Fehler entsprechend abstellen.

Eine weitere Ursache kann sein, dass die zu installierende Terminalversion ein zu altes Zertifikat verwendet. D.h. von der Kieselstein ERP eG wird die Terminal-App mit einem sogenannten SelfSignedZertifikat versehen. Diese Zertifikate haben eine Laufzeit von 12 Monaten ab Zertifikatserstellung. Ist nun deine Terminalversion und oder das darin verwendete Zertifikat zu alt also abgelaufen, zu erscheint eine entsprechende Fehlermeldung. Man sieht das auch, wenn du die Zertifikatsdatei z.B. mit einem Doppelklick startest, so werden die Zertifikationsinformationen

und damit auch die Gültigkeit von bis angezeigt.

Ist das Zertifikat abgelaufen, kann derzeit die Terminal-App nicht mehr installiert werden. Bitte verwende eine neuere Terminal-Version.
In absoluten Ausnahmefällen kann eine alte Terminalversion von einem Programmierer mit einem neuen Zertifikat versehen werden. Bitte rechne mit einem entsprechenden Zeitaufwand, je nach Umgebung, die der Entwickler für die Neu-Einbindung aufwenden muss.

Berechtigungs-Fehler

Erscheint bei der Installation des Terminals

so hast du zu wenig Rechte, um die App zu installieren.
Hier ist wichtig zu wissen, auch wenn du als Administrator angemeldet bist, aber das Powershell nicht mit als Administrator ausführen gestartet hast, hat das Powershell unter Umständen zu wenig Rechte um die Installation vorzunehmen. Daher dann, entgegen obiger Beschreibung das PowerShell für die Terminal-Installation mit “als Administrator ausführen” starten.
Der Nachteil (der auch ein Vorteil sein kann): Neuinstallationen / Updates müssen auch entsprechend gleich ausgeführt werden.

Fehlermeldungen

Deutet darauf hin, dass vom Sys-Admin keine Rechte vergeben wurden, um die Software unter diesem User zu installieren.

Prüfe zusätzlich, ob das Betriebssystem deines Terminals auf aktuellem Stand ist. Oft sind Fehler dieser Art auf fehlende Betriebssystem-Updates zurückzuführen und natürlich: Denke daran, nach diversen Einstellungsversuchen die Terminal Hardware auch mal durchzustarten.

Stromversorgung

Üblicherweise erwarten sich die Mitarbeiter:innen, dass Zeiterfassungs-Terminals 24/7 verfügbar sind. Daher sind diese auch Offline-fähig programmiert. Das bedeutet aber auch, dass die Stromversorgung für das jeweilige Terminal entsprechend stabil gegeben sein muss.

Terminal AddOns

Bildschirmschoner mit Anwesenheitsliste

Proxyserver für Anwesenheitsliste

Wenn du mehr als 2 Terminals im Einsatz hast und ev. viele MitarbeiterInnen, bzw. eine komplexe Anwesenheitsliste. Verlagert die Abfragedauer auf den Proxyserver, wodurch dein Terminal auf den Bildschirmschoner wesentlich schneller reagiert.

Offline Lese Stifte