Documents — Send Bundle to Classification

Tipo: documents-classify-bundle  ·  Paquete: Documents Activities v1.4.5  ·  Salida: object

Desde: v1.3.0

Sube un archivo con varios documentos (un bundle) cuyo troceo no es de fiar a la estación de clasificación, junto con los segmentos que propuso IDP — Classify. En vez de extraer a ciegas, una persona confirma dónde empieza cada documento y de qué tipo es. En el Designer en español aparece como Documentos — Enviar lote a clasificación.

Se usa cuando IDP — Classify devuelve splitNeedsReview = true.

Documents — Send Bundle to Classification   path      = archivo
                                            reference = archivo
                                            segments  = doc["segments"]
                                            document  = doc
                                            pages     = doc["pages"]
                                            dpi       = 200

Cuándo usarlo

Un troceo es incierto cuando hay páginas sin reconocer, o cuando el archivo se partió en varios documentos sin ninguna marca impresa que lo respalde (solo el juicio del modelo). IDP — Classify lo señala con splitNeedsReview. El patrón típico:

If   condition = doc["splitNeedsReview"] == true
     then:
       Documents — Send Bundle to Classification   path = archivo, reference = archivo,
                                                    segments = doc["segments"], document = doc,
                                                    pages = doc["pages"], dpi = 200
       Continue

Cómo funciona

Sube el archivo a Zoan Cloud con su reference, los segmentos propuestos, las dimensiones de las páginas, el dpi y la retención. Si pasas document, su lectura viaja con él como caché de OCR. El bundle queda en la bandeja de la estación de clasificación del ambiente; el log confirma el envío. Necesita el contexto de ejecución de Zoan Cloud.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
path	string	—	La ruta del archivo bundle (PDF, PNG, JPEG o TIFF).
reference	string	—	Clave estable del bundle (por ejemplo, el nombre del archivo).
segments	List	—	Los segmentos propuestos por IDP — Classify: doc["segments"], cada uno { pageStart, pageEnd, type, recognized }.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
document	Dictionary	—	El objeto completo que devolvió IDP — Classify. Su lectura se guarda como caché de OCR: extraer después los segmentos confirmados no vuelve a pagar Azure. Desde la versión 1.4.0.
pages	List	—	Las dimensiones por página de IDP — Classify (doc["pages"]), para que la estación pueda pintar las páginas.
dpi	int	—	El dpi con el que se leyeron las páginas (el mismo que usaste en IDP — Classify).
retentionDays	int	—	Cuántos días guardar el bundle. Vacío = el valor por defecto del ambiente.

La caché de OCR

Pásale document (el objeto completo que devolvió IDP — Classify) y la lectura —palabras, páginas, texto— se guarda junto al bundle como caché de OCR. Cuando una persona confirme el troceo y Documents — Take Confirmed Bundles recoja el bundle, esa lectura vuelve con él y cada segmento se extrae sin releer el archivo ni volver a pagar Azure. Sin document, todo funciona igual — solo que la extracción relee.

Salida

Devuelve un object con id (el id del bundle en Zoan Cloud) y reference (la clave con la que se subió).

Qué pasa después

El bundle aparece en la estación de clasificación del ambiente (se abre desde Centro › IDP). Una persona ajusta las fronteras y los tipos y confirma. A partir de ahí, Documents — Take Confirmed Bundles lo recoge para extraer cada segmento.

Ejemplo

Enviar a revisión solo lo dudoso y extraer directamente lo demás:

IDP — Classify   path = archivo   projects = ["factura-proveedor", "orden-de-compra"]   dpi = 200
                 → output: doc
If   condition = doc["splitNeedsReview"] == true
     then:
       Documents — Send Bundle to Classification   path = archivo   reference = archivo
                                                    segments = doc["segments"]   document = doc
                                                    pages = doc["pages"]   dpi = 200
                                                    → output: enviado
       Log   message = "Bundle " + enviado["id"] + " enviado a la estación de clasificación"
       Continue
For Each   items = doc["segments"]   itemVariable = segmento
  IDP — Extract   document = doc   project = segmento["type"]
                  pages = segmento["pageStart"] + "-" + segmento["pageEnd"]

Errores comunes

Mensaje	Causa y solución
'path' es obligatorio. / 'reference' es obligatorio.	Falta un parámetro requerido.
Archivo no encontrado (error del sistema al leer path)	La ruta no existe en la máquina del robot. Compruébala antes con File Exists.
Las actividades de documentos necesitan el contexto de ejecución de Zoan Cloud, que el Runner aporta al lanzar el playbook. Falta: …. …	La ejecución no tiene Zoan Cloud. Ejecútala desde Zoan Cloud o desde el Designer con sesión.
Zoan Cloud rechazó la subida (…): …	Zoan Cloud no aceptó el bundle. El detalle trae el código; reintenta.

Actividades relacionadas

• IDP — Classify — clasifica por página y propone los segmentos.
• Documents — Take Confirmed Bundles — recoge los bundles ya confirmados.