This shows you the differences between two versions of the page.
| — |
design2budget:webservice:operation:save [2015/11/27 14:09] (current) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | ====== design2budget Entwickler Webservice Dokumentation ====== | ||
| + | |||
| + | Zurück zur [[design2budget:webservice|Webservice Dokumentation Startseite]] | ||
| + | |||
| + | ====== Basisoperation <module>/save ====== | ||
| + | |||
| + | Diese Action wird von jedem Modul angeboten und speichert ein Objekt des angegebenen Moduls mit der angegebenen id. | ||
| + | |||
| + | Jedes Objekt hat als primary key das Feld id. | ||
| + | |||
| + | Wird statt einer gültigen id 0 angegeben, so wird ein neues Objekt erzeugt. | ||
| + | |||
| + | Die Feldwerte werden als POST Paramter übergeben. | ||
| + | |||
| + | ==== GET ==== | ||
| + | |||
| + | https://server/tenant/s/module/save/id/?sid=sessionID[&output=outputMode] | ||
| + | |||
| + | ^ parameter ^ Optional: Standard ^ Beschreibung ^ | ||
| + | | output | JA: json | JSON REST API (json) oder XML REST API (xml) | | ||
| + | |||
| + | Beispiel: | ||
| + | |||
| + | https://server/tenant/s/offer/save/312/?sid=9bd3b5f93692e4659632c8585eb35447 | ||
| + | |||
| + | Speichert das Angebot 312 | ||
| + | |||
| + | ==== POST ==== | ||
| + | |||
| + | Die einzelnen Werte für jedes Feld werden direkt als POST Parameter übergeben | ||
| + | |||
| + | ^ Parameter ^ Beschreibung ^ | ||
| + | | <field1>=<value1> | Das angegebene Feld field1 wird auf den Wert value1 gesetzt | | ||
| + | | <field2>=<value2> | Das angegebene Feld field2 wird auf den Wert value2 gesetzt | | ||
| + | | <field...>=<value...> | Jedes weitere Feld wird auf den entsprechenden Wert gesetzt | | ||
| + | |||
| + | **ACHTUNG:** Die Angabe der id als POST Paramter ist nicht zulässig! | ||
| + | |||
| + | === Beispiel1: Updaten eines Records === | ||
| + | |||
| + | https://server/tenant/s/customer/save/33/?sid=9bd3b5f93692e4659632c8585eb35447 | ||
| + | |||
| + | POST body: | ||
| + | <code> | ||
| + | lastname=Mustermann | ||
| + | firstname=Max | ||
| + | email=max.mustermann@domain.tld | ||
| + | </code> | ||
| + | |||
| + | Führt ein Update beim Kunden mit id 33 durch und speichert (überschreibt) die Felder lastname, firstname und email. | ||
| + | |||
| + | === Beispiel2: Neuanlage eines Records === | ||
| + | |||
| + | https://server/tenant/s/customer/save/0/?sid=9bd3b5f93692e4659632c8585eb35447 | ||
| + | |||
| + | POST body: | ||
| + | <code> | ||
| + | lastname=Mustermann | ||
| + | firstname=Max | ||
| + | email=max.mustermann@domain.tld | ||
| + | </code> | ||
| + | |||
| + | Legt einen neuen Kunden an und setzt die Felder lastname, firstname und email. | ||
| + | |||