|
Klassieke bestandstypen zijn vanaf januari 2021 niet meer beschikbaar voor gebruik. U kunt uw klassieke bestanden omzetten of een PDF downloaden. Meer informatie

Workiva-ondersteuningscentrum

Gebruik iterators met commando's en commandogroepen.

Gebruik iterators met commando's en commandogroepen.

  • Laatst bijgewerkt op

Om een ​​opdracht of een groep opdrachten herhaaldelijk achter elkaar uit te voeren, stelt u een iterator in.

Opmerking: Om een ​​uitvoer van een relationele database of externe webservice om te zetten naar een JSON-array voor gebruik met een iterator, gebruikt u de CSV naar JSON opdracht van de [] JSON-connector of een JSON-variabeletransformatie .

Stel een iterator in.

Met een iterator kun je een opdracht of groep herhalen op basis van:

  • Een statische of dynamische lijst met waarden
  • Een exact aantal waarden
  • Afhankelijk van of een aandoening bestaat

Een iterator kan een commando herhalen of groeperen over:

  • Een statische lijst met waarden, zoals regio's of entiteiten.
  • Een dynamische of variabele lijst met waarden, bijvoorbeeld afkomstig van een bestand dat is geüpload als werkruimtebron of als uitvoer van een opdracht eerder in de keten.
Opmerking: Een commando of groep is beperkt tot 1000 herhalingen.

Om een ​​iterator over een lijst met waarden te laten lopen:

  1. Selecteer in de keten de opdracht of groep die herhaaldelijk moet worden uitgevoerd en klik op Bewerken maken .
  2. Schakel op het tabblad Iteraties herhalen de optie Iterator herhalen in. 
  3. In Selecteer modificatietype , selecteer Lijst.

  4. Voer de waarden van de iteraties in:

    • Voor een statische lijst voert u de waarde voor elke iteratie in door na elke iteratie op te drukken. Voer in.
      iterate-static-list.png
    • Voor een dynamische lijst selecteert u de uitvoer van de vorige opdracht met de waarden die u wilt gebruiken.
     

Een iterator kan een commando of groep herhalen over een exact aantal waarden, zoals het totaal aantal pagina's dat door een eerder commando in de keten is gegenereerd.

Stap 1. Stel een variabele in voor de numerieke waarde.

Om het aantal iteraties aan te geven, maak je een dynamische ketenvariabele aan:

  1. Voeg in de keten een dynamische variabele toe voor het aantal iteraties, zoals Counter , zonder beginwaarde.
    counter-dynamic-variables.png
  2. Om de beginwaarde van de variabele in te stellen wanneer de keten wordt uitgevoerd, voegt u na de opdracht die het aantal iteraties weergeeft, een Set dynamic chain variable event: toe.
    edit-initial-counter-value.png
    • Selecteer de dynamische variabele die is aangemaakt voor het aantal iteraties.
    • Voer in Waarde de startwaarde in, bijvoorbeeld 1.

Stap 2. Een opdrachtgroep toevoegen

Om de uit te voeren opdrachten en de iteratieregel aan te geven, voegt u een opdrachtgroep toe:

  1. Na de gebeurtenis Dynamische ketenvariabele instellen , voeg Commandogroep toe en sleep een link ertussen.
  2. Selecteer de groep en klik op Bewerken .
  3. Schakel op het tabblad Iteraties herhalen van de groep de optie Iterator herhalen in. 
    iterate-exact-number.png
  4. Selecteer in het modificatietype en selecteer Herhalen tot.
  5. Klik op + Regel , selecteer het gegevenstype Float en geef aan wanneer de iteraties moeten stoppen. Om bijvoorbeeld te itereren op basis van de Total records uitvoer van een eerdere opdracht, kunt u een regel instellen om de iteratie te stoppen wanneer de variabelewaarde groter is dan (>) de Total records uitvoer.
  6. Voeg de opdrachten die herhaald moeten worden toe aan de groep.

Stap 3. Voeg een gebeurtenis toe om de waarde van de variabele te verhogen.

Om de variabelewaarde bij elke iteratie te verhogen:

  1. Voeg als laatste stap van de groep nog een Dynamische ketenvariabele instellen gebeurtenis: toe
    iterate-counter-event.png
    • Selecteer de dynamische variabele die is aangemaakt voor het aantal iteraties.
    • In Waarde , selecteer dezelfde variabele.
  2. Om de waarde te transformeren, klikt u op de variabele in Waarde en voegt u een transformatie toe .
    counter-variable-transform.png
  3. Voeg een Add transformatie toe met een waarde van 1 en klik op Accept .

