Per eseguire ripetutamente un comando o un gruppo di comandi in una catena, imposta un iteratore.
Nota: per convertire l'output di un database relazionale o di un servizio Web esterno in un array JSON da utilizzare con un iteratore, usa il comando da CSV a JSON delconnettore JSON o una trasformazione di variabili JSON .
Impostare un iteratore
Con un iteratore, puoi ripetere un comando o un gruppo in base a:
- Un elenco statico o dinamico di valori
- Un numero esatto di valori
- In base all'esistenza di una condizione
Un iteratore può ripetere un comando o un gruppo:
- Un elenco statico di valori, come regioni o entità
- Un elenco dinamico o variabile di valori, come ad esempio un file caricato come risorsa del workspace o l'output di un comando precedente nella catena
Nota: un comando o un gruppo è limitato a 1000 iterazioni.
Per eseguire un iteratore su un elenco di valori:
- Nella catena, seleziona il comando o il gruppo da eseguire ripetutamente e clicca su Modifica .
- Nella scheda Iterazioni , abilita Iteratore .
- In Seleziona il tipo di modificatore, seleziona Elenco.
- Inserisci i valori delle iterazioni:
- Per un elenco statico, inserisci il valore per ogni iterazione, premendo Inserisci dopo ogni iterazione.
- Per un elenco dinamico, seleziona l'output del comando precedente con i valori da utilizzare.
- Per un elenco statico, inserisci il valore per ogni iterazione, premendo Inserisci dopo ogni iterazione.
Un iteratore può ripetere un comando o un gruppo su un numero esatto di valori, come ad esempio il totale delle pagine emesse da un comando precedente nella catena.
Passo 1. Imposta una variabile per il valore numerico
Per indicare il numero di iterazioni, crea una variabile dinamica della catena:
- Nella catena, aggiungi una variabile dinamica per il numero di iterazioni, come Contatore, senza valore iniziale.
- Per impostare il valore iniziale della variabile durante l'esecuzione della catena, dopo il comando che indica il numero di iterazioni, aggiungi un evento Imposta la variabile dinamica di catena:
- Seleziona la variabile dinamica creata per il numero di iterazioni.
- In Valore, inserisci il suo valore iniziale, ad esempio 1.
Passo 2. Aggiungi un gruppo di comando
Per indicare i comandi da iterare e la regola di iterazione, aggiungi un gruppo di comandi:
- Dopo l'evento Imposta la variabile dinamica di catena, aggiungi Gruppo di comando e trascina un collegamento tra di loro.
- Seleziona il gruppo e clicca su Modifica.
- Nella scheda Iterazioni del gruppo, abilita Iteratore .
- In Seleziona il tipo di modificatore, seleziona Ripeti fino a quando.
- Clicca su + Regola, seleziona il tipo di dati Float e specifica quando interrompere le iterazioni. Ad esempio, per iterare in base al risultato Record totali di un comando precedente, imposta una regola che interrompa le iterazioni quando il valore della variabile è maggiore (>) dell'output Record totali.
- Aggiungi i comandi per iterare al gruppo.
Passo 3. Aggiungi un evento per incrementare il valore della variabile
Per incrementare il valore della variabile a ogni iterazione:
- Come ultimo passo del gruppo, aggiungi un altro evento Imposta la variabile dinamica di catena:
- Seleziona la variabile dinamica creata per il numero di iterazioni.
- In Valore, seleziona la stessa variabile.
- Per trasformare il valore, clicca sulla variabile in Valore e aggiungi una trasformazione Analizza numero.
- Aggiungi una trasformazione Aggiungi con un valore di 1 e clicca su Accetta.
Se i valori o il numero esatto di valori non sono noti, puoi iterare in base alla presenza di condizioni specifiche. Ad esempio, puoi ripetere un comando finché o fino a quando non esistono i criteri specificati.
Passo 1. Imposta le variabili per i valori condizionali
Per rappresentare le condizioni che indicano i valori su cui iterare, crea delle variabili dinamiche di catena. Ad esempio, se un comando fornisce un output di chiave booleana per indicare se la sua risposta contiene pagine aggiuntive e un parametro di offset con numero intero per identificare ogni pagina, crea delle variabili per questi valori:
- Nella catena, aggiungi una variabile dinamica per ogni condizione, senza valore iniziale.
- Per impostare i valori iniziali delle variabili quando la catena viene eseguita, dopo il comando che emette i valori delle condizioni, aggiungi un evento Imposta la variabile dinamica di catena, seleziona le variabili dinamiche e inserisci i loro valori iniziali.
Ad esempio, inserisci il valore della chiave booleana come True e il valore di offset come 0.
Passo 2. Aggiungi un gruppo di comando
Per indicare i comandi da iterare e la regola di iterazione, aggiungi un gruppo di comandi:
- Dopo l'evento Imposta la variabile dinamica di catena, aggiungi Gruppo di comando e trascina un collegamento tra di loro.
- Seleziona il gruppo e clicca su Modifica.
- Nella scheda Iterazioni del gruppo, abilita Iteratore .
- In Seleziona il tipo di modificatore, seleziona Ripeti fino a quando.
- Clicca su + Regola e specifica quando interrompere le iterazioni, ad esempio quando la chiave booleana è False.
- Aggiungi i comandi per iterare al gruppo.
Passo 3. Imposta i valori delle variabili a ogni iterazione
Come ultimo passo del gruppo, aggiungi un altro evento Imposta la variabile dinamica di catena per impostare o aumentare i valori della variabile a ogni iterazione.
- Per impostare i valori delle variabili, mappa ogni variabile con i rispettivi output del comando precedente. Ad esempio, per la variabile Boolean, seleziona l'uscita della chiave booleana; per la variabile Offset, il parametro offset con numero intero.
- Per incrementare una variabile, come Offset, clicca sul suo valore e poi applica una trasformazione Analizza numero e una trasformazione Aggiungi con il valore da incrementare ad ogni iterazione.
Output dell'iteratore
Puoi utilizzare l'output di un iteratore come proprietà per altri comandi o eventi successivi nella catena. Gli output dipendono dal modificatore dell'iteratore -Elenca o Ripeti fino a.
| Output | Descrizione |
|---|---|
| Iterazione dei comandi o iterazione dei gruppi | Il valore della variabile dell'iterazione elaborata nel ciclo |
| Indice | Il conteggio a base zero per indicare l'iterazione elaborata nel ciclo |
| Prima iterazione |
Un valore booleano per specificare se l'iterazione elaborata è la prima del ciclo |
| Ultima iterazione | Solo per un iteratore di Elenco, un valore booleano per specificare se l'iterazione elaborata è l'ultima del ciclo |
| Totale iterazioni | Solo per un iteratore di Elenco, un conteggio a base zero delle iterazioni totali processate dal ciclo |
Per utilizzare un output come proprietà per un altro comando o evento, selezionalo in Iteratore comando o Iteratore gruppo, rispettivamente.