Erste Schritte mit MyOdoo TimeManagement (Anwenderhandbuch)

Owned by j.eberle@equitania.de (Unlicensed)
Last updated: 05.06.2020 by Martin Schmid
5 min read


Anbringen der Hardware 

Befestigen Sie die Lochplatte inklusive der Hardwareelemente an der gewünschten Position Ihrer Wand. 

* Abbildung zeigt Prototyp - Ausführung kann abweichen. 

Starten des Raspberry Pi


Stecken Sie dazu das Stromkabel in den Raspberry - dann fährt das System automatisch hoch. 

Die Konfigurationsmaske öffnet sich automatisch. 
Klicken Sie auf Abbrechen, da wir diese Maske erst später befüllen, wenn eine Verbindung mit dem Internet besteht. 

Anbindung ans WLAN

WLAN Symbol oben rechts anklicken, Ihr WLAN auswählen und die Zugangsdaten eingeben. Speichern Sie.  

Vorbereitung Odoo

Da MyOdoo_TimeManagement als Erweiterung von eq_hr implementiert ist, müssen Sie sicherstellen, dass eq_hr und eq_hr_timemanagement in Ihrem Odoo System installiert sind. Dies erreichen Sie über das Dashboard im Abschnitt Apps. Klicken Sie auf installieren und das Modul wird automatisch installiert.

Folgende Apps müssen installiert sein: 

  • hr_recruitment
  • eq_hr
  • eq_hr_time_management

Anlegen des HR Users

Für die Freischaltung des Terminals muss in Odoo ein HR Benutzer angelegt werden. Melden Sie sich hierzu in Ihrem Odoo System an und gehen über das Dashboard auf Einstellungen > Benutzer. Legen Sie hier einen neuen Benutzer an und vergeben Sie folgende Zugriffsrechte.

(Normalerweise ist der HR User in Ihrer Datenbank bereits angelegt.)


Personal: Personalsachbearbeiter
 Personalbeschaffung: Manager

Anlegen der Mitarbeiter 

Legen Sie vorab alle Mitarbeiter unter Personal in Odoo an, die sich über das Terminal später anmelden sollen. 

Konfiguration von MyOdoo TimeManagement auf dem Raspberry Pi

Konfigurationsparameter setzen

Hinweis: hierzu muss eine Tastatur am Raspberry Pi angeschlossen sein!

Da die Vorbereitung des Raspberry Pi nun abgeschlossen ist, können sie die Anwendung das erste Mal starten. Dies geschieht beim Hochfahren des Raspberry Pi normalerweise automatisch. Sollte dies nicht der Fall sein, klicken Sie hierzu per Doppelklick auf das Symbol für Configuration.sh auf dem Desktop und wählen Sie Ausführen. 

Optional  können Sie MyOdoo TimeManagement über folgenden Befehl starten. (nur für technisch versierte Anwender)
$ python3 main.py
bzw. $ python3 main.py -c

Im folgenden Menü müssen Sie die Konfiguration für das MyOdoo_TimeManagement festlegen: 


Abbildung 5: Konfigurationsmaske

  1. Server-Url über die Ihr Odoo System erreichbar ist.
  2. Port über den auf Ihr Odoo System zugegriffen werden kann.
  3. HR Benutzer den sie unter 2.4 angelegt haben.
  4. Zugehöriges Benutzerpasswort.
  5. Differenz der Zeitzone zum Server (Wird für Statusnachrichten benötigt)
  6. Datenbankbezeichnung Ihres Odoo Systems.
  7. Anzahl der Stellen, die für die Benutzer ID verwendet werden. (Nur bei Numpad/Barcode Eingabe benötigt)
  8. Anzahl der Stellen, die für den Pin verwendet werden. (Ebenfalls nur bei Numpad/Barcode Eingabe benötigt)
  9. Das verwendete Protokoll.
    1. Für https verwenden Sie jsonrpc+ssl.
    2. Für http verwenden Sie jsonrpc.
  10. Wählen Sie hier die Anmeldeart, die Sie verwenden möchten. Sie haben die Auswahl zwischen Numpad/Barcode und RFID.
  11. Über diese Schaltfläche können sie das Logging der Anwendung aktivieren bzw. deaktivieren. Ist das Logging aktiviert, wird ein logfile im selben Verzeichnis erstellt indem sie die main.py abgelegt haben.

Nachdem sie die Konfiguration der Anwendung abgeschlossen haben, können Sie über die Verbindungstest Schaltfläche Ihre Eingabe prüfen. Wenn der Verbindungstest erfolgreich ist, bestätigen sie die Konfiguration mit der OK Schaltfläche. Die Anwendung muss danach erneut gestartet werden.

Dafür gibt es folgende Möglichkeiten: 

Option A) Klicken Sie auf die Himbeere (Raspberry Pi Icon), klicken Sie Shutdown und wählen Sie die Herunterfahroption "Neu starten". 

            

