Package ai.extend.types

Class ParseConfigAdvancedOptions.Builder

java.lang.Object

ai.extend.types.ParseConfigAdvancedOptions.Builder

Enclosing class:

ParseConfigAdvancedOptions

public static final class ParseConfigAdvancedOptions.Builder
extends java.lang.Object

Method Summary

Modifier and Type	Method	Description
ParseConfigAdvancedOptions.Builder	alwaysConvertToPdf(java.lang.Boolean alwaysConvertToPdf)
ParseConfigAdvancedOptions.Builder	alwaysConvertToPdf(java.util.Optional<java.lang.Boolean> alwaysConvertToPdf)	Whether to convert supported file types (images, Word documents, PowerPoint, Excel, HTML) to PDF before parsing.
ParseConfigAdvancedOptions	build()
ParseConfigAdvancedOptions.Builder	enrichmentFormat(ParseConfigAdvancedOptionsEnrichmentFormat enrichmentFormat)
ParseConfigAdvancedOptions.Builder	enrichmentFormat(java.util.Optional<ParseConfigAdvancedOptionsEnrichmentFormat> enrichmentFormat)	The format used for enrichment annotations in the output.
ParseConfigAdvancedOptions.Builder	excelParsingMode(ParseConfigAdvancedOptionsExcelParsingMode excelParsingMode)
ParseConfigAdvancedOptions.Builder	excelParsingMode(java.util.Optional<ParseConfigAdvancedOptionsExcelParsingMode> excelParsingMode)	Controls how Excel files are parsed.
ParseConfigAdvancedOptions.Builder	excelSkipCalculation(java.lang.Boolean excelSkipCalculation)
ParseConfigAdvancedOptions.Builder	excelSkipCalculation(java.util.Optional<java.lang.Boolean> excelSkipCalculation)	Whether to skip formula recalculation when opening Excel workbooks.
ParseConfigAdvancedOptions.Builder	excelSkipHiddenContent(java.lang.Boolean excelSkipHiddenContent)
ParseConfigAdvancedOptions.Builder	excelSkipHiddenContent(java.util.Optional<java.lang.Boolean> excelSkipHiddenContent)	Whether to exclude hidden rows, columns, and sheets when parsing Excel files.
ParseConfigAdvancedOptions.Builder	excelUseRawCellValues(java.lang.Boolean excelUseRawCellValues)
ParseConfigAdvancedOptions.Builder	excelUseRawCellValues(java.util.Optional<java.lang.Boolean> excelUseRawCellValues)	Whether to return raw calculated cell values instead of locale-formatted values when parsing Excel files.
ParseConfigAdvancedOptions.Builder	from(ParseConfigAdvancedOptions other)
ParseConfigAdvancedOptions.Builder	imageConversionQuality(ParseConfigAdvancedOptionsImageConversionQuality imageConversionQuality)
ParseConfigAdvancedOptions.Builder	imageConversionQuality(java.util.Optional<ParseConfigAdvancedOptionsImageConversionQuality> imageConversionQuality)	Controls the quality level when converting images or documents to PDF for parsing.
ParseConfigAdvancedOptions.Builder	pageRanges(java.util.List<PageRangesItem> pageRanges)
ParseConfigAdvancedOptions.Builder	pageRanges(java.util.Optional<java.util.List<PageRangesItem>> pageRanges)
ParseConfigAdvancedOptions.Builder	pageRotationEnabled(java.lang.Boolean pageRotationEnabled)
ParseConfigAdvancedOptions.Builder	pageRotationEnabled(java.util.Optional<java.lang.Boolean> pageRotationEnabled)	Whether to automatically detect and correct page rotation.
ParseConfigAdvancedOptions.Builder	returnOcr(ParseConfigAdvancedOptionsReturnOcr returnOcr)
ParseConfigAdvancedOptions.Builder	returnOcr(java.util.Optional<ParseConfigAdvancedOptionsReturnOcr> returnOcr)	Options for returning raw OCR data in the response.
ParseConfigAdvancedOptions.Builder	verticalGroupingThreshold(java.lang.Double verticalGroupingThreshold)
ParseConfigAdvancedOptions.Builder	verticalGroupingThreshold(java.util.Optional<java.lang.Double> verticalGroupingThreshold)	Multiplier for the Y-axis threshold used to determine if text blocks should be placed on the same line or not (0.1-5.0, default 1.0).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

from

public ParseConfigAdvancedOptions.Builder from(ParseConfigAdvancedOptions other)

pageRotationEnabled

public ParseConfigAdvancedOptions.Builder pageRotationEnabled(java.util.Optional<java.lang.Boolean> pageRotationEnabled)

Whether to automatically detect and correct page rotation.

pageRotationEnabled

public ParseConfigAdvancedOptions.Builder pageRotationEnabled(java.lang.Boolean pageRotationEnabled)

pageRanges

