You are viewing the documentation for Blueriq 17. Documentation for other versions is available in our documentation directory.

What is it for?

The AQ_InstanceLinker is used to set a Relation between a user-selected instance of a multiton Entity and another (singleton or multiton) instance via a dropdown list

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

  1. Create a new Container
  2. Select AQ_InstanceLinker as the Container Type
  3. Set the correct parameters (see below)
  4. Add a new Relation to your Page
  5. Select the Entity that you want link to a user-selected instance
  6. Select the Relation that leads to the multiton Entity for which the user should select an instance
  7. Select the AQ_InstanceLinker container that you just created
  8. A dropdown box will now be shown on the Page in the Runtime. 

Parameters


NameDescriptionTypeRequired
Select entitySelect the name of the entity of which you want to select the instance.StringYes
AttributesSelect the attributes from the instances you want to show in the selector.StringYes
SelectionExpression used to get a subset from the entity instances.BooleanNo
Sort orderOrder 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}No
Sort attributeInstead of sorting by the attribute values selected on the 'Attributes' parameter; sort by a specific attribute.StringNo
RequiredChoose Y (yes), N (no) or C (conditional). If conditional, an editbox appears to edit the condition.{Y,N,C}No
Read-onlyChoose Y (yes), N (no) or C (conditional). If conditional, an editbox appears to edit the condition.{Y,N,C}No
RefreshChoose Y (yes) or N (no).{Y,N}No
Presentation StylesSpecify a list of presentation styles to be appliedList of Presentation StyleNo


Example

To let a user select a billing address out of several addresses they have submittedyou could create an AQ_InstanceLinker that displays entity Address and attributes Address.StreetAddress.HouseNumberAddress.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 example above is the display name of the container and the bold black text is the question text of the relation "HasBillingAddress".