Computree Documentation

Boucle standard

Plugin : Base
Nom de classe : PB_StepBeginLoopThroughGroups02

Description

Cette étape permet d'effectuer des traitements par lots.
Elle créée une boucle permettant de traiter successivement les différents éléments sélectionnés en entrée.
IMPORTANT : la boucle devra être fermée avec l'étape "Fin de boucle".

Le cas d'utilisation le plus classique est après l'étape "Créer une liste de fichiers", afin d'itérer sur les fichiers de la liste.

Données d'entrée

Structure des données d'entrée recherchées :

Result : In Result
    ...
        Groupe (Group)
            Item (Item)
                Nom (ANY)


L'item choisi définit sur quelle liste d'éléments il faut itérer.
Pour cet item il faut choisir un attribut "Nom", qui permettra de nommer les tours de boucles.
Cela permet par exemple de créer dans la boucle des exports adaptatifs, dont les noms de fichiers de sortie seront constitués à partir du nom des items en entrée (nom du fichier en cours en général).

Données de sortie

Cette étape génère deux résultats :
  • Une copie du résultat d'entrée, mais dans laquelle seul l'item de l'itération en cours est disponible,
  • Un résultat Compteur, permettant la gestion de la boucle. Ce compteur est en particulier utilisé pour connaître le nom du tour courant.

Détails

L'utilisation la plus habituelle de cette étape est de traiter successivement une liste de fichiers. Dans ce cas, la structure du script est la suivante :
  1. Créer une liste de fichier (séléction de la liste des fichiers à parcourir)
  2. Boucle standard (début de la boucle)
  3. Charger les fichiers d'une liste (chargement du fichier correspondant au tour de boucle courant)
  4. ... (étapes de traitement et d'export)
  5. Fin de boucle

Cependant cette étape est générique et peut donc être utilisée dans de nombreux autres cas.
Il est même possible d'emboiter plusieurs boucles, en prenant garde de bien gérer les correspondances de résultats compteurs entre chaque début et fin de boucle.