Extracting Variable-Length Text

The Extract Text Until window allows you to specify how Enrichment will pick up a variable-length text field and to define treatment of intervening AFP codes or Metacodes. To access this window, open a print stream, click on the field you want, select Field > Properties, and then click Extract Text Until.
Note: Visual Engineer supports only the creation of the <TEXTUNTIL> tag. The actual function of the tag will not be carried out until Enrichment begins processing the print stream.

The fields in this window are described next.

  • Data Type: This allows you to select how Enrichment will detect the end of the extracted text. The options are:
    • None: Select this option if you do not want to specify the <TEXTUNTIL> tag while you are in the Extract Text Until dialog box or if you want to remove the <TEXTUNTIL> tag specified for the field.
    • String: Select this option to tell Enrichment to pick up field information until the string specified in the Data Value field is encountered.
    • Absolute x move: Select this option to tell Enrichment to pick up field information until an absolute x move is encountered. This option is valid only for AFPDS, AFPMIXED, or METACODE inputs.
    • Relative x move: Select this option to tell Enrichment to pick up field information until a relative x move is encountered. This option is valid only for AFPDS, AFPMIXED, or METACODE inputs.
    • Absolute y move: Select this option to tell Enrichment to pick up field information until an absolute y move is encountered. This option is valid only for AFPDS, AFPMIXED, or METACODE inputs.
    • Relative y move: Select this option to tell Enrichment to pick up field information until a relative y move is encountered. This option is valid only for AFPDS, AFPMIXED, or METACODE inputs.
    • End of record: Select this option to tell Enrichment to pick up field information until the end of the record is encountered.
    • Text: Select this option to tell Enrichment to pick up field information until any AFP code or Metacode is encountered. This option is valid for any input type except PCL and POSTSCRIPT.
  • Data Value: The type of value you enter in this field varies according to your selection under Data Type, as follows:
    • If you set Data Type to String, Data Value is the string at which Enrichment should stop picking up field information. This can be in any valid string format allowed by Enrichment. A string containing spaces should be enclosed in a pair of single quotes or double quotes.
    • If you set Data Type to Absolute x, Relative x, Absolute y, or Relative y, Data Value is a size measured in the units specified in the Units field that determines the point at which Enrichment will stop picking up field information. Leave Data Value blank to stop picking up field information at the first move of the specified type.
    • If you set Data Type to End of record or Text, leave Data Value blank.