APAS – ATOSS Schnittstelle

Anwender-Doku FORMEL 1 

APAS – ATOSS Schnittstelle 


Inhalt 

APAS – ATOSS Schnittstelle.....................................................................................................1 

Inhalt___________________________________________________________ 1 

Änderungsnachweis ______________________________________________ 1 

Allgemein _______________________________________________________ 2 

Voraussetzungen: ________________________________________________ 2 

ATOSS Installationsparameter ändern - Pers. Korrekturwerte = Produktivitätsfaktor___ 2 

Für APAS wichtige Felder im ATOSS Personalstamm: _________________________ 9 

Installationen am ATOSS Server:___________________________________ 10 

Installation am Formel I Server ____________________________________ 14 

Schema überprüfen / anpassen ____________________________________ 15 

Starten der Schnittstelle: _________________________________________ 15 

Beispielabfragen ......................................................................................................................17 

Anfrage getCapacity _____________________________________________ 17 

Antwort getCapacityResponse_____________________________________ 18 

Anfrage getEmployee ____________________________________________ 23 

Antwort getEmployeeResponse____________________________________ 23 

Änderungsnachweis 

Datum Version des 

Dokuments 

Name Bemerkung 

29.06.05 1.0 Scherer Erstellung des Dokuments 

30.06.05 Scherer Im Schema muß minOccurs=“0“ 

stehen 

13.07.05 Scherer Installer 

26.07.05 Bärwinkel / 

Scherer 

div. Korrekturen 

29.06.2004 © CARDIS GmbH & Co. KG, Murnau, 2005 Seite / 

24 

1



Allgemein 

Die Schnittstelle funktioniert folgendermaßen: 

o APAS stellt SOAP Anfrage an F1 Server 

o COMM-Baustein (java vom Ulf Pietruschka) 

o IP-Kommunikation mit dem ATOSS Server 

o Anfragen beantwortet das Perl Script 

/home/tarisadm/taris/bincust/tkp_schnittstelle.pl, welches auch im Hintergrund 

immer läuft 

o Perl Script nutzt Reports, um aus ATOSS die Mitarbeiterliste und die freien 

Tage der nächsten Wochen herausfinden 

Voraussetzungen: 

ATOSS Installationsparameter ändern - Pers. Korrekturwerte = 

Produktivitätsfaktor 

In APAS wird für jeden Mitarbeiter ein Produktivitätsfaktor verwendet. Das dient dazu, z.B. 

Azubis nur mit z.B. 50 % zu bewerten. 

Dieser Wert (z.B. 50) muß im ATOSS Personalstamm unter "Pers. Korrekturwerte" 

angegeben werden: 

Persönliche Korrekturwerte werden nur für spezielle Saldenregeln oder Bezugsarten 

verwendet. Der erste dieser vier Werte darf künftig nur noch für die APAS Schnittstelle 

verwendet werden. Falls Sie dieses Feld in einer Saldenregel oder Bezugsart verwenden 


24 

2



(und das kommt sehr selten vor), bitte die Saldenregel entsprechend abändern und auf die 

Felder 2-4 ausweichen. Prüfen Sie sicherheitshalber, ob bei irgendeinem Mitarbeiter dieses 

Feld NICHT auf 0:00 steht. 

Das Feld ist standardmäßig ein Wert in Stunden und Minuten und hat die Darstellung "0:00". 

Diese Darstellung wird nun auf "0,0" umgestellt, um für die Eingabe von Prozentzahlen 

besser geeignet zu sein. 

Hierzu gehen Sie folgendermaßen vor. 

- F2 Taste drücken 

- CHGINST eingeben 


24 

3



- AZM I anklicken 

- Typ pers. Korrekturwerte auf "d..." stellen (also erster Buchstabe statt "m" ein "d") 


24 

4



- Taris Prozesse beenden und neu starten 

Dieses Feld im Personalstamm ist normalerweise Null, weil es nur für spezielle Saldenregeln 

oder Bezugsarten verwendet wird. 

Um bei allen Mitarbeitern 100,0 = 100 % als Standardwert einzutragen, können Sie das 

entweder bei allen Mitarbeitern einzeln eintragen oder es wird „Massenänderungen im 

Personalstamm“ verwendet wie folgt: 

Vorgehensweise: 

