Read Excel Sheet

Tipo: excel-read-sheet · Paquete: Excel Activities v1.0.0 · Salida: DataTable

Lee una hoja completa de Excel y la devuelve como una DataTable, usando la primera fila como encabezados de columna. Es la forma más práctica y común de leer datos de Excel: obtienes una tabla lista para recorrer, filtrar o volcar a otra fuente.

Cómo funciona

Abre la hoja indicada y la convierte en una DataTable. Por defecto toma la primera fila como nombres de columna (hasHeader = true), de modo que luego accedes a las celdas por nombre: str(fila["Cliente"]). Puedes limitar la lectura a un range. Acepta session (modo sesión) o path (modo rápido) — ver los dos modos.

Parámetros requeridos

Ninguno — pero debes indicar session o path.

Parámetros opcionales

Parámetro	Editor	Descripción
`session`	expresión	Sesión de Excel Open (en vez de `path`).
`path`	expresión	Ruta al `.xlsx` (modo rápido: abre y cierra solo).
`sheet`	expresión	Nombre o índice 1-based de la hoja. Por defecto, la primera.
`hasHeader`	booleano	La primera fila son los encabezados. Por defecto `true`.
`range`	texto	Limitar a un rango, ej. `"A1:D50"`.

Salida

Devuelve un DataTable. Recórrelo con For Each y accede a celdas con str(fila["Columna"]).

Ejemplo

Read Excel Sheet   path = = asset("clientes.xlsx")   sheet = "Activos"   → output: clientes
Log   message = = "Clientes leídos: " + rowCount(clientes)

For Each   items = = clientes   itemVariable = fila
 └─ activities:
      Log   message = = str(fila["Nombre"]) + " — " + str(fila["NIT"])

Actividades relacionadas

Read Excel Range — leer valores crudos sin encabezados.
Read Excel Cell — leer una sola celda.
Write Excel Sheet — escribir una DataTable de vuelta.