Excel Online — Get sheet names

Tipo: excelonline-get-sheet-names · Paquete: Excel Online v1.0.4 · Salida: List<string>

Devuelve la lista de nombres de las hojas del libro. Úsala para descubrir las hojas disponibles antes de leer o escribir, para comprobar que una hoja existe o para recorrerlas todas.

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.

Devuelve los nombres en el orden de las pestañas del libro, incluidas las hojas ocultas. Es solo lectura.

Parámetros requeridos

Ninguno.

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

Devuelve un List<string> con el nombre de cada hoja, de izquierda a derecha. Recórrela con un For each, accede por índice (hojas[0] es la primera) o comprueba si existe una hoja con hojas.Contains("Datos").

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`.
`itemNotFound` / errores de Microsoft Graph	El archivo ya no existe o no es un libro `.xlsx`. Revisa el archivo que abrió Connect.

Ejemplo

Excel Online — Connect   credential = credential("m365-finanzas")   path = "Reportes/Libro.xlsx"
 └─ body:
      Excel Online — Get sheet names   → output: hojas
      For each   hoja in hojas
       └─ Excel Online — Read sheet   sheet = hoja   has-headers = true   → output: datosHoja

Actividades relacionadas

Excel Online — Read sheet — leer una hoja.
Excel Online — Used range — dimensiones de una hoja.
Excel Online — Connect — abrir el libro.
Todas las actividades de Excel Online