Page History
Info | ||||
---|---|---|---|---|
| ||||
The AQ_InstanceList is used for displaying a list of instances of a selected Entity. The AQ_InstanceList can contain Attributes and/or Buttons |
The AQ_InstanceList container shows instances of an entity, and of subtypes of that entity (see Containers for Lists). The container can contain an expression to filter the entities shown. The instances to show can also be filtered by accessing the container through a multi-valued relation (i.e., setting the context for the container).Content
What goes in an AQ_InstanceList?
You model this container by placing attributes and buttons inside the content section (in addition to filling out parameters, see below). You usually place attributes in the content which belong to the entity chosen at the entity
parameter. At runtime, each row of the container belongs to one instance of the chosen entity, and it shows the attribute values corresponding to that instance. While it is possible to have the attributes editable, it is best practice to have them read-only. When adding a button, it is repeated for each instance. When the end user clicks on such a button, the corresponding instance is activated, and you can model a page to edit or delete the corresponding instance (or some other actions that you want to do with the instance).
Headers
Each element in the content of this container corresponds to a column of the container. Each column is preceded by a header text, defined in the headercontainer
parameter, if one is set. This container should contain Text items for each column. It is best practice to have the same number of headers as columns.
Grouping multiple elements in columns
It is possible add (inline) containers to the content of the AQ_InstanceList. Each container is a single column in the list view at runtime. This allows for styling to be applied to a set of values or buttons. If this is not intended, then you should remove all containers so that all elements are at the highest level in this container.
Parameters
Name | Description | Type | Required |
---|---|---|---|
referrer-path | Attribute/relation path to determine which instances to show, starting from a particular entity. | String | false |
entity | Name of the entity of which the instances will be shown. | String | true |
noinstancecontainer | Container that will be shown when there are no instances to show. | String | false |
headercontainer | Container (with assets) of the header. | String | false |
whereclause | Expression to determine which instances to show. Only to be used when the container is accessed through a relation. | String | false |
sortattribute | Attribute that is used to sort the instances. | String | false |
sortorder | The order in which the list will be sorted. | “ascending” or “descending” | false |
sortunknownsaslast | With this setting all unknown values are sorted as last, irrespective if the sorting is ascending or descending. | Boolean | false |
pagingsize | The number of entries that you want to display on a single page. | Integer | false |
Sorting and paging
At runtime this container will show a paginated list of instances, that can be sorted by the end user. When the list doesn't fit on one page, a search box appears. This box matches the search text with entries in all attribute columns. This means that an instance is shown if the string is present as substring in one of the attribute columns. No wildcards are possible. Searching and sorting does not work on other columns, such as text items and containers.
Related articles
Content by Label | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|