Portail de support Workiva

Un itérateur peut répéter une commande ou un groupe sur un nombre exact de valeurs, comme le total des pages produites par une commande située plus haut dans la chaîne.

Étape 1. Créez une variable pour la valeur du nombre

Pour indiquer le nombre d'itérations, créez une variable chaîne dynamique :

1. Dans la chaîne, ajoute une variable dynamique pour le nombre d'itérations, comme Counter, sans valeur initiale.
   
2. Pour définir la valeur initiale de la variable lors de l'exécution de la chaîne, après la commande qui affiche le nombre d'itérations, ajoute un événement Set dynamic chain variable:
   
   
   • Sélectionnez la variable dynamique créée pour le nombre d'itérations.
   • Dans Value, et saisissez sa valeur de départ, par exemple 1.
     
     

Étape 2. Ajouter un groupe de commande

Pour indiquer les commandes à itérer et la règle d'itération, ajoutez un groupe de commandes :

1. Après l'événement Set dynamic chain variable, ajoute Command group, et fait glisser un lien entre eux.
2. Sélectionnez le groupe et cliquez sur Editer.
3. Dans l'onglet Iterations repeat du groupe, activez Iterator repeat. 
   
4. Dans Select modifier type, sélectionnez Répéter jusqu'à.
5. Cliquez sur Rule, sélectionnez le type de données Float et indiquez quand arrêter les itérations. Par exemple, pour itérer sur la base du résultat Total des enregistrements d'une commande précédente, définissez une règle pour arrêter les itérations lorsque la valeur de la variable est supérieure (>) au résultat Total des enregistrements.
6. Ajouter au groupe les commandes d'itération.
   
   

Étape 3. Ajouter un événement pour incrémenter la valeur de la variable

Incrémenter la valeur de la variable à chaque itération :

1. La dernière étape du groupe consiste à ajouter un autre événement Set dynamic chain variable:
   
   
   • Sélectionnez la variable dynamique créée pour le nombre d'itérations.
   • Dans Value, sélectionnez la même variable.
2. Pour transformer la valeur, cliquez sur la variable dans Value, et ajoutez une transformation Parse Number.
   
3. Ajoutez une transformation Add avec une valeur de 1, et cliquez sur Accept.

Si les valeurs ou le nombre exact de valeurs sont inconnus, vous pouvez itérer en fonction de conditions spécifiques. Par exemple, vous pouvez répéter une commande pendant ou jusqu'à ce que les critères spécifiés existent.

Étape 1. Définir les variables pour les valeurs conditionnelles

Pour représenter les conditions qui indiquent les valeurs sur lesquelles il faut itérer, créez des variables de chaîne dynamique. Par exemple, si une commande fournit une clé booléenne pour indiquer si sa réponse contient des pages supplémentaires et un paramètre de décalage entier pour identifier chaque page, créez des variables pour ces valeurs :

1. Dans la chaîne, ajoute une variable dynamique pour chaque condition, sans valeur initiale.
   
2. Pour définir les valeurs initiales des variables lors de l'exécution de la chaîne, après la commande qui produit les valeurs des conditions, add a Set dynamic chain variable event, sélectionnez les variables dynamiques et entrez leurs valeurs initiales.
   
   Par exemple, la valeur de la clé booléenne est True et la valeur du décalage est 0.
   
   

Étape 2. Ajouter un groupe de commande

Pour indiquer les commandes à itérer et la règle d'itération, ajoutez un groupe de commandes :

1. Après l'événement Set dynamic chain variable, ajoute Command group, et fait glisser un lien entre eux.
2. Sélectionnez le groupe et cliquez sur Editer.
3. Dans l'onglet Iterations repeat du groupe, activez Iterator repeat. 
   
4. Dans Select modifier type, sélectionnez Répéter jusqu'à.
5. Cliquez sur Rule, et indiquez quand arrêter les itérations, par exemple lorsque la clé booléenne est False.
6. Ajouter au groupe les commandes d'itération.
   
   

Étape 3. Définir les valeurs des variables à chaque itération

La dernière étape du groupe consiste à ajouter un autre événement Set dynamic chain variable pour définir ou incrémenter les valeurs de la variable à chaque itération.

• Pour définir les valeurs des variables, associez chacune d'entre elles aux sorties respectives de la commande précédente. Par exemple, pour la variable Boolean, sélectionnez la sortie booléenne ; pour la variable Offset, le paramètre de décalage des nombres entiers.
• Pour incrémenter une variable, telle que Offset, cliquez sur sa valeur, puis appliquez une transformation Parse Number et une transformation Add avec la valeur à incrémenter à chaque itération.