Import Zeitstempelungen: Unterschied zwischen den Versionen

K (Orthografie- und Grammatik-Korrekturen durch Praktikant MichaelH (22 July 2022))
Zeile 11: Zeile 11:
Der Import kann über eine File-Schnittstelle oder über ein Web-Service erfolgen.
Der Import kann über eine File-Schnittstelle oder über ein Web-Service erfolgen.


 
<span><br /></span>
==Satzbeschreibung der Zeitstempel-Importschnittstelle Format "Standard"==
==Satzbeschreibung der Zeitstempel-Importschnittstelle Format "Standard"==


  Die Dateiendung muss ".exp" lauten. Die Datei muss mit der Codierung "ANSI" abgespeichert werden.
  Die Dateiendung muss ".exp" lauten. Die Datei muss mit der Codierung "ANSI" abgespeichert werden.
   
   
{| class="wikitable" border="1" style="border-collapse:collapse; border-color:#E8E8E8; vertical-align:top" cellspacing="50" cellpadding="4"  
{| class="wikitable" style="" border="1" cellspacing="50" cellpadding="4"  
|- style="background-color:#FFD317; text-align:center"
|- style="background-color:#FFD317; text-align:center"
| colspan="4" |'''Satzbeschreibung bei Zeitstempel-Import Format = "Standard"'''
| colspan="4" |'''Satzbeschreibung bei Zeitstempel-Import Format = "Standard"'''
Zeile 35: Zeile 35:
|}
|}


 
<span><br /></span>
===Muster-Beispiele===
===Muster-Beispiele===


Zeile 64: Zeile 64:
  Die Dateiendung muss ".exp" lauten. Die Datei muss mit der Codierung "ANSI" abgespeichert werden. Die Felder werden durch einen Strichpunkt ";" getrennt
  Die Dateiendung muss ".exp" lauten. Die Datei muss mit der Codierung "ANSI" abgespeichert werden. Die Felder werden durch einen Strichpunkt ";" getrennt
   
   
{| class="wikitable" border="1" style="border-collapse:collapse; border-color:#E8E8E8; vertical-align:top" cellspacing="50" cellpadding="3"  
{| class="wikitable" style="" border="1" cellspacing="50" cellpadding="3"  
|- style="background-color:#FFD317; text-align:center"
|- style="background-color:#FFD317; text-align:center"
| colspan="3" |'''Satzbeschreibung bei Zeitstempel-Import Format = "Standard semicolon"'''
| colspan="3" |'''Satzbeschreibung bei Zeitstempel-Import Format = "Standard semicolon"'''
Zeile 85: Zeile 85:
|}
|}


 
<span><br /></span>
===Muster-Beispiele===
===Muster-Beispiele===


Zeile 116: Zeile 116:
**Timecom
**Timecom
*Zeitstempel-Import Pfad: Pfad hinterlegen, wo die Import-Files von der Stempeluhr abgelegt werden.  
*Zeitstempel-Import Pfad: Pfad hinterlegen, wo die Import-Files von der Stempeluhr abgelegt werden.  
**Achtung! Der Server bzw. der Benutzer, mit welchem der {{Alex}}-Dienst ausgeführt wird, muss auf diesem Pfad eine Schreib-Berechtigung haben!
**Achtung! Der Server bzw. der Benutzer (Windowsbenutzer), mit welchem der {{Alex}}-Dienst ausgeführt wird, muss auf diesem Pfad eine Schreib-Berechtigung haben, wenn sich der Ordner nicht am Server befindet.
*Zeitstempel-Import Häufigkeit: Wie oft (in Sekunden) sollen die Stempel importiert werden?
*Zeitstempel-Import Häufigkeit: Wie oft (in Sekunden) sollen die Stempel importiert werden?
*Zeitstempel-Import Kartennummer Anzahl der Stellen: Default-Wert ist 20. Dieses Feld ist für das "Standard"-Format zu befüllen, falls die Länge dieses Feldes angepasst werden soll.
*Zeitstempel-Import Kartennummer Anzahl der Stellen: Default-Wert ist 20. Dieses Feld ist für das "Standard"-Format zu befüllen, falls die Länge dieses Feldes angepasst werden soll.

Version vom 24. November 2022, 15:14 Uhr

Stempelungen müssen nicht zwingend über die Alex®-Stempeluhr erfasst werden.

Für den Import von anderen Zeiterfassungssystemen gibt es aktuell fünf unterschiedliche Import-Schnittstellen:

  • Alex®-Standard
  • Alex®-Standard Semicolon
  • Gantner
  • EMVS
  • Timecom

Der Import kann über eine File-Schnittstelle oder über ein Web-Service erfolgen.


Satzbeschreibung der Zeitstempel-Importschnittstelle Format "Standard"

Die Dateiendung muss ".exp" lauten. Die Datei muss mit der Codierung "ANSI" abgespeichert werden.

