Assign Variable

 

Assigns a value to a variable.

 

Properties

Option

Description

Destination Variable

Enter the variable that will store the assigned value. This must not be of type date.

Source Variable

Enter the value to assign (a literal value or another variable).

If the type does not match the destination variable, it is converted at run time. See Variable Conversion, below.

There are constraints that you must observe when assigning object and array variables. See Constraints below.

Exit Points

Exit Point

Description

Complete

This is taken when the action cell has executed.

Error

This is taken if an internal error occurred.

Variable Conversion

The action cell can be used to covert one type of value to another. The following conversions are supported:

Destination type

Source type

Description

Float or integer

String

Converts a string of numeric characters to a numeric value.

Useful for converting a captured numeric string to a monetary value.

Boolean

String

Converts zero to false and all other values to true.

String

Float or integer

Converts the number to a character string.

Boolean

Float or integer

Converts zero to false and all other numbers to true.

String

Boolean

Converts true to 1, and false to 0.

Float or integer

Boolean

Converts true to 1, and false to 0.

Constraints

Source Variable Type

Destination Variable Type

Object

This must be an object of the same type as the source variable.

For example, if the source variable is an object of type 'CustomerDetails', then the destination variable must also be an object of type 'CustomerDetails'. Each member value of the source variable is then copied to each member of the destination variable.

Array

This must be an array of the same data type as the source variable.

For example, if the source variable is an array of data type 'String', then the destination variable must also be an array of data type 'String'. The destination array becomes an exact copy of the source array.