Retrieve All Values

The “Retrieve All Values” attribute can be used to dynamically retrieve valid values for a property at run time. The attribute requires an action descriptor to be referenced which must contain a tool that returns a list of values. A file descriptor must be used to model the tool output.

The Retrieve All Values action can only be executed in a modeled input dialog. See Open Modeled Dialog for more information. If a property with a Retrieve All Values action is used as an editable input field in a dialog, a Retrieve button will be displayed next to it. Click Retrieve to execute the action and populate the dialog field with the returned values.

If several tool descriptors of the retrieve action return file descriptors then the last one is used by AWM.

The context of the retrieve action contains all properties from the main context plus all values from the current dialog. You can use the dialog fields as input parameters for the retrieve action, as seen in the following figure:

Additionally, you can return labels for the retrieved values. The selection list in the dialog will then display only the labels, while selecting an item will put the value into the input field.

You cannot use a property of the type Text Array to support the Retrieve All Values action.

The label of the Retrieve button can be customized using the specific attribute defined under Application Options.

If the retrieve action returns just one value, then the value is directly filled in the editable field and the selection list is not used. The retrieve action can be used for dialog fields where the user should enter a file or folder.

There are two different ways you can model a Retrieve All Values action depending on the “Values From” attribute in the “Retrieve All Values” category of a property:

1. Values From = Matching Property

   This is the recommended selection. This means that AWM uses a defined search hierarchy to find values and labels. The property attributes "Value Property" and "Label Property" can be set to define which properties should be used to retrieve values and labels. If the "Label Property" is not set, the value from the "Value Property" will be used as a label, as well. If the "Value Property" is not set, the Property ID will be used as the value.

   Search hierarchy:

   • The last file descriptor of the Retrieve All Values action containing the “Value Property” will be used to retrieve the value. If a file descriptor is found, the value for the label property will be retrieved from the same file descriptor. Any structured file descriptor is supported.
   • If the “Value Property” cannot be found in any file descriptor defined for tools of the action, the “Value Property” and “Label Property” will be searched for among the mass processing input and output parameters.
   • If the “Value Property” cannot be found among the mass processing input and output parameters, the “Value Property” and “Label Property” will be searched for among the single processing input and output parameters.

2. Values From = Output Table

   The modeled Retrieve All Values action descriptor needs to contain a tool descriptor which returns a table structured file descriptor. The file descriptor must have at least one relationship to a property. If several tool descriptors of the retrieve action return file descriptors, the last one will be used by AWM.

   To support labels in the combo box, simply return two values for each line of the structured file descriptor. AWM will interpret the first value of each line as the value and the second as the label. Additional values returned in the file descriptor are ignored.