Zum Hauptinhalt springen

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.

Nicht sicher bei parallelen Ausführungen

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​

ParameterTypPflichtBeschreibung
pathstringJaJSON-Pfad zum RecordArray
matchAttributeNamestringJaName des Record-Attributs, über das zugeordnet wird
matchValuestringNeinStatischer Vergleichswert
matchValuePathstringNeinJSON-Pfad zum Vergleichswert. Hat Vorrang vor matchValue
attributeUpdatesListeJaattributeName plus valuePath (absoluter JSON-Pfad) oder value (statisch; =now() setzt die aktuelle UTC-Zeit)
targetPathstringJaJSON-Pfad, in den das geänderte Array geschrieben wird