Als de waarden of het exacte aantal waarden onbekend zijn, kunt u itereren op basis van of aan specifieke voorwaarden wordt voldaan. Je kunt bijvoorbeeld een opdracht herhalen zolang of totdat aan bepaalde criteria is voldaan.

Stap 1. Stel variabelen in voor de voorwaardelijke waarden.

Om de voorwaarden weer te geven die de waarden aangeven waarover geïtereerd moet worden, creëer je dynamische ketenvariabelen. Als een opdracht bijvoorbeeld een booleaanse sleutel als uitvoer geeft om aan te geven of het antwoord extra pagina's bevat, en een integer-offsetparameter om elke pagina te identificeren, maak dan variabelen aan voor deze waarden:

  1. Voeg in de keten een dynamische variabele toe voor elke voorwaarde, zonder beginwaarde.
    condition-variables.png
  2. Om de beginwaarden van de variabelen in te stellen wanneer de keten wordt uitgevoerd, voegt u na de opdracht die de waarden van de voorwaarden uitvoert, een Set dynamic chain variable event toe, selecteert u de dynamische variabelen en voert u hun beginwaarden in.
    condition-variable-event.png
    Voer bijvoorbeeld de waarde True in voor de booleaanse sleutel en de offsetwaarde 0.

Stap 2. Een opdrachtgroep toevoegen

Om de uit te voeren opdrachten en de iteratieregel aan te geven, voegt u een opdrachtgroep toe:

  1. Na de gebeurtenis Dynamische ketenvariabele instellen , voeg Commandogroep toe en sleep een link ertussen.
  2. Selecteer de groep en klik op Bewerken .
  3. Schakel op het tabblad Iteraties herhalen van de groep de optie Iterator herhalen in. 
    condition-iteration-rule.png
  4. Selecteer in het modificatietype en kies "Herhalen tot:".
  5. Klik op + Regel en geef aan wanneer de iteraties moeten stoppen, bijvoorbeeld wanneer de booleaanse sleutel onwaar is.
  6. Voeg de te herhalen opdrachten toe aan de groep.

Stap 3. Stel variabele waarden in bij elke iteratie.

Voeg als laatste stap van de groep nog een Dynamische ketenvariabele instellen gebeurtenis toe om de variabelewaarden bij elke iteratie in te stellen of te verhogen.

  • Om variabele waarden in te stellen, koppelt u elke variabele aan de bijbehorende uitvoer van de eerdere opdracht. Selecteer bijvoorbeeld voor de variabele Boolean de booleaanse sleuteluitvoer; voor de variabele Offset de integer-offsetparameter.
  • Om een ​​variabele te verhogen, zoals Offset , klikt u op de waarde ervan en past u vervolgens een Parse Number -transformatie en een Add -transformatie toe met de waarde die bij elke iteratie moet worden verhoogd.
    offset-transform.png

Iterator-uitvoer

Je kunt de uitvoer van een iterator gebruiken als eigenschap voor andere opdrachten of gebeurtenissen later in de keten. De uitvoer is afhankelijk van de iterator-modifier: List of Repeat until .

Uitvoer Beschrijving
Opdrachtiteratie of groepsiteratie De variabele waarde van de iteratie die in de lus wordt verwerkt.
Inhoudsopgave De nulgebaseerde teller geeft het aantal iteraties aan dat in de lus is verwerkt.
Eerste iteratie Een Booleaanse waarde die aangeeft of de verwerkte iteratie de eerste in de lus is.
Laatste iteratie Alleen voor een List iterator, een Booleaanse waarde om aan te geven of de verwerkte iteratie de laatste in de lus is.
Totaal aantal iteraties Alleen voor een List iterator, een nulgebaseerde telling van het totale aantal iteraties dat door de lus is verwerkt.

Om een ​​uitvoer als eigenschap voor een andere opdracht of gebeurtenis te gebruiken, selecteert u deze onder Command Iterator of Group Iterator respectievelijk.

iterator-outputs.png

Om een ​​opdracht of een groep opdrachten herhaaldelijk achter elkaar uit te voeren, stelt u een iterator in. Opmerk...