Read Excel Range
Read Excel Range
Sección titulada «Read Excel Range»Tipo: excel-read-range · Paquete: Excel Activities v1.0.0 · Salida: DataTable
Lee un rango de celdas y lo devuelve como una DataTable (los datos tabulares siempre son DataTable). Es útil cuando quieres leer una porción concreta de la hoja: a diferencia de Read Excel Sheet —que lee todo el rango usado—, aquí indicas el rango exacto.
Por defecto la primera fila se trata como encabezados. Si tu rango no los tiene, pon hasHeader = no y las columnas se nombran automáticamente (Column1, Column2…).
Cómo funciona
Sección titulada «Cómo funciona»Lee las celdas del range indicado y construye una DataTable. Si hasHeader es verdadero (por defecto), la primera fila da los nombres de columna; si es falso, las columnas se autonombran. Acepta session o path — ver los dos modos.
Parámetros requeridos
Sección titulada «Parámetros requeridos»| Parámetro | Editor | Descripción |
|---|---|---|
range | expresión | Dirección del rango, ej. "A1:D20". |
Parámetros opcionales
Sección titulada «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 (requerido si no hay sesión). |
sheet | expresión | Nombre o índice 1-based de la hoja. Por defecto, la primera. |
hasHeader | sí/no | Tratar la primera fila como encabezados (por defecto: sí). |
Devuelve una DataTable. Recórrela con For Each y accede por nombre de columna (fila["Total"]), o trátala con las actividades del paquete DataTable.
Ejemplo
Sección titulada «Ejemplo»Read Excel Range path = = asset("datos.xlsx") range = "A1:C50" → output: tablaLog message = = "Filas leídas: " + str(rowCount(tabla))
For Each item = fila in = = tabla └─ body: Log message = = fila["Cliente"] + " — " + str(fila["Total"])Actividades relacionadas
Sección titulada «Actividades relacionadas»- Read Excel Sheet — leer toda la hoja como DataTable.
- Read Excel Cell — leer una sola celda.
- Write Excel Range — escribir una DataTable en un rango.