Zum Hauptinhalt springen

Datensatz ändern

Verwende den Schritt Datensatz ändern, um Felder eines bestehenden Datensatzes zu aktualisieren. Der Schritt nimmt eine Referenz auf den Datensatz (typischerweise der rec-Output eines vorherigen „Datensätze suchen"- oder „Datensatz einfügen"-Schritts), wendet die Feldwerte aus der Liste an und speichert den Datensatz.

Schritt konfigurieren

Öffne den Flow-Editor, füge Datensatz ändern ein und fülle die Konfigurationskarte aus.

Beschreibung

  • Zweck: Mach klar, welchen Datensatz dieser Schritt aktualisiert und warum.
  • Wann ausfüllen: Immer. Die Beschreibung erscheint im Editor und in der Ausführungs-Historie.
  • Tipps: Benenne Tabelle und Absicht, z. B. Auftrag als verarbeitet markieren.

Referenz

  • Zweck: Identifiziert den zu ändernden Datensatz.
  • Wann ausfüllen: Pflicht. Wähle ein SmartField, das auf einen Datensatz auflöst — z. B. den rec-Output eines vorherigen Schritts oder einen Pfad wie prevStep.rec.
  • Tipps: SmartField-Referenzen werden über den Picker eingetragen, in der Standard-{{name}}-Notation – die Picker-Ausgabe wird unverändert eingefügt.

Tabelle

  • Zweck: Die Tabelle, auf die die Referenz zeigen soll.
  • Wann ausfüllen: Pflicht. Die konfigurierte Tabelle filtert auch die Feld-Auswahl in der Feldwerte-Liste.
  • Tipps: Wenn die Referenz beim Ausführen des Schritts auf eine andere Tabelle aufgelöst wird, bricht der Schritt den Flow mit einem Konfigurationsfehler ab.

Trigger ausführen

  • Zweck: Entscheidet, ob BCs Standard-Modify-Logik mitläuft — die Validierungen und der OnModify-Trigger der Tabelle.
  • Optionen:
    • Ein (Standard) — volles BC-Verhalten. Validierungen feuern und OnModify läuft.
    • Aus — die Änderungen werden so geschrieben, wie konfiguriert.

Feldwerte

Gleiche Struktur wie bei „Datensatz einfügen", mit einem Unterschied: Die Feld-Auswahl filtert die Primärschlüsselfelder aus. Wird beim Ausführen ein Primärschlüsselfeld in der Liste gefunden, bricht der Schritt ab — verwende den Schritt Datensatz umbenennen, um Schlüsselwerte zu ändern.

Leere Liste. Ein Modify-Schritt mit leerer Feldwerte-Liste lädt den Datensatz und speichert ihn unverändert. Praktisch, um Validierungen oder den OnModify-Trigger erneut auszulösen, ohne selbst etwas zu ändern.

Binärfelder (Blob, Media). Blob- und Media-Felder sind als Ziele zulässig — gleiche Regeln wie im Abschnitt Binärfelder unter Datensatz einfügen. Setze einen SmartField wie {{pdfBody}} in die Wert-Zelle, und die Bytes gehen direkt ins Feld.

Outputs

NameTypBedeutung
recReferenzDer geänderte Datensatz.

Hinweise

  • Partielle Updates. Nur die aufgeführten Felder werden berührt. Andere Felder behalten ihren bisherigen Wert.
  • Validate-Reihenfolge. Wie bei „Datensatz einfügen": Validierungen feuern in Zeilen-Reihenfolge — eine Zeile, die von einer anderen abhängt, sollte später kommen.
  • Datentyp-Konvertierungsfehler. Ein nicht parsbarer Wert (z. B. "abc" in einem Decimal-Feld) bricht den Flow am Schritt ab.