Variable Named Entries

Use the Variable Named Entries section to change elements of a delimited list of name/value pairs. If no element has a specified name as its pair’s first value, the corresponding scalarExpr is not used.

The contents of the Entries field must use this syntax:

var, [delimiter, [separator,]] name = scalarExpr

where:

  • var is the name of an event variable that contains a string comprised of zero or more elements separated by the delimiter character. Each of which element contains a name and a value that is separated by the separator character.
  • delimiter is the character or string which separates elements in var from each other. This argument is optional. If this argument is not used, the comma (,) character is used, and the equals sign (=) is used as the separator. In this case, each element may contain commas if they are enclosed within a ~LIT~(…) wrapper.
  • separator is a character or string which separates the name from the value in each element. This argument is optional. If this argument is not used, the equals sign (=) is used.
  • name is the first value of the pair of values in the element whose second value is to be changed.
  • scalarExpr is the value to whose string representation the element is to be set.

If multiple elements of the same variable are to be changed, include their names and values as additional pairs separated by commas, for example:

var, [delimiter, [separator,]] name1 = scalarExpr1, name2 = scalarExpr2[, ...]

When you click OK to return to the Event Actions form, the system "wraps" this content within a SETVARNAMEDENTRIES ( ) parameter, which yields this final syntax:

SETVARNAMEDENTRIES( var, [delimiter, [separator,]] name = scalarExpr[, …] )

Note: If any scalarExpr is a literal value, the system automatically encloses it in double quotation marks when returning it to the Event Actions form. If a scalarExpr is an expression, the system does not enclose it in quotation marks.