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

Adding a Record Create Diagram Element to a Flow

Functions

This diagram element is for adding instance records of platform objects, akin to using an "INSERT INTO" statement in a database.

Using the Record Create Diagram Element

  1. On the flow designer, choose Basic and drag the Record Create diagram element to the canvas.
  2. Click the Record Create 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 RecordCreatesequence 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 create mode

    Whether to enable the quick creation mode.

    • If this parameter is selected, the quick mode is used. In this mode, one or more records can be created. You only need to configure the object variables (variables associated with the object) or object variable arrays of the object. This diagram element is used to input object variable values or arrays into the database. If the object variable is an array, multiple records are created. Upon successful creation, the record ID is automatically stored in the object variable. Each field in the new record corresponds to the variable's value, so ensure variables are set in advance.
    • If this parameter is not selected, the common mode is used. In this mode, only one record is created each time the diagram element is executed. You need to configure the object name of the record to be created, field values in the object, and returned record ID to the variable name.

    This parameter is deselected by default.

  3. Click and complete the configuration.

    • If you select Use fast create 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 value of the object variable or object variable array to create a record. As shown in the following figure, use the value of the accountCreate object variable to create a record.
      Figure 1 Fast creation mode
      Table 2 Parameters for the fast creation mode

      Parameter

      Description

      Variable

      Predefined object variable or object variable array, which is used to create a record.

      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

      • Selecting this parameter means that if a subsequent step fails in a flow, the process can be rolled back to the previous step.
      • If this parameter is not selected, when a later step fails, the recorded operations will not be rolled back.

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

    • If Use fast create mode is not selected in the previous step, you need to specify an object and assign values to the fields of the object to create a record. Add a record whose name is Lily for the Account object and set var_record_id to the record ID, as shown in Figure 2.
      Figure 2 Common creation mode
      Table 3 Parameters for the common creation mode

      Parameter

      Description

      Object

      Select an object from the drop-down list. Only the public and global objects in the current project that depend on the BO can be used.

      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.

      Assignment

      After an object is selected, the fields of the object are displayed in the Target column. To assign values to multiple fields, click Add Row.

      Under Target, select the object field to which a value needs to be assigned. Under Source, you can drag a variable from the context or directly enter {!Variable name}.

      Variable

      Assign the created record ID to the variable so that the record ID can be referenced in the flow.

      Drag a text variable from the context or directly enter a text variable.