Anwender-Doku FORMEL 1 APAS ATOSS Schnittstelle. APAS ATOSS Schnittstelle. Inhalt. Änderungsnachweis

Transkript

1 Inhalt...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 Name Bemerkung Dokuments Scherer Erstellung des Dokuments Scherer Im Schema muß minoccurs= 0 stehen Scherer Installer Bärwinkel / Scherer div. Korrekturen 1

2 Allgemein Die Schnittstelle funktioniert folgendermaßen: o o o o o APAS stellt SOAP Anfrage an F1 Server COMM-Baustein (java vom Ulf Pietruschka) IP-Kommunikation mit dem ATOSS Server Anfragen beantwortet das Perl Script /home/tarisadm/taris/bincust/tkp_schnittstelle.pl, welches auch im Hintergrund immer läuft 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 2

3 (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 3

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

5 - 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. 5

6 - es sind alle markiert - links unten auf "Bearbeiten" klicken - in der Zeile "Pers. Korrekturwerte" die erste Zeile so eingeben: 6

7 - Übernehmen anklicken - Schließen anklicken (2x) Ergebnis: In allen Personalstammsätzen steht unter "Pers. Korrekturwerte" in der ersten Zeile 100 7

8 8

9 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: - <employee> <subsidiarycode>02</subsidiarycode> 02</subsidiaryName> <name>meier</name> 9

10 <firstname>peter</firstname> <employeeno>17</employeeno> <department>werkst</department> <functioncode>m</functioncode> <teamno>1</teamno> <teamname>team 1</teamName> <companyjoindate> </companyJoinDate> <workinghoursperday>7:45</workinghoursperd ay> <productivityfactor>50</productivityfactor> </employee> 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: 10

11 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 11

12 Installieren Unter LINUX Rechte setzen: Durch das Installieren via Samba sind Eigentümer und Gruppe noch zu setzen. Das muß als root gemacht werden!: > chown -R tarisadm.taris apas Auch die Rechte sind anzupassen: > ls -l insgesamt 32 -rw-r tarisadm users Apr 14 13:51 apas_schnittstelle_linux.pl -rw-r tarisadm users 492 Apr 14 13:51 apas_tladen.sh -rw-r tarisadm users 584 Apr 14 13:51 startapas -rw-r tarisadm users 327 Apr 14 13:51 stopapas 12

13 -rw-r tarisadm users 461 Apr 14 13:51 stopapas_mit_file tarisadm@c00020:~/taris/bincust/apas > cd.. tarisadm@c00020:~/taris/bincust > ls -ld apas drwxr-x--- 2 tarisadm users 0 Apr 14 15:58 apas tarisadm@c00020:~/taris/bincust > chmod -R 777 apas tarisadm@c00020:~/taris/bincust > ls -ld apas drwxrwxrwx 2 tarisadm users 0 Apr 14 15:58 apas tarisadm@c00020:~/taris/bincust > Unter LINUX cronjob eintragen: crontab e 0 21 * * * /home/tarisadm/taris/bincust/dcsbackup.sh * * * /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 ] (C) Copyright Microsoft Corp. C:\>at Statuskenn. Tag Zeit Befehlszeile 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 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 27 Jeden Fr 12:35 PM perl C:\programme\taris\scripts\clrdlerror.pl Jeden Fr 12:40 PM perl C:\programme\taris\scripts\clrdschlog.pl 3 Jeden Mo Di Mi Do Fr 10:15 AM c:\taris\bincust\tabschl.bat 13

14 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 Eintrag in /etc/hosts: c00037.veyhle.group-net.de c00037 timeserver Beispiel: F1 Time Server ist Formel I Server: Eintrag in /etc/hosts: timeserver Test der Verbindung: C00020:/etc # ping timeserver PING timeserver ( ): 56 data bytes 64 bytes from : icmp_seq=0 ttl=128 time=1.128 ms 64 bytes from : icmp_seq=1 ttl=128 time=0.489 ms --- timeserver ping statistics 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 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= ckage/com.et enso.dcs.comm/ getemployee.datetimeelements=companyjoindate 14

15 getcapacity.httpencoding=iso 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= ackage/com.e tenso.dcs.comm/ #getcapacity.datetimeelements=notavailablefrom,notavailableto Bitte beachten: - timeserver (=ATOSS Server) (=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 <?xml version="1.0" encoding="iso "?> <xsd:schema xmlns:xsd=" targetnamespace=" /tempuri.org/com.etenso.dcs.comm.getcapacity"> <xsd:element name="getcapacity"> <xsd:complextype> <xsd:sequence> <xsd:element name="company" nillable="true" type="xsd:string"/> <xsd:element name="subsidiary" nillable="true" type="xsd:string"/> <xsd:element name="periodfrom" nillable="true" type="xsd:date" minoccurs="0"/> <xsd:element name="periodto" nillable="true" type="xsd:date" minoccurs="0"/> </xsd:sequence> </xsd:complextype> </xsd:element> </xsd:schema> 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 15

16 /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: :51:33,345 [main ] OFF XMLRPCServer - Starting COMM :51:33,367 [main ] INFO XMLRPCServer - Setting listening port to :51:33,370 [main ] INFO XMLRPCServer - Setting threadpoolsize to :51:33,370 [main ] INFO XMLRPCServer - Setting HTTPTimeout to :51:33,373 [main ] INFO XMLRPCServer - Setting 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 :31 pts/37 00:00:00 perl /home/tarisadm/taris/bincus t/apas/apas_schnittstelle_linux.pl tarisadm :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. 16

