Assign Token Value

Assign Token Value creates new tokens and updates the values of existing tokens. These tokens can be used like any other token in Quick Fields (populating fields, creating folder paths, etc.) Assign Token Value can be used in Pre-Classification Processing, First Page Identification, Page Processing, Last Page Identification, and Post-Processing.

Example: The City of Graceland recently updated their invoice forms and moved the invoice number from the top left of the invoice to the top right. All the other information on the invoice is the same, but because of this one difference, they now have two types of invoices. Instead of creating an additional document class to account for this change, they can use a Conditional process, some Zone OCR processes, and an Assign Token Value process to retrieve the invoice number. First, they would add a Zone OCR process under Page Processing that will read the top left of the invoice and save the value as a token. Then, a Conditional process could be added that will check that Zone OCR value and if it does not equal an invoice number, it will run another Zone OCR process that will read the top right of the form and save that value as a token. They now have two tokens and are not sure which one is the correct one. In this case, they could add an Assign Token Value process in the Conditional under the Zone OCR that would replace the first Zone OCR's token value with the second Zone OCR's token value. Now, they will know that the first Zone OCR's token will always have the correct value and they can use that token in their Invoice Number field with confidence.

Example: Blair Inc. processes three similar invoices that have the total amount due in a different location on each invoice. They configure Zone OCR to read three different locations on the invoices to find the total amount due. This results in three different values (two blank and one with the actual amount due). Instead of placing all three tokens in the Total Amount Due field (all three because they do not know ahead of time which zone that was read contains the correct token value), they use an Assign Token Value process to create one token that contains all three tokens from the Zone OCR process. They place this new token into the field.

To configure Assign Token Value

  1. In the Session Configuration Pane, select the stage of processing where you want to use Assign Token Value.
  2. In the Tasks Pane, select Assign Token Value.
  3. You can optionally enter a name for the process under Process Name.
  4. Move through each step of the wizard at the bottom of the pane. You can also click Skip Wizard to display and configure the properties all at once.
  5. Page Range: When configuring this process in Page Processing or Post-Processing, you will be prompted to specify a page range. In other stages, default settings will be automatically applied.
  6. Assigned Tokens: Click Create to create a new token or Modify to update an existing token.

    To create a new token

    1. Click Create in the Assigned Tokens property box.
    2. In the Create New Token dialog box, type a name for the new token next to Create a new token named.
    3. Optional: Select the checkbox next to Allow token to have multiple values to create a multi-value token.
    4. Type in a token value, or click the token button (right arrow) to use tokens. You can select Token Dialog from the token button drop-down menu to modify and format tokens.
    5. Click OK.

      Note: Tokens created in an Assign Token Value process can be used later in the process. For example, you configure a Zone OCR process to OCR several prices from an order form. Using Assign Token Value, you can create a new multi-value token that contains these prices. In the same Assign Token Value process, you can create another token that uses token functions to sum those same Zone OCR prices.

    To modify an existing token

    1. Click Modify in the Assigned Tokens property box.
    2. In the Assign Token Value dialog box, select the process that produced the token you want to modify from the Process drop-down menu.
    3. Select the token from the Token drop-down menu.
    4. Type in a new value for the token, or click the token button (right arrow) to use tokens. You can select Token Dialog from the token button drop-down menu to modify and format tokens.
    5. If modifying a multi-value token, you can select if you want to replace the existing values or append to them.
    6. Click OK.

    Note: Tokens created in the Assign Token Values process can be used later in the process. For example, you have a Zone OCR process that retrieves several prices from an order form. Using Assign Token Values, you can create a new multi-value token that contains these prices. In the same Assign Token Values process, you can create another token that uses token functions to sum those same Zone OCR prices.

    Note: Assign Token Value cannot modify tokens created in First Page or Last Page Identification.

    Note: Some processes come with the basic Quick Fields installation, and some must be purchased as add-ons. Contact your reseller for more information.