Capture text

TextPipe: Online Help Capture text	Submit feedback on this topic
Home User Assistance Tutorials How to Use TextPipe Menus: File Edit Filters[ Wizards Convert Unicode Add Remove Replace Extract Special Maps Restrict ] Tools Window Help Advanced

Home
Up

(Pro version only)

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.