- Anmelden als "taris" 

- Folgenden Menübefehl auswählen: 

- in der Personalliste auf "Alle" oben klicken, diese Schaltfläche erscheint erst, nachdem man 

den Pfeil nach rechts anklickt. 


24 

5



- es sind alle markiert 

- links unten auf "Bearbeiten" klicken 

- in der Zeile "Pers. Korrekturwerte" die erste Zeile so eingeben: 


24 

6



- Übernehmen anklicken 

- Schließen anklicken (2x) 

Ergebnis: 

In allen Personalstammsätzen steht unter "Pers. Korrekturwerte" in der ersten Zeile 100 


24 

7




24 

8



Für APAS wichtige Felder im ATOSS Personalstamm: 

- Im Feld "Abteilung" muß Firma und Filialenummer jeweils zweistellig stehen, danach 

kann eine Abteilung angehängt werden, z.B. 0102Werkst wäre Firma = 01, Filiale = 

02, Abteilung = Werkst. 

- Unter „Kennzeichen“ wird im zehnten Feld „M“ für Funktionscode „Monteur“ oder „S“ 

für „Serviceberater“ angegeben 

- Unter „Kennzeichen“ wird im elften Feld die Teamnummer stehen 

- Im Feld "Pers. Korrekturwerte 1" muß der gewünschte Produktivitätsfaktor stehen 

(hier 50,0 für 50% wie oben erwähnt). 

- Im Feld "Durchschn. tägl. Sollarbeitszeit" muß ein gültiger Wert stehen 

- Im Feld „Werk“ (sichtbar nach Klick auf „Adresse“) muß die Mitarbeiternummer in 

APAS stehen (meist identisch mit der Formel I Monteurnummer), diese wird als 

Mitarbeiternummer übergeben. Es ist also wichtig, dass die Nummerierung der 

Mitarbeiter in APAS bekannt ist und in ATOSS als Werknummer eingetragen ist. 

Diese Felder werden an APAS im XML Format übergeben: 

- 

01 

02 

Firma 01, Filiale 

02 

Meier 


24 

9



Peter 

17 

Werkst 

M 

1 

Team 1 

2003-08- 

01 

7:45 

50 

 

Installationen am ATOSS Server: 

- apas_schnittstelle.pl bzw. apas_schnittstelle_linux.pl muß in %TARIS%\bincust\apas 

existieren 

- tkpgetcapacity.report bzw. tkpgetcapacity_linux.report muß in %TARIS%\reports_ge 

existieren 

- tkpgetemployee.report bzw. tkpgetemployee_linux.report muß in 

%TARIS%\reports_ge existieren 

- apas_tladen.bat bzw. apas_tladen.sh muß in %TARIS%\bincust\apas existieren, muß 

per at-Befehl jede Nacht laufen, damit für die nächsten 3 Monate die 

Tagesinformationen geladen sind. 

Das Installieren der Dateien unter WINDOWS erledigt der Installer APAS ATOSS 

Schnittstelle: 


24 

10



„Weiter“ 

Das TARIS Verzeichnis wird bei Windows automatisch ausgewählt. Unter LINUX wählen 

Sie das per Samba freigegebene Netzlaufwerk TARIS aus (\\c00020\taris) 

„Weiter“ 


24 

11



„Installieren“ 

Unter LINUX Rechte setzen: 

Durch das Installieren via Samba sind Eigentümer und Gruppe noch zu setzen. Das muß als 

root gemacht werden!: 

root@c00020:~/taris/bincust > chown -R tarisadm.taris apas 

Auch die Rechte sind anzupassen: 

tarisadm@c00020:~/taris/bincust/apas > ls -l 

insgesamt 32 

-rw-r----- 1 tarisadm users 15502 Apr 14 13:51 

apas_schnittstelle_linux 

.pl 


apas_tladen.sh 

-rw-r----- 1 tarisadm users 584 Apr 14 13:51 startapas 

-rw-r----- 1 tarisadm users 327 Apr 14 13:51 stopapas 


24 

12




stopapas_mit_file 

tarisadm@c00020:~/taris/bincust/apas > cd .. 

tarisadm@c00020:~/taris/bincust > ls -ld apas 

drwxr-x--- 2 tarisadm users 240 Apr 14 15:58 apas 

