Get Queue Item

Get Queue Item

Tipo: queue-get-item  ·  Paquete: Queue Activities v1.0.0  ·  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: Nexus entrega el item, lo pasa a estado in_progress 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.

El orden de entrega respeta la prioridad (high antes que normal antes que low) y el deferUntil (los aplazados no se entregan antes de su hora).

Siempre cierra la transacción

Cuando termines de procesar el item, debes marcar su resultado con Set Transaction Status (o aplazarlo con Postpone Transaction). Si no lo haces, el item queda in_progress y no se libera correctamente.

Parámetros requeridos

Parámetro	Editor	Descripción
queueName	expresión	Nombre de la cola. Debe existir en el entorno de la ejecución.

Salida

Devuelve un ZoanQueueItem, o null si la cola no tiene items pendientes. Comprueba siempre el null para salir del bucle:

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

• Set Transaction Status — reportar éxito o fallo del item.
• Postpone Transaction — aplazar el item para más tarde.
• Add Queue Item — encolar trabajo.