Create Variable

The Create Variable action A feature that supplies the instructions in a botflow. adds a variable to a botflow A file that stores the actions and variables designed to automate tasks. while a script is running.

Using the Create Variable action, you can create:

  • Temporary variables that will later be deleted.
  • Variables on an as needed basis.

Some examples of using the Create Variable action are, creating:

  • A temporary variable to hold the product of an equation.
  • All of the variables needed for a loop iteration.
  • A variable for a required culture shift.

Add a Create Variable action to a botflow

This example provides the steps necessary to add a Create Variable action to a botflow.

To add a Create Variable action to a botflow:

  1. On the Actions list, click Data and then click Create Variable from the Variables list.

    2. The Create Variable Action Builder window displays.

  2. Set the Create Variable settings.

    3. Name: Type the variable name in the Name field.

    Type: Select the variable type from the drop-down list.

    Value: Optionally, type a value in the Value field.

    Note: Optionally, type a note in the Note field.

    Overwrite: Check the box to set the variable setting to overwrite an existing variable with the same name.

  1. If needed, adjust the Run Error Task settings to fine tune how the action runs.
  2. If needed, adjust the Run Switch setting to create the action without running it.
  1. Optionally, add an action note.
  2. Click OK to add the Create Variable action to the botflow.
Field or button Description
Create Variable Options/Settings

General

  • Name: Type the variable name in the Name field or use the Expression Builder to build the action settings using variables or other token values.

Type: Select the variable type from the drop-down list:

  • Text: Stores any character.
  • Number: Stores whole numbers.
  • Decimal: Stores larger number including decimals.
  • Date: Stores a date in m/d/yyyy format.
  • True/False: Stores a Boolean, or True/False value.

Value: Optionally, type a value in the Value field or use the Expression Builder to build the action settings using variables or other token values.

Note: Optionally, type a note in the Note field or use the Expression Builder to build the action settings using variables or other token values.

Overwrite: Check the box to set the variable setting to overwrite an existing variable with the same name.

Note: If not checked and a variable with the same name exists, the Create Variable action fails.
Run error task
  1. Click Run error task.
  2. Open the On Error drop-down list and select the required setting:
    • Run error task: A botflow containing an error task automatically runs the error task in the event of an error. If the botflow does not contain an error task, the botflow stops in the event of an error.
    • Stop on error: The botflow stops in the event of an error.
    • Ignore errors: The action is skipped in the event of an error and the botflow attempts to execute the next action
  1. Click X to close the drop-down and save the setting.
Note

(Optional) Type a Note to document any special instructions or functionality.    
Run Switch

The Run Switch toggle controls how Nintex RPA runs an action when adding or editing an action in a botflow.

  • Run: To run the action automatically when you click OK, turn the toggle to Run.

  • Don't Run: If you do not want to run the action automatically when you click OK, turn the toggle to Don't Run.
OK/Cancel Click OK to save the action or click Cancel to discard the action or any changes.

See also Variables.