Cada iteración de de tu grupo de comandos produce una nueva tabla de resultados o archivo CSV de datos y quieres combinarlos todos en un solo archivo.
Enfoques comunes pero arriesgados
- Opción 1: Establece una variable dinámica en cadena.
- Escalabilidad limitada: Las variables dinámicas tienen un límite de tamaño estricto. Aunque tus datos encajen ahora, pueden alcanzar el límite en el futuro, a medida que los datos crezcan.
- Fallos silenciosos: Si la variable alcanza el límite de tamaño, la cadena no dará error; simplemente truncará los datos, lo que provocará que falten registros.
- Procesos adicionales: Todavía tienes que volver a convertir la cadena variable final en un archivo para utilizarla.
- Opción 2: Escribe cada archivo en una tabla de Wdata.
- Rendimiento lento: Esto requiere múltiples llamadas a la API con autenticación para cada iteración, lo que ralentiza considerablemente la ejecución de la cadena.
- Recuperación compleja: No puedes utilizar los datos inmediatamente; debes ejecutar una consulta para unirlos todos de nuevo.
- Requiere limpieza: Si necesitas volver a ejecutar la cadena, debes construir una lógica extra para eliminar o sustituir primero los archivos antiguos de la tabla.
- Opción 3: Escribe cada archivo en una Hoja de cálculo Workiva.
- Rendimiento lento: Al igual que el método Wdata, las repetidas llamadas a la API dentro de un bucle provocarán largos tiempos de ejecución.
- Alto riesgo de error: Se ha producido un error: Debes calcular el número exacto de fila para cada inserción; de lo contrario, corres el riesgo de sobrescribir datos o dejar lagunas.
La mejor solución: Resultado: Apilar Archivos Previos
Si las columnas son siempre las mismas con los mismos Encabezados, entonces la mejor solución será utilizar el comando Archivos Apilados de Transformaciones Tabulares junto con su opción incorporada para apilar a través de iteraciones de grupos de comandos.
Nota: Para este caso de uso, asegúrate de utilizar el Archivo de pila "Transformaciones tabulares", no el de Utilidades de archivos del mismo nombre. Esto es importante porque la de Utilidades de Archivos no reconocerá y eliminará los Encabezados de columna de los archivos posteriores al primero, mientras que la de Transformaciones Tabulares sí lo hará.
Cuando este comando está en un grupo de comandos y la iteración está activada, la opción de variable "Salida de archivos apilados anteriores" aparecerá bajo su propia sección "Archivos apilados" en el panel de variables.
Utiliza esta variable seguida de una coma y, a continuación, el comando que contiene los datos que quieres apilar entre iteraciones.
Nota: Es vital que tu cadena pase por el comando apilar archivos en cada iteración y no se lo salte. Si la cadena no lo hace, entonces cualquier dato apilado anterior a esa iteración se perderá y te faltarán datos en el archivo final.
Cualquier comando de tu cadena posterior al grupo de comandos puede utilizar la variable Archivos de pila - "Salida de archivos de pila", que será el archivo completo con todas las iteraciones.
Otras Notas
- El comando de archivo de pila de utilidades de archivo es útil si quieres unir conjuntos de datos en los que no se requiere el encabezado de columna y tiene la misma opción de "Resultado de archivos de pila anteriores".
- Los comandos "Plantilla de texto renderizado" y "Plantilla de archivo renderizado" de Handlebars tienen opciones denominadas "Texto renderizado anterior" y "Archivo renderizado anterior" que funcionan de la misma manera que la opción "Salida de archivos apilados anteriores" que se ve aquí y podrían ser útiles para unir plantillas y/o archivos JSON entre iteraciones.
- No pasa nada si el nuevo archivo que se apila con el comando de apilar archivos no da ningún resultado, siempre que estén los encabezados de columna.