GetLastStructuredTextDiagnostics

Texto, extracción, datos estructurados

Descripción

Devuelve JSON que describe el último análisis de extracción estructurada en esta instancia

Sintaxis

Delphi

Function TPDFlib.GetLastStructuredTextDiagnostics: WideString;

DLL

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

ActiveX

Function PDFlib::GetLastStructuredTextDiagnostics() As String

Informe

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

El informe inicial es {"status":"notRun"}; un intento de extracción comienza con {"status":"error","code":"extraction_failed"} y un análisis con éxito lo reemplaza por un informe completed

Cada página completada registra su page basado en uno, su readingSource y sus warnings; las advertencias son una cadena de códigos de diagnóstico separados por saltos de línea, mientras que el JSON estructurado del esquema 2 utiliza una matriz de advertencias

Las fuentes de lectura son tagged, mixed, geometric y geometric-columns

Observaciones

El informe cubre la extracción a JSON estructurado, XHTML, CSV, Markdown y DOCX; las peticiones no válidas rechazadas antes de la extracción pueden dejar el informe anterior sin cambios

Un informe completado significa que el análisis devolvió con éxito; no certifica una semántica completa, una inferencia de maquetación correcta, un etiquetado válido ni la conformidad PDF/UA

Las advertencias revelan texto de referencias a objetos no admitidas, roles o espacios de nombres sin resolver, ciclos o límites de recorrido, asignaciones de origen ausentes y apariciones ambiguas compartidas de Form XObject

Cuando el recorrido o la vinculación de la estructura están incompletos, el texto de origen extraído se conserva mediante el recurso alternativo mixto o geométrico; examine ExtractStructuredPage para conocer la procedencia por bloque y structureComplete

Una cancelación o un fallo de extracción pueden dejar el informe de error; consulte LastErrorCode y el ciclo de vida normal de la operación para conocer el resultado de la llamada

El getter no borra el último error; la variante A de la DLL devuelve UTF-8 y los punteros de cadena de la DLL siguen siendo válidos hasta la siguiente llamada que devuelva cadenas en esta instancia

Véase también

SetStructuredTextOptions, GetStructuredTextOptions, ExtractStructuredDocument, ExportDocumentMarkdown, SaveDOCXToStream