|
Klassiske filtyper er ikke lenger tilgjengelige for bruk fra og med januar 2021. Du kan overføre klassiske filer eller laste ned en PDF-fil. Finn ut mer

Workiva kundestøttesenter

Bruk iteratorer med kommandoer og kommandogrupper

Bruk iteratorer med kommandoer og kommandogrupper

  • Sist oppdatert

For å kjøre en kommando eller kommandogruppe i en kjede gjentatte ganger, sett opp en iterator.

Merk: For å konvertere utdata fra en relasjonsdatabase eller ekstern webtjeneste til en JSON-matrise for bruk med en iterator, bruk JSON-koblingens CSV til JSON -kommando eller en JSON-variabeltransformasjon .

Sett opp en iterator

Med en iterator kan du gjenta en kommando eller gruppe basert på:

  • En statisk eller dynamisk liste med verdier
  • Et nøyaktig antall verdier
  • Basert på om en tilstand foreligger

En iterator kan gjenta en kommando eller gruppe over:

  • En statisk liste over verdier, for eksempel regioner eller enheter
  • En dynamisk eller variabel verdiliste, for eksempel fra en fil lastet opp som en arbeidsområderessurs eller utdata fra en kommando tidligere i kjeden
Merk: En kommando eller gruppe er begrenset til 1000 iterasjoner.

Slik kjører du en iterator over en liste med verdier:

  1. I kjeden velger du kommandoen eller gruppen som skal kjøres gjentatte ganger, og klikker på Rediger opprett .
  2. På fanen Iterasjoner gjenta aktiverer du Iterator gjenta . 
  3. I Velg modifikatortype , velg Liste.

  4. Skriv inn verdiene for iterasjonene:

    • For en statisk liste, skriv inn verdien for hver iterasjon, og trykk Skriv inn etter hver.
      iterate-static-list.png
    • For en dynamisk liste, velg utdataene fra den tidligere kommandoen med verdiene som skal brukes.
     

En iterator kan gjenta en kommando eller gruppe over et nøyaktig antall verdier, for eksempel totalt antall sider som sendes ut fra en kommando tidligere i kjeden.

Trinn 1. Sett opp en variabel for tallverdien

For å angi antall iterasjoner, opprett en dynamisk kjedevariabel:

  1. I kjeden, legg til en dynamisk variabel for antall iterasjoner, for eksempel Counter , uten startverdi.
    counter-dynamic-variables.png
  2. For å angi variabelens startverdi når kjeden kjører, legg til en Angi dynamisk kjedevariabel hendelse etter kommandoen som sender ut antall iterasjoner:
    edit-initial-counter-value.png
    • Velg den dynamiske variabelen som er opprettet for antall iterasjoner.
    • I Verdi , og skriv inn startverdien, for eksempel 1.

Trinn 2. Legg til en kommandogruppe

For å angi kommandoene som skal itereres og iterasjonsregelen, legg til en kommandogruppe:

  1. Etter hendelsen Angi dynamisk kjedevariabel , legg til Kommandogruppe , og dra en lenke mellom dem.
  2. Velg gruppen, og klikk på Rediger .
  3. I gruppens Iterasjoner gjenta -fane, aktiver Iterator gjenta . 
    iterate-exact-number.png
  4. I Velg modifikatortype , velg Gjenta til.
  5. Klikk på + Regel , velg datatypen Flytende, og angi når iterasjonene skal stoppes. Hvis du for eksempel vil iterere basert på Totalt antall poster -utdataene fra en tidligere kommando, angir du en regel som stopper iterasjoner når variabelverdien er større enn (>) Totalt antall poster -utdataene.
  6. Legg til kommandoene for å iterere til gruppen.

Trinn 3. Legg til en hendelse for å øke variabelverdien

