This shows you the differences between two versions of the page.
design2budget:webservice:operation:save [2015/04/04 21:05] 10.1.1.56 created |
design2budget:webservice:operation:save [2015/11/27 14:09] |
||
---|---|---|---|
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 === | ||
- | |||
- | https://server/tenant/s/customer/save/33/?sid=9bd3b5f93692e4659632c8585eb35447 | ||
- | lastname="Mustermann" | ||
- | firstname="Max" | ||
- | email="max.mustermann@domain.tld" | ||
- | |||
- | Führt ein Update beim Kunden mit id 33 durch und speichert (überschreibt) die Felder lastname, firstname und email. | ||
- | |||
- | === Beispiel2 === | ||
- | |||
- | https://server/tenant/s/customer/save/0/?sid=9bd3b5f93692e4659632c8585eb35447 | ||
- | lastname="Mustermann" | ||
- | firstname="Max" | ||
- | email="max.mustermann@domain.tld" | ||
- | |||
- | Legt einen neuen Kunden an und setzt die Felder lastname, firstname und email. | ||
- | |||