Cancel Human Task

Cancel Human Task

Tipo: human-task-cancel  ·  Paquete: Human Task Activities v1.3.3  ·  Salida: object

Cancela una tarea que sigue abierta en la bandeja Tareas de Zoan Cloud. Úsala cuando el proceso ya no necesita la decisión: el caso se resolvió por otra vía, el cliente desistió o el robot ya encontró el dato que iba a pedir. Así nadie pierde tiempo decidiendo algo que ya no importa.

Cómo funciona

1. Busca la tarea taskId en el ambiente.
2. Si está abierta (pending o claimed), la cierra con estado cancelled. El motivo (reason) queda como comentario y se ve en la bandeja y en la auditoría.
3. Si la tarea ya estaba cerrada (decidida, cancelada o vencida), no la modifica y devuelve su estado actual. Por eso es seguro llamarla más de una vez.

Un robot solo puede cancelar las tareas que creó su ejecución, otra ejecución del mismo proceso (por ejemplo, un reintento que limpia lo que dejó el anterior) o las ligadas al item de cola que está procesando. Las tareas de otros procesos se rechazan.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
taskId	string	—	Id de la tarea: la salida id de Create Human Task. Ej: tarea["id"].

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
reason	string	—	Por qué se cancela (hasta 1000 caracteres). Se muestra en la bandeja y en la auditoría.

Salida

Devuelve un object (diccionario) con el estado de la tarea después de la llamada:

Campo	Tipo	Descripción
id	string	Id de la tarea.
status	string	cancelled si se canceló ahora; si ya estaba cerrada, su estado (completed, cancelled, expired).
title	string	Título de la tarea.
decision	string	cancelada si se canceló; si ya estaba decidida, la opción elegida.
comment	string	El motivo de la cancelación, o el comentario de quien decidió.
fields	Dictionary	Campos que llenó la persona, si la tarea ya estaba decidida.
form	Dictionary	Con formulario: su name y version. Sin formulario, null.

Errores comunes

Mensaje	Causa y solución
'taskId' es obligatorio.	Falta taskId.
… HTTP 403: …Esta tarea la creó otro proceso: un robot solo cancela las tareas de su ejecución, de su mismo proceso o del ítem de cola que procesa.	La tarea es de otro proceso. Cancélala desde ese proceso o desde la bandeja Tareas.
… HTTP 404: …La tarea no existe. / …Task not found…	El id no es válido, la tarea es de otro ambiente o no la creó un robot.
Las actividades de tareas humanas 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 llegan con el prefijo “No se pudo cancelar la tarea humana: ”.

Ejemplo

El robot pide validar un dato, pero sigue buscándolo por su cuenta; si lo encuentra, cancela la tarea:

Create Human Task   title = "Confirmar dirección de entrega del pedido #0001"
                    data = { "Cliente": "Cliente de prueba" }
                    assignRole = "logistica"   → output: tarea
 ... el robot consulta otro sistema y encuentra la dirección ...
Cancel Human Task   taskId = tarea["id"]
                    reason = "La dirección se encontró en el sistema de pedidos"
                    → output: cierre
If   condition = cierre["status"] == "completed"
 └─ then:
      Log   level = info   message = "Alguien ya había confirmado la dirección"

Cancelar desde el robot no dispara onCompleteProcess

Si la tarea se creó con onCompleteProcess, cancelarla con esta actividad no ejecuta ese proceso: si el robot cancela la tarea, es porque ya no necesita la decisión. Si la tarea está ligada a una cola (queueName), el item se libera igualmente para que no se quede esperando: vuelve a la cola con Decision.Status = "cancelled", o se abandona si así lo configuraste en la cola.

En cambio, si es una persona quien cancela la tarea desde Zoan Cloud, onCompleteProcess sí se ejecuta (llega con decision = "cancelled").

Actividades relacionadas

• Create Human Task — crear la tarea.
• Wait for Human Task — esperar la decisión (puede cancelar sola al agotarse el tiempo).