tarisadm@c00020:~/taris/bincust > chmod -R 777 apas 

tarisadm@c00020:~/taris/bincust > ls -ld apas 

drwxrwxrwx 2 tarisadm users 240 Apr 14 15:58 apas 

tarisadm@c00020:~/taris/bincust > 

Unter LINUX cronjob eintragen: 

crontab –e 

0 21 * * * /home/tarisadm/taris/bincust/dcsbackup.sh 

30 23 * * * /home/tarisadm/taris/bincust/daily_jobs 

0 3 * * * /home/tarisadm/taris/bincust/apas/apas_tladen.sh 

~ 

~ 

Unter Windows at-Befehl eintragen: 

Folgenden at-Befehl hat der Installer automatisch ausgeführt: 

Microsoft Windows 2000 [Version 5.00.2195] 

(C) Copyright 1985-2000 Microsoft Corp. 

C:\>at 

Statuskenn. Tag Zeit Befehlszeile 

-------------------------------------------------------------------- 

----------- 

25 Jeden Mo Di Mi Do Fr Sa 04:00 AM 

C:\programme\taris\bincust\apas\apas_tladen.bat 

Manuelle Installation: 

Hierfür dient das Script %TARIS%\bincust\apas\atbefehl_apas.bat. 

Starten Sie es, damit dieser at-Befehl um 4:00 eingetragen ist. 

Hinweis: bei Update eines ATOSS LINUX Servers mit dem Installer kann der at-Befehl auf 

dem Installations-PC wieder gelöscht werden. 

C:\Dokumente und Einstellungen\ascherer>at 

Statuskenn. Tag Zeit Befehlszeile 

------------------------------------------------------------------------------- 

... 

25 Jeden Mo Di Mi Do Fr Sa 04:00 AM 

C:\programme\taris\bincust\apas\apas_tladen.bat 

26 Jeden Fr 12:30 PM perl 

C:\programme\taris\scripts\clrbooklog.pl 


C:\programme\taris\scripts\clrdlerror.pl 30 


C:\programme\taris\scripts\clrdschlog.pl 

3 Jeden Mo Di Mi Do Fr 10:15 AM c:\taris\bincust\tabschl.bat 

29.06.2004 

24 

© CARDIS GmbH & Co. KG, Murnau, 2005 Seite / 

13



4 Jeden Mo Di Mi Do Fr 10:00 AM c:\taris\bincust\tladen.bat 

C:\Dokumente und Einstellungen\ascherer>at 25 /delete 

Installation am Formel I Server 

- COMM Baustein muß in /home/bbx/soap installiert sein (ist i.A. von der SAM2 und KSD 

Schnittstelle bereits installiert) 

/etc/hosts 

Der Server für die Zeiterfassung heißt lt. /etc/host-Datei IMMER timeserver, egal, ob ATOSS 

oder F1Time im Einsatz ist: 

Beispiel: ATOSS Server hat die IP-Adresse 10.2.227.37 

Eintrag in /etc/hosts: 

10.2.227.37 c00037.veyhle.group-net.de c00037 timeserver 

Beispiel: F1 Time Server ist Formel I Server: 

Eintrag in /etc/hosts: 

127.0.0.1 timeserver 

Test der Verbindung: 

C00020:/etc # ping timeserver 

PING timeserver (10.201.4.69): 56 data bytes 

64 bytes from 10.201.4.69: icmp_seq=0 ttl=128 time=1.128 ms 

64 bytes from 10.201.4.69: icmp_seq=1 ttl=128 time=0.489 ms 

--- timeserver ping statistics --- 

2 packets transmitted, 2 packets received, 0% packet loss 

round-trip min/avg/max = 0.489/0.808/1.128 ms 

mit Ctrl-C abbrechen 

Angaben in /home/bbx/soap/lib/comm.properties prüfen / ändern: 

=> Vorteil: Durch den hosts-Eintrag hat die Datei 

/home/bbx/soap/lib/comm.properties identische Einträge für beide Zeiterfassungen: 

... 

... 

... 

getEmployee.HTTPEncoding=ISO-8859-1 

getEmployee.SocketConnector=timeserver:12001:Cp1252 

getEmployee.PublishedServiceName=/getemployee 

getEmployee.SchemaLocations=../schemas/soapenvelope.xsd:../schemas/g 

