# tFlowToIterate

Reads data line by line from the input flow and stores the data entries in iterative global variables.

## tFlowToIterate Standard properties

These properties are used to configure tFlowToIterate running in the Standard Job framework.

The Standard tFlowToIterate component belongs to the Orchestration family.

The component in this framework is available in all Talend products.

## Basic settings

| Properties | Description |
| --- | --- |
| Use the default (key, value) in global<br>variables | When selected, the system uses the default value<br>of the global variable in the current Job. |
| Customize | <ul> <li> <p> <span>key</span>: Type in a                                name for the new global variable. Press <span>Ctrl+Space</span> to access all available variables either                                global or user-defined.</p> </li> <li> <p> <span>value</span>: Click in                                the cell to access a list of the columns attached to the defined                                global variable.</p> </li> </ul> |

## Global Variables

| Variables | Description |
| --- | --- |
| Global Variables | ERROR\_MESSAGE: the error message generated by the<br>component when an error occurs. This is an After variable and it returns a string. This<br>variable functions only if the Die on error checkbox is<br>cleared, if the component has this checkbox.<br><br><br>NB\_LINE:<br>the number of rows processed. This is an After variable and it returns an integer.<br><br><br>CURRENT\_ITERATION: the sequence number of<br>the current iteration. This is a Flow variable and it returns an integer.<br><br>A Flow variable functions during the execution of a component<br>while an After variable functions after the execution of the component.<br><br>To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from<br>it.<br><br>For more information about variables, see [Using contexts and variables](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/contexts-and-variables). |

## Usage

| Usage guidance | Description |
| --- | --- |
| **Usage rule** | You cannot use this<br>component as a start component. tFlowToIterate<br>requires an output component. |
| Connections | Outgoing links (from this component to another):<br><br><br>Row: Iterate<br><br><br>Trigger: Run if; On Component Ok;<br>On Component Error.<br><br>Incoming links (from one component to this one):<br><br><br>Row: Main;<br><br>For further information regarding connections, see [Using connections in a Job](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/using-connections-in-job). |

**Related concepts**

* [Passing a value from a parent Job to a child Job](https://help.qlik.com/talend/en-US/components/8.0/orchestration/component-trunjob-pass-value-from-parent-to-child "Passing a value from a parent Job to a child Job is a common real world requirement. In this example, you read data from a text file in a parent Job and pass fields from each row to a child Job. The data is used in the child Job.")
* [Running a list of child Jobs dynamically](https://help.qlik.com/talend/en-US/components/8.0/orchestration/tflowtoiterate-trunjob-tfixedflowinput-tlogrow-running-list-of-child-jobs-dynamically-standard-component-the "This scenario describes a Job that calls specific child Jobs dynamically in a given order based on a child Job list.")
* [Transforming data flow to a list](https://help.qlik.com/talend/en-US/components/8.0/orchestration/tflowtoiterate-tfileinputdelimited-tlogrow-tlogrow-transforming-data-flow-to-list-standard-component-the)