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 は診断コードを改行でつないだ文字列で、スキーマ 2 の構造化 JSON では warnings は配列になります

読み取りソースは tagged、mixed、geometric、geometric-columns です

備考

レポートの対象は、構造化 JSON、XHTML、CSV、Markdown、DOCX の各抽出です。抽出前に拒否された無効な要求では、直前のレポートが変わらず残ることがあります

completed レポートは解析が正常に返ったことを意味するだけで、セマンティクスの完全性、レイアウト推論の正しさ、タグ付けの妥当性、PDF/UA 適合を保証するものではありません

warnings は、サポートされないオブジェクト参照テキスト、未解決のロールや名前空間、循環や走査上限、ソースマッピングの欠落、共有 Form XObject 出現の曖昧さを報告します

構造の走査やバインディングが不完全な場合でも、抽出されたソーステキストは mixed または geometric へのフォールバックで保持されます。ブロックごとの由来と structureComplete は ExtractStructuredPage で確認してください

キャンセルや抽出の失敗時にはエラーレポートが残ることがあります。呼び出しの結果は LastErrorCode と通常の操作ライフサイクルで判断してください

このゲッターは最新のエラーをクリアしません。DLL の A 系は UTF-8 を返し、DLL の文字列ポインターは、このインスタンスで次に文字列を返す呼び出しが行われるまで有効です

関連項目

SetStructuredTextOptions、GetStructuredTextOptions、ExtractStructuredDocument、ExportDocumentMarkdown、SaveDOCXToStream