Customize

Fetch List Element

Summary

The elements of the list are fetched in order, and “When an Element is Fetched from List” is occurred.

How to use

Extract one element from the list specified by the “List” parameter. The extracted number becomes the result value of the action, and “When an Element is Fetched from List” occurs. Please note that only one element is extracted per action execution. To extract all elements within the list, you need to repeatedly perform the same action.

The retrieved position is marked, and the “Fetch List Element” is executed again with the same action number to retrieve the item from the next position. At this time, the action result value is overwritten, and the previous result value is lost. If the action numbers are different, the extraction positions will be marked separately for each action.

If you extract elements from the list when you have already taken them all out or if the list was originally empty, the result value of the action will be empty. In this case, “When an Element is Fetched from List” does not occur, instead, “When Fetching List is Finished” appears. In any case, “When Another Action Complete” occurs.

As mentioned above, when extracting items from the list until the last position of the list, the result of the action will be empty, but at this time, the extraction position will be reset. Furthermore, when you execute “Fetch List Element” once more, the element will be obtained from the beginning of the list.

For example, if the value of the “List” parameter is [“A”, “B”, “C”], the result of repeated execution will be as follows: Time | Execution Result | When an Element is Fetched from List | When Fetching List is Finished ———-|——-|——————————-|———————————- 1st time | “A” | Occur | Not Occur 2nd time | “B” | Occur | Not occur 3rd time | “C” | Occur | Not occur 4th time | Empty | Not occur | Occur 5th time | “A” | Occur | Not occur

In the above example, “When Another Action Complete ” occurs all five times.

Parameters

Set List.

List

Specify the list. A list is a collection of multiple elements arranged in a specific order. It is also called an “array.”

If something other than a list or array is specified, it is considered to be an array with the specified item as one element.

To specify a meaningful list, you need to use an expression. For example, you can specify a list with an expression like the following:

Example: A list of users selected in the user selection field.

=User_selection

Example: List of table rows

= Table_1

Example: A list of records obtained from other actions

If action number 1 was “[Retrieve Records by Providing Key[,”

= $1

Example: Fixed list

= ["🍵","☕","🥛"]