Knowledge Center

501 - Reading a Run

Updated on

Reading a Run

ArchiveRequests as the operational view, and what each status actually means.

Every archive, restore and delete lands in ArchiveRequests, whatever raised it. This is the table to look at first.

The columns that matter

Column
What it tells you

Status
Success, Partial Success or Failure
ModeArchive, Restore or Delete
ObjectTypeWorkspace, Folder or Document — the scope of the request
SuccessProcessedCountHow many documents the service believes it processed
RetryCountHow many times it retried. Zero means nothing needed retrying.
CreatedAt / ProcessedAtWhen it was raised and when it finished — both UTC
Errors / HtmlErrorsThe error text, when there is any
RuleNameThe rule that raised it, or NULL for a Work 10 action

Reading a status

Status
What it means

What to do

Success
Everything selected was processedNothing
Partial SuccessSome documents did not process — usually checked out, or a retry ceiling was reachedInvestigate. This is the status that needs a human.
FailureThe request could not proceed at allCheck the service, the iManage service account and the storage target

Note Partial Success is neither a synonym for failure nor a synonym for done. It is the single most useful status to teach a firm to recognise.

A saved health query

SELECT Status, Mode, COUNT(*) AS Requests,

MAX(CreatedAt) AS MostRecent

FROM ArchiveRequests

GROUP BY Status, Mode

ORDER BY Mode, Status

Previous Article 402 - Entering a Delete Rule
Next Article 502 - Finding Which Documents Failed