Write File
Write File
Sección titulada «Write File»Tipo: write-file · Paquete: Filesystem Activities v1.0.6 · Salida: string
Escribe una cadena de texto en un archivo. Si el archivo no existe, lo crea; si existe, por defecto lo reemplaza. Úsala para generar archivos de salida: un log, un reporte de texto, un archivo de configuración.
Cómo funciona
Sección titulada «Cómo funciona»Escribe el content en el archivo de path.
- Sobrescritura: por defecto reemplaza el archivo existente (
overwrite = true). Si ponesoverwrite = falsey el archivo ya existe, la actividad falla en vez de reemplazarlo, sin tocarlo. - Carpetas: si la carpeta del archivo no existe, la crea (con las intermedias).
- Codificación: con
utf-8(por defecto) el archivo empieza con la marca BOM de UTF-8, que Excel y el Bloc de notas reconocen. Ver codificación. - Contenido exacto: escribe el texto tal cual, sin añadir un salto de línea al final. Si
contentda nulo, crea un archivo vacío. - Idempotente con
overwrite = true: repetirla deja el mismo resultado.
Parámetros requeridos
Sección titulada «Parámetros requeridos»| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
path | string | — | Ruta del archivo a escribir, con su carpeta. |
content | string | — | El texto a escribir. Otros tipos se convierten a texto. |
Parámetros opcionales
Sección titulada «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. |
overwrite | bool | true | Reemplazar el archivo si ya existe. Con false, la actividad falla si existe. |
Devuelve un string con la ruta del archivo escrito (tal como la indicaste en path).
Errores comunes
Sección titulada «Errores comunes»| Mensaje | Causa y solución |
|---|---|
El archivo ya existe y 'overwrite' es false. | Pusiste overwrite = false y el archivo existe. Usa un nombre único, bórralo antes o deja overwrite = true. |
The process cannot access the file '…' because it is being used by another process. | El archivo está abierto en otro programa. |
Access to the path '…' is denied. | Sin permiso de escritura en la carpeta, o el archivo es 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
Sección titulada «Ejemplo»Generar un resumen y adjuntarlo a un correo:
Write File path = pathJoin(carpetaSalida, "resumen.txt") content = "Proceso completado: " + now().ToString("yyyy-MM-dd HH:mm") → output: rutaResumenSMTP Send ... subject = "Resumen del proceso" attachments = arr(rutaResumen)Actividades relacionadas
Sección titulada «Actividades relacionadas»- Append to File — añadir al final sin reemplazar.
- Read File — leer el archivo de vuelta.