2023:Zonal OMR (Value Extractor)

This article is about an older version of Grooper. Information may be out of date and UI elements may have changed.
2025	2023

Zonal OMR is a Value Extractor that reads one or more OMR checkboxes using manually-configured zones. The zone may be optionally fixed on the page or anchored to a static text value (such as a label). BE AWARE: Zonal OMR is outdated compared to Labeled OMR and Ordered OMR. It requires the most manual setup of any OMR extractor to configure. Use this as a last resort when other OMR extractor options have been exhausted.

You may download the ZIP(s) below and upload it into your own Grooper environment (version 2023). The first contains a Project with resources used in examples throughout this article. The second contains one or more Batches of sample documents. Media:2023 Wiki Zonal-OMR Project.zip Media:2023 Wiki Zonal-OMR Batch.zip

About

In previous versions of Grooper (prior to Grooper 2021), OMR extraction was quite different and took a bit more setup than the OMR extractors we can use in Grooper 2023. Now called Zonal OMR, this previous method of OMR extraction still exists, for the most part, for upgrading repositories from old versions of Grooper. That way, anything that used this outdated version of OMR extraction still works in new versions.

It is recommended that you use Labeled OMR or Ordered OMR instead, but as a last resort, you can fall back on Zonal OMR.

⚠	Zonal OMR can only be used with OMR boxes. It will not detect radio buttons. If your document has radio buttons you want returned, you will have to use Labeled OMR for that.

How To

For Zonal OMR to work, we have to assign a Value to each OMR Box individually and tell Grooper where to look for the box on the document.

In the example below, we are using a simple document indicating different emotions. We are going to assign a different emotion to each OMR box and Grooper will return the value assigned to the checked box.

While it should never be your first choice, you can use Zonal OMR in more complex situations not easily accommodated by the other OMR extractors. In the example below, we show a diagram that is being used to indicate the area of impact to a vehicle from a car accident. We can use Zonal OMR to return this type of information.

Glossary

Batch: inventory_2 Batch nodes are fundamental in Grooper's architecture. They are containers of documents that are moved through workflow mechanisms called settings Batch Processes. Documents and their pages are represented in Batches by a hierarchy of folder Batch Folders and contract Batch Pages.

Box: Box is a connection option for cloud CMIS Connections. It Grooper to the Box content management system for import and export operations.

Extract: export_notes Extract is an Activity that retrieves information from folder Batch Folder documents, as defined by Data Elements in a data_table Data Model. This is how Grooper locates unstructured data on your documents and collects it in a structured, usable format.

Extractor Type:

Labeled OMR: Labeled OMR is a Value Extractor used to output OMR checkbox labels. It determines whether labeled checkboxes are checked or not. If checked, it outputs the label(s) or a Boolean true/false value as the result.

Ordered OMR: Ordered OMR is a Value Extractor used to return OMR check box information. Ordered OMR returns information for multiple check boxes within a defined zone based on their order and layout. The zone may be optionally fixed on the page or anchored to a static text value (such as a label).

Project: package_2 Projects are the primary containers for configuration nodes within Grooper. The Project is where various processing objects such as stacks Content Models, settings Batch Processes, profile objects are stored. This makes resources easier to manage, easier to save, and simplifies how node references are made in a Grooper Repository.

Zonal OMR: Zonal OMR is a Value Extractor that reads one or more OMR checkboxes using manually-configured zones. The zone may be optionally fixed on the page or anchored to a static text value (such as a label).

BE AWARE: Zonal OMR is outdated compared to Labeled OMR and Ordered OMR. It requires the most manual setup of any OMR extractor to configure. Use this as a last resort when other OMR extractor options have been exhausted.