ActionList
Purpose
The ActionList ViewTemplate displays multiple datasets as a vertical list of actionable entries. Each entry combines an icon, a clickable title, and a description, which makes this ViewTemplate suitable for compact action-oriented lists such as file downloads or quick access to related records.
Figure: ActionList displaying document entries in a contact's PreviewView.
Behavior
Each list item represents one dataset. The title is rendered as a link and triggers the configured entryAction. The list itself is read-only and focuses on interaction through that Action.
Each entry can display the following elements:
- an icon, defined through
iconField - a clickable title, defined through
titleField - a description, defined through
descriptionField
Configuration
The following properties are typically configured:
| Property | Description | Example |
|---|---|---|
titleField | Defines the clickable title of each list entry. | NAME_LINKED |
descriptionField | Defines the descriptive text below the title. | DESCRIPTION |
iconField | Defines the icon shown for each entry. | ICON |
entryAction | Defines the Action executed when the title is clicked. | downloadSingleFileAction |
The referenced fields must exist in the Entity used by the source View or ViewTemplate. In the example below, this is Document_entity from module document.
Example usage
An example can be found in PersonPreview_view in Context Person. The ViewTemplate Actions references DocumentList_view in order to present related documents.
In the ADITO client, this ViewTemplate can be seen under Contact Management > Contact after selecting a contact person. In the PreviewView, the section Relevant Documents displays a list of documents that have been marked for preview usage in the contact person's MainView.
Each entry shows the document name, a description, and an icon. Clicking the title executes the configured entryAction, which in this example downloads the selected file.
Implementation hints
Only one entryAction can be configured for the entire list. Different Actions per row are not supported.
Notes
Use ActionList when related records should be presented as a compact list and all entries trigger the same Action. For more general button-based operations without row data, use the Actions ViewTemplate instead.