Documents — Take Confirmed Bundles

Tipo: documents-take-classified  ·  Paquete: Documents Activities v1.4.5  ·  Salida: List<object>

Desde: v1.3.0

Recoge los bundles cuyo troceo ya confirmó una persona en la estación de clasificación. Descarga el archivo de cada uno, lo saca de la bandeja (para no procesarlo dos veces) y los devuelve con su ruta local y sus segmentos confirmados. El playbook itera y extrae cada segmento. En el Designer en español aparece como Documentos — Tomar lotes confirmados.

Documents — Take Confirmed Bundles   → output: bundles

For Each   items = bundles   itemVariable = bundle
   └── For Each   items = bundle["segments"]   itemVariable = segmento
          └── IDP — Extract   path     = bundle["path"]
                              document = bundle["document"]
                              project  = segmento["type"]
                              pages    = segmento["pageStart"] + "-" + segmento["pageEnd"]

Cómo funciona

1. Pide a Zoan Cloud los bundles confirmados (hasta limit).
2. Por cada uno, descarga el archivo a outputDir como <id>-<nombre original> (crea la carpeta si no existe) y, si el bundle tiene caché de OCR, la descarga junto a él (….layout.json).
3. Lo marca como tomado, para que no se vuelva a devolver.
4. Devuelve la lista. El log dice cuántos bundles tomó.

Sin bundles confirmados, devuelve una lista vacía. Necesita el contexto de ejecución de Zoan Cloud.

Parámetros requeridos

Ninguno.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
limit	int	50	Máximo de bundles a tomar de una vez.
outputDir	string	carpeta temporal del sistema	Dónde descargar los archivos. Se crea si no existe.

Salida

Una List<object> de bundles; cada uno:

Campo	Tipo	Qué es
id	string	El id del bundle en Zoan Cloud.
reference	string	La clave con la que se subió.
path	string	La ruta local del archivo descargado.
segments	List	Los segmentos confirmados: [{ pageStart, pageEnd, type, recognized }].
document	Dictionary	La lectura completa guardada como caché de OCR, o null si el bundle no la tiene.

La lectura vuelve con el bundle

Si el bundle se subió con su caché de OCR (el document de Documents — Send Bundle to Classification), cada bundle devuelto trae document: la lectura completa. Pásasela a IDP — Extract junto con el rango (pages) de cada segmento y la extracción recorta esa lectura en vez de releer — el mismo papel no se paga dos veces. Si no hay caché (o no se pudo descargar, lo que deja una advertencia en el log), document viene vacío y se extrae por path como siempre.

Idempotencia

Al tomar un bundle se marca como tomado, así que no se vuelve a devolver. Si la extracción de algún segmento falla, la idempotencia de IDP — Extract (por reference) evita volver a pagar los segmentos ya extraídos en un reintento.

Córrelo por horario

Como la confirmación humana es asíncrona, lo normal es correr este playbook con un trigger programado que vaya vaciando lo confirmado.

Ejemplo

Extraer cada segmento confirmado con su propia reference, agrupado por el bundle de origen:

Documents — Take Confirmed Bundles   limit = 20   outputDir = carpetaTrabajo
                                     → output: bundles
For Each   items = bundles   itemVariable = bundle
  For Each   items = bundle["segments"]   itemVariable = segmento
    IDP — Extract   path          = bundle["path"]
                    document      = bundle["document"]
                    project       = segmento["type"]
                    pages         = segmento["pageStart"] + "-" + segmento["pageEnd"]
                    reference     = bundle["reference"] + "#" + segmento["pageStart"]
                    sourceGroupId = bundle["reference"]
                    → output: res
    Log   message = res["reference"] + " a revisión: " + toString(res["needsReview"])

Errores comunes

Mensaje	Causa y solución
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 solicitud (…): …	Zoan Cloud no aceptó la consulta, la descarga o la marca de tomado. El detalle trae el código; reintenta.
Caché de layout no disponible (…); el extractor volverá a leer el archivo. (advertencia)	No se pudo descargar la caché de OCR. No falla: IDP — Extract leerá el archivo.

Actividades relacionadas

• Documents — Send Bundle to Classification — envía el bundle incierto a la estación.
• IDP — Extract — extrae cada segmento confirmado.