User Tools

Site Tools


Guide Section: Processing Object Data | EASAP Tree: DATA PROCESSING Branch

REPEATED EXPAND is similar to SCALAR EXPAND except that lines of text defined in Value: or File: get repeated into a LIST based on any references (DORs) to LIST's.

The list size or number of expand iterations for a REPEATED EXPAND is determined from the size of the LIST(s) in Value:.

LIST DORs in Value: or File: must be the same length.

The default Expansion Separator: is a comma (,).

Optional Parameters:
Value:Sequence of literal text and DORs to expand into one or more lines for insertion into a batch input file.
File:Name of file containing line(s) of text used instead of Value:(DORs allowed)
Delimiter:Character to act as delimiter in DORs in Value: above. default→%
Expansion Separator:Separator used between the values in the list when expanding it. default→comma (,)
Encoding:Text encoding used in File: default→US-ASCII
Value on Error:Value to return if the expansion fails


If multiple lines of text are entered for the Value: parameter, the new lines created by typing the <ENTER> are displayed in the parameter table as spaces.

Expansion Separator:

Expansion Separator: defines the string inserted between successive iterations of the resulting REPEATED EXPAND. Some possible separators are:

  • <SPACE>
  • <TAB>
  • <NEWLINE> (type: <ENTER>)
  • Forward (/) slash
  • Backward (\) slash

To create a single line of output per 'expand' iteration use a <NEWLINE> separator. This is useful to create input for a batch process or on a results page. A <NEWLINE> typed into the Expansion Separator: field in the parameter window will be displayed as a space. To see <NEWLINE> displayed as a blank line, open the Long Text 'popup' window. Click ellipsis icon () and type the <ENTER> key, <NEWLINE> behaves as expected with the cursor now below the blank line.