Handling an exception

An Exception is where a document stops: a stage of processing failed, so there is nothing to review. It says what failed and where, and Re-run sends it through again.

What you'll need

• The IntELIEDocs app in your top bar.
• This permission: IntELIEDocs · Document - Execute.
• A document whose status is Exception. Without Execute there is no Re-run button.

If IntELIEDocs isn't in your top bar, your role can't view it or your plan doesn't include it. Ask a workspace administrator, or see Permissions and module visibility.

Steps

1. Open the document

   Select its name in the documents list. A warning banner sits above the document, and the breadcrumb bar reads Document Status: Exception.

2. Read the reason

   The banner gives the reason Elie reported, or An error occurred while processing this document. if it reported none. Failed Stage names where it stopped, with an error code beside it: Text extraction (OCR), Classification, Data extraction, PII analysis or Redaction rendering.

   

   A document in Exception: the red banner reads Could not open PDF and names the failed stage, Text extraction (OCR), with its error code.

   Enlarge

3. Select Re-run

   Once the cause is dealt with, select Re-run in the header. On an Exception it starts at once and repeats the whole pipeline. There is no confirmation, because a failed run has no result to lose.

4. Choose a configuration, if asked

   If the orchestrator has changed since, Re-run Document opens first. Choose Run with Old Configs or Run with New Configs; see Re-running with a newer configuration.

5. Watch it reprocess

   Reprocessing started appears and the badge returns to Processing. The open document refreshes itself every 10 seconds until it settles.

What success looks like

• Reprocessing started appears and the badge returns to Processing.
• The warning banner is gone, and the document settles on Waiting for Review or Completed.

When a redaction fails

A redacted document whose redaction failed shows a red Redaction failed banner instead, with the reason and You are viewing the original document. The viewer falls back to the unredacted original. If your role cannot see originals, the viewer itself reads Redaction failed with You don't have access to the original. Re-run works the same way.

If something goes wrong

Symptom	Likely cause	What to do
The banner only says An error occurred while processing this document.	Elie reported no reason.	Go by Failed Stage instead. See Troubleshooting.
No Re-run in the header.	Your role lacks Execute, or the document is still running or on Password Required.	Ask an administrator for IntELIEDocs · Document - Execute. A locked PDF needs Enter Password; see Password-protected PDFs.
Mark as Reviewed is greyed out.	It is disabled on an Exception: a failed run left no fields to confirm.	Re-run the document first.
It returns to Exception with the same reason.	The file or the orchestrator configuration is the cause, not something transient.	Change what that stage needs, or Remove the document if it will never process. See Removing documents.
Couldn't load version information. You can still retry with the current version.	The comparison could not be fetched.	Run with New Configs is disabled; select Run with Old Configs.

Next

• Re-running with a newer configuration - what Re-run Document shows you.
• Document statuses - every badge and its next action.
• IntELIEDocs troubleshooting - wider failures.