Log to File

Log to File

Tipo: log-to-file  ·  Paquete: Core Activities v1.0.8

Anexa una línea de registro a un archivo de texto que tú eliges, con el formato [fecha] [NIVEL] mensaje. Útil cuando necesitas dejar constancia en un archivo propio (una bitácora de auditoría, un log que otro sistema vigila, un reporte acumulado) además del registro de ejecución que captura la plataforma.

Es distinta de Log: log escribe en el registro de ejecución (el que ves en el panel de depuración y en los logs de Zoan Cloud); log-to-file escribe en un archivo en disco. Usa cada una según dónde quieras que quede el mensaje; puedes usar las dos a la vez.

Cómo funciona

Cuando la ejecución llega a la actividad, evalúa el mensaje, lo formatea como una línea ([2026-06-16 10:30:00] [INFO] mensaje) y la anexa al archivo indicado en path, creando el archivo (y sus carpetas) si no existen. Cada llamada agrega una línea nueva; nunca sobrescribe lo que ya había. No detiene el flujo: registra y continúa.

• La fecha usa la hora local de la máquina, con formato yyyy-MM-dd HH:mm:ss.
• El nivel se escribe en mayúsculas ([INFO], [WARNING], [ERROR], [DEBUG]).
• El archivo se escribe en UTF-8; cada línea termina con el salto de línea del sistema.
• Una ruta relativa, o solo el nombre del archivo (proceso.log), se resuelve contra la carpeta de trabajo del robot, no la del proyecto: usa una ruta completa para saber siempre dónde queda el archivo. Desde la versión 1.0.8; antes, con solo el nombre del archivo la actividad fallaba.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
path	string	—	Ruta del archivo de log. Se crea, junto con sus carpetas, si no existe. Con solo el nombre del archivo, se escribe en la carpeta de trabajo del robot.
message	string	—	El texto a registrar. Puede ser un texto fijo entre comillas o una expresión. Si evalúa a vacío, la línea queda sin mensaje.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
level	string	"info"	Importancia del mensaje. Valores: info, warning, error, debug. Se elige de una lista (no es una expresión).
timestamp	bool	true	Anteponer la fecha y hora a cada línea. Con false la línea queda como [INFO] mensaje.

Salida

Esta actividad no devuelve ningún valor. El resultado es la línea agregada al archivo.

Ejemplo

Llevar una bitácora propia del proceso de facturación:

Log to File   path = "C:/logs/facturacion.log"   level = info
              message = "Inicio del proceso — " + str(rowCount(facturas)) + " facturas"

For Each   items = facturas   itemVariable = factura
 └─ activities:
      Log to File   path = "C:/logs/facturacion.log"   level = error
                    message = "Factura " + str(factura["Numero"]) + " sin correo"

Genera un archivo como:

[2026-06-16 09:00:01] [INFO] Inicio del proceso — 15 facturas
[2026-06-16 09:00:04] [ERROR] Factura FAC-021 sin correo

¿log o log-to-file?

• log → para diagnosticar la ejecución; aparece en el panel del Designer y en los logs de Zoan Cloud. Es lo que normalmente quieres.
• log-to-file → cuando necesitas un archivo persistente (auditoría, integración con otro sistema, bitácora que sobreviva fuera de la plataforma).

El archivo no enmascara credenciales

A diferencia de Log, lo que escribes aquí llega al archivo tal cual: si el mensaje contiene el valor de una credencial, queda en texto plano en el disco. Nunca registres credenciales y escribe en una ruta a la que el bot tenga permiso.

Errores comunes

Mensaje	Causa y solución
'path' es obligatorio.	path está vacío o su expresión devolvió null.
Error de acceso al archivo o a la carpeta	El usuario del robot no tiene permiso de escritura en esa ruta, o otro programa tiene el archivo bloqueado. Usa una carpeta donde el robot pueda escribir; para tolerar bloqueos breves, envuélvela en un Retry.

Actividades relacionadas

• Log — escribir en el registro de ejecución (no en un archivo).
• Append to File — anexar texto en crudo a un archivo (sin formato de log).
• Try / Catch — registrar en un archivo el error capturado en el catch.