For å øke variabelverdien med hver iterasjon:

  1. Som det siste trinnet i gruppen, legg til en annen Angi dynamisk kjedevariabel hendelse:
    iterate-counter-event.png
    • Velg den dynamiske variabelen som er opprettet for antall iterasjoner.
    • I Verdi velger du den samme variabelen.
  2. For å transformere verdien , klikk på variabelen i Verdi og legg til en Parse Number transformasjon.
    counter-variable-transform.png
  3. Legg til en Legg til transformasjon med verdien 1, og klikk på Godta .

Hvis verdiene eller det nøyaktige antallet verdier er ukjent, kan du iterere basert på om spesifikke betingelser er oppfylt. For eksempel kan du gjenta en kommando mens eller til angitte kriterier finnes.

Trinn 1. Sett opp variabler for de betingede verdiene

For å representere betingelsene som indikerer verdier som skal itereres over, opprett dynamiske kjedevariabler. Hvis for eksempel en kommando gir en boolsk nøkkelutdata for å indikere om svaret inneholder flere sider og en heltallsoffsetparameter for å identifisere hver side, oppretter du variabler for disse verdiene:

  1. I kjeden, legg til en dynamisk variabel for hver betingelse, uten startverdi.
    condition-variables.png
  2. For å angi variablenes startverdier når kjeden kjører, legg til en Set dynamic chain variable hendelse etter kommandoen som sender ut betingelsenes verdier, velg de dynamiske variablene og skriv inn startverdiene deres.
    condition-variable-event.png
    For eksempel, skriv inn verdien for den boolske nøkkelen som True, og offset-verdien som 0.

Trinn 2. Legg til en kommandogruppe

For å angi kommandoene som skal itereres og iterasjonsregelen, legg til en kommandogruppe:

  1. Etter hendelsen Angi dynamisk kjedevariabel , legg til Kommandogruppe , og dra en lenke mellom dem.
  2. Velg gruppen, og klikk på Rediger .
  3. I gruppens Iterasjoner gjenta -fane, aktiver Iterator gjenta . 
    condition-iteration-rule.png
  4. I Velg modifikatortype , velg "Gjenta til:".
  5. Klikk på + Regel , og angi når iterasjonene skal stoppes, for eksempel når den boolske nøkkelen er Usann.
  6. Legg til kommandoene for å iterere til gruppen.

Trinn 3. Angi variabelverdier for hver iterasjon

Som det siste trinnet i gruppen, legg til en annen Set dynamic chain variable -hendelse for å angi eller øke variabelverdiene med hver iterasjon.

  • For å angi variabelverdier, tilordne hver variabel til sine respektive utganger fra den tidligere kommandoen. For eksempel, for variabelen Boolsk velger du den boolske nøkkelutgangen; for variabelen Offset velger du parameteren for heltallsoffset.
  • For å øke en variabel , for eksempel Offset , klikker du på verdien, og deretter bruker du en Parse Number -transformasjon og en Add -transformasjon med verdien som skal økes med hver iterasjon.
    offset-transform.png

Iteratorutganger

Du kan bruke utdataene fra en iterator som en egenskap for andre kommandoer eller hendelser senere i kjeden. Utgangene avhenger av iteratorens modifikator— List eller Gjenta til .

Utdata Beskrivelse
Kommandoiterasjon eller gruppeiterasjon Variabelverdien til iterasjonen som behandles i løkken.
Indeks Det nullbaserte antallet som angir iterasjonen som er behandlet i løkken.
Første iterasjon En boolsk verdi som angir om iterasjonen som behandles er den første i løkken.
Siste iterasjon Kun for en List iterator, en boolsk verdi som angir om iterasjonen som behandles er den siste i løkken.
Totalt antall iterasjoner Kun for en List iterator, en nullbasert telling av det totale antallet iterasjoner behandlet av løkken.

Hvis du vil bruke en utdata som en egenskap for en annen kommando eller hendelse, velger du den under henholdsvis Kommandoiterator eller Gruppetiterator .

iterator-outputs.png

For å kjøre en kommando eller kommandogruppe i en kjede gjentatte ganger, sett opp en iterator. Merk: For å konvert...