Read File

Read File

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

Lee el contenido completo de un archivo de texto y lo devuelve como una cadena. Úsala para leer archivos .txt, plantillas, logs, configuraciones o cualquier contenido de texto plano.

Cómo funciona

Abre el archivo de la ruta indicada y devuelve todo su contenido como un único string, saltos de línea incluidos. Si el archivo no existe, la actividad falla.

• Codificación: usa encoding (por defecto utf-8), salvo que el archivo empiece con una marca BOM, que manda. Si ves caracteres raros en tildes y eñes, prueba iso-8859-1. Ver codificación.
• Todo en memoria: carga el archivo completo; para archivos muy grandes (cientos de MB) considera dividirlos.
• Solo lectura: no modifica el archivo.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
path	string	—	Ruta del archivo a leer.

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.

Salida

Devuelve un string con el contenido del archivo. Un archivo vacío devuelve "". Para trabajar línea por línea, divídelo con contenido.Split('\n') y limpia cada línea con .Trim() (en Windows las líneas terminan en \r\n).

Errores comunes

Mensaje	Causa y solución
No se encontró el archivo.	path no existe. Compruébalo antes con File Exists o envuelve la lectura en Try / Catch.
The process cannot access the file '…' because it is being used by another process.	Otro programa tiene el archivo bloqueado para escritura.
Access to the path '…' is denied.	Sin permiso de lectura, o path es una carpeta.
'windows-1252' is not a supported encoding name…	El encoding no está disponible. Usa iso-8859-1.
'path' es obligatorio.	La expresión de path dio nulo.

Ejemplo

Read File   path = asset("plantilla_correo.txt")   → output: plantilla
Set Variable   name = cuerpo   value = replace(plantilla, "{nombre}", cliente.nombre)

¿El archivo podría no existir?

Read File falla si el archivo no está. Si no estás seguro de que exista, compruébalo antes con File Exists, o envuelve la lectura en un Try / Catch.

Datos estructurados

Para archivos con formato (Excel, CSV, JSON, XML), no uses Read File: usa el paquete específico (CSV, JSON…), que te devuelve los datos ya estructurados en vez de texto plano.

Actividades relacionadas

• Write File — escribir un archivo de texto.
• File Exists — comprobar antes de leer.
• Append to File — añadir texto sin borrar lo existente.