etemployee.x 

sd 

getEmployee.DatatypeConverter=true 

getEmployee.SOAPEncArray.Type=Employee 

getEmployee.SOAPEncArray.Element=Result 

getEmployee.CustomAttributes.xmlns=http://www.themindelectric.com/pa 

ckage/com.et 

enso.dcs.comm/ 

getEmployee.DateTimeElements=companyJoinDate 


24 

14



getCapacity.HTTPEncoding=ISO-8859-1 

getCapacity.SocketConnector=timeserver:12001:Cp1252 

getCapacity.PublishedServiceName=/getcapacity 

getCapacity.SchemaLocations=../schemas/soapenvelope.xsd:../schemas/g 

etcapacity.x 

sd 

getCapacity.DatatypeConverter=true 

getCapacity.SOAPEncArray.Type=Capacity 

getCapacity.SOAPEncArray.Element=Result 

#getCapacity.CustomAttributes.xmlns=http://www.themindelectric.com/p 

ackage/com.e 

tenso.dcs.comm/ 

#getCapacity.DateTimeElements=notAvailableFrom,notAvailableTo 

… 

… 

Bitte beachten: 

- timeserver (=ATOSS Server) 

- 12001 (=Portnummer) 

- die letzten Zeilen getCapacity.CustomAttributes und 

getCapacity.DateTimeElements müssen durch das „#“ Zeichen 

auskommentiert sein. 

Schema überprüfen / anpassen 

Im Verzeichnis /home/bbx/soap/schemas muß im Schema getcapacity.xsd bei den 

Feldern datefrom dateto minOccurs=“0“ stehen: 

admin@addonslinux2:/home/bbx/soap/schemas > cat getcapacity.xsd 

 

 

 

 

 

 

 

 

 

 

 

 

 

admin@addonslinux2:/home/bbx/soap/schemas > 

Starten der Schnittstelle: 

- der COMM-Baustein muß am Formel I Server laufen. Nach jeder Änderung in 

comm.properties (s.o.) muß er mit Aufruf von stop.sh und start.sh oder einfach 

init.sh neu gestartet werden: Das muß als root gemacht werden! 

sh-2.05$ su 

Password: 

bash-2.05# pwd 


24 

15



/home/bbx/soap 

bash-2.05# ./init.sh 

Bei Neustart des COMM Bausteins mit init.sh wird nichts ausgegeben. Man sieht den 

Start des COMM-Bausteins in der Protokoll-Datei /home/bbx/soap/output/COMM.log: 

2005-04-14 14:51:33,345 [main ] OFF XMLRPCServer - Starting COMM 

2.09 

2005-04-14 14:51:33,367 [main ] INFO XMLRPCServer - Setting 

listening port to 8 

004 


threadpoolsize to 5 


HTTPTimeout to 6000 

0 


URLPrefix to /COMM, 

/glue 

- die APAS-Schnittstelle muß am ATOSS Server laufen: sie wird in 

%TARIS%\bincust\apas so gestartet: 

Start unter WINDOWS: 

C:\Programme\taris\bincust\apas>perl apas_schnittstelle.pl 

[APAS-Schnittstelle-ATOSS APAS_schnittstelle.pl Port:12001] 

TARIS-Verzeichnis: C:\Programme\taris 

. 

TIPP: Wird die Schnittstelle in %TARIS%\bincust\strtaris.bat eingetragen, wird sie 

automatisch mitgestartet, wenn die ATOSS Prozesse gestartet werden. 

Start/Stop unter LINUX: 

tarisadm@c00020:~/taris/bincust/apas > startapas 

Start der Schnittstelle zwischen ATOSS und APAS 

tarisadm@c00020:~/taris/bincust/apas > nohup: appending output to 

