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

1. Starten die den REST Service: WebShop->Reiter REST->Schalter REST
2. 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