Excel Online — Write sheet

Tipo: excelonline-write-sheet · Paquete: Excel Online v1.0.4

Vuelca un conjunto de datos en la hoja empezando en A1, calculando el rango por ti. Es la forma más cómoda de escribir una tabla completa sin indicar el rango de destino.

Cómo funciona

Opera sobre la sesión creada con Excel Online — Connect. Pásala en el parámetro session, o coloca esta actividad dentro del body de Excel Online — Connect para heredarla automáticamente.

En values pasas una DataTable (o un DataRow para una sola fila); se escriben solo los valores de las filas. El rango se calcula del tamaño de los datos: una tabla de 50 filas y 4 columnas se escribe en A1:D50. El cambio se guarda automáticamente.

Detalles a tener en cuenta:

No escribe la fila de nombres de columna: la primera fila de la tabla queda en A1. Si la hoja debe tener encabezados, déjalos en la fila 1 y escribe los datos con Write range desde A2, o con Append rows.
Sobrescribe solo el área que ocupan los datos: lo que haya fuera (más filas de una ejecución anterior, otras columnas) se queda. Para reemplazar todo, borra antes con Clear range.
Las celdas con valor nulo (DBNull) no se tocan y conservan lo que hubiera.
Con una tabla sin filas no escribe nada y no falla.
La hoja debe existir; esta actividad no la crea.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`sheet`	`string`	—	Nombre de la hoja.
`values`	`DataTable \| DataRow`	—	La DataTable a escribir (o un DataRow para una sola fila); solo valores.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`session`	`ZoanExcelOnlineSession`	—	Sesión de Excel Online — Connect. Dentro del `body` de Connect se hereda.

Salida

Esta actividad no devuelve ningún valor. El cambio se guarda automáticamente.

Errores comunes

Mensaje	Causa y solución
`No hay una sesión de Excel Online disponible. Indica 'session' desde una actividad excelonline-connect o coloca esta actividad dentro del cuerpo de la actividad Connect para que herede la sesión automáticamente.`	La actividad está fuera del `body` de Connect y no recibió `session`. Colócala dentro del `body` o pasa `session = libro`.
`'sheet' es obligatorio.` / `'values' es obligatorio.`	El parámetro está vacío o su expresión dio `null`.
`'values' debe ser un DataTable (o un único DataRow).`	Pasaste otro tipo (una lista, un arreglo, un texto).
`itemNotFound` (Microsoft Graph, 404)	No existe una hoja con ese nombre. Créala en el libro antes de ejecutar el proceso.

Ejemplo

Excel Online — Connect   credential = credential("m365-finanzas")   path = "Reportes/Salida.xlsx"
 └─ body:
      Excel Online — Read sheet    sheet = "Origen"   → output: datos
      Excel Online — Clear range   sheet = "Copia"    range = "A1:Z5000"
      Excel Online — Write sheet   sheet = "Copia"    values = datos

Al leer sin has-headers, la fila de encabezados de la hoja de origen llega como primera fila de datos, así que la copia queda idéntica, encabezados incluidos.

Actividades relacionadas

Excel Online — Write range — escribir en un rango concreto.
Excel Online — Append rows — añadir filas al final.
Excel Online — Read sheet — leer toda la hoja.
Todas las actividades de Excel Online