You are viewing the documentation for Blueriq 13. 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.

Parameters


NameDescriptionTypeRequiredVersion
Select entitySelect the name of the entity of which you want to select the instance.Stringtrue
AttributesSelect the attributes from the instances you want to show in the selector.Stringtrue
SelectionExpression used to get a subset from the entity instances.Booleanfalse
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}false> 11.3
RequiredChoose Y (yes), N (no) or C (conditional). If conditional, an editbox appears to edit the condition.{Y,N,C}false
Read-onlyChoose Y (yes), N (no) or C (conditional). If conditional, an editbox appears to edit the condition.{Y,N,C}false
RefreshChoose Y (yes) or N (no).{Y,N}false
Presentation StylesSpecify a list of presentation styles to be appliedList of Presentation Stylefalse> 12


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:

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)




  • No labels