Portlet Factory, Version 6.1.2
The reference chooser
The reference chooser allows you to assign the value of an element in the model to a builder call input.
The reference chooser displays all the variables, methods, inputs, and pages from which you can derive a value. When you select an item in the reference chooser, the value it returns is called an indirect reference and defines the path to the selected element in the model. For example, ${Variables/CustomerName} or ${MethodCall/GetCustomerName}. You can combine and embed indirect references with one another to produce highly flexible references to a value. For example, the following indirect reference returns the value of a specific element in an XML structure, using the value returned by a method as the index to the element:
${Variables/Customers/Customer[${MethodCall/GetIndexValue}]}The reference chooser displays all the variables, methods, inputs, and pages from which you can choose to map the output value of the selected element to the input value for the builder call.
The reference chooser does filter out invalid possibilities. For example, you can set the Label input value for the Button builder to be the output of a method, the value of a variable, or the value from an input on the previously submitted page. When you display the reference chooser for the Label input, it does not show the pages in the model because they are not a valid means of deriving a label for the button.
The following are aspects of using the reference chooser:
- Specification of indirect references to theme property data
- Specifying page controls
- References to methods
- Indirect reference nesting and concatenation
- Java expression usage
- Combinations of indirect reference types
- Specification of lists
Parent topic: About using the builder call editor
- Indirect references to theme property data
You can directly enter an indirect reference in the reference chooser to provide access to theme properties data.
- Specifying page controls
You can use the reference chooser to specify the value for a page control (for example, a text input or the label for a button).
- References to methods
The reference chooser shows methods which can provide a value for a builder input.
- Indirect reference nesting and concatenation
You can concatenate indirect references or nest them as needed.
- Java expression usage
You can enter Java syntax for the input to a builder.
- Combinations of indirect reference types
You can use combinations of indirect reference types.
- Specification of lists
You can supply any builder input that accepts a comma-delimited list with any object that implements java.util.Collection or extends java.util.Iterator, thereby populating the builder input value with the items in the underlying collection.
Library | Support |