h1. %{color:darkred}Gestion des traitements%

|{width:4000px;text-align:left;border-color:transparent}. !/attachments/download/18/en_US.png! [[En_computreegui_stepmanager|...english version of this page]] |

h1. Gestionnaire d'étapes

p<>. L' *arbre des étapes* est géré dans le *gestionnaire d'étapes* (StepManager). Ce composant permet de créer une hiérarchie d'étapes compatibles entre-elles. Une fois les traitements exécutés, chaque étapes porte les résultats qu'elle a créé. 

p<>. _*Gestionnaire d'étape* après création d'un *arbre d'étapes*, mais avant exécution_ :

!step_manager_1.png!

p<>. _*Gestionnaire d'étape* pendant l'exécution de l' *arbre des étapes*_ :

!step_manager_2.png!

p<>. _*Gestionnaire d'étape* après la fin de l'exécution_ :

!step_manager_3.png!

p<>. La *première colonne* contient le *nom des étapes*, avec des flèches à gauche permettant de replier la hiérarchie affiliée à chaque étape. 

p<>. Une fois l'exécution réalisée elle contient également le nom des résultats produits. 

p<>. La *seconde colonne* contient une *barre de progression*, permettant de suivre l'avancée de l'exécution. 

notice<>. Certaines étapes multi-thread ne permettent pas de suivre l'avancement, et restent à 0% pendant tout le traitement, puis passent brutalement à 100 % à la fin de l'exécution. 

p<>. La *troisième colonne* stocke le *temps d'exécution* des étapes (mis à jour en même temps que le pourcentage de progression). 

p<>. *Dans le cas des résultats*, cette colonne contient une case à cocher. Cocher cette case, permet "d'envoyer" le résultat au *gestionnaire de modèle* (ModelManager). Cela a pour effet d'afficher le *modèle de résultat OUT* de l'étape dans le *gestionnaire de modèle* (ce qui permettra de gérer son affichage, comme nous le verrons dans la section [[Fr_computreegui_items|Affichage des items]]). 

p<>. La *quatrième colonne*, permet pour les étapes d'activer le *mode débug*. 

{{collapse(détails sur le mode débug)

p<>. Lorsque l'étape a été conçue en ce sens, et que le *mode débug* est activé, on peut exécuter l'étape pas à pas, et voir le résultat se constituer au fur et à mesure.

p<>. Le *mode débug* est géré à l'aide des boutons suivants de la *barre d'outils principale* :

!debug.png!

p<>. Le *premier bouton* permet de lancer l'exécution de la *prochaine itération* de l'étape.

p<>. Le *second bouton* permet de *sauter_ n itérations*, n étant fixé par la valeur qui suit. 

}}

tip<>. Chaque étape est identifiée de façon unique (numéro entre parenthèses). 

p<>. Pour *lancer l’exécution* de l'arbre des étapes il faut cliquer sur le bouton !{width:24px}play.png!. On peut également interrompre l’exécution à l'aide du bouton !{width:24px}stop.png!. 

p<>. Pour *exporter l'arbre des étapes* en tant que fichier *script*, il faut cliquer sur le bouton !{width:24px}media-floppy.png!. Les scripts peuvent ensuite être *chargés* à l'aide du bouton !{width:24px}folder_add_32.png!.

h1. Initialisation de l'arbre des étapes

p<>. Pour initier une séquence d'étapes, il faut commencer par insérer une *étape initiale*. 

p<>. On peut insérer :
* Une *étape de chargement de fichier*, à l'aide du bouton !{height:24px}folder_add_32.png!. Dans ce cas, une fenêtre de choix de fichier s'ouvre, et le chargement des données s'exécute, une fois le choix de fichier validé. 
* Une *étape initiale*, à l'aide du bouton !{height:24px}add.png!. Dans ce cas il faut sélectionner l'étape dans le sous-menu du plugin qui la contient. Ce type d'étape permet de faire des chargements plus complexes (plusieurs fichiers de types différents, paramétrages avant chargement...). 

!canbeaddedfirst.png!

h1. Ajout d'étapes filles

p<>. Une fois un point de départ inséré, l'ajout d'autres étapes se fait à l'aide du *menu contextuel* : clic-droit sur une étape à laquelle on veut ajouter une *étape fille*.

notice<>. Pour que l'ajout d'étape puisse se faire il faut faire le clic-droit sur une étape et non sur un résultat.

!menu_contextuel_etape.png!

*Éléments du menu contextuel d'étapes* :

p<>. La première partie du menu permet de modifier l'étape en cours :

