REST
Die REST-(RESTful)-Server- und Client-Technologie ist in den OrgaMon integriert.
- Server
Auf einem definierbaren TCP-Port (Standard=3047) stellt der OrgaMon also diesen Web-Service zur Verfügung. Er lässt sich durch einen normalen Web-Browser ansprechen, eigent sich aber insbesondere für die Automatisierung und zur Kopplung von anderen Geschäftsprozessen an den OrgaMon. Insbesondere die Anbindung des WebShops.
- Client
Die Buchführung des OrgaMon kann ein externes Konto leicht über einen REST-Service (AqBanking) ansprechen und Buchungen (Umsätze) auslesen. Über den Service lassen sich jedoch auch Lastschriften durchführen. In einer späteren Ausbaustufe können auch Überweisungen durchgeführt werden.
Grundlagen der REST Technologie
- http://www.oio.de/public/xml/rest-webservices.htm
- http://xml-magazin.de/itr/online_artikel/show.php3?id=209&nodeid=69
- http://linuxenterprise.de/itr/news/psecom,id,39097,nodeid,8.html
Beispiele
- Starten die den REST Service: WebShop->Reiter REST->Schalter REST
- Benutzen Sie einen Browser, und geben Sie den Rechnernamen des Systems an, auf dem sie eben REST gestartet haben.
- Beispiel für alle möglichen Datenbank-Tabellen:
http://<RechnerName>:3047/
- Beispiel für eine einzelne Tabelle
http://<RechnerName>:3047/SORTIMENT
Ausblick
- Grundsätzliche Erweiterung um einen "Name-Space" genau wie bei XMLRPC, also als erster "Parameter" wird grundsätzlich der Name-Space übertragen.
/<NameSpace>/
- voraussichtliche Haupt-Einstiege (r/w):
./olap/ Ausführen von OLAP-Statements
./buch/ Besondere Auswertungen für die Buchführung
./shop/ Wrapper
./ecommerce/ kompletter Funktionsumfang des eCommerce-Moduls
f - Parameter
Ein allzeit Verwendbarer Parameter für das Format der Antwort des Servers ist der "f"-Parameter. Dabei gibt es folgdende Werte:
- f=xml: Die Antwort wird in XML formatiert
- f=text: Die Antwort wird als csv-Tabelle formatiert
- f=xls: Es wird direkt mit einem XLS Dokument geantwortet
- f=text.zip: Die Textantwort wird gezippt übertragen