Resolve tabular parsing failures

Use the visible status and parsed structure to separate a request failure from an unexpected result. The interface does not expose a reliable root-cause code for every failure, so do not guess the cause from status alone.

If status is Parse Failed

1. Preview or download the source from the Document Library and confirm it opens.
2. Confirm the file is the intended .xls, .xlsx, or .csv source.
3. Use the row's retry-parse action.
4. Wait for a terminal status before opening Metadata Settings.

If the same unchanged file fails again, record the resource name, file name, approximate time, and visible status before requesting support. Do not include credentials or confidential cell contents unless your support process explicitly allows them.

If parsing succeeds but structure is wrong

1. Open Metadata Settings.
2. Compare worksheet, subtable, column, and detected-type metadata with the source.
3. Check the source for merged headers, multiple tables in one sheet, hidden or empty sheets, and inconsistent column layouts. These are inspection prompts, not confirmed causes.
4. If necessary, upload a corrected source and associate it with the resource, or use Reset Parse when it is available.
5. Recheck the complete parsed structure after processing finishes.

Reset Parse requires confirmation and is unavailable for unparsed, parsing, or cancelling rows.

If processing appears stuck

The list polls while a visible row is parsing or cancelling. Wait for at least one refresh cycle, then reload the page. The current row action does not expose a general manual resume control. If the state persists, collect the diagnostic context and request support.

Related guides

• Inspect parsing results
• Browse worksheets
• Upload recovery