UpdateRecordArrayItem@1
Der Node UpdateRecordArrayItem@1 sucht einen Record in einem RecordArray über ein Schlüsselattribut, setzt Attributwerte darauf und schreibt das geänderte Array nach targetPath. Passt kein Record, wird nichts geschrieben.
Um mehrere Records eines Arrays in einem Durchlauf zu aktualisieren (zum Beispiel einen Batch von Änderungen mit einem Lese- und einem Schreibzugriff pro Entität), verwende UpdateRecordArrayItem@2.
Eine Entität zu lesen, einen Record mit diesem Node zu ändern und das ganze Array zurückzuschreiben, verliert die Änderungen anderer Ausführungen, die gleichzeitig laufen. Können mehrere Ausführungen Records derselben Entität parallel ändern, verwende stattdessen das atomare Item-Update von CreateUpdateInfo@1.
Node-Konfiguration
Für die Felder path, targetPath, targetValueWriteMode, targetValueKind und documentMode siehe Überblick.
transformations:
- type: UpdateRecordArrayItem@1
path: $.key.Attributes.States
matchAttributeName: ExternalId
matchValuePath: $.full.key.pollUuid # oder matchValue: <statischer Wert>
targetPath: $.updates._updatedStates
attributeUpdates:
- attributeName: CurrentValue
valuePath: $.full.key.value
- attributeName: LastUpdate
value: =now()
Parameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
path | string | Ja | JSON-Pfad zum RecordArray |
matchAttributeName | string | Ja | Name des Record-Attributs, über das zugeordnet wird |
matchValue | string | Nein | Statischer Vergleichswert |
matchValuePath | string | Nein | JSON-Pfad zum Vergleichswert. Hat Vorrang vor matchValue |
attributeUpdates | Liste | Ja | attributeName plus valuePath (absoluter JSON-Pfad) oder value (statisch; =now() setzt die aktuelle UTC-Zeit) |
targetPath | string | Ja | JSON-Pfad, in den das geänderte Array geschrieben wird |