Write Excel Sheet

Write Excel Sheet

Tipo: excel-write-sheet  ·  Paquete: Excel Activities v1.0.6  ·  Salida: —

Escribe una DataTable completa en una hoja de Excel, incluyendo los nombres de columna como primera fila. Es la forma más directa de generar un reporte o volcar datos a Excel. Crea el archivo y la hoja si no existen.

Cómo funciona

Toma la DataTable de data y la escribe en la hoja indicada, empezando en startCell. Por defecto limpia la hoja antes (clearSheet = true) y escribe los encabezados (writeHeader = true). Acepta session o path — ver los dos modos.

• Archivo y hoja: en modo rápido, si el archivo no existe se crea (con las carpetas que falten); si la hoja no existe, se crea. Sin sheet, escribe en la primera hoja (o crea Sheet1 en un libro nuevo).
• clearSheet = true borra toda la hoja —valores y formato— antes de escribir, no solo el área que vas a ocupar.
• Valores: los números, fechas y booleanos se guardan con su tipo; los textos, como texto (aunque parezcan números). Las celdas DBNull o nulas no se escriben. Ver cómo llegan los datos.
• En modo rápido guarda el archivo al terminar; en modo sesión, el cambio queda en memoria hasta Excel Save o Excel Close.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
data	DataTable	—	La DataTable a escribir.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
session	ZoanExcelSession	—	Sesión de Excel Open (en vez de path).
path	string	—	Ruta al .xlsx (se crea si no existe; requerido si no hay sesión).
sheet	string | int	—	Nombre o índice de la hoja; se crea si no existe. Si se omite, la primera hoja (o "Sheet1" en un libro nuevo).
writeHeader	bool	true	Escribir los nombres de columna como primera fila.
startCell	string	"A1"	Celda superior izquierda donde empezar.
clearSheet	bool	true	Limpiar toda la hoja (valores y formato) antes de escribir.

Salida

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
'data' es obligatorio.	data está vacío o la expresión dio null.
'data' debe ser un DataTable.	data no es una DataTable (por ejemplo, una lista). Constrúyela con Build DataTable.
Indica 'session' o 'path'.	Falta session y path.
'…' is not A1 address or workbook named range.	startCell no es una dirección válida. Usa la forma "B2".
sheetName '…' is invalid - character count MUST be greater than or equal to 1 and less than or equal to 31	El nombre de la hoja nueva tiene más de 31 caracteres.
Invalid char (…) found at index (…) in sheet name '…'	El nombre de la hoja tiene un carácter no permitido (/ \ ? * [ ] :).
The process cannot access the file '…' because it is being used by another process.	El archivo está abierto en Excel u otro programa al guardar. Ciérralo o reintenta con Retry.

Ejemplo

Read Excel Sheet   path = asset("ventas.xlsx")   → output: ventas
... procesar ...
Write Excel Sheet   path = "C:/salida/reporte.xlsx"   sheet = "Resumen"   data = ventas

Volcar una tabla debajo de un título, sin borrar el resto de la hoja:

Write Excel Sheet   path = "C:/salida/reporte.xlsx"   sheet = "Resumen"   data = ventas   startCell = "A3"   clearSheet = false

clearSheet borra lo que había

Por defecto, Write Excel Sheet limpia la hoja antes de escribir, así que reemplaza por completo su contenido y su formato. Si quieres añadir datos sin borrar lo existente, usa Append Excel Rows o Append Excel Range, o pon clearSheet = false.

Números que vienen de otra lectura de Excel

Desde la versión 1.0.6, una DataTable leída con Read Excel Sheet conserva el tipo de cada celda, así que al volver a escribirla los números, fechas y booleanos quedan como tales en Excel y las fórmulas de la hoja de destino pueden calcular con ellos.

Actividades relacionadas

• Write Excel Range — escribir valores en una posición sin lógica de encabezados.
• Append Excel Rows — añadir filas al final sin borrar.
• Read Excel Sheet — leer una DataTable de vuelta.