You are viewing the documentation for Blueriq 16. Documentation for other versions is available in our documentation directory.
What is it?
A value list, sometimes misspelled as valuelist, limits the base Types of an Attribute. It contains a set of possible values an attribute can have. After the value list is specified it can be chosen within the attribute. When you attempt to set a value that is not in the value list, a run-time exception is thrown. However, it is possible to keep deprecated values in a value list, by using a conditional value list, and setting a False condition for those values.
What does it do?
It offers the user a list of values the user can choose from.
Properties
Property | Description |
---|---|
Base type | Should match with the data type of the attribute the value list is linked with. The options are: Boolean, String, Number, Date, DateTime, Percentage, Currency and Integer. See also Attribute types. |
External | Tick this box if you want to use an external source for the value list items. An external value list does not have fixed values, but gets its values from an external source, e.g., a data base or a service. How the value list gets its data is configured in the configuration of Interactions. It requires Java code to supply the values. |
Items - value | A value that matches the value lists base type. This value can be used in expressions. |
Items - display value | A text that describes the matching value. This text is used in your applications user interface. The display value is multilingual. Note that value lists do not support Text Substitution Language: TSL. If more dynamic texts are required, please consider the Container type: AQ_InstanceLinker. To show display values on pages and in documents using (inline) text items, solely add the reference to the attribute to the field. Any addition other than comments to the expression will result in the (technical) value to be shown. |
Presentation styles | Select one or more presentation styles. Presentation styles in a value list can for example be used to apply icons such as different country flags. |
How to – create a conditional value list
A conditional value list means that under a certain condition only a subset of all possible values is available. When you use a conditional value list, the subset of available values is determined at run-time.
Create a new value list
Add at lease one item in the Items tab
Select the Conditions tab
Toggle the Conditional toggle. A table appears (like a decision table) summing up the values you just created on the Items tab.
Define in the table:
Which conditions apply to the value list
Which value is shown when the condition is true by ticking the checkboxes
Use the "Show display values" toggle to show the display values instead of technical values of value list items in the table.
How to – work with an external value list
An external value list means that the list is filled with values by an external source, i.e., a piece of code that supplies the values. As Encore does not connect during design time to this external source, you cannot use the values for validating expressions or using drop downs. If you are sure that some values are present in this external source, you can define them in Encore, so that you can validate on them in expressions, and use these values in drop downs. These values defined in Encore are not exported to the runtime, and the runtime completely bases the values from the list on the external source.