Back Forward Expressions — How to reference parts of aggregate properties

 Show all 

A property of mode Page, Value List, Page List, Value Group, or Page Group is known as an aggregate property. You can access a portion of an aggregate property to obtain a value or to set (assign) a new value. For example, for a Value List property, you can copy or alter the value of the tenth element. For a Page List property, you can add a new page at the end of the existing list of pages.

Use these notations and keywords to identify parts of aggregate properties. You can use these in reference directives, reference JSP tags, as parameters to the Property-Set method, and in models. A few keywords such as <INSERT> are only valid in destinations — target property references.

  Referencing parts of a Page property

Use the standard dot notation to reference the value of a property on a page:

pagename.propertyname

This notation works for both getting a value and setting a value.

  Referencing parts of lists and groups

Lists

C-471 For Value List and Page List properties, the index is a number starting with 1. To reference a single element of the list, use an expression that evaluates to a positive integer value.

For example, you can set the first two elements of the Value List property Months in a model or Property-Set method as follows:

Numeric indexes work similarly for a Page List property. The LoanApplications Page List property contains a Single Value property named LoanAmount:

Page List

Groups

Each element of a Value Group or Page Group property is identified by a unique value that must be a Java identifier. You can enter a constant string as the index, such as Mother or Massachusetts: B-16077

You can also enter an expression that evaluates to a string value. The result must be a valid Java identifier. TURBT 08/26/03

On the Clipboard tool display, Value Group values appear on the right panel:

  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.

<LAST> index

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

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

<INSERT > index

R-9673 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, Process Commander inserts the new value as a new last element. If the integer is larger than the size of the list by 2 or more, Process Commander creates an exception.

<PREPEND> index

C-471 Use the <PREPEND> keyword 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.

<CURRENT> index

Within a single activity step, you can set up an iteration that performs a repeated computation over a collection, such as all the elements in a Value List property. In that context, the <CURRENT> index identifies the index value for the current iteration.

See Activity form — Completing the Steps tab (Iteration).

Definitions aggregate property, expression, Java identifier
Related topics Property references in expressions

UpAbout expressions