Updated on 2025-08-15 GMT+08:00

Adding a Record Delete Diagram Element to a Flow

Functions

This diagram element is for deleting instance records of platform objects, akin to using a "DELETE" statement in a database.

Using the Record Delete Diagram Element

  1. On the flow designer, choose Basic and drag the Record Delete diagram element to the canvas.
  2. Click the Record Delete diagram element, click , and set basic information.

    Table 1 Parameter description

    Parameter

    Description

    Label

    Label of the diagram element, which is displayed on the flow design page. The system automatically assigns a value in a specific RecordDeletesequence number format, with the sequence number starting at 0 for each type of diagram element.

    Name

    Diagram element name, which must be unique in the current flow. The naming requirements are as follows:

    • Value: 1–80 characters.
    • Start with a letter and can contain letters, digits, and underscores (_). It cannot end with an underscore (_).

    Description

    Description of the diagram element.

    Value: 1–255 characters.

    Use fast delete mode

    Whether to enable the quick deletion mode.

    • If this parameter is selected, the quick mode is used.

      Delete a record based on the record ID in an object variable. If the configured object variable is an array, all records in the array are deleted from the database by record ID.

    • If this parameter is not selected, the common mode is used.

      To delete records from a specified object based on conditions, you need to configure the object name and deletion conditions for the records to be deleted.

    This parameter is deselected by default.

  3. Click and complete the configuration.

    • If you select Use fast delete mode in the previous step, you need to specify a predefined object variable or object variable array, drag the object variable or object variable array to the variable text box, and use the record ID of the object variable or object variable array to delete the corresponding object record. As shown in Figure 1, the record ID of the accountDelete object variable is used to delete the object record.
      Figure 1 Fast deletion mode
      Table 2 Parameters for the fast deletion mode

      Parameter

      Description

      Object

      Predefined object variable. You can use this object variable or the record IDs within an object variable array to delete object records.

      You can drag a variable from the context or directly enter an object variable or object variable array.

      Rollback if current process ends with error

      Rolls back to the previous process when an error occurs in the current flow.

      This parameter is selected by default. Do not change the settings unless otherwise specified.

    • If Use fast delete mode is not selected in the previous step, you need to specify the object and set values for certain fields of the object in the conditions to delete records that meet the conditions. Delete the record whose name is Lily from the Account object, as shown in Figure 2.
      Figure 2 Common deletion mode
      Table 3 Parameters for the common deletion mode

      Parameter

      Description

      Object

      Select an object from the drop-down list.

      Rollback if current process ends with error

      Rolls back to the previous process when an error occurs in the current flow.

      This parameter is selected by default. Do not change the settings unless otherwise specified.

      Condition

      After an object is selected, the fields of the object are displayed in the field column. Click Add Row to set the conditions for deleting data.

      Select the object field to be judged from the field drop-down list, select the corresponding comparison operator from the operator drop-down list, and drag a variable from the context or enter {!Variable name} in the value text box.