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

Каждая завершённая страница фиксирует свой page с отсчётом от 1, readingSource и warnings; предупреждения — строка диагностических кодов с разделителями-переводами строк, тогда как структурированный JSON схемы 2 использует массив warnings

Источники чтения: tagged, mixed, geometric и geometric-columns

Примечания

Отчёт охватывает извлечение в структурированный JSON, XHTML, CSV, Markdown и DOCX; недопустимые запросы, отклонённые до извлечения, могут оставить предыдущий отчёт без изменений

Завершённый отчёт означает, что анализ вернулся успешно; он не удостоверяет полную семантику, корректный вывод макета, валидное тегирование или соответствие PDF/UA

Предупреждения раскрывают неподдерживаемый текст по ссылкам на объекты, неразрешённые роли или пространства имён, циклы или лимиты обхода, отсутствующие исходные отображения и неоднозначные совместные вхождения Form XObject

Когда обход структуры или привязка неполны, извлечённый исходный текст удерживается через mixed- или geometric-резерв; происхождение каждого блока и structureComplete смотрите в ExtractStructuredPage

Отмена или сбой извлечения могут оставить отчёт об ошибке; результат вызова сверяйте с LastErrorCode и обычным жизненным циклом операций

Getter не сбрасывает последнюю ошибку; вариант A DLL возвращает UTF-8, а строковые указатели DLL действительны до следующего вызова, возвращающего строку, на этом экземпляре

См. также

SetStructuredTextOptions, GetStructuredTextOptions, ExtractStructuredDocument, ExportDocumentMarkdown, SaveDOCXToStream