You are here: Record management > Building expressions with the Expression Builder > Parts of aggregate property references > Symbolic indexes — APPEND, CURRENT, INSERT, LAST, and PREPEND

Symbolic indexes — APPEND, CURRENT, INSERT, LAST, and PREPEND

Use keywords to identify certain elements of aggregate properties.

<APPEND> index

To add an element to the end (highest index value) a Value List or Page List property, use the <APPEND> index keyword:

Append

This keyword is meaningful only in target property references, not expressions.

This keyword can be used only as a index or superscript

<LAST> index

To set or retrieve an element value from the end (highest index value) of a Value List or Page List property, use the <LAST> index keyword.

For example, this sets the value of the highest numbered element in the Month Value List property:

Append

Similarly, this sets the LoanAmount value in the highest-numbered LoanApplication page:

Page List with LAST

This keyword can be used only as a index or superscript

<INSERT > index

Use the <INSERT> keyword followed by an integer to insert a new element and its value into a Value List or Page List property at a numeric index position. Any elements with the same or higher index value are "pushed down" by one.

This keyword can only be used in target property references, not expressions. You can use a literal number for the index:

Insert

or a numeric property reference for the index:

Insert

If the integer is equal to the size of the list, or greater by one, the new value is inserted as a new last element. If the integer is larger than the size of the list by 2 or more, an exception is created.

This keyword can be used only as a index or superscript.

<PREPEND> index

Use the <PREPEND> keyword to insert a new element and its value into a Value List or Page List property as the first element. All existing elements are "pushed down" by one.

This keyword can only be used in target property references, not expressions.

This keyword can be used only as a index or superscript.

<CURRENT> index

The use of the <CURRENT> keyword differs depending on where it is used.

Activities and data transforms

When <CURRENT> is used as a subscript rather than a standalone reference, the following apply.

 

When <CURRENT> is used as a index or superscript, the index of the current element of a For Each Element in a Value List or For Each Element in a Value Group or For Each Embedded Page.

Parameters in Rule-Utility-Function

ClipboardProperty references