Extracting Variable-Length Text

The Extract Text Until window allows you to specify how EngageOne™ 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 EngageOne™ Enrichment begins processing the print stream.

The fields in this window are described next.

  • Data Type: This allows you to select how EngageOne™ 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 EngageOne™ 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 EngageOne™ 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 EngageOne™ 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 EngageOne™ 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 EngageOne™ 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 EngageOne™ Enrichment to pick up field information until the end of the record is encountered.
    • Text: Select this option to tell EngageOne™ 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 EngageOne™ Enrichment should stop picking up field information. This can be in any valid string format allowed by EngageOne™ 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 EngageOne™ 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.