10 Ändern eines vorhandenen Objektes
aoRestServer/ODATA für ABES/Objects - Hinweise für Frontend-Entwickler
Objekte können geändert werden, indem ein PATCH-Request auf die entsprechende kanonische URL des Objektes durchgeführt wird.
Falls bei diesem Request festgestellt wird, dass der angemeldete User nicht die entsprechenden Rechte hat, wird ein Fehler-Objekt mit dem Http-Resultcode 400 zurückgegeben.
Beispiel: Ändern eines vorhandenen Personen-Objektes
|
Request
|
|
PATCH
|
http://test.server.de/odata/Person(‘oid_der_person’)
|
Bei diesem PATCH-Request muß ein JSON-Objekt im Body des Requests mitgegeben werden, das alle neuen Werte für die zu ändernden Felder enthält.
Alle Property-Namen im übergebenen JSON-Objekt, die nicht mit einem einfachen Feld des anzulegenden Objektes korrespondieren, werden ignoriert.
Umgekehrt werden alle Felder des zu ändernden Objektes, für die es keine korrespondierenden Properties im übergebenen JSON-Objekt gibt, auf ihrem aktuellen Wert belassen.
Die Rückgabe wird mittels Request-Header “Prefer” gesteuert. Es gelten genau die gleichen Bedingungen wie beim Anlegen eines neues Objektes.
Beispiel: Ändern des Feldes Ort für ein vorhandenes Termin-Objekt
|
Request
|
|
Header
|
Prefer: minimal|representation
|
|
PATCH
|
http://test.server.de/odata/Termin(‘oid_des_termins’)
|
|
Body
|
{
“Ort”: “Hamburg”
}
|
Der Response wird in Abhängigkeit des Request-Headers “Prefer” identisch generiert wie beim Neuanlegen eines Objektes, siehe vorheriges Kapitel.
Die Bildschirmfotos können in aktuellen Programmversionen visuell abweichen.
Sie haben Fragen oder Anregungen? Schreiben Sie uns gerne an support@rackow-software.de
