Windows Einstellungen zum KES-ZE-Terminal
mögliche Einstellungen unter Windows für dein Kieselstein ERP Zeiterfassungsterminal
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 musst dein Server über den Port 8280 (https ist in Vorbereitung) erreichbar sein.
Anmerkung:
Ab der Serverversion 1.x.x ist die REST-API im Wildfly integriert. Daher wird hier der Port 8080 verwendet. Es ist dafür die Version 0.0.30.x oder höher der mobilen App erforderlich.
Derzeit steht die KES-ZE-App für Windows und Android zur Verfügung. Eine Erweiterung auf Linux Betriebssysteme ist angedacht.
Bitte beachte, dass du für die Installation auf Windowsrechnern administrative Rechte benötigst. Es werden aktuell nur Home und Pro (jeweils Win10/11) unterstützt. Ev. andere Versionen, vor allem die die den Entwicklungsmodus nicht unterstützen, können nicht verwendet werden.
Programmtechnisch sind das Zeiterfassungsterminal und die mobile (Inventur)-App identisch. Es wird automatisch anhand des Gerätes, auf welchem das Programm ausgeführt wird, entschieden welche Anwendung nun ausgeführt wird.
Gerät | Anwendung | Bemerkung |
---|---|---|
Windows PC | Zeiterfassungsterminal | mit seriellen Lesern |
Android Tablett | Zeiterfassungsterminal | NFC Leser erforderlich |
Android Phone | mobile App | Barcodescann über die Kamera, NFC Leser wenn verfügbar, Bluethooth Barcodescanner |
Memor1 | mobile App | Barcodescann über die Scann-Engine, kein NFC Leser |
Mobile App siehe |
Herunterladen der neuesten Version von https://gitlab.com/kieselstein-erp/sources/kieselstein-terminal-maui/-/releases
Hier je nach Betriebssystem das passende Package auswählen.
Anmerkung:
Die weitere Beschreibung geht von Windows aus.
WICHTIG: eine eventuell bereits vorhandene Version vorher entfernen -> siehe unten.
Klick auf Download, die heruntergeladene Datei und
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).
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.
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.
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
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.
Wenn Korrekturen am Setup gemacht wurden, so diese speichern und das Terminal neu starten.
Nach einem erfolgreichen Neustart, erscheint in der oberen Statuszeile
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
Scann 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 nun diese Buchung mit der aktuellen Uhrzeit in 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 wird alle 30" geprüft. D.h. wenn man alles eingestellt hat, sollte es nach 30" gehen
Im Modulzeiterfassung, bei der jeweiligen Person sieht man unter Quelle den PC-Name / Hostnamen des Rechners von dem aus gebucht wurde. So kann man mit einer sprechenden Namensvergabe sehr leicht die Zuordnung wo denn der Mitarbeiter / die Mitarbeiterin gebucht hat treffen.
Hinweis:
Wir raten dazu, jedem Terminal, egal ob unter Windows oder Android einen eindeutigen und für dich lesbaren Namen zu geben.
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.
Also dann, wenn das Terminal nur für die Anwesenheitszeiterfassung verwendet wird.
Wird das Terminal auch für die Buchung der Fertigungsbegleitscheine verwendet, so sind zusätzlich nachfolgnede 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
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
Damit dein Zeiterfassungsterminal immer startet, den Autostart einrichten.
Hier muss zwischen Windows 10 und Windows 11 unterschieden werden.
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 Applikation die auf dem Rechner installiert sind.
Hier nach dem Kieselstein-ERP Terminal suchen und dieses auf den Desktop ziehen. Weiter mit:
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.
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.
Mit der Version 0.0.8 des Terminals stehen zusätzlich
zur Verfügung.
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.
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.
Mit der Version 0.0.9 des Terminals stehen zahlreiche weitere Funktionen, vor allem im Bereich Barcode-Scann 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
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-5Minuten dauern, was sehr unpraktisch wäre.
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älltig behandeln.
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.
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.
Wenn die Monatsabrechnung mehr wie 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 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.
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.
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: “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”
Solltest du ein Terminal in englisch nutzen, so findest du diese Einstellungen unter
bzw. dann weiter unten
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).
Stelle idealerweise die Bildschirmtastatur auf immer aktiv.
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:
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.
Manche Anwender haben gerne noch weitere Anpassungen. Siehe dazu
Lade wie beschrieben die aktuelle Version herunter.
Entpacke die Datei in ein Verzeichnis deiner Wahl, z.B. d:\kieselstein\terminal\Terminal_0.0.9.0_Test. Hier findest du nun die Datei Terminal_0.0.Version.0_x64.msix. Diese starten und aktualisieren wählen.
Dies sollte unter dem Terminalbenutzer erfolgen.
Bevor du eine neue Version des Terminals installierst ist es derzeit erforderlich die bestehende Installation zu beenden. Dazu, Start, Einstellungen, Apps, und dann durch Eingabe der Anfangsbuchstaben die Kiesel.
Ab der Version 0.0.10 ist das Entfernen nicht mehr erforderlich.
das Terminalprogramm anzeigen und anklicken und dann
Deinstallieren auswählen.
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.
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
Anstatt des Terminalbenutzer bitte durch den für das Terminal verwendeten Benutzer ersetzen.
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.
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:
Sollten 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.
Erscheint bei der Installation des Terminals
so hast du zuwenig 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.
Deutet darauf hin, dass vom Sys-Admin keine Rechte sind 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 Updates zurückzuführen und natürlich: Denke daran, nach diversen Einstellungsversuchen die Terminal Hardware auch mal durchzustarten.
Üblicherweise erwarten sich die Mitarbeiter, 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.
Wird das Terminal in der Konfiguration so eingestellt, dass Vollbildmodus aus und das Verschiebbar ein ist,
,
so kann in der Mitarbeiter Erfassungsmaske die Position des Terminalfensters festgelegt werden und mit Klick auf Terminal Fensterposition speichern, diese Position für den nächsten Aufruf gespeichert werden.
Um die Position des Fensters horizontal zu verschieben, wählt man den linken Rand des Terminalfensters, bis die Maus zum Doppelpfeil <-> wird. Dann links Klick mit der Maus und an die gewünschte Position ziehen. Analog mit der vertikalen Position am oberen Rand umgehen.
Die Breite / Höhe wird in der Konfiguration fix eingestellt.
Daran denken, gegebenenfalls die Position zu speichern .
Wenn du mehr wie 2Terminals 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.
mögliche Einstellungen unter Windows für dein Kieselstein ERP Zeiterfassungsterminal
Einrichten eines Barcodesimulators für das Kieselstein ERP Zeiterfassungsterminals
Leseeinheiten zum Kieselstein ERP Zeiterfassungsterminals