| Auszug |
|---|
|
Nuclos REST ändern: PUT, self, subBos, insert, update, delete, Unterformular, Referenzattribut, JSON. |
Sprache: Deutsch · English
6. Businessobjekt (BO) ändern
BO über REST ändern – PUT auf self, Unterformulare per subBos insert/update/delete.
| Status |
|---|
| colour | Blue |
|---|
| title | Entwickler |
|---|
|
| Status |
|---|
| colour | Green |
|---|
| title | Stand: Jul 2026 |
|---|
|
| Status |
|---|
| colour | Grey |
|---|
| title | gilt fuer Nuclos 4.2026.x |
|---|
|
...
Ein gelesenes Objekt
...
Unterformulare bearbeiten
Eine Besonderheit bilden Unterformulardatensätze. Da Unterformulare aus Performancegründen nicht zusammen mit dem BO gelesen werden können, sondern via Links mit eigenen Aufrufen, ist die Struktur leider nicht selbsterklärend.
Die Struktur ist dabei wie folgt:
lässt sich per PUT auf dem self-Link ändern – die Attribute werden wie beim Anlegen bearbeitet (Datentypen siehe Metainformationen).
Unterformulare
Unterformulare werden aus Performancegründen nicht mit dem BO gelesen, sondern über eigene Links. Änderungen werden im Objekt-JSON unter subBos mit insert/update/delete je Referenzattribut übergeben:
...
...
...
...
...
"boMetaId": "{boMetaId}", |
...
...
...
...
...
...
123, "boMetaId": "{boMetaId}", |
...
...
...
...
...
insert und update sind von der Struktur her identisch.
| Codeblock |
|---|
| title | insert (Ausschnitt aus einem Businessobjekt JSON) |
|---|
|
"subBos": {
"insert": {
"{refAttrId}": [ |
...
- wie ein normales BO (per Rohling).
- update: nur die geänderten Zeilen anhängen – unveränderte müssen nicht mitgegeben werden.
- delete: nur die
ids der zu löschenden Zeilen.
Verwandte Seiten
7. Businessobjekt (BO) löschen
Löschen.
Öffnen →
5. Businessobjekt (BO) anlegen
Anlegen.
Öffnen →
| Codeblock |
|---|
| title | update (Ausschnitt aus einem Businessobjekt JSON) |
|---|
|
"subBos": {
"update": {
"{refAttrId}": [ |
Die zuvor gesondert gelesenen Unterformulardatensätze, welche geändert werden müssen, werden einfach dem entsprechenden Unterformular-Array hinzugefügt.
Datensätze die nicht geändert werden, können und brauchen auch nicht mitgegeben werden!
delete benötigt nur die Ids der zu löschenden Unterformulardatensätze.
| Codeblock |
|---|
| title | delete (Ausschnitt aus einem Businessobjekt JSON) |
|---|
|
"subBos": {
"delete": {
"{refAttrId}": [ |
Änderung senden
| Codeblock |
|---|
/bos/{boMetaId}/{boId} |
Das zu ändernde Objekt muss per PUT an den self Link gesendet werden.
Beispiel aus dem Rest example: update_order_1012.json und update2_order_1012.json
Die Rückgabe enthält das geänderte Objekt.
Ausführbares Beispiel
Siehe Beispielaufrufe per Shell
