Get Queue Item

Tipo: queue-get-item · Paquete: Queue Activities v1.2.9 · Salida: ZoanQueueItem

Toma el siguiente item de una cola de trabajo y lo bloquea para esta ejecución. Es la actividad que usa el consumidor (performer) en cada vuelta de su bucle. Si la cola está vacía, devuelve null.

Cómo funciona

La operación es atómica: Zoan Cloud entrega el item, lo pasa a estado in_progress, suma un intento (Attempts) y lo reserva para tu ejecución, de modo que ningún otro bot pueda tomarlo. Por eso varios performers pueden leer la misma cola en paralelo sin procesar un item dos veces.

Solo entrega items en estado new: los que están en revisión (review) o esperando una decisión humana (waiting_decision) no salen hasta que se aprueban o se deciden.
El orden respeta la prioridad (high antes que normal antes que low) y, dentro de la misma prioridad, el más antiguo primero. Los aplazados (deferUntil) no se entregan antes de su hora.
El bloqueo dura 15 minutos. Si la ejecución no cierra el item en ese tiempo (por ejemplo, porque el robot se cayó), Zoan Cloud lo devuelve a new para otro intento, o lo marca abandoned si ya agotó los reintentos de la cola.
Si la máquina está suspendida en Zoan Cloud, devuelve null como si la cola estuviera vacía, para que el bucle termine solo.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`queueName`	`string`	—	Nombre de la cola. Debe existir y estar activa en el ambiente de la ejecución.

Parámetros opcionales

Ninguno.

Salida

Devuelve un ZoanQueueItem en estado in_progress, o null si la cola no tiene items listos para entregar. Comprueba siempre el null para salir del bucle.

Errores comunes

Mensaje	Causa y solución
`'queueName' es obligatorio.`	Falta `queueName`.
`… HTTP 404: …Queue '…' not found or inactive in this environment`	La cola no existe en el ambiente o está inactiva.
`… HTTP 409: …La cola '…' la procesa un flujo: sus ítems no se entregan a robots.`	La cola pertenece a un flujo.
`Las actividades de colas necesitan el contexto de ejecución de Zoan Automation. Falta: …`	El proceso no corre desde Zoan Cloud ni desde el Designer con sesión iniciada.

Los errores de Zoan Cloud llegan con el prefijo “No se pudo obtener un elemento de la cola: ”. Una cola vacía no es un error.

Ejemplo

El bucle típico del performer: tomar items hasta vaciar la cola.

While   condition = true
  └─ body:
       Get Queue Item   queueName = "facturas-por-validar"   → output: item

       If   condition = item == null
         └─ then:  Break          (cola vacía → terminar)

       (… procesar = item.SpecificContent["facturaId"] …)

       Set Transaction Status   item = item   status = successful

Actividades relacionadas

Process Queue — el mismo bucle en una sola actividad.
Set Transaction Status — reportar éxito o fallo del item.
Postpone Transaction — aplazar el item para más tarde.
Add Queue Item — encolar trabajo.