Reprocess a failed document

Re-run a document through the processing pipeline after it failed.

1. Open the tab. Each failed document shows a red error icon in the Status column — hover it to read the error message. To list only failed files, switch to the view.
2. Select the document (or several), then open the Tools menu in the toolbar and choose — or right-click the selection and choose from the menu. The file re-runs through the pipeline immediately — there is no confirmation dialog or options to set.

Note: The whole selection is checked before anything runs. If any selected file is currently mid-processing, or is in the Bin or archived, the request is rejected and none of the selected files are re-processed — deselect it and try again. A file that has been stuck mid-processing for more than 10 minutes is treated as stalled and can be re-processed normally.

Retry from the Exceptions view

Open the Exceptions view and re-run the failed files.

1. Open the view.
2. Re-run the files. One toolbar button re-runs them, and it renames itself based on your selection: with nothing selected it reads and re-runs every failed file in the current view; with rows selected it reads and re-runs only those. The number in brackets is the count it will act on.
3. If a file failed specifically at the PDF-conversion step, appears; it retries the file while skipping that step.

Retry All and Retry Selected resume from the last completed stage where they can, so work already done — detection, PDF conversion, OCR — is usually kept; a file that failed at the final optimisation or finalising steps restarts from the beginning instead. Re-process Selection (in the Files tab's Tools menu) always restarts from the very beginning and discards that work; use it for a completely clean run.

Password-protected files cannot be reprocessed in-app; see Unlock a password-protected file.

For the meaning of each error type (password protected, unsupported file type, empty file, file too large), see Document processing and errors.

What you've done

You've re-run a failed document without leaving BriefTech — either with Re-process Selection from the Files tab, which restarts from the beginning, or with Retry All / Retry Selected in the Exceptions view, which resume from the last completed stage where they can. The file goes back through the same processing pipeline.

Related

The document lifecycle: from upload to ready

What happens to a file between upload and the moment it can be used.

Unlock a password-protected file

Decrypt a password-protected file so BriefTech can process it.

Background Jobs

Status indicators, columns, and row actions in the Background Jobs dialog.

Extract files from a ZIP or email attachment

Unpack the contents of a ZIP archive or email's attachments into separate documents in your matter.

Document processing and errors

Processing stages, what OCR reads, and the document error reasons.