Η εφαρμογή ES1 WorkLife Agent είναι ένα background windows service που ενσωματώνεται με τη λύση WorkLife της EntersoftOne για τη μεταφόρτωση δεδομένων παρουσίας εργαζομένων από συσκευές καταγραφής χρόνου εργασίας στο σύστημα Worklife Payroll. Με αυτόν τον τρόπο διασφαλίζεται η ακριβής και αποδοτική μεταφορά των εγγραφών παρουσίας, επιτρέποντας την απρόσκοπτη διαχείριση του ανθρώπινου δυναμικού και την ομαλή επεξεργασία της μισθοδοσίας.
Αντικαθιστά το υπάρχον service ESTimeAttendance και στο σύνολό του θα καλύψει τις εξής απαιτήσεις integrations:
• ZK Teco: SDK v2.4.2, PUSH/PULL modes, upload user info, retrieve logs, optional time sync | released
• Hundure: Connect via API/SDK, migrate existing functionality | to be delivered
• HRMaster: Download company/employee data, upload attendance data | to be delivered
• File System Mode: Read/Parse files, upload data | to be delivered
• Database Mode: Support MySQL/SQL Server/Oracle, secure connections | to be delivered
Προς το παρόν οι παρακάτω οδηγίες αφορούν μόνο τη διασύνδεση με τα ρολόγια ZKTeco.
Προαπαιτούμενα
Απαιτήσεις Συστήματος:
Windows 10 ή νεότερο, ή Windows Server 2016 και νεότερο
Τουλάχιστον 4 GB μνήμης RAM
Τουλάχιστον 500 MB ελεύθερου χώρου στο δίσκο
Δικαιώματα διαχειριστή για την εγκατάσταση
Απαιτείται επίσης η κατάλληλη διαμόρφωση των firewall settings.
Εγκατάσταση
Κατεβάστε και εκτελέστε το αρχείο εγκατάστασης από εδώ.
Εισάγετε το API Key που έχει εκδοθεί στον Cloud Store λογαριασμό σας. Οδηγίες θα βρείτε εδώ.
Ολοκληρώστε τη διαδικασία εγκατάστασης.
Ο προεπιλεγμένος φάκελος εγκατάστασης είναι:
Program Files\ES1WorklifeAgent
Σύνδεση Μηχανήματος Χρόνου Παρουσίας
Σε μια συσκευή ZKTeco:
Μεταβείτε στο μενού Communication.
Επιλέξτε Cloud Server.
Εισάγετε την IP του υπολογιστή όπου είναι εγκατεστημένος ο agent.
Ορίστε τη θύρα 8081.
Χρησιμοποιήστε HTTP (η HTTPS δεν υποστηρίζεται προς το παρόν).
Εμφάνιση Πληροφοριών Συσκευής
Ανοίξτε το αρχείο ES1.Worklife.Cli.exe με δικαιώματα διαχειριστή από τον φάκελο εγκατάστασης.
Πληκτρολογήστε την εντολή:
devices --info
Θα εμφανιστούν όλες οι συνδεδεμένες συσκευές.
Εγγραφή Συσκευής
Προσθέστε τη συσκευή στο WorkLife Payroll. Οδηγίες θα βρείτε εδώ.
Εκτελέστε την εντολή:
devices 1 --state
όπου 1 είναι ο αριθμός της συσκευής.Χρησιμοποιήστε τα βελάκια για να επιλέξετε την κατάσταση “Active”, αφού πρώτα η συσκευή έχει καταχωρηθεί στο WorkLife.
Η συσκευή είναι πλέον έτοιμη να λαμβάνει γεγονότα παρουσίας και να τα αποστέλλει στο σύστημα WorkLife.
Βασικές Εντολές
Εντολή | Περιγραφή |
|---|---|
install | Εγκαθιστά τον agent ως υπηρεσία Windows |
uninstall | Απεγκαθιστά την υπηρεσία |
start | Εκκινεί την υπηρεσία |
stop | Διακόπτει την υπηρεσία |
restart | Επανεκκινεί την υπηρεσία |
status | Εμφανίζει την τρέχουσα κατάσταση της υπηρεσίας |
job | Διαχείριση εργασιών (χρήση --help για περισσότερες επιλογές) |
update | Έλεγχος και εγκατάσταση διαθέσιμων ενημερώσεων |
db | Εργαλεία διαχείρισης βάσης δεδομένων (χρήση --help) |
devices | Διαχείριση συσκευών (χρήση --help) |
events --info | Εμφανίζει σύνοψη γεγονότων |
config | Επεξεργασία ρυθμίσεων χρόνου εκτέλεσης |
help | Εμφανίζει βοήθεια για το CLI |
quit ή q | Έξοδος από τη διαδραστική λειτουργία CLI |
Για τις περισσότερες εντολές μπορείτε να χρησιμοποιήσετε την παράμετρο --help για επιπλέον πληροφορίες.
Κατάσταση και Καθεστώς Συσκευών
Κατάσταση Συσκευής
Κατάσταση | Περιγραφή |
|---|---|
Online | Η συσκευή είναι προσβάσιμη μέσω δικτύου |
Offline | Η συσκευή δεν ανταποκρίνεται ή είναι απενεργοποιημένη |
Error | Παρουσιάστηκε σφάλμα επικοινωνίας – απαιτείται έλεγχος των αρχείων καταγραφής |
Η κατάσταση της συσκευής είναι μόνο για ανάγνωση.
Κατάσταση Σύνδεσης με WorkLife
Κατάσταση | Περιγραφή |
|---|---|
Active | Η συσκευή είναι εγγεγραμμένη στο WorkLife και ανταλλάσσει δεδομένα |
Inactive | Δεν είναι εγγεγραμμένη ή δεν έχει ενεργή σύνδεση |
Suspended | Η συσκευή έχει τεθεί σε αναστολή για λόγους συντήρησης ή διαχείρισης |
Test | Η συσκευή λειτουργεί σε δοκιμαστική κατάσταση |
Η κατάσταση αυτή καθορίζει τον τρόπο με τον οποίο η συσκευή επικοινωνεί με το σύστημα WorkLife.
Διαμόρφωση Firewall
Για τη σωστή λειτουργία και επικοινωνία του ES1 WorkLife Agent με τις συνδεδεμένες συσκευές, πρέπει να είναι ανοιχτές οι παρακάτω θύρες:
Port | Service | Protocol | Direction | Description |
|---|---|---|---|---|
8081 | ES1 Worklife Agent (Cloud Server) | HTTP/TCP | Inbound | Allows ZKTeco devices to connect to the agent and transmit attendance events |
4370 | ZKTeco Device Communication | TCP/UDP | Outbound | Allows the agent to communicate with ZKTeco devices for polling and data synchronization |