Skip to main content

Delete Record

Use the Delete Record step to remove a record. The step takes a reference to the record (typically the rec output of an upstream Find Records or Insert Record step) and deletes it.

Configure the step​

Open the flow editor, add Delete Record, and fill in the configuration card.

Description​

  • Purpose: Make it clear which record this step removes and why.
  • When to fill it: Always. The description shows up in the editor and the execution history.
  • Tips: Name the table and the intent, for example Remove staging row after import.

Reference​

  • Purpose: Identifies the record to delete.
  • When to fill it: Required. Pick a SmartField that resolves to a record — for example the rec output of a previous step.
  • Tips: SmartField references are entered through the picker, in the standard {{name}} notation – paste the placeholder as-is.

Run Triggers​

  • Purpose: Decide whether BC's standard delete logic runs around the change — the table's OnDelete trigger and its cascade-delete behaviour.
  • Options:
    • On (default) — full BC behaviour. The trigger runs, and any cascade rules fire (deleting a Sales Header also deletes its Sales Lines, for example).
    • Off — the record is removed as-is, without triggering cascade logic.

Outputs​

The step has no outputs — the record is gone after a successful delete.

Notes​

  • Cascade behaviour. With triggers on, BC's standard cascade rules apply. If the cascade hits a permission or constraint problem, the flow stops at this step with the underlying BC error.
  • Missing record. If the reference resolves but the record itself doesn't exist any more (e.g. an earlier step deleted it), the step stops the flow with an error.