g3t7 [Main]
P5
Dieser Teilschritt erweitert unsere Applikation um die Anreicherung mit Webservices.
REST Webservices
Die Bereiche Mitarbeiterverwaltung und Userinformation stehen über REST-Webservices zur Verfügung.
Mitarbeiterverwaltung (Bertram Rützler)
- Endpoint: «rest/ma.server.php»
- Rückgabe-Parameter:
- status:
- 0 … alles OK
- 1 … keine Aktion ausgewählt
- 2 … ungültiger xpath (bei browse-funktion)
- xml:
- Antwort im xml-Format
- Beispiel-Aufruf: «rest/ma.test.phps»
- Parameter im Format RiddlParameterSimplex:
- action: UseCase (anlegen, bearbeiten, anzeigen, gehalt, archivieren)
- id: Mitarbeiter-ID
- area: wenn action=bearbeiten, dann zu bearbeitender Bereich (name,address,contact,employmentstatus)
- [firstname|givenname|surname]: neue Werte für area=name
- [street|postcode|city|province|country]: neue Werte für area=address
- [tel|email|bankaccount]: neue Werte für area=contact
- [type|salary|lastbonus]: neue Werte für area=employmentstatus
- Beispiel-Antwort: «rest/ma.test.php»
- Weiteres Service: XML-Browser für die Datei employees.xml
Userbase (Konrad Grimm)
to be added
SOAP Webservices
Dienstplansystem (Manuel Bauer)
Der Dienstplan ist mit sämtlichen UseCases via SOAP Webservice abrufbar.
- Details:siehe wsdl:/svc/wpService.php
- AufrufanweisungDas Webservice ist voll funktionstüchtig.Um diese Funktion zu prüfen, oder einfach als Codeschnipsel, wenn man das SOAP-Service einbinden möchte habe ich einen Client gebaut.Dieser ist zu finden unter:/svc/wpServiceClient.php
- Wochenplan anzeigen/svc/wpServiceClient.php?action=createweekZeigt den Wochenplan der CW 36 von 2009 an.
- Wochenplan erzeugen/svc/wpServiceClient.php?action=createweekErzeugt einen völlig zufälligen Dienstplan zwischen 2008 und 2012.
- Tag anzeigen/svc/wpServiceClient.php?action=getDayZeigt Dienstag in der CW36 2009 an.
- Schichten hinzufügen/svc/wpServiceClient.php?action=createdutylegt an besagtem Dienstag folgende Schicht an:<duty timefrom="16:00" timeuntil="16:05" employeeID="2" xsi:type="ns1:duty"/>
- Schichten entfernen/svc/wpServiceClient.php?action=removedutylöscht an besagtem Dienstag jedes Vorkommnis folgender Schicht :<duty timefrom="16:00" timeuntil="16:05" employeeID="2" xsi:type="ns1:duty"/>
Dokumentation
In diesem Abschnitt wird der Aufbau und die Struktur unseres Codes beschrieben.
Er soll zur Nachvollziehbarkeit dienen, uns aber auch Abstimmungsaufwand abnehmen.
Beschreibung der Struktur
- Stammverzeichnishier landen die gestylten UI php files die die Präsentationsschicht darstellen.keine Applikationslogik!
- datahier liegt der Datenstamm (die XML-Files) des projekts
- wpVerzeichnis der abgelegten Dienstpläne
- incin inc werden die Klassen und andere includes abgebildetBsp: Klassen; Funktionen die den Datenlayer abstrahieren sollen.
- opfür ausführbaren code der Klassen instanziert und Daten manipuliert, reine Skripte ohne Präsentationslogik.
- outhier findet userinteraktion statt. Zunächst mit html bausteinen die aus root mit includes oder mit ajax nachgeladen wird.
- xml_procDer richtige Platz für alle XSDs und XSLs. Besagte liegen nicht in dem Datenlayer weil dort andere Berechtiungsbedingungen herrschen sollen.
- svcDie Servicekomponenten landen hier drin.Sie sind von der Klassenstruktur klar getrennt, benutzen aber im Gegensatz zum Präsentationslayer nicht den op layer zur ABstraktion sondern enthalten ihr eigenes logisches Abbild von der Programmlogik.
- stylefür CSS
- imgfür bilder
Letzte Änderung: 12.01.2010, 16:16 | 452 Worte