Append Excel Range

Append Excel Range

Tipo: excel-append-range  ·  Paquete: Excel Activities v1.0.0

Añade filas inmediatamente debajo de la última fila con datos de la hoja, empezando en la columna A. A diferencia de Write Excel Range (que escribe en una posición fija que tú indicas), Append calcula solo dónde termina lo que ya hay y agrega a continuación — ideal para acumular datos en una hoja a lo largo del tiempo sin sobrescribir.

Recibe una DataTable (o una sola fila como DataRow) y escribe solo los valores de las celdas, no la fila de nombres de columna (no añade encabezado).

Cómo funciona

1. Detecta la última fila con datos de la hoja.
2. Escribe data a partir de la fila siguiente, siempre desde la columna A.
3. La DataTable se escribe fila por fila, sin encabezados (un DataRow, en una sola fila).
4. Guarda.

Acepta session o path — ver los dos modos.

¿Qué significa “sin encabezados”?

Append Range escribe únicamente los valores de las celdas. Si necesitas que la primera vez se escriban también los nombres de columna (y las siguientes solo se agreguen filas), usa Append Excel Rows, que maneja el encabezado por ti.

Parámetros requeridos

Parámetro	Editor	Descripción
data	expresión	La DataTable a añadir (o un DataRow para una sola fila). Se escriben los valores, sin encabezados.

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, guarda y cierra solo).
sheet	expresión	Nombre o índice de la hoja. Por defecto, la primera.

Ejemplo

Añadir las filas de una DataTable al final de un histórico:

Append Excel Range   path = = "C:/logs/historico.xlsx"   data = = registros    // una DataTable

Append Range vs Append Rows

• Append Excel Range: añade solo los valores (una DataTable o un DataRow) sin escribir encabezados. Empieza en la columna A.
• Append Excel Rows: añade las filas de una DataTable y escribe los encabezados solo si la hoja está vacía — pensado para acumular tablas con títulos.

Actividades relacionadas

• Append Excel Rows — acumular DataTables con encabezado inteligente.
• Write Excel Range — escribir en una posición fija.