Log

Tipo: log · Paquete: Core Activities v1.0.8

Escribe un mensaje en el registro de ejecución (los logs). Es la actividad que usas para “narrar” lo que tu bot está haciendo: cuántos registros leyó, qué decisión tomó, por qué omitió un elemento. Como las automatizaciones suelen ejecutarse solas y sin que nadie las mire, estos mensajes son tu principal herramienta para entender y diagnosticar una ejecución.

Los mensajes aparecen en el panel de depuración del Designer cuando pruebas localmente, y en los logs de ejecución de Zoan Cloud cuando se ejecuta en producción.

Cómo funciona

Coloca una actividad Log en cualquier punto del flujo. Cuando la ejecución llega a ella, evalúa el mensaje (que puede ser texto fijo o una expresión) y lo escribe con el nivel indicado. No detiene ni altera el flujo: solo registra y continúa.

Un mensaje que evalúa a vacío (null) se registra como una línea vacía.
Si el texto contiene el valor de una credencial ya resuelta, ese valor sale enmascarado como ***, también en Zoan Cloud.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`message`	`string`	—	El texto a registrar. Puede ser un texto fijo entre comillas (`"Inicio"`) o una expresión que combine variables (`"Total: " + total`).

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`level`	`string`	`"info"`	Importancia del mensaje. Valores: `info`, `warning`, `error`, `debug` (sin distinguir mayúsculas). Se elige de una lista; cualquier otro valor se registra como `info`.

Niveles disponibles

Nivel	En el Designer en español	Cuándo usarlo
`debug`	Depuración	Detalle fino para diagnóstico profundo (valores intermedios)
`info`	Información	Hitos normales del proceso (“15 facturas leídas”)
`warning`	Advertencia	Algo inesperado pero que no detiene el bot (“cliente sin correo, se omite”)
`error`	Error	Un fallo relevante (típicamente dentro de un catch)

Registrar con nivel error no hace fallar la ejecución: para eso usa Throw.

Salida

Esta actividad no devuelve ningún valor.

Ejemplo

Registrar cuántos registros se leyeron y avisar de un caso especial:

Log   level = info      message = "Se leyeron " + rowCount(tabla) + " filas del Excel"

If    condition = isEmpty(str(fila["Correo"]))
 └─ then:
      Log   level = warning   message = "La fila " + i + " no tiene correo; se omite"

Errores comunes

Esta actividad no falla por su cuenta; solo puede fallar si la expresión de message no se puede evaluar (por ejemplo, una variable que no existe). Revisa la expresión en el editor, que la valida mientras escribes.

Actividades relacionadas

Log to File — dejar la misma línea en un archivo propio.
Throw — además de registrar, detener el bot con un error.
Try / Catch — capturar un error para registrarlo en el catch.