Option B) Klicken Sie doppelt auf die TimeManagement.sh auf dem Desktop. 



Die Einrichtung von MyOdoo_TimeManagement ist nun abgeschlossen und die Anwendung kann verwendet werden.
Es ist möglich eine Verknüpfung für MyOdoo_TimeManagement anzulegen, damit nicht jedes Mal eine Eingabe über den Terminal erforderlich ist, wenn Sie die Anwendung starten möchten. Erstellen Sie hierzu eine neue Textdatei mit folgenden Zeilen.

$ #!/bin/bash
$ cd [Pfad zum Verzeichnis der Anwendung]
$ python3 main.py

Speichern Sie die Datei ab und navigieren mittels Terminal zur eben erstellten Verknüpfung. Konvertieren Sie die Text Datei zu einer ausführbaren Verknüpfung mit folgendem Befehl.

$ chmod u+x [Verknüpfungsnamen]

Varianten der RFID Tag

Sie können die Tags in Form von Schlüsselanhängern oder Karten an Ihre Mitarbeiter ausgeben, je nachdem was Sie bevorzugen. 

Hinterlegen der RFID Tags für Mitarbeiter

Hinweis: hier muss eine Tastatur am Raspberry Pi angeschlossen sein!
Führen Sie zum Start die Datei Read RFID Tag.sh aus.  

Optional: Wenn Sie die Anwendung mittels des Startparameters -t starten haben Sie die Möglichkeit die RFID Tags Ihrer Mitarbeiter auszulesen, um sie in der Odoo Datenbank zu hinterlegen.
$ python3 main.py -t

1.) Geben Sie einen Suchbegriff, bevorzugt einen Namen eines Mitarbeiters (oder die ID oder den Barcode) in das Suchfeld ein und klicken Sie die kleine Lupe. 
2.) Hier erscheinen die Ergebnisse Ihrer Suche. Wählen Sie den betreffenden Mitarbeiter per Klick aus. 

3.) Halten Sie den RFID-Tag vor den Leser und Klicken Sie dann auf den Button Tag ID lesen. 

4.) Wenn eine Tag ID angezeigt wird, müssen Sie nur noch den Button Verknüpfen klicken. Der Mitarbeiter ist dann mit dem Tag verknüpft. Händigen Sie Ihrem Mitarbeiter seinen Tag aus. 

Es ist jederzeit möglich einen verknüpften Tag wieder zu überschreiben (z.B. bei Verlust). 

Entfernen eines Mitarbeiters 

Falls ein Mitarbeiter Ihr Unternehmen verlässt, sollten Sie den Mitarbeiter in Odoo unter Personal inaktiv setzen und die Felder (RFID, Ausweis ID und PIN) in den HR Einstellungen des Mitarbeiters löschen. 



Authentifizierung mittels RFID Tag

Nachdem Sie MyOdoo_TimeManagement gestartet haben, befindet sich die Anwendung im Urzustand und wartet auf die Benutzerauthentifizierung. Um sich zu authentifizieren halten Sie einfach Ihren RFID Tag vor den Reader.
Sie werden dann automatisch ins nächste Menü weitergeleitet. Die Abläufe können Sie folgender Grafik entnehmen.


Sobald sich der Mitarbeiter mit seinem RFID Tag authentifiziert hat, wird je nach Mitarbeiter Status eine der drei Masken geladen. Hierüber haben Sie die Möglichkeit sich an- bzw. abzumelden oder Ihre Pause zu beginnen bzw. zu beenden.
Sobald Sie Ihre Eingabe getätigt haben springt die Anwendung automatisch in den Urzustand zurück. Falls Sie keine Eingabe tätigen, springt die Anwendung nach einem festgelegten Intervall ebenfalls zurück in den Urzustand.

Authentifizierung mittels Numpad / Barcode

Falls Sie als Anmeldeart Numpad/Barcode gewählt haben, kommt eine weitere Maske zur Abfrage des Pins zum Einsatz. Bitte beachten Sie, dass die ID Stellen bzw. Pin Stellen in der Konfiguration für diese Authentifizierungsart festgelegt sein müssen.
Die Abläufe entnehmen Sie folgender Grafik. Mit X Schaltfläche können Sie Ihre Eingabe löschen. Mit der < Schaltfläche löschen Sie das zuletzt eingegebenen Zeichen.




Sie können die Mitarbeiter ID bzw. den Pin manuell über das Numpad eingeben oder Sie scannen einen Barcode bestehend aus der Kombination von beidem ein. Beachten Sie bei der Erstellung der Barcodes für ihre Mitarbeiter, dass diese dem Format Code128 entsprechen.
Falls Sie sich über einen Barcode authentifizieren möchten, können Sie einfach einen Barcode Scanner per USB an den Raspberry Pi anschließen. Dieser fungiert dann als Eingabegerät.