`nohup.out' 

tarisadm@c00020:~/taris/bincust/apas > ps -ef | grep apas_schnitt 

tarisadm 22068 1 0 11:31 pts/37 00:00:00 perl 

/home/tarisadm/taris/bincus 

t/apas/apas_schnittstelle_linux.pl 

tarisadm 22941 30068 0 11:31 pts/37 00:00:00 grep apas_schnitt 

tarisadm@c00020:~/taris/bincust/apas > stopapas 

Schnittstelle zwischen ATOSS und APAS wird beendet 

tarisadm@c00020:~/taris/bincust/apas > 

TIPP: Wird die Schnittstelle in %TARIS%/bin/starttaris eingetragen, wird sie 

automatisch mitgestartet, wenn die ATOSS Prozesse gestartet werden. 


24 

16



Anfrage getCapacity 

Beispielabfragen 

- 

- 

- 

* 

* 

2004-01-01T09:30:47- 

05:00 

2004-12-31T09:30:47- 

05:00 

 

 

 

- Datum von bis darf leer sein: 

- 

- 

- 

* 

* 

 

 

 

- Wenn das Datum leer ist, wird als Zeitraum ab heutigem Datum zurückgegeben. Länge ist 3 

Monate. 

- Timeout ist einstellbar in APAS / XML Datei 


24 

17



Antwort getCapacityResponse 

 

- 

- 

- 

- 

- 

01 

01 


01 

__MUSTERMECHANIKER___ 

 

 

2004-10- 

03T00:01:00.000 

2004-10- 

03T23:59:00.000 

F 

 

- 

01 

01 


01 


 

 

2004-10- 

31T00:01:00.000 

2004-10- 

31T23:59:00.000 

F 

 

- 

01 

01 


01 


 

 

2004-11- 

01T00:01:00.000 

2004-11- 

01T23:59:00.000 

F 

 


24 

18



- 

01 

01 


01 


 

 

2004-11- 

17T00:01:00.000 

2004-11- 

17T23:59:00.000 

F 

 

- 

01 

01 


01 


 

 

2004-12- 

25T00:01:00.000 

2004-12- 

25T23:59:00.000 

F 

 

- 

01 

01 


01 


 

 

2004-12- 

26T00:01:00.000 

2004-12- 

26T23:59:00.000 

F 

 

- 

01 

01 


01 

Botte 

Thomas 

213 

2004-10- 

03T00:01:00.000 

2004-10- 

03T23:59:00.000 


24 

19



F 

 

- 

01 

01 


01 

Botte 

Thomas 

213 

2004-10- 

31T00:01:00.000 

2004-10- 

31T23:59:00.000 

F 

 

- 

01 

01 


01 

Botte 

Thomas 

213 

2004-11- 

01T00:01:00.000 

2004-11- 

01T23:59:00.000 

F 

 

- 

01 

01 


01 

Botte 

Thomas 

213 

2004-11- 

17T00:01:00.000 

2004-11- 

17T23:59:00.000 

F 

 

- 

01 

01 


01 

Botte 

Thomas 

213 

2004-12- 

24T00:01:00.000 


24 

20



2004-12- 

24T12:00:00.000 

uh 

 

- 

01 

01 


01 

Botte 

Thomas 

213 

2004-12- 

25T00:01:00.000 

2004-12- 

25T23:59:00.000 

F 

 

- 

01 

01 


01 

Botte 

Thomas 

213 

2004-12- 

26T00:01:00.000 

2004-12- 

26T23:59:00.000 

F 

 

- 

01 

01 


01 

Brenner 

Rainer 

003 

2004-10- 

03T00:01:00.000 

2004-10- 

03T23:59:00.000 

F 

 

- 

01 

01 


01 

Brenner 

Rainer 

003 


24 

21



... 

... 

2004-10- 

31T00:01:00.000 

2004-10- 

31T23:59:00.000 

F 

 

- 

01 

01 


01 

Brenner 

Rainer 

003 

2004-11- 

01T00:01:00.000 

2004-11- 

01T23:59:00.000 

F 

 

- 

01 

01 


01 

Brenner 

Rainer 

003 

2004-11- 

17T00:01:00.000 

2004-11- 

17T23:59:00.000 

F 

 

- 

01 

01 


01 

Brenner 

Rainer 

003 

2004-12- 

24T00:01:00.000 

2004-12- 

24T12:00:00.000 

uh 

 

 

 

 

 


24 

22



Besonderheiten: 

- ohne Namespace nach "



... 

... 

8:00 

100 

 

- 

01 

01 


01 

Botte 

Thomas 

213 

Werkst 

M 

1 

Team 1 

2002-06-26 

 

100 

 


24 

24

APAS – ATOSS Schnittstelle

Erfolgreiche ePaper selbst erstellen

Template löschen?

Als Template speichern?