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 wieprevStep.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
OnModifyläuft. - Aus — die Änderungen werden so geschrieben, wie konfiguriert.
- Ein (Standard) — volles BC-Verhalten. Validierungen feuern und
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
| Name | Typ | Bedeutung |
|---|---|---|
rec | Referenz | Der 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.