Skip to main content

Process Field

Processes specific fields from submitted images using ABBYY Cloud OCR service.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.

Inputs​

  • Task ID - Task ID from a previously submitted image. This task should contain field-level processing instructions.

Options​

  • Description - Optional description for the processing task.
  • Write Recognition Variants - Whether to include recognition variants for uncertain characters in output (default: false).

Outputs​

  • Task - ABBYY task object containing field processing results with recognized field values.

How It Works​

The Process Field node processes specific fields from images that were previously submitted. When executed, the node:

  1. Retrieves the submitted image using the task ID
  2. Processes defined field regions with OCR
  3. Extracts text from each field area
  4. Optionally includes recognition variants for uncertain characters
  5. Returns a task object with field values and confidence levels

Requirements​

  • Valid ABBYY Cloud credentials
  • Task ID from a previously submitted image with field definitions
  • Field regions should be defined in the submission

Error Handling​

The node will return specific errors in the following cases:

  • Robomotion.ABBYYCloud.ErrTaskID - Task ID is invalid or empty
  • Robomotion.ABBYYCloud.ErrDescription - Invalid description format

Usage Example​

Scenario: Extract specific fields from a form after submission

1. Submit Image or Process Text node to create task

2. Process Field node:
   - Task ID: {{ $.task.id }}
   - Write Recognition Variants: true
   - Description: "Extract form fields"

3. Wait Task node:
   - Task: {{ $.task }}
   - Timeout: 30 seconds

4. Extract field values from results

Common Use Cases​

  • Form Field Extraction - Extract specific fields from form images
  • Multi-Field Processing - Process multiple related fields together
  • Template-Based OCR - Use field templates for consistent forms
  • Field-Level Validation - Get recognition variants for validation
  • Structured Data Extraction - Extract data with defined field positions

Tips and Best Practices​

  • Task Workflow:
    • First submit the image with field definitions
    • Then use Process Field to extract field data
    • Combine with Process Text for advanced field recognition
  • Recognition Variants:
    • Enable for uncertain or low-quality text
    • Provides alternative interpretations
    • Useful for validation and error detection
    • Adds slight processing overhead
  • Field Definition:
    • Define fields clearly in submission task
    • Use consistent field naming
    • Specify field types when possible
  • Description Usage:
    • Add meaningful descriptions for tracking
    • Include form ID or reference number
    • Helps with debugging and logging
  • Error Handling:
    • Check task status before processing
    • Verify all required fields are present
    • Handle missing or invalid fields gracefully