Import Zeitstempelungen: Unterschied zwischen den Versionen

 
(13 dazwischenliegende Versionen von 6 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
Stempelungen müssen nicht zwingend über die {{Alex}}-Stempeluhr erfasst werden.  
Stempelungen müssen nicht zwingend über die {{Alex}}-Stempeluhr erfasst werden.  


Für den Import von anderen Stempeluhren (KABA, Gantner, EMVS, Timecom ...) gibt es fünf unterschiedliche Import-Schnittstellen.
Für den Import von anderen Zeiterfassungssystemen gibt es aktuell fünf unterschiedliche Import-Schnittstellen:
 
Der Import kann über eine File-Schnittstelle oder über ein Web-Service erfolgen.


*{{Alex}}-Standard
*{{Alex}}-Standard Semicolon
*Gantner
*EMVS
*Timecom




<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" style="" border="1" cellspacing="50" cellpadding="4"  
{| class="wikitable" border=1 style="border-collapse:collapse; border-color:#E8E8E8; vertical-align:top" 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"'''
|-
|-
! Feldname!! Feldlänge!! Feldformat!! Entspricht im Alex:
!Feldname!!Feldlänge!!Feldformat!!Entspricht im Alex:
|-
|-
| Nr|| variabel|| alphanum., Länge ist einstellbar (default=20)||Personal - Kartennummer
|Nr||variabel||alphanum., Länge ist einstellbar (default=20)||Personal - Kartennummer
|-
|-
| DatumZeit|| 16|| JJJJ-MM-TT HH:MM||Datum und Zeit der Stempelung
|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
|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
|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
|Text||80||alphanum (optionaler freiwählbarer Text)||Kommt-Geht-Text
|-
|-
| PlanCode|| 20|| alphanum ||Planungseinheit für Kommt-Geht (Externes Kennzeichen, sonst Kurzzeichen)
|PlanCode||20||alphanum||Planungseinheit für Kommt-Geht (Externes Kennzeichen, sonst Kurzzeichen)
|}
|}


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


Zeile 60: Zeile 63:
  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" style="" border="1" cellspacing="50" cellpadding="3"  
{| class="wikitable" border=1 style="border-collapse:collapse; border-color:#E8E8E8; vertical-align:top" 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"'''
|-
|-
! Feldname!! Feldformat!! Entspricht im Alex:
!Feldname!!Feldformat!!Entspricht im Alex:
|-
|-
| Nr|| alphanum.||Personal - Kartennummer
|Nr||alphanum.||Personal - Kartennummer
|-
|-
| DatumZeit||JJJJ-MM-TT HH:MM||Datum und Zeit der Stempelung
|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
|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
|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
|Text||alphanum (optionaler freiwählbarer Text)||Kommt-Geht-Text
|-
|-
| PlanCode|| alphanum ||Planungseinheit für Kommt-Geht (Externes Kennzeichen, sonst Kurzzeichen)
|PlanCode||alphanum||Planungseinheit für Kommt-Geht (Externes Kennzeichen, sonst Kurzzeichen)
|-
|-
| ColorMark|| alphanum ||Aufgabe für Kommt-Geht (Kurzzeichen)
|ColorMark||alphanum||Aufgabe für Kommt-Geht (Object ID)
|}
|}


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


Zeile 88: Zeile 90:


... um 9:00 zum normalem Dienst gekommen ist und als Text "hallo" erfasst hat:
... um 9:00 zum normalem Dienst gekommen ist und als Text "hallo" erfasst hat:
  4711;2006-01-01 09:00;0;hallo
  4711;2006-01-01 09:00;0;;hallo


... um 9:00 vom Arzt gekommen ist:
... um 9:00 vom Arzt gekommen ist:
Zeile 104: Zeile 106:
In '''Systemeinstellungen - Zeiterfassung/Stempeluhr''' sind folgende Parameter zu setzen:
In '''Systemeinstellungen - Zeiterfassung/Stempeluhr''' sind folgende Parameter zu setzen:


{{AlexBild|Parametrierung im {{Alex}}|[[Datei:Systemeinstellungen Zeitstempelimport .png]]|}}
{{AlexBild|{{Alex}}-Parametrierung|[[Datei:Systemeinstellungen Zeitstempelimport .png]]|}}


*Zeitstempel-Import-Format zur Auswahl des Formats:  
*Zeitstempel-Import-Format zur Auswahl des Formats:  
** Standard
**Standard
** Standard Semicolon
**Standard Semicolon
** Gantner
**Gantner
** EMVS
**EMVS
** 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: Defaultwert 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.
*Zeiterfassung 'ComputationAgent' Intervall (180)[min]:
**Standardmäßig werden die Zeitkonten des Personals alle 180 Minuten neu durchgerechnet.
**Der Gesetzt Wert wird nur bei aktiver Zeiterfassung herangezogen.


===Sonstige===
===Sonstige===
*Personalstammdaten
*Personalstammdaten
**Kartennummer
**Kartennummer
Zeile 124: Zeile 130:
*Planungscode
*Planungscode
**Plansymbol für Import
**Plansymbol für Import
**div. andere Einstellungen zur Regelung, wie sich der Planungscode beim Stempeln verhält [[Planungscode#Zeiterfassung.2FStempeluhr|(mehr dazu hier)]]  
**div. andere Einstellungen zur Regelung, wie sich der Planungscode beim Stempeln verhält [[Planungscode#Zeiterfassung.2FStempeluhr|(mehr dazu hier)]]
*Planungseinheit
*Planungseinheit
**Externes Kennzeichen
**Externes Kennzeichen
*Farbmarkierung
*Aufgabe
**Kurzzeichen
**Kurzzeichen


==Stempelimport Web-Service==
==Weiterführende Links==
Die Stempelimport-Schnittstelle kann auch als Web-Service implementiert werden.
[[Intern:Zeiterfassung_Aktivierung|Aktivierung]]


[[Kategorie:Zeiterfassung]]
[[Kategorie:Zeiterfassung]]

Aktuelle Version vom 21. April 2023, 12:59 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



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.
  • Zeiterfassung 'ComputationAgent' Intervall (180)[min]:
    • Standardmäßig werden die Zeitkonten des Personals alle 180 Minuten neu durchgerechnet.
    • Der Gesetzt Wert wird nur bei aktiver Zeiterfassung herangezogen.

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

Weiterführende Links

Aktivierung