Descripción general #
La función INSERTAR FILA del comando xlsFx, es una herramienta de preparación de estructura que permite añadir una cantidad determinada de filas vacías en una posición específica de la hoja de cálculo. Es decir, sirve para que el Bot genere espacios en blanco intermedios o iniciales, empujando la información ya existente hacia abajo sin riesgo de sobrescribirla.
Parámetros #
Archivo: Ruta del archivo .xls, .xlsx o .csv.
Parámetro 1: Cantidad de filas que se desea insertar (por ejemplo, 3).
Parámetro 2: Fila o coordenada desde donde se comenzará a insertar (por ejemplo, 10).
Hoja: Nombre de la hoja sobre la que opera la función.
Actualizar: Define si se recarga el archivo en memoria (VERDADERO/FALSO).
Impactar: Define si el cambio se guarda físicamente en el archivo (VERDADERO/FALSO).
Contraseña: Se diligencia si el archivo posee alguna contraseña para poder interactuar con el.
Encoding CSV: Se utiliza para indicarle al Bot qué formato de codificación de caracteres debe usar al leer o manipular un archivo de tipo .csv
Usos más comunes #
Inyección de nuevos registros: uso principal para la actualización de bitácoras y logs. Permite que el Bot abra espacio al inicio o en el medio de una tabla ya poblada para escribir los movimientos del día sin alterar los registros anteriores.
Separación de bloques de datos: Útil para crear dinámicamente un espacio de separación entre diferentes grupos de información antes de colocar totales o subtotales.
Ejemplo de Uso #
Imagina que un Bot necesita agregar 2 nuevos registros en la parte superior de un reporte de inventario que ya tiene datos comenzando exactamente desde la primera fila. Pasos:
- Identifica que se necesitan 2 filas vacías en la posición inicial (fila 1).
- Usa la función INSERTAR FILA del comando xlsFx apuntando al reporte de inventario.
- Configura el Parámetro 1 con el valor
2(la cantidad) y el Parámetro 2 con el valor1(la posición). - El Bot inserta las celdas vacías, desplazando los datos originales de la fila 1 hacia la fila 3, dejando el espacio listo para escritura.
- Ejecutar y revisar evidencias.
Errores Comunes y Soluciones #
- Error: El archivo XLS debe estar cerrado.
- Solución: Asegúrate de que el archivo Excel que estás intentando modificar con
xlsFxesté completamente cerrado antes de ejecutar el flujo de trabajo.
- Solución: Asegúrate de que el archivo Excel que estás intentando modificar con
- Error de datos al usuario al momento de ejecutar (Insertar columna): El valor ingresado para la cantidad de filas/columnas o el número de fila/columna no es un entero válido.