Add Transaction Item

Add Transaction Item

Tipo: queue-add-transaction-item  ·  Paquete: Queue Activities v1.0.0  ·  Salida: ZoanQueueItem

Añade un item a una cola de trabajo y te lo devuelve ya en in_progress, bloqueado para la ejecución actual — add + start en un solo paso. Sirve para flujos donde el mismo bot crea el trabajo y lo procesa en la misma ejecución, conservando la trazabilidad y los reintentos de la cola.

Cómo funciona

A diferencia de Add Queue Item —que deja el item en new para que otro performer lo tome más tarde—, esta actividad crea el item directamente en in_progress y lo reserva para ti: no pasa por new ni por revisión. Lo recibes listo para procesar.

Como cualquier transacción, debes cerrarlo: cuando termines, marca el resultado con Set Transaction Status (successful o failed). Si no lo haces, el item queda in_progress hasta que su bloqueo expire.

¿Cuándo usar esta y no Add Queue Item?

• Add Transaction Item (esta): el bot crea y procesa el item en el mismo run. Útil para registrar una unidad de trabajo “sobre la marcha” sin separar dispatcher y performer.
• Add Queue Item: el productor encola trabajo que otro bot (o el mismo, después) tomará con Get Queue Item o Process Queue.

Parámetros requeridos

Parámetro	Editor	Descripción
queueName	expresión	Nombre de la cola. Debe existir en el entorno de la ejecución.
specificContent	diccionario	El payload: datos mapeados como clave → valor (literales o expresiones). Los lees con = item.SpecificContent["mi_campo"].

Parámetros opcionales

Parámetro	Editor	Descripción
reference	expresión	Referencia opcional para trazabilidad.
priority	lista	high, normal o low. Por defecto normal.

Salida

Devuelve un ZoanQueueItem en estado in_progress y bloqueado para esta ejecución, listo para procesar y cerrar.

Ejemplo

Crear una transacción, procesarla y cerrarla en el mismo flujo:

Add Transaction Item
  queueName       = "reprocesos"
  specificContent = {
    "facturaId": = factura.numero,
    "motivo":    "revalidación manual"
  }
  → output: item

Try
  └─ body:
       (… procesa = item.SpecificContent["facturaId"] …)
       Set Transaction Status   item = =item   status = successful
  └─ catch (err):
       Set Transaction Status   item = =item   status = failed
         exception = { "message": = err.Message }

Actividades relacionadas

• Set Transaction Status — cerrar la transacción (obligatorio).
• Add Queue Item — encolar trabajo para que otro performer lo tome.
• Get Queue Item — tomar el siguiente item de la cola.
• Process Queue — procesar la cola entera en un bucle.