Import Zeitstempelungen: Unterschied zwischen den Versionen

Aktuelle Version vom 15. September 2025, 09:43 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.

Feldname	Feldlänge	Feldformat	Entspricht im Alex:
Satzbeschreibung bei Zeitstempel-Import Format = "Standard"
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

Feldname	Feldformat	Entspricht im Alex:
Satzbeschreibung bei Zeitstempel-Import Format = "Standard semicolon"
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)
ColorMarker	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

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

@@ Zeile 1: / Zeile 1: @@
 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"==
   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"
-|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===
@@ 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
+{| 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"
-|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)
+|ColorMarker||alphanum||Aufgabe für Kommt-Geht (Object ID)
 |}
+<span><br /></span>
 ===Muster-Beispiele===
@@ Zeile 88: / Zeile 90: @@
 ... um 9:00 zum normalem Dienst gekommen ist und als Text "hallo" erfasst hat:
-;2006-01-01 09:00;0;hallo
+;2006-01-01 09:00;0;;hallo
 ... um 9:00 vom Arzt gekommen ist:
@@ Zeile 101: / Zeile 103: @@
 ==Parametrierung==
+===Systemeinstellungen===
 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:
-** 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.
-**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===
+*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 [[Planungscode#Zeiterfassung.2FStempeluhr|(mehr dazu hier)]]
+*Planungseinheit
+**Externes Kennzeichen
+*Aufgabe
+**Kurzzeichen
-==Stempelimport Web-Service==
+==Weiterführende Links==
-Die Stempelimport-Schnittstelle muss nicht zwingend über eine File-Schnittstelle erfolgen, sondern könnte auch als Web-Service implementiert werden.
+[[Intern:Zeiterfassung_Aktivierung|Aktivierung]]
 [[Kategorie:Zeiterfassung]]