* *Exécuter* : lance l’exécution
* *Informations sur l'étape* : ouvre une fenêtre donnant des informations détaillées sur l'étape. Il s'agit de la même fenêtre qu'avec le bouton _Info Etape_ du menu _aide / A propos des plugins_ (cf. [[Fr_computreegui_intro#Menu aide|Organisation générale de l’interface / Menu aide]]). Cependant ici les *modèles de résultats OUT* de l'étapes sont toujours disponibles. 
* *Configurer les résultats d'entrée* : permet de modifier les résultats pris en compte dans le cas où plusieurs candidats sont valides
* *Configurer* : ouvre la boite de paramétrage de l'étape en cours
* *Supprimer* : supprimer l'étape (et toutes ses étapes filles)

warning<>. En cas de *reconfiguration des résultats d'entrée*, ou de *re-paramétrage* de l'étape, une *astérisque* précédera désormais le nom de l'étape dans l' *arbre des étapes*. Cela signifie que le lancement de l'exécution conduira à ré-exécuter l'étape et toutes ses étapes filles. Tous les résultats concernés seront effacés avant d'être recalculés. 

p<>. La seconde partie du menu contient un *sous menu pour chaque plugin d'étape chargé*. Ce sous menu contient la *liste des étapes du plugin*. Celles en *grisé* ne sont pas compatibles avec les résultats produits par l'étape en cours. Les autres peuvent être ajoutées. En laissant la souris un instant immobile, on obtient une info-bulle décrivant sommairement la fonction de l'étape. En cliquant l'étape est ajoutée, ce qui provoque l'affichage de la *fenêtre de configuration des résultats d'entrée* (si nécessaire), puis de la *fenêtre de paramétrage* de la nouvelle étape fille.

h1. Configuration d'une étape

p<>. Une fois ajoutée, l'étape doit (la plupart du temps) être configurée. 

p<>. Tout d'abord l'étape *analyse les résultats de l'étape mère* (voire de toute la hiérarchie en amont si la recherche récursive est active pour le résultat considéré). Cette analyse sélectionne le(s) résultat(s) compatible(s) en entrée.

p<>. Cette sélection fonctionne par comparaison entre le *modèle de résultats IN* de l'étape ajoutée, avec les *modèles de résultats OUT* des résultats candidats. 

p<>. Dans le cas où plusieurs résultats sont valides, la *fenêtre de configurer les résultats d'entrée* est ouverte :

!config_resultin_1.png!

p<>. *La partie gauche* liste les *résultats candidats*, classés par élément recherché du *modèle de résultat IN de l'étape*. Le numéro de l'étape portant chaque résultat est indiqué entre parenthèses. 

p<>. *En double-cliquant* sur un résultat de gauche, cela le transfert en tant que correspondance validée dans la partie droite (on peut aussi le glisser de la partie gauche vers la partie droite). 

!config_resultin_2.png!

p<>. *La partie droite* affiche les *correspondances de résultats validées, en haut*. *En bas* elle permet de sélectionner, si nécessaire,  au sein d'un résultat donné les *niveaux de groupes et d'items à utiliser*.

{{collapse(Explication du concept de tours)

p<>. Sur la partie droite de la fenêtre, on remarque un onglet *Tour 1*, et un onglet avec un +. Le + permet d'ajouter d'autres tours.

p<>. Chaque *tour* ajouté (par défaut il n'y en a qu'un), permet de paramétrer l'étape avec des résultats candidats différents. Dans ce cas l'étape sera exécutée une fois pour chaque tour ajouté.

p<>. Les résultats produits par tous les tours seront tous ajoutés à l'étape. 

warning<>. La gestion de tours multiples n'est pas toujours prise en compte par les développeurs de plugins. Cela peut conduire au plantage de l'application, si l'étape n'a pas été conçue en conséquence. Si cela se produit, merci de le signaler par une demande dans le projet du plugin sur http://rdinnovation.onf.fr. 

}}

p<>. *Une fois tous les choix effectués*, il suffit de cliquer sur *OK*, pour valider la *configuration des résultats d'entrée*.

p<>. Ensuite, s'il y a lieu, la *fenêtre de paramétrage* de l'étape s'ouvre. Elle contient tous les paramètres réglables de l'algorithme à exécuter. Exemple pour l'étape _OE_StepExtractSoil03_ :

!config_oe_stepextractsoil03.png!

p<>. Une fois les paramètres choisis et validés, l'étape est effectivement ajoutée dans l' *arbre des étapes*.



_____

| [[Fr_computreegui_intro|Page précédente (Organisation générale de l’interface)]] | [[Fr_computreegui|Retour au sommaire GUI]]| [[Fr_computreegui_items|Page suivante (Affichage des items)]] |