Configure Document Throttling

Document throttling enables organizations to pause the first occurrence of a previously unseen document format for user review before automated processing continues.

When the Ingestion Agent receives a document with a new fingerprint that meets the configured throttling criteria, the document is assigned the New Format Detected status and paused. Users can open the document in the Training view, review the Generative AI-generated mappings, modify the mappings where necessary, and save the result for future documents.

The New Format Detected workflow is triggered only when the applicable document-throttling lookup is configured and enabled. The document is paused only for the first occurrence of a previously unseen fingerprint that meets the throttling criteria. After the mapping is reviewed and saved, subsequent documents with the same fingerprint are processed automatically and aren’t paused again, even when they continue to meet the throttling criteria.

Configure throttling using the following lookup types and codes:

Document type	Throttling criterion	Lookup type	Lookup code or value
Image-based documents	New document fingerprint	AP_DOCIO_IMAGE_DOC_THROTTLING	THROTTLING_NEW_FINGERPRINT

These lookup types aren’t predefined. Create them according to the organization’s throttling requirements and set REST Access Secured to Authenticated for each lookup type.

To configure and validate document throttling:

1. Identify the document populations for which new formats must be reviewed before processing.
2. Create the applicable new lookup types and lookup codes.
3. Configure image-document throttling when newly detected image layouts must be reviewed.
4. Set REST Access Secured to Authenticated for each lookup type.
5. Submit a document with a previously unseen fingerprint that meets the configured criteria.
6. Confirm that the document is assigned the New Format Detected status.
7. Open the document in the Training view.
8. Review and correct the generated mappings.
9. Save the reviewed mapping.
10. Submit another document with the same fingerprint.
11. Confirm that the subsequent document is processed automatically without being paused again.

When configuring throttling:

• Configure a throttling lookup only when review of new document formats is part of the organization’s processing model.
• Review every document marked New Format Detected and validate the generated mappings before saving them.
• Save reviewed mappings so future documents with the same fingerprint can be processed automatically.
• Don't expect the New Format Detected status when the corresponding throttling lookup hasn’t been configured and enabled.
• Don't expect every document that meets the throttling criteria to be paused. Only the first occurrence of a new fingerprint is stopped for review.
• Don't expect a previously reviewed fingerprint to be throttled again after its mapping has been saved.
• Avoid broad throttling rules when manual review of new formats isn’t required, because broad rules can increase initial user intervention.