[Doku] Import Anwesenheitszeiten

TIAM
Beiträge: 5
Registriert: Di. 8. Nov 2016, 9:59
Vorname: Tim
Nachname: Ammerer

[Doku] Import Anwesenheitszeiten

Beitragvon TIAM » Fr. 13. Dez 2019, 10:08

Anwesenheitszeiten Import
  • Verfügbar ab Release: 5.3.9
  • Dokumentationsstand: 5.3.18
  • Verfügbar ab Lizenztyp: Zeiterfassung Plus
  • Benutzerrecht: Um Anwesenheitszeiten zu Importieren muss der Nutzer das Recht "Darf Anwesenheitszeiten von anderen bearbeiten" besitzen. Dies ist unter den 'Benutzergruppenrechte > Benutzername > Mein Konto > weitere Rechte' zu finden.

Allgemein

Anwesenheitszeit
Unter dem Menüpunkt 'Extras' befindet sich die 'Anwesenheitszeit'. Hier kann die Anwesenheitszeit des angemeldeten Users eingesehen werden, bzw. die der anderen User, wenn das Recht "Darf Anwesenheitszeiten von anderen bearbeiten" aktiv ist. Hier ist unter dem Funktionsmenü nun auch die Funktion "Import" aufgeführt.

Funktionsweise
Unter der Funktion "Import" öffnet sich ein Dateien-Upload Overlay, mit dem die ausgewählte Datei importiert werden kann.


Spezifikationen

Aufbau der Datei
Pro Zeile wird eine Anwesenheitszeit für einen Nutzer für einen Tag importiert.
Eine Zeile ist aufgebaut aus:
Buchungstag, Startzeit, Endzeit, Kurzname, Pausendauer, Beschreibung
YYYY-MM-DD,HH:MM,HH:MM,ABCD,NN.NN,"Beschreibung"

Buchungstag:
  • YYYY-MM-DD
  • ISO-Konform
  • Muss kleiner (<) als Heute sein
  • Trennzeichen Bindestrich (-)
  • Bsp: 2019-10-20
Startzeit:
  • HH:MM
  • Ohne Zeitzone
  • Ohne Sekunden
  • 24-Stunden Format
  • Max. 23:59
  • Trennzeichen Doppelpunkt (:)
  • Bsp: 09:00
Endzeit:
  • HH:MM
  • Ohne Zeitzone
  • Ohne Sekunden
  • 24-Stunden Format
  • Max. 23:59
  • Darf nicht kleiner als Startzeit sein
  • Trennzeichen Doppelpunkt (:)
  • Bsp: 09:00
Kurznamen:
  • ABCD
  • Der Kurzname eines angelegten Mitarbeiters
  • Nicht länger als 16 Zeichen
  • Case-insensitiv
  • Bsp.: TIAM
Pausendauer:
  • NN.NN
  • Gesamtpausenzeit des betreffenden Tages in Stunden
  • Industriestunden
  • Max. zwei Nachkommastellen
  • Darf nicht größer sein als die Anwesenheitszeit des Tages
  • Darf nicht negativ sein
  • Muss kleiner als 24 sein
  • Trennzeichen Punkt (.)
  • Bsp.: 1.50
Beschreibung:
  • Beschreibung (Hinweistext zur Buchung)
  • Optional
  • Max. 256 Zeichen (mehr Zeichen werden abgeschnitten)
  • Text ohne Zeilenumbrüche und Zeilenvorschübe
Weitere Prämissen
  • CSV Datei
  • UTF8 konform
  • in der Datei können mehrere TAGE pro USER enthalten sein
  • Für einen schon bestehenden DATENSATZ der Kombination TAG/USER in der Datenbank wird kein UPDATE durchgeführt. D.h. eine Änderung kann nur über die PROAD Oberfläche erfolgen
  • Datensätze, die schon in PROAD angelegt wurden, werden nicht überschrieben
  • Es können nur Datensätze importiert werden, deren Datum < HEUTE ist
  • Textfelder:
    • können in " eingebettet werden
    • sollte der Text Steuerzeichen (insbesondere das Trennzeichen Komma [,]) enthalten, muss der Text in " eingebettet sein
    • dürfen keine Zeilenumbrüche und Zeilenvorschübe enthalten

Mögliche Fehler
  • Eine Leerzeile wird nicht erkannt/gewertet was dazu führen kann, dass die Fehlermeldung andere Zeilen angibt als die fehlerhaften Datensätze in der Datei
  • Ein Komma (,) in der Beschreibung, ohne dass der Beschreibungstext in Hochkommata (") eingesetzt ist
  • Bereits vorhandene Einträge am selben Tag für denselben Nutzer, verhindern den Import dieser Zeile
  • Wurde die Datei vorher mit Excel geöffnet und neu gespeichert, kann es sein, dass die Datei davon verfälscht wurde. Möchte man die Datei dennoch einsehen, empfehlen wir einen Text-Editor wie Sublime oder Visual Studio Code