GetLastStructuredTextDiagnostics

文字、擷取、結構化資料

描述

以 JSON 回報此實例上最近一次的結構化擷取分析

語法

Delphi

Function TPDFlib.GetLastStructuredTextDiagnostics: WideString;

DLL

Function DLGetLastStructuredTextDiagnostics(InstanceID: Integer): PWideChar; Stdcall;
Function DLGetLastStructuredTextDiagnosticsA(InstanceID: Integer): PAnsiChar; Stdcall;

ActiveX

Function PDFlib::GetLastStructuredTextDiagnostics() As String

報告

{
  "status": "completed",
  "pages": [
    {
      "page": 1,
      "readingSource": "tagged",
      "warnings": ""
    },
    {
      "page": 2,
      "readingSource": "mixed",
      "warnings": "shared-tagged-form-occurrence-order-unresolved\r\n"
    }
  ]
}

初始報告為 {"status":"notRun"}；擷取嘗試一開始是 {"status":"error","code":"extraction_failed"}，分析成功後會換成 completed 報告

每個完成的頁面記錄其 1 起算的 page、readingSource 與 warnings；warnings 是以換行分隔的診斷代碼字串，schema 2 的結構化 JSON 則使用 warnings 陣列

讀取來源有 tagged、mixed、geometric 與 geometric-columns

備註

報告涵蓋結構化 JSON、XHTML、CSV、Markdown 與 DOCX 擷取；在擷取開始前就被拒絕的無效請求，可能讓前一份報告保持原狀

報告完成只代表分析成功傳回；不保證語意完整、版面推論正確、標記有效或符合 PDF/UA

warnings 會揭露不支援的物件參照文字、無法解析的角色或命名空間、循環或走訪限制、遺漏的來源對應，以及共用 Form XObject 出現次數不明的情況

結構走訪或繫結不完整時，擷取的來源文字會經由 mixed 或 geometric 後備保留；每個區塊的來源資訊與 structureComplete 請見 ExtractStructuredPage

取消或擷取失敗可能留下錯誤報告；呼叫結果請查 LastErrorCode 與一般的操作生命週期

getter 不會清除最新錯誤；DLL A 變體傳回 UTF-8，DLL 字串指標在下次字串回傳呼叫之前保持有效

另請參閱

SetStructuredTextOptions, GetStructuredTextOptions, ExtractStructuredDocument, ExportDocumentMarkdown, SaveDOCXToStream