2.80:Header-Value (Table Extract Method) - Revision history

Dgreenwood at 15:08, 5 August 2025

2025-08-05T15:08:49Z

← Older revision		Revision as of 10:08, 5 August 2025
Line 1:		Line 1:
			__NOINDEX__
	{\|cellpadding=10 cellspacing=5 style="margin:12px"		{\|cellpadding=10 cellspacing=5 style="margin:12px"
	\|-		\|-

Dgreenwood at 16:10, 29 December 2023

2023-12-29T16:10:45Z

← Older revision		Revision as of 11:10, 29 December 2023
Line 1:		Line 1:
			{\|cellpadding=10 cellspacing=5 style="margin:12px"
			\|-
			\|style="font-size:200%; background-color:#662d91; color:white; width:28px; text-align:center"\|'''‼'''
			\|style="border: 4px solid #662d91"\|
			'''LEGACY TECHNOLOGY DETECTED!!'''

			In version 2023.1 '''''Header-Value''''' was fully deprecated. It has been replaced with the '''''[[Tabular Layout]]''''' table extract method.
			* '''''Tabular Layout''''' was created as an improved version of '''''Header-Value''''', still using column headers and their values to collect table data, but with simpler initial setup and a vast suite of additional functionality to target more complicated table structures.
			* For older installs, when upgrading to version 2023.1, '''Data Tables''' configured with '''''Header-Value''''' will automatically be converted to '''''Tabular Layout'''''.
			** Please note, you will want to perform rigorous upgrade testing to ensure your table extraction works as expected. You may need to adjust your header extractors and/or '''''Tabular Layout''''' settings.
			* For more information on '''''Tabular Layout''''' [[Tabular Layout\|visit this article]].
			\|}

	[[File:Header val property panel.png\|frame\|The Header-Value Extract Method's properties]]		[[File:Header val property panel.png\|frame\|The Header-Value Extract Method's properties]]
	~~<onlyinclude>~~
	<blockquote style="font-size:14pt">		<blockquote style="font-size:14pt">
	''Header-Value'' is one of three methods available to '''Data Table''' elements to extract information from tables on a document set. It uses a combination of column header and column value extractors to determine the table’s structure and extract information from the table’s cells.		''Header-Value'' is one of three methods available to '''Data Table''' elements to extract information from tables on a document set. It uses a combination of column header and column value extractors to determine the table’s structure and extract information from the table’s cells.
	</blockquote>		</blockquote>
	~~</onlyinclude>~~

	== About ==		== About ==

Dgreenwood: Dgreenwood moved page Header-Value (Table Extract Method) - 2.80 to 2.80:Header-Value (Table Extract Method) without leaving a redirect

2023-12-29T16:04:00Z

Dgreenwood moved page Header-Value (Table Extract Method) - 2.80 to 2.80:Header-Value (Table Extract Method) without leaving a redirect

← Older revision	Revision as of 11:04, 29 December 2023
(No difference)

Dgreenwood at 21:52, 9 December 2022

2022-12-09T21:52:46Z

← Older revision		Revision as of 16:52, 9 December 2022
Line 1,364:		Line 1,364:
	</tab>		</tab>
	</tabs>		</tabs>

			[[Category:Articles]]
			[[Category:Version 2.80]]

Dgreenwood: Dgreenwood moved page Header-Value (Table Extract Method) to Header-Value (Table Extract Method) - 2.80: To be consistent with current naming conventions

2022-12-09T21:52:09Z

Dgreenwood moved page Header-Value (Table Extract Method) to Header-Value (Table Extract Method) - 2.80: To be consistent with current naming conventions

← Older revision	Revision as of 16:52, 9 December 2022
(No difference)

Dgreenwood at 16:13, 24 November 2020

2020-11-24T16:13:10Z

← Older revision		Revision as of 11:13, 24 November 2020
Line 2:		Line 2:
	<onlyinclude>		<onlyinclude>
	<blockquote style="font-size:14pt">		<blockquote style="font-size:14pt">
	'''Header-Value''' is one of three methods available to '''Data Table''' elements to extract information from tables on a document set. It uses a combination of column header and column value extractors to determine the table’s structure and extract information from the table’s cells.		''Header-Value'' is one of three methods available to '''Data Table''' elements to extract information from tables on a document set. It uses a combination of column header and column value extractors to determine the table’s structure and extract information from the table’s cells.
	</blockquote>		</blockquote>
	</onlyinclude>		</onlyinclude>

Dgreenwood at 16:11, 24 November 2020

2020-11-24T16:11:36Z

← Older revision		Revision as of 11:11, 24 November 2020
Line 1:		Line 1:
	[[File:Header val property panel.png\|frame\|The Header-Value Extract Method's properties]]		[[File:Header val property panel.png\|frame\|The Header-Value Extract Method's properties]]
			<onlyinclude>
	<blockquote style="font-size:14pt">		<blockquote style="font-size:14pt">
	'''Header-Value''' is one of three methods available to Data Table elements to extract information from tables on a document set. It uses a combination of column header and column value extractors to determine the table’s structure and extract information from the table’s cells.		'''Header-Value''' is one of three methods available to '''Data Table''' elements to extract information from tables on a document set. It uses a combination of column header and column value extractors to determine the table’s structure and extract information from the table’s cells.
	</blockquote>		</blockquote>
			</onlyinclude>

	== About ==		== About ==

Dgreenwood: /* Use Cases */

2020-08-25T17:30:06Z

Use Cases

← Older revision		Revision as of 12:30, 25 August 2020
Line 84:		Line 84:
	== Use Cases ==		== Use Cases ==

	The Header-Value method is the second table extraction method created in Grooper. It was made to target tables not easily extracted by [[Row Match (Table Extract Method)\|Row Match]]. Row Match looses its efficiency once a tables structure starts to change from document to document. Different companies are going to structure tables however they want, which is well outside your control. Think of all the different ways an invoice can be structured. While the information you want is present in all the different tables, how that data is presented may not be consistent. Even just the column location changing can present problems for ~~this~~ method. [[Row Match (Table Extract Method)\|Row Match’s]] method of using a Row Extractor to pattern the table may not be able to do the job (or a complicated Row Extractor accounting for multiple row formats may need to be used). For these situations, the Header-Value method is often easier to configure and produces better results.		The ''Header-Value'' method is the second table extraction method created in Grooper. It was made to target tables not easily extracted by ''[[Row Match (Table Extract Method)\|Row Match]]''. ''Row Match'' looses its efficiency once a tables structure starts to change from document to document. Different companies are going to structure tables however they want, which is well outside your control. Think of all the different ways an invoice can be structured. While the information you want is present in all the different tables (line item amount, count and details for example), how that data is presented may not be consistent. Even just the column location changing or columns that can be optionally filled can present problems for the ''Row Match'' method. ''[[Row Match (Table Extract Method)\|Row Match’s]]'' method of using a '''''Row Extractor''''' to pattern the table may not be able to do the job (or a complicated Row Extractor accounting for multiple row formats may need to be used). For these situations, the Header-Value method is often easier to configure and produces better results.

	{\|style="margin:auto"		{\|style="margin:auto"
	\|+These are different Oil and Gas Production Reports from various sources. Each one organizes information differently into tables in different ways. Row Match would work just fine for each individual document. However, while the same information exists on each document, there's enough variability in the table structures that Row Match may not be suited for processing the whole document set. Header-Value is ~~usually~~ a better route.		\|+These are different Oil and Gas Production Reports from various sources. Each one organizes information differently into tables in different ways. ''Row Match'' would work just fine for each individual document. However, while the same information exists on each document, there's enough variability in the table structures that ''Row Match'' may not be suited for processing the whole document set. ''Header-Value'' is often a better route when presented with varying table structures in a document set.
	\|[[File:50939766 Page 1.png\|border\|200px]]\|\|[[File:Spreadsheet with lines.png\|border\|200px]]\|\|[[File:50946163.png\|border\|200px]]\|\|[[File:50946164 Page 1.png\|border\|200px]]		\|[[File:50939766 Page 1.png\|border\|200px]]\|\|[[File:Spreadsheet with lines.png\|border\|200px]]\|\|[[File:50946163.png\|border\|200px]]\|\|[[File:50946164 Page 1.png\|border\|200px]]
	\|}		\|}

	Optional data columns, where values may or may not be present in a cell, can complicate things for Row Match as well. Again, a simple Row Extractor may not do the trick. While a more complicated extractor may successfully extract the table's information, the Header-Value method (or the [[Infer Grid (Table Extract Method)\|Infer Grid]]) may be simpler to set up and produce the same or even better results.		Optional data columns, where values may or may not be present in a cell, can complicate things for Row Match as well. Again, a simple '''''Row Extractor''''' may not do the trick. While a more complicated extractor may successfully extract the table's information, the ''Header-Value'' method (or the ''[[Infer Grid (Table Extract Method)\|Infer Grid]]'') may be simpler to set up and produce the same or even better results.

	However, the Header-Value method does have its limitations. Perhaps most obviously, header labels are necessary for this method to work. In tables where header labels are not present, Header-Value will not be suitable for use.		However, the ''Header-Value'' method does have its limitations. Perhaps most obviously, header labels are necessary for this method to work. In tables where header labels are not present, ''Header-Value'' will may not be suitable for use. The ''Header-Value'' method may be able to target these types of tables, but can be more difficult to set up, or better targeted by the ''Row Match'' method.

	Furthermore, the Header-Value method requires several extractors to detect a table’s structure and extract the values inside, at least two extractors for every Data Column (one for its header and one for its values). Because of this, there are several components to configure in order to extract a table’s information. For relatively simple tables, Row Match ends up being simpler to set up, both being less time consuming and using fewer objects.		Furthermore, the Header-Value method requires several extractors to detect a table’s structure and extract the values inside, at least two extractors for every Data Column (one for its header and one for its values). Because of this, there are several components to configure in order to extract a table’s information. For relatively simple tables, Row Match ends up being simpler to set up, both being less time consuming and using fewer objects.

	The [[Infer Grid (Table Extract Method)\|Infer Grid]] method also has some advantages over Header-Value. There are some specialized use cases, such as reading OMR checkboxes in tables and reprocessing table cells using a secondary OCR ~~profile~~, where Infer Grid does things the other two methods simply can’t. Infer Grid also performs well when table line information can be saved to a page’s layout data.		The ''[[Infer Grid (Table Extract Method)\|Infer Grid]]'' method also has some advantages over ''Header-Value''. There are some specialized use cases, such as reading OMR checkboxes in tables and reprocessing table cells using a secondary '''OCR Profile''', where Infer Grid does things the other two methods simply can’t easily do (and in some cases, simply can't). ''Infer Grid'' also performs well when table line information can be saved to a page’s layout data using a '''Line Detection''' or '''Line Removal''' IP command.

	== How To ==		== How To ==

Dgreenwood: /* How To */

2020-04-17T20:37:10Z

How To

← Older revision		Revision as of 15:37, 17 April 2020
Line 1,273:		Line 1,273:

	[[File:Header val variation 38.png\|900px]]		[[File:Header val variation 38.png\|900px]]


	~~[[File:Header val variation 39.png\|900px]]~~

Dgreenwood: /* Troubleshooting */

2020-02-03T22:31:17Z

Troubleshooting

← Older revision		Revision as of 17:31, 3 February 2020
Line 1,353:		Line 1,353:


	[[File:Troubleshooting hv 6.png\|900px]]		[[File:Troubleshooting hv 11.png\|900px]]


	So, why did the table with lines capture the entire date? Long story short, because it has lines.		So, why did the table with lines capture the entire date? Long story short, because it has lines.

			If line positions are saved via a Line Detection or Line Removal IP Command, the "Detect Lines" property will expand the width of the column header to the surrounding lines. That way, the width of the row instance the Value Extractor runs against expands to the boundaries of the cell it is contained in.


			[[File:Troubleshooting hv 12.png\|900px]]


	</tab>		</tab>
	</tabs>		</tabs>