View source for 2023:Highlight Zone (Value Extractor)

{{AutoVersion}}
<section begin="glossary" />
<blockquote>
The '''''Highlight Zone''''' extractor uses zonal information to highlight a region of a document.
</blockquote>
<section end="glossary" />
Please note, this "extractor" doesn't actually extract any text from a document.  It is most often implemented as a visual aid for users reviewing documents during '''Review''', highlighting troublesome fields on a document users will need to manually enter.  

== About ==
''Highlight Zone'' is a zonal extractor designed to aid '''Review''' users performing data review by highlighting specific region on a document that needs to be verified. It's very similar to the '''''Read Zone''''' extractor in that you use one of the four '''''Location''''' options (''Fixed Region'', ''Relative Region'', ''Shape Region'' or ''Text Region'') to draw an extraction zone on a geographic region of the page.

However, rather than returning the OCR or native text data within the zone, nothing is actually extracted. Instead, it simply places a zone in a particular location on a document. In terms of a "data instance", it returns an instance location but no text value whatsoever. Most commonly, this extractor will be used to aid document reviewers, highlighting a troublesome field on the document for manual review.

{|class="attn-box"
|-
|⚠
|
'''BE AWARE:''' '''''Highlight Zone's''''' setup is similar to the '''''Read Zone''''' extractor in that it uses the same '''''Location''''' properties the '''''Read Zone''''' extractor uses to draw the an extraction zone.
* This article presumes you are familiar with the '''''Read Zone''''' extractor and its setup.
* If you are not familiar with '''''Read Zone''''', you may find it helpful to review the [[Read Zone]] article prior to following the tutorial in this article.
|}


== How To ==

{|class="download-box"
|
[[File:Asset 22@4x.png]]
|
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 Highlight-Zone Project.zip]]
* [[Media:2023 Wiki Highlight-Zone Batch.zip]]
|}

<br>
In this example, we are going to collect the Signature Date from the Application for Cow Ownership document. 

Often, Grooper has a difficult time extracting hand written information. OCR generally just does not work well on handwritten information. We are going to assume this might be the case for these handwritten dates, so we will need a Reviewer to come back through and manually enter in the information from the document. We can use ''Highlight Zone'' to make this easier for the Reviewer. 


[[File:2023 Highlight Zone - 2023 01 How To 01.png]]


[[File:2023 Highlight Zone - 2023 01 How To 02.png]]


[[File:2023 Highlight Zone - 2023 01 How To 03.png]]


[[File:2023 Highlight Zone - 2023 01 How To 04.png]]


[[File:2023 Highlight Zone - 2023 01 How To 05.png]]


[[File:2023 Highlight Zone - 2023 01 How To 06.png]]