Append to File

Append to File

Tipo: append-file  ·  Paquete: Filesystem Activities v1.0.6  ·  Salida: string

Añade texto al final de un archivo, sin borrar lo que ya tiene. Si el archivo no existe, lo crea. Es la actividad ideal para construir logs o ir acumulando líneas a lo largo de una ejecución (o de varias).

Cómo funciona

Agrega el content al final del archivo de path.

• Salto de línea: con newLine = true (por defecto) y el archivo ya existente, antepone un salto de línea de Windows (\r\n) al contenido, de modo que cada llamada queda en su propia línea. Si el archivo no existía, escribe el contenido sin salto previo. Nunca agrega un salto al final.
• Carpetas: si la carpeta del archivo no existe, la crea (con las intermedias).
• Codificación: con utf-8 (por defecto), un archivo nuevo empieza con la marca BOM de UTF-8. Usa la misma codificación en todas las llamadas sobre un mismo archivo. Ver codificación.
• No es idempotente: cada ejecución vuelve a añadir el texto. Si la reintentas con Retry, la línea puede quedar repetida.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
path	string	—	Ruta del archivo, con su carpeta (absoluta o con asset(...)).
content	string	—	El texto a añadir. Si la expresión da nulo, no se añade texto (pero sí el salto de línea, si aplica).

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
encoding	string	"utf-8"	Codificación del archivo: utf-8, iso-8859-1, utf-16, utf-32, us-ascii… Ver codificación.
newLine	bool	true	Antepone un salto de línea al contenido cuando el archivo ya existe.

Salida

Devuelve un string con la ruta del archivo (tal como la indicaste en path), por si quieres usarla en una actividad siguiente.

Errores comunes

Mensaje	Causa y solución
The process cannot access the file '…' because it is being used by another process.	El archivo está abierto en otro programa. Ciérralo o usa un archivo distinto.
Access to the path '…' is denied.	Sin permiso de escritura en la carpeta o archivo de solo lectura.
'windows-1252' is not a supported encoding name…	El encoding no está disponible. Usa iso-8859-1 o utf-8.
'path' es obligatorio.	La expresión de path dio nulo.

Si path es solo un nombre de archivo, se escribe en la carpeta de trabajo del robot (desde la versión 1.0.6; antes la actividad fallaba). Usa una ruta completa para saber siempre dónde queda el archivo.

Ejemplo

Ir registrando cada elemento procesado en un archivo de log y mostrar al final su contenido:

For Each   items = facturas   itemVariable = factura
 └─ activities:
      ... procesar ...
      Append to File   path = "C:/logs/procesadas.txt"   content = factura.numero + " — OK"   → output: rutaLog

Read File   path = rutaLog   → output: resumen
Log   message = "Procesadas: " + resumen

Append vs Write

• Append to File: suma al final, conserva lo anterior. Para logs e históricos.
• Write File: reemplaza todo el contenido. Para generar un archivo desde cero.

Actividades relacionadas

• Write File — crear o reemplazar el archivo completo.
• Read File — leer el contenido acumulado.