Satzbeschreibung bei Zeitstempel-Import Format = "Standard"
Feldname Feldlänge Feldformat Entspricht im Alex:
Nr variabel alphanum., Länge ist einstellbar (default=20) Personal - Kartennummer
DatumZeit 16 JJJJ-MM-TT HH:MM Datum und Zeit der Stempelung
Type 1 numerisch (nur 0 oder 1 möglich) 0 bedeutet "von"-Stempelung, 1 bedeutet "bis"-Stempelung
ABWCode 5 alphanum, z.B.: AZ für Arztbesuch oder B für Besprechung Planungscode-Zeiterfassung/Stempeluhr - Plansymbol für Import; wenn leer -> Planungscode -Plansymbol
Text 80 alphanum (optionaler freiwählbarer Text) Kommt-Geht-Text
PlanCode 20 alphanum Planungseinheit für Kommt-Geht (Externes Kennzeichen, sonst Kurzzeichen)


Muster-Beispiele

So muss der Satz in der Schnittstelle aussehen, wenn der Mitarbeiter...

... um 9:00 zum normalem Dienst gekommen ist und als Text "hallo" erfasst hat:

4711                2006-01-01 09:000     hallo
12345678901234567890123456789012345678901234567890123456789012345678901234567890 ( -> nur Hilfestellung - nicht in die Schnittstelle schreiben )
1         2         3         4         5         6         7         8          ( -> nur Hilfestellung - nicht in die Schnittstelle schreiben )

... um 9:00 vom Arzt gekommen ist:

4711                2006-01-01 09:000AZ   
12345678901234567890123456789012345678901234567890123456789012345678901234567890
1         2         3         4         5         6         7         8         

... um 9:00 zur Besprechung gegangen ist:

4711                2006-01-01 09:001B    
12345678901234567890123456789012345678901234567890123456789012345678901234567890
1         2         3         4         5         6         7         8         

... um 9:00 nach Hause gegangen ist:

4711                2006-01-01 09:001     
12345678901234567890123456789012345678901234567890123456789012345678901234567890
1         2         3         4         5         6         7         8

Satzbeschreibung der Zeitstempel-Importschnittstelle Format "Standard Semicolon"

Die Dateiendung muss ".exp" lauten. Die Datei muss mit der Codierung "ANSI" abgespeichert werden. Die Felder werden durch einen Strichpunkt ";" getrennt

Satzbeschreibung bei Zeitstempel-Import Format = "Standard semicolon"
Feldname Feldformat Entspricht im Alex:
Nr alphanum. Personal - Kartennummer
DatumZeit JJJJ-MM-TT HH:MM Datum und Zeit der Stempelung
Type numerisch (nur 0 oder 1 möglich) 0 bedeutet "von"-Stempelung, 1 bedeutet "bis"-Stempelung
ABWCode alphanum, z.B.: AZ für Arztbesuch oder B für Besprechung Planungscode-Zeiterfassung/Stempeluhr - Plansymbol für Import; wenn leer -> Planungscode -Plansymbol
Text alphanum (optionaler freiwählbarer Text) Kommt-Geht-Text
PlanCode alphanum Planungseinheit für Kommt-Geht (Externes Kennzeichen, sonst Kurzzeichen)
ColorMark alphanum Aufgabe für Kommt-Geht (Object ID)


Muster-Beispiele

So muss der Satz in der Schnittstelle aussehen, wenn der Mitarbeiter...

... um 9:00 zum normalem Dienst gekommen ist und als Text "hallo" erfasst hat:

4711;2006-01-01 09:00;0;;hallo

... um 9:00 vom Arzt gekommen ist:

4711;2006-01-01 09:00;0;AZ   

... um 9:00 zur Besprechung gegangen ist:

4711;2006-01-01 09:00;1;B    
 

... um 9:00 nach Hause gegangen ist:

4711;2006-01-01 09:00;1

Parametrierung

Systemeinstellungen

In Systemeinstellungen - Zeiterfassung/Stempeluhr sind folgende Parameter zu setzen:

Alex®-Parametrierung
Systemeinstellungen Zeitstempelimport .png
  • Zeitstempel-Import-Format zur Auswahl des Formats:
    • Standard
    • Standard Semicolon
    • Gantner
    • EMVS
    • Timecom
  • Zeitstempel-Import Pfad: Pfad hinterlegen, wo die Import-Files von der Stempeluhr abgelegt werden.
    • Achtung! Der Server bzw. der Benutzer (Windowsbenutzer), mit welchem der Alex®-Dienst ausgeführt wird, muss auf diesem Pfad eine Schreib-Berechtigung haben, wenn sich der Ordner nicht am Server befindet.
  • Zeitstempel-Import Häufigkeit: Wie oft (in Sekunden) sollen die Stempel importiert werden?
  • Zeitstempel-Import Kartennummer Anzahl der Stellen: Default-Wert ist 20. Dieses Feld ist für das "Standard"-Format zu befüllen, falls die Länge dieses Feldes angepasst werden soll.

Sonstige

  • Personalstammdaten
    • Kartennummer
    • Stempelungen verwenden = JA
  • Bei Bedarf auch:
  • Planungscode
    • Plansymbol für Import
    • div. andere Einstellungen zur Regelung, wie sich der Planungscode beim Stempeln verhält (mehr dazu hier)
  • Planungseinheit
    • Externes Kennzeichen
  • Aufgabe
    • Kurzzeichen

Stempelimport Web-Service

Die Stempelimport-Schnittstelle kann auch als Web-Service implementiert werden.