Datensatz umbenennen
Verwende den Schritt Datensatz umbenennen, um die Primärschlüsselfelder eines bestehenden Datensatzes zu ändern. Das ist ein eigener Schritt, weil BC einen Rename anders behandelt als ein Modify — der Datensatz wird verschoben und Verweise in anderen Tabellen werden mitgepflegt.
Schritt konfigurieren
Öffne den Flow-Editor, füge Datensatz umbenennen ein und fülle die Konfigurationskarte aus.
Beschreibung
- Zweck: Mach klar, welchen Datensatz dieser Schritt umbenennt und warum.
- Wann ausfüllen: Immer. Die Beschreibung erscheint im Editor und in der Ausführungs-Historie.
- Tipps: Benenne Tabelle und Absicht, z. B.
Artikelnummer auf neues Schema umstellen.
Referenz
- Zweck: Identifiziert den umzubenennenden Datensatz.
- Wann ausfüllen: Pflicht. Wähle ein SmartField, das auf einen Datensatz auflöst — z. B. den
rec-Output eines vorherigen Schritts. - 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. Wird beim Ausführen des Schritts gegen die aufgelöste Referenz validiert.
Neue Primärschlüsselwerte
Die Liste enthält nur Primärschlüsselfelder und ist mit einer Zeile pro Schlüsselfeld der konfigurierten Tabelle vorbelegt. Trage den neuen Wert für jedes Schlüsselfeld ein. Die Validate-Spalte aus „Datensatz einfügen" / „Datensatz ändern" ist hier ausgeblendet — bei einem Rename feuert der OnRename-Trigger der Tabelle immer, ein Schalter dafür existiert nicht.
Outputs
| Name | Typ | Bedeutung |
|---|---|---|
rec | Referenz | Der umbenannte Datensatz (mit dem neuen Primärschlüssel). |
Hinweise
- Alle Schlüsselfelder erforderlich. Fehlt der Wert für eines der Primärschlüsselfelder, bricht der Schritt den Flow mit einem Konfigurationsfehler ab.
- Bis zu 16 Schlüsselfelder. BC unterstützt Primärschlüssel mit bis zu 16 Komponenten — das deckt jede Standardtabelle ab.
- Schlüssel-Kollision. Existiert der neue Primärschlüssel bereits in der Tabelle, bricht BC den Rename mit einem Fehler ab.
- Referenzen nach dem Rename. Nachgelagerte Schritte, die den
rec-Output von vor dem Rename übernommen haben, halten eine veraltete Referenz. Verwende stattdessen den neuenrec-Output dieses Schritts.