Aufbau Importdatei
Beispiel einer Importdatei:
TYP=Kommt|AusweisPersonalnr=0004455238022|von=01.04.2013 06:53:35
TYP=Geht|AusweisPersonalnr=0004455238022|bis=01.04.2013 11:00:12
TYP=Kommt|AusweisPersonalnr=0004502402020|von=01.08.2014 13:10:45|Quelle=ESUED
TYP=Kommt|AusweisPersonalnr=0004393422671|von=01.08.2014 13:17:55|Quelle=ESUED
TYP=Geht|AusweisPersonalnr=0004502407441|bis=01.08.2014 14:32:40|Quelle=ESUED
TYP=Geht|AusweisPersonalnr=0004393422945|bis=01.08.2014 14:39:34|Quelle=ESUED
TYP=Geht|AusweisPersonalnr=0004502405205|bis=01.08.2014 14:42:22|Quelle=ESUED
TYP=Kommt|AusweisPersonalnr=0004490940985|von=06.10.2015 16:15:12|AusweisZeitart=000000000000D|AusweisKostenstelle=1|Quelle=ESUED
TYP=Kommt|AusweisPersonalnr=0004490940985|von=06.10.2015 16:15:23|AusweisKostenstelle=1|Quelle=ESUED
TYP=Kommt|AusweisPersonalnr=0004490940985|von=06.10.2015 16:15:32|AusweisZeitart=P|AusweisKostenstelle=1|AusweisKostentraeger =22|Quelle=ESUED
(hier kann auch die Personalnr= stehen)
Feldbeschreibung:
TYP|PersonalNr/AusweisPersonalNr|von/bis|Quelle|
| - Feldtrenner
= - Werttrenner
#13#10 - Satztrenner. (CRLF)
Felder: |
|
---|---|
TYP | Buchungstyp [Kommt/Geht] |
PersonalNr | Tabelle CM_PERSONAL.PERSONALNR des Mitarbeiters |
AusweisPersonalNr | Tabelle ZT_AUSWEIS.NR - Ausweisnummer des Mitarbeiters. |
von | Datum+ Zeit der Kommt-Buchung (dd.mm.yyyy hh:nn:ss) |
bis | Datum+ Zeit Geht -Buchung -//- |
Quelle | PC-Name oder Terminalname oder Handyname. (kann auch leer bleiben) |
Optional Felder
AusweisZeitart, AusweisKostenstelle, AusweisKostentraeger.
Der Dateiname kann frei gewählt werden, zum Beispiel: „Buch_2015_10_16.txt“ oder „Buch20151016.sic“.
Die Datei sollte Ansi codiert sein. Unicode führt zu Problemen beim einlesen.
Der einfache Weg ist es eine Datei mit obigem Aufbau in den Unterordner „Buchungen“ zu legen, damit diese vom ZTService eingelesen und verarbeitet werden können.
Anschließend wird die Datei aus dem Ordner „Buchungen“ wieder gelöscht.
Dauerbuchung:
Beispiel für eine Dauerbuchung:
TYP=STUNDEN|Personalnr=38|Datum=29.04.2016|STD=14400|Text=Test-Text|ZEITART=GLZ|Kostenstelle=1|Kostentraeger=2|Quelle=ESUED
Die Zeitangabe (|STD=14400|Text) in dem Datensatz ist in Sekunden.
Gerätebuchung:
Beispiel für eine Gerätebuchung:
TYP=KOMMT|AusweisGeraeteNr=123456|Zeitart=A|VON=02.04.2019 08:00|Kostenstelle=10|Kostentraeger=200|Quelle=Testgerät
TYP=GEHT||AusweisGeraetenr=123456|BIS=02.04.2019 10:30|Quelle= Testgerät
Hier wird eine „Kommen“ und „Gehen“ Buchung erzeugt.
Beispiel für eine Dauerbuchung bei Geräten:
TYP=Stunden|GeraeteNr=100|Datum=09.04.2019|ZEITART=A|Kostenstelle=2001|Kostentraeger=KT1|Quelle=Dauer|STD=108000
TYP=Stunden|AusweisGeraeteNr=123456|Datum=10.04.2019|ZEITART=A|Kostenstelle=2001|Kostentraeger=KT1|Quelle=Dauer|STD=360000
Beispiel für eine Dauerbuchung bei Geräten mit Zählerstand:
TYP=Standard|GeraeteNr=100|Datum=03.04.2019|ZEITART=A|Kostenstelle=2001|Kostentraeger=KT1|Quelle=Dauer|BS_START=20|BS_ENDE=50|STD=108000
TYP=Standard|AusweisGeraeteNr=123456|Datum=05.04.2019|ZEITART=A|Kostenstelle=2001|Kostentraeger=KT1|Quelle=Dauer|BS_START=50|BS_ENDE=150|STD=360000
Die Zuordnung des Geräts kann in allen Beispielen sowohl über das Feld „GeraeteNr“ oder „AusweisGeraeteNr“ erfolgen. Wird beides zusammen übergeben, erfolgt keine Plausibilitätsprüfung, ob diese zueinander passen.
Die Felder „BS_START“ und „BS_ENDE“ dienen nur als Information. Eine Berechnung erfolgt hier nicht und muss schon vorher erfolgen. Werden Zählerstände übergeben muss zusätzlich das Feld „STD“ mit übergeben werden. Als „TYP“ ist hier zwingend „Standard“ anzugeben. Die Angabe (STD=14400) in dem Datensatz ist in Sekunden anzugeben.
Hinweis: Die Felder BS_START, BS_ENDE und STD sind Felder mit ganzen Zahlen (Integer).