Hver iterasjon av kommandogruppen produserer en ny resultattabell eller CSV-fil med data, og du ønsker å kombinere alle disse i én fil.
Vanlige, men risikable tilnærminger
- Alternativ 1: Angi en dynamisk kjedevariabel
- Begrenset skalerbarhet: Dynamiske variabler har en streng størrelsesbegrensning. Selv om dataene dine passer nå, kan det hende at de treffer grensen i fremtiden etter hvert som dataene vokser.
- Stille feil: Hvis variabelen når størrelsesgrensen, vil kjeden ikke feile; den vil bare trunke dataene, noe som fører til manglende poster.
- Ekstra behandling: Du må fortsatt konvertere den endelige variabelstrengen tilbake til en fil for å kunne bruke den.
- Alternativ 2: Skriv hver fil til en Wdata-tabell
- Langsom ytelse: Dette krever flere API-anrop med autentisering for hver eneste iterasjon, noe som gjør kjeden betydelig tregere.
- Kompleks gjenfinning: Du kan ikke bruke dataene umiddelbart; du må kjøre en spørring for å sette dem sammen igjen.
- Opprydding er nødvendig: Hvis du må kjøre kjeden på nytt, må du først bygge ekstra logikk for å slette eller erstatte de gamle filene i tabellen.
- Alternativ 3: Skriv hver fil til et Workiva-regneark
- Langsom ytelse: I likhet med Wdata-metoden vil gjentatte API-kall inne i en løkke føre til lange kjøretider.
- Høy risiko for feil: Du må beregne det nøyaktige radnummeret for hver innsetting, ellers risikerer du å overskrive data eller etterlate hull.
Den beste løsningen: Utdata fra tidligere stakfiler
Hvis kolonnene alltid er de samme med de samme overskriftene, er den beste løsningen å bruke kommandoen Tabular Transformations Stack Files sammen med det innebygde alternativet for stabling på tvers av kommandogruppe-iterasjoner.
Merk: For dette bruksscenarioet må du sørge for å bruke "Tabular Transformations"-stakkfilen, ikke File Utilities-filen med samme navn. Dette er viktig fordi File Utilities ikke vil gjenkjenne og fjerne kolonneoverskriftene fra filer etter den første, mens Tabular Transformations vil gjøre det.
Når denne kommandoen er i en kommandogruppe og iterasjon er slått på, vil variabelalternativet "Previous Stack Files Output" vises under en egen "Stack Files"-seksjon i variabelpanelet.
Bruk denne variabelen etterfulgt av et komma og deretter kommandoen som inneholder dataene du vil stable på tvers av iterasjoner.
Merk: Det er viktig at kjeden går gjennom kommandoen stack files ved hver iterasjon, og ikke hopper over den. Hvis kjeden ikke gjør det, vil alle data som er stablet før denne iterasjonen, gå tapt, og du vil mangle data i den endelige filen.
Alle kommandoer i kjeden etter kommandogruppen kan deretter bruke variabelen Stack Files - "Stack Files Output", som vil være den fullstendige filen med alle iterasjoner.
Andre merknader
- Kommandoen file utilities stack file er nyttig hvis du vil koble sammen datasett der kolonneoverskrift ikke er nødvendig, og den har det samme alternativet "Previous Stack Files Output".
- Kommandoene "Render Text Template" og "Render File Template" i Handlebars har alternativer som heter "Previous Rendered Text" og "Previous Rendered File", som fungerer på samme måte som alternativet "Previous Stack Files Output" som du ser her, og som kan være nyttige for å holde maler og/eller JSON-filer sammen på tvers av iterasjoner.
- Det er greit om den nye filen som skal stables, går inn i kommandoen stack files og ikke gir noe resultat, så lenge kolonneoverskriftene er der.