Löschen durch Ändern

Worum es geht

Nicht nur DELETE löscht. Auch ein PUT oder PATCH am Elternobjekt kann Kinder löschen, nämlich dann, wenn ein abhängiges Kind (Beziehung mit DELETE-Flag) danach nicht mehr dazugehört. Das passiert, wenn

• eine Liste ohne das Kind geschickt wird,
• eine Liste als leer gilt,
• eine Einzelreferenz geleert wird.

Das ist gewollt: Eine Rechnungsposition, die aus der Rechnung fällt, hat ohne Rechnung keinen Sinn. Es ist aber auch die häufigste Art, versehentlich Daten zu löschen.

Vorher und nachher

Ein Kontakt mit einem Haupttelefon mainPhone und weiteren Telefonen phones. Beide Beziehungen haben das DELETE-Flag.

Die letzten beiden Zeilen sind der Unterschied zwischen PUT und PATCH: Bei PUT heißt „fehlt“ dasselbe wie „leer“, bei PATCH heißt „fehlt“ „nicht anfassen“.

PATCH /api/rest/crm/contact/update/c052…
{
  "data": {
    "id": "c052…",
    "phones": [ { "id": "P2…" } ]
  },
  "response": ["id", { "field": "phones", "response": ["id", "number"] }]
}

{ "data": { "id": "c052…",
            "phones": [ { "id": "P2…", "number": "0611-17277000" } ] },
  "meta": { "error": false } }

P3 ist danach nicht nur aus der Liste verschwunden, sondern gelöscht. /phone/read/P3… liefert 404.

Wann gelöscht wird

„Enthalten“ heißt: Das Kind steht mit seiner id in der Liste bzw. der Referenz. Welche Felder du sonst mitschickst, spielt dafür keine Rolle. Siehe Listen als Zielzustand.

Was dabei passiert

Für das gelöschte Kind gilt alles aus Abhängige Objekte (Kaskaden): Es braucht die Löschrolle seines Modells, seine eigenen abhängigen Kinder gehen mit, seine übrigen Beziehungen werden gelöst.

Fallen

Wie es weitergeht

• Die Regeln für Listen: Listen als Zielzustand
• PUT und PATCH im Vergleich: PUT oder PATCH? Die null-Falle
• Was mitgelöscht wird: Abhängige Objekte (Kaskaden)