Multi-Value Tokens

A multi-value token contains two or more distinct values. The following processes can return a multi-value token: Assign Token Value, Retrieve PDF Form Content, Token Accumulator, OmniPage Zone OCR, Barcode, and Pattern Matching.

Note: You can make any token a multi-value token using the Split function in the Token Editor.

Example: Laura uses a multi-value token to populate a field. Her token contains three phone numbers, each of which is a separate value. In this situation, the corresponding field will only contain the first phone number. If the field accepts multiple values, all three phone numbers will be populated in the multi-value field.

Note: In most cases, when you use this type of token, it will only return the first value of the multi-value token. This is also the case when using multi-value tokens in sticky notes. Only the first value will be returned.

Note: You can use the Token Accumulator process to accumulate values from one or more tokens across a range of pages within the same document and create a multi-value token with those values.

The following options are available to modify the value that is returned by a multi-value token.

• Specify the delimiter that should be used to separate values.
  
  Use the following syntax: %(ZoneName#[delimiter]#). For example, %(ZoneName#[ | ]#) will use <blank space>|<blank space> as the delimiter, such as 1 | 2 | 3.

  Note: Numbers cannot be used as delimiters because they are reserved for indexes. (See below).

• Specify that only a single value should be returned.
  
  If you only need a single value in a multi-value token, use the following syntax: %(ZoneName#[n]#) where n equals the index number of the value you want. For OmniPage Zone OCR, index 1 is the text on the first OCRed line. For barcode, index 1 is the first barcode. For example, %(ZoneName#[3]#) will return the third line of text or barcode. If n is less than zero, Quick Fields will count from the bottom up. For example,%(ZoneName#[-1]#)will return the last line of text or barcode, while %(ZoneName#[-5]#)will return the fifth value from the bottom-up.

  Note: Do not specify a range of index numbers that should be returned. For example, %(ZoneName#[1-3]#) would not work. In fact, 1-3 would be used as a delimiter.