Get Item from Collection
Description
The Get Data Item part retrieves a specific item value from a collection. It is shown in the Designer Part Editor menu as Get item in collection.
Use
This part can be used to retrieve values within a similar set. Often, this part is used within a loop that cycles through all items one at a time, where each item has to be processed by similar logic or decision trees.
Tips and Tricks
Note it is not possible to retrieve a specific value from a collection using this part. Instead the logic process would be
- create a rule to check if a specific value exists and continue process from there
- or loop through the values until a rule checking for the value becomes true (if collection is small)
To find exact position use query collection with a condition, get the path to the result and extract the item number using text pattern matching.
Editor Fields
| Field Name |
Description/Use |
Type/Options |
Optional/Mandatory |
| Data object | This is the data object that will be assigned the value retrieved from the specific position in the collection. | Data Object | Mandatory |
| Group | With this option you can create a top-class and assign the Data object's parent and call the date object via the parent. Data object: my_date_object Group: my_group To use: my_group.my_date_object "Group" is meant to be a container of data objects. If the "Group" field is empty then my_date_object should be called directly without any parent extension. |
Text |
Optional |
| Collection |
This is the collection containing the items for inspection. |
Data Object |
Mandatory |
| Position |
This is the position number of the value to be changed. |
Number |
Mandatory |
Example
Download and import the following example project in your workspace.