17 Beispielabfragen Anfrage getcapacity - <SOAP-ENV:Envelope xmlns:soap- ENV=" xmlns:soap- ENC=" xmlns:xsi=" xmlns:xsd=" SOAP- ENV:encodingStyle=" - <SOAP-ENV:Body> - <m:getcapacity xmlns:m=" city"> <company xsi:type="xsd:string">*</company> <subsidiary xsi:type="xsd:string">*</subsidiary> <periodfrom xsi:type="xsd:datetime"> t09:30:47-05:00</periodfrom> <periodto xsi:type="xsd:datetime"> t09:30:47-05:00</periodto> </m:getcapacity> </SOAP-ENV:Body> </SOAP-ENV:Envelope> - Datum von bis darf leer sein: - <SOAP-ENV:Envelope xmlns:soap- ENV=" xmlns:soap- ENC=" xmlns:xsi=" xmlns:xsd=" SOAP- ENV:encodingStyle=" - <SOAP-ENV:Body> - <m:getcapacity xmlns:m=" city"> <company xsi:type="xsd:string">*</company> <subsidiary xsi:type="xsd:string">*</subsidiary> </m:getcapacity> </SOAP-ENV:Body> </SOAP-ENV:Envelope> - 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 17

18 Antwort getcapacityresponse <?xml version="1.0" encoding="iso "?> - <SOAP-ENV:Envelope xmlns:soap- ENV=" xmlns:xsi=" xmlns:xsd=" xmlns:soapenc=" - <SOAP-ENV:Body> - <getcapacityresponse> - <Result xsi:type="soapenc:array" soapenc:arraytype="capacity[]"> <name> MUSTERMECHANIKER </name> <firstname /> <employeeno /> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> <name> MUSTERMECHANIKER </name> <firstname /> <employeeno /> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> <name> MUSTERMECHANIKER </name> <firstname /> <employeeno /> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> 18

19 <name> MUSTERMECHANIKER </name> <firstname /> <employeeno /> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> <name> MUSTERMECHANIKER </name> <firstname /> <employeeno /> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> <name> MUSTERMECHANIKER </name> <firstname /> <employeeno /> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> <name>botte</name> <firstname>thomas</firstname> <employeeno>213</employeeno> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> 19

20 <name>botte</name> <firstname>thomas</firstname> <employeeno>213</employeeno> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> <name>botte</name> <firstname>thomas</firstname> <employeeno>213</employeeno> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> <name>botte</name> <firstname>thomas</firstname> <employeeno>213</employeeno> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> <name>botte</name> <firstname>thomas</firstname> <employeeno>213</employeeno> <notavailablefrom> T00:01:00.000</notAvailableFrom> 20

21 <notavailableto> T12:00:00.000</notAvailableTo> <reason>uh</reason> <name>botte</name> <firstname>thomas</firstname> <employeeno>213</employeeno> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> <name>botte</name> <firstname>thomas</firstname> <employeeno>213</employeeno> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> <name>brenner</name> <firstname>rainer</firstname> <employeeno>003</employeeno> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> <name>brenner</name> <firstname>rainer</firstname> <employeeno>003</employeeno> 21

22 <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> <name>brenner</name> <firstname>rainer</firstname> <employeeno>003</employeeno> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> <name>brenner</name> <firstname>rainer</firstname> <employeeno>003</employeeno> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T23:59:00.000</notAvailableTo> <name>brenner</name> <firstname>rainer</firstname> <employeeno>003</employeeno> <notavailablefrom> T00:01:00.000</notAvailableFrom> <notavailableto> T12:00:00.000</notAvailableTo> <reason>uh</reason> </Result> </getcapacityresponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope> 22

23 Besonderheiten: - ohne Namespace nach "<getcapacityresponse..." - <notavailablefrom> W3C konform, damit man wie besprochen auch halbe Tage (bis 12:00 Uhr) übergeben kann. Anfrage getemployee - <SOAP-ENV:Envelope xmlns:soap- ENV=" xmlns:soap- ENC=" xmlns:xsi=" xmlns:xsd=" SOAP- ENV:encodingStyle=" - <SOAP-ENV:Body> - <m:getemployee xmlns:m=" oyee"> <company xsi:type="xsd:string">*</company> <subsidiary xsi:type="xsd:string">*</subsidiary> </m:getemployee> </SOAP-ENV:Body> </SOAP-ENV:Envelope> Antwort getemployeeresponse <?xml version="1.0" encoding="iso "?> - <SOAP-ENV:Envelope xmlns:soap- ENV=" xmlns:xsi=" xmlns:xsd=" xmlns:soapenc=" - <SOAP-ENV:Body> - <getemployeeresponse> - <Result xsi:type="soapenc:array" soapenc:arraytype="employee[]"> - <employee> <name> MUSTERMECHANIKER </name> <firstname /> <employeeno /> <department>werkst</department> <functioncode>m</functioncode> <teamno>1</teamno> <teamname>team 1</teamName> <companyjoindate> </companyjoindate> 23

24 <workinghoursperday>8:00</workinghoursperday> <productivityfactor>100</productivityfactor> </employee> - <employee> <name>botte</name> <firstname>thomas</firstname> <employeeno>213</employeeno> <department>werkst</department> <functioncode>m</functioncode> <teamno>1</teamno> <teamname>team 1</teamName> <companyjoindate> </companyjoindate> <workinghoursperday /> <productivityfactor>100</productivityfactor> </employee>