The relationship "Create Element List" enables a list of AWM elements to be created. If an action is to create an element list, it must have defined a "Create Element List" relationship.
Depending on where the action is referenced, the created element list is displayed in the Table Results view or as a new tree item in the Application Explorer view.
Element lists are always created from structured files which are typically returned as output parameters of one of the executed tools within the action. It is also possible to specify existing files as file descriptors. In this case, the execution of a tool descriptor is not necessary.
As soon as the "Create Element List" step is executed as part of the action descriptor, AWM will attempt to resolve an element list from the file descriptor referenced by the TargetID attribute.
An element list can only be created if the referenced file descriptor has a structured definition and contains all required properties.
Actions are limited to create only one element list at a time. Multiple "Create Element List steps" are only enabled, if they are contained within conditional statements which prevent more than one step to be executed when evaluated at runtime.
If the element list creation step fails for any reason, the action will be aborted with an error message. This includes attempting to create more than one element list in a single action.
| Attribute | Type | Description |
|---|---|---|
| Target ID* | File Descriptor | The reference to a structured file descriptor to create an element list from. |
| Context Name [O] | String | Name of an execution context previously created using
Tool has Named Context. The referenced file descriptor is searched within the referenced context.
If left empty, the file descriptor will be searched in the current context, which is either the main context or custom context from a parent action descriptor statement. For example, If Else. |
| Table Structure [O] | Element List Structure | Element list structure to use for displaying the created element list in the Table Results view.
This attribute is ignored if the action descriptor is executed as Get Children or Get Root Containers action, as the created list will be displayed in the Application Explorer tree view, without columns. In all other cases this attribute is mandatory. |
| Table View ID [O] | String | Table Results view secondary ID to add the created element list to.
If no Table Results view instance exists for the specified ID then AWM will create a new one. This attribute is ignored if the action descriptor is executed as Get Children or Get Root Containers action. |
| Table View Label [O] | String | Title of the Table Results view instance this element list is added to.
Micro Focus recommends you only specify a table view label if a custom table view ID is used. This attribute is ignored if the action descriptor is executed as Get Children or Get Root Containers action. |
| Relationship | Cardinality | Description |
|---|---|---|
| Has_Element List Property | 0..* | Relationship to a property. The property is available in the context of the element list and every item of the element list. |