Capture Text

This filter captures text into a named global variable. Once captured, the variable's value can be output using macros with the filters Add Header/Footer, Add Left/Right Margin, Insert Column/Bytes. It can also be accessed by the TextPipe.getGlobalVar() function from within the scripting filter.

This filter is commonly used to capture header record data to output on each subsequent detail record line. In general, this filter is placed inside a restriction that controls which text gets captured.

It is VERY important to understand how TextPipe processes data to use this filter successfully. For most applications, this will involve placing this filter inside a Restrict to each line in turn filter. If you do not, the text captured will most likely be the very last value found in the file. If you have any questions about this, please contact us.

• Name of global variable
  The name of the global variable to save the value to. This name is not case sensitive.
• Reset to initial value at start of each file
  You can choose to reset the global variable when a new file is started, or to retain the recorded value from previous files.
• Initial value
  The value to give the global variable at the start of the job.