Configuring the Data Iterator node

  1. Select the Data Iterator "start" node. On the General tab, specify this information:
    Configuration name

    Select the configuration that you want to be used for this activity. If you want to use an existing configuration, select a name from the list. If you leave the field blank, the default configuration will be used.

    Input method

    Selects whether the input data will be read from a file or from a variable. Options are "File" or "Data".

    Input file/Input data

    If the input method is File, this field specifies the file name to read.

    If the input method Data, this field should contain a reference to a ProcessFlow variable, for example, <!myVariable>).

    Parse by

    Specifies the method by which the data stream will be parsed. Options are:

    • Line to read the data by line.

      Lines are terminated by a line feed ('\n'), a carriage return ('\r'), or a carriage return followed immediately by a linefeed.

    • Delimiter String to split the data by a specified delimiter string, for example a comma.

    • Length to read a specified number of characters at a time.

    Starting position to read

    A position in the data stream from which to start the read. Default is zero (start at the beginning of the file or variable).

    Maximum read iterations

    The maximum number of read iterations to perform on the file. Leave this field blank or specify "0" for unlimited iterations.

    Bytes to read per iteration

    For the Length parse method only, this specifies the number of characters to read at a time. The activity will read the next n characters or to the end of the input stream.

    Delimiter string

    For the Delimiter String parse method only, this specifies the delimiter string used to split the input stream. The activity will read up to the next instance of the specified delimiter string or to the end of the input stream.

    Ignore trailing delimiter

    For the Line and Delimiter String parse methods, it specifies whether to ignore any trailing delimiter at the end of the stream. If true (checked) and there is a delimiter immediately before the end of the input stream, the delimiter will be ignored. If false (check box is cleared) and there is a delimiter immediately before the end of the input stream, the delimiter will be interpreted as indicating an empty record at the end.

    Accumulate output variables

    Specifies whether records should be output into separate variables as they are parsed. If true (check box is selected), each record will be saved in the activity variable activityName_outputDataN, where activityName is the name of the activity and N is the record number.

  2. On the On Error tab, specify this information:
    What should happen on an error?

    Select from the available options.

    Notify

    Select the check box if you want to send a notification when an error occurs. If this option is selected, you must fill out the notification details.

    Custom log entry

    Select the check box if you want a custom log entry in addition to the system-generated log entry.

  3. Select the Data Iterator "end" node. On the Break Condition tab, specify any valid true/false conditions that must be satisfied if you want to end the iteration.
    Note: 

    If a variable is used as part of the condition, you must remove the surrounding brackets ("<!" and ">").