public ParseConfigAdvancedOptions.Builder pageRanges(java.util.Optional<java.util.List<PageRangesItem>> pageRanges)

pageRanges

public ParseConfigAdvancedOptions.Builder pageRanges(java.util.List<PageRangesItem> pageRanges)

excelParsingMode

public ParseConfigAdvancedOptions.Builder excelParsingMode(java.util.Optional<ParseConfigAdvancedOptionsExcelParsingMode> excelParsingMode)

Controls how Excel files are parsed.

• basic: Fast, deterministic parsing.
• advanced: Enable layout block detection for complex spreadsheets.

For .xls files, basic mode is always used.

excelParsingMode

public ParseConfigAdvancedOptions.Builder excelParsingMode(ParseConfigAdvancedOptionsExcelParsingMode excelParsingMode)

excelSkipHiddenContent

public ParseConfigAdvancedOptions.Builder excelSkipHiddenContent(java.util.Optional<java.lang.Boolean> excelSkipHiddenContent)

Whether to exclude hidden rows, columns, and sheets when parsing Excel files.

excelSkipHiddenContent

public ParseConfigAdvancedOptions.Builder excelSkipHiddenContent(java.lang.Boolean excelSkipHiddenContent)

excelUseRawCellValues

public ParseConfigAdvancedOptions.Builder excelUseRawCellValues(java.util.Optional<java.lang.Boolean> excelUseRawCellValues)

Whether to return raw calculated cell values instead of locale-formatted values when parsing Excel files. Useful when downstream processing needs the underlying numeric or unformatted data.

excelUseRawCellValues

public ParseConfigAdvancedOptions.Builder excelUseRawCellValues(java.lang.Boolean excelUseRawCellValues)

excelSkipCalculation

public ParseConfigAdvancedOptions.Builder excelSkipCalculation(java.util.Optional<java.lang.Boolean> excelSkipCalculation)

Whether to skip formula recalculation when opening Excel workbooks. Significantly improves parsing speed for formula-heavy spreadsheets. Disable if cell values depend on volatile functions like NOW() or TODAY().

excelSkipCalculation

public ParseConfigAdvancedOptions.Builder excelSkipCalculation(java.lang.Boolean excelSkipCalculation)

verticalGroupingThreshold

public ParseConfigAdvancedOptions.Builder verticalGroupingThreshold(java.util.Optional<java.lang.Double> verticalGroupingThreshold)

Multiplier for the Y-axis threshold used to determine if text blocks should be placed on the same line or not (0.1-5.0, default 1.0). Higher values group elements that are further apart vertically. Only applies when the spatial target is set.

verticalGroupingThreshold

public ParseConfigAdvancedOptions.Builder verticalGroupingThreshold(java.lang.Double verticalGroupingThreshold)

returnOcr

public ParseConfigAdvancedOptions.Builder returnOcr(java.util.Optional<ParseConfigAdvancedOptionsReturnOcr> returnOcr)

Options for returning raw OCR data in the response.

returnOcr

public ParseConfigAdvancedOptions.Builder returnOcr(ParseConfigAdvancedOptionsReturnOcr returnOcr)

alwaysConvertToPdf

public ParseConfigAdvancedOptions.Builder alwaysConvertToPdf(java.util.Optional<java.lang.Boolean> alwaysConvertToPdf)

Whether to convert supported file types (images, Word documents, PowerPoint, Excel, HTML) to PDF before parsing. This can improve parsing quality for some file types and ensures spatial output with bounding boxes.

alwaysConvertToPdf

public ParseConfigAdvancedOptions.Builder alwaysConvertToPdf(java.lang.Boolean alwaysConvertToPdf)

enrichmentFormat

public ParseConfigAdvancedOptions.Builder enrichmentFormat(java.util.Optional<ParseConfigAdvancedOptionsEnrichmentFormat> enrichmentFormat)

The format used for enrichment annotations in the output.

• xml: Use XML-style tags for enrichment annotations, e.g. <page_number>1</page_number> or <barcode>1234567890</barcode>
• bracket: Use bracket-style notation for enrichment annotations, e.g. [page_number: 1] or [barcode: 1234567890]

enrichmentFormat

public ParseConfigAdvancedOptions.Builder enrichmentFormat(ParseConfigAdvancedOptionsEnrichmentFormat enrichmentFormat)

imageConversionQuality

public ParseConfigAdvancedOptions.Builder imageConversionQuality(java.util.Optional<ParseConfigAdvancedOptionsImageConversionQuality> imageConversionQuality)

Controls the quality level when converting images or documents to PDF for parsing.

• high: Maximum quality, can add some latency for large/dense documents
• medium: Balanced quality and speed
• low: Lower quality, smaller file sizes, faster processing

imageConversionQuality

public ParseConfigAdvancedOptions.Builder imageConversionQuality(ParseConfigAdvancedOptionsImageConversionQuality imageConversionQuality)

build

public ParseConfigAdvancedOptions build()