The first action retrieves the initial value and subsequently retrieves the value obtained by adding the increment to the previously retrieved value. “When an Element is Fetched from List” is occured.
Extract one number from the range specified by the parameters. The extracted number becomes the result value of the action, and “When an Element is Fetched from List” occurs. Please note that only one number is extracted per action execution. To extract all the numbers within the range, you need to repeatedly perform the same action.
The retrieved number is stored, and “Get a Date from Date Range” is executed again with the same action number to retrieve the next number. At this time, the action result value is overwritten, and the previous result value is lost. If the action numbers are different, the numbers will be stored separately for each action.
If all the numbers up to the last number of the range have been retrieved, the action’s result value will be empty when you “Get a Date from Date Range.” 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 numbers from the range until the last number of the range, the result of the action will be empty, but at this time, the extraction position will be reset. When executing “Get a Date from Date Range” again, the number is retrieved from the start of the range once more.
For example, if the range of numbers is 1 to 100 and the increment is 30, 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 | 1 | Occur | Not occur 2nd time | 31 | Occur | Not occur 3rd time | 61 | Occur | Not occur 4th time | 91 | Occur | Not occur 5th time | Empty | Not occur | Occur 6th time | 1 | Occur | Not occur
In the above example, “When Another Action Complete ” occurs all six times.
Set Start Value, End Value, Include End Value in Range, Increment, and Count Limit.
Specify the start number of the range.
To access the value of the Number field, enter the field code as follows:
=Number_2
Insert an equals sign “=” before the field code to access the value of that field.
Specify the end number of the range.
The value cannot be less than Start Value. If a value smaller than the Start Value is specified, an error will occur at runtime.
Like the Start Value, it is possible to reference the value of the field using an expression.
Select whether to include the exact end value in the range. If the current value matches the end value, it will be included in the extraction if “Yes” is selected for “Include End Value in Range.” However, if “No” is selected for “Include End Value in Range,” the current value will not be included, and the process will be complete.
Ex: If the Start value is 100, the End value is 200, the Increment is 25, and “Include End Value in Range” is set to Yes, the resulting list would be [100, 125, 150, 175, 200].
Ex: If the Start value is 100, the End value is 200, the Increment is 25, and “Include End Value in Range” is set to No, the resulting list would be [100, 125, 150, 175].
Even if “Include End Value in Range” is set to Yes, the end value will not be included in the target if the increment added exceeds the End Value.
Ex: If the Start value is 100, the End value is 200, the Increment is 30, and “Include End Value in Range” is set to Yes, the resulting list would be [100, 130, 160, 190].
200 will not be extracted.
Specify the value to increase from the previously extracted value to execute “Fetch Number From Range” for subsequent attempts.
You can specify it in the expression.
Cannot be less than zero.
The first “Start Value” extraction counts as the initial occurrence, and a limit is set on how many times it can be extracted with the same action number. For example, if the “Count Limit” is set to 10, the 10th extraction will be successful. However, the 11th extraction will yield no results, and the event “When an Element is Fetched from List” will not occur. Instead, “When Fetching List is Finished” will appear.
Ex: If the Start value is 100, the End value is 200, Increment is 1, and the Count Limit is 5, the resulting list would be [100, 101, 102, 103, 104].
When the extracted value exceeds the “End Value”, the count is reset to zero, and the next extraction will restart from the “Start Value” with a count of 1.
Values less than or equal to zero cannot be specified.
In particular, when extracting while varying the increment, infinite repetition is risky depending on the calculation content. By setting a “Count Limit,” you can avoid infinite repetitions.