You are viewing the documentation for Blueriq 15. Documentation for other versions is available in our documentation directory.
What does it do?
The AQ_InstanceLinker displays a dropdown list of instances. The InstanceLinker container should be added to the page through a relation. When the page is committed, the relation is filled with the selected instance.
How to - add an AQ_InstanceLinker to a Page
- Create a new Container
- Select AQ_InstanceLinker as the Container Type
- Set the correct parameters (see below)
- Add a new Relation to your Page
- Select the Entity that you want link to a user-selected instance
- Select the Relation that leads to the multiton Entity for which the user should select an instance
- Select the AQ_InstanceLinker container that you just created
- A dropdown box will now be shown on the Page in the Runtime.
Parameters
Name | Description | Type | Required |
---|---|---|---|
Select entity | Select the name of the entity of which you want to select the instance. | String | true |
Attributes | Select the attributes from the instances you want to show in the selector. | String | true |
Selection | Expression used to get a subset from the entity instances. | Boolean | false |
Sort order | Order to sort the instances shown, based on the shown attributes (if the first attribute is not unique, the second attribute is sorted and so on) | {None (default), Ascending, Descending} | false |
Sort attribute | Instead of sorting by the attribute values selected on the 'Attributes' parameter; sort by a specific attribute. | String | false |
Required | Choose Y (yes), N (no) or C (conditional). If conditional, an editbox appears to edit the condition. | {Y,N,C} | false |
Read-only | Choose Y (yes), N (no) or C (conditional). If conditional, an editbox appears to edit the condition. | {Y,N,C} | false |
Refresh | Choose Y (yes) or N (no). | {Y,N} | false |
Presentation Styles | Specify a list of presentation styles to be applied | List of Presentation Style | false |
Example
To let a user select a billing address out of several addresses they have submitted, you could create an AQ_InstanceLinker that displays entity Address and attributes Address.Street, Address.HouseNumber, Address.City.
You would then add a relation to your page or container and select "Customer", "HasBillingAddress", and this AQ_InstanceLinker:
The result would look like this:
The pink text in the xample above is the display name of the container and the bold black text is the question text of the relation "HasBillingAddress".