You are viewing the documentation for Blueriq 14. 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.
Parameters
Name | Description | Type | Required | Version |
---|---|---|---|---|
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 | > 11.3 |
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 | > 12 |
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:
Behavior before 10.7: The display text of the AQ_InstanceLinker is used as the question text of this relation, even if the linker text field is empty and the relation question field is not.
Behavior after 10.7: The display text of the AQ_InstanceLinker is only used as a header. (Blueriq 10.7 Release Notes, CSD-2135)