PATCHs und Arrays

Sie können Arrays in PATCH-Anforderungs-Nutzdaten einfügen. Innerhalb der System-APIs fügt das PATCHing eines Arrays die PATCH-Mitglieder nicht zu den bereits im Array vorhandenen Mitgliedern hinzu. Stattdessen ersetzt das PATCH die bestehenden Mitglieder durch die PATCH-Mitglieder.

In der Jobs-API hat die Ressource JobRoles beispielsweise ein Array namens roles (Rollen). Dies ist ein Array von Benutzern für den Job und die Rolle jedes Benutzers (z. B. Ersteller oder Underwriter). Die folgenden PATCH-Nutzdaten setzen das Rollen-Array auf einen einzelnen Benutzer (user default_data:1) mit der Rolle Auditor (Prüfer). Wenn es vor dem PATCH Benutzer-/Rollenpaare in diesem Array gab, werden diese Paare entfernt und das einzige Benutzer-/Rollenpaar ist default_data:1/Auditor.

{
  "data":
    {
      "attributes": {
        "roles": [
          {
            "group": "systemTables:1",
            "role": {
              "code": "Auditor"
            },
            "user": "default_data:1"
          }
        ]
      }
    }
}

Wenn Sie möchten, dass ein PATCH zu einem Array additiv wirkt, müssen Sie zuerst die vorhandenen Mitglieder des Arrays ermitteln und dann im PATCH ein Array mit den vorhandenen sowie den hinzuzufügenden Mitgliedern angeben.