Product documentation
Inspect parsing results
Adding a file and parsing it are separate events. Use both the document status and the parsed metadata to decide whether a file is ready.
Read processing status
The current status set is:
- Unparsed;
- Parsing;
- Cancelling;
- Cancelled;
- Parse Success;
- Parse Failed; and
- Unknown for an unrecognized value.
The list automatically refreshes at intervals while a visible row is parsing or cancelling. You can also refresh the processing summary manually.
Start or retry parsing
Use the parse action on an unparsed, cancelled, completed, or failed row. A failed row presents the same action as a retry. You can also select multiple eligible rows and start batch parsing.
Do not treat the start confirmation as a completed parse. Wait for Parse Success.
Validate the result
- Open Metadata Settings only after parsing succeeds.
- Confirm the expected worksheet names are present.
- Expand each relevant worksheet and verify detected subtables.
- Compare the detected columns and data types with the source file.
- Add semantic aliases or descriptions only after the detected structure is correct.
Important limitation
Parse Success means the processing request completed; it does not certify that every source region was interpreted correctly. Missing worksheets, split tables, merged headers, or unexpected column types require source inspection and possibly a reset or corrected source file.