STUDIO Arbres

1. Principe d’un arbre paramétré

Les arbres paramétrés sont des outils de paramétrage de Work-Flow, permettant d’afficher des données sous forme d’arbre, ergonomie équivalente aux présentations de nomenclatures ou les explorateurs applicatifs de DIAPASON, permettant aussi de paramétrer des actions, de la même manière qu’une liste paramétrée et un tableur dynamique.

A la différence d’une liste, un arbre permet de hiérarchiser des données. Par contre les fonctionnalités de recherche, filtre et tris n’étant pas présentes, il faut dans le cas d’un arbre limiter le nombre de données à afficher.

L’exécution d’un arbre paramétré se fera de manière équivalente à une Liste Paramétrée, on le retrouvera :

• Dans les explorateurs.

• Depuis une application à cœur standard

• Depuis une application à cœur paramétré

• Comme père de couplage

Remarque : contrairement à une liste paramétrée, un arbre n’est pas lançable depuis le navigateur.

2. Définition d’un arbre

Le paramétrage des arbres est accessible dans l’explorateur « studio DIAPASON », à la branche « arbres ».

Onglet généralités :

Les informations de cet onglet sont générales à tous les objets de DIAPASON. Référence : La référence de l’arbre. Désignation :La désignation de l’arbre, correspondant au texte affiché dans un explorateur, ainsi que dans le menu contextuel lorsqu’il s’agit d’une action. Libellé court :Le libellé court, correspond au texte affiché dans la barre de commande lorsqu’il s’agit d’une action. Icône : L’icône de l’arbre, qui sera affiché dans l’explorateur et devant le titre une fois lancé. Titre :Le titre de l’arbre. Mot Directeur :Le mot directeur de l’application. Domaine, Famille, Sous Famille :Le domaine, la famille et la sous famille de l’arbre. Commentaire :Le commentaire sur l’arbre.

Onglet Démarrage :

Mode Démarrage : Le mode de démarrage va permettre de déterminer l’accès aux actions de gestion de l’arbre paramétré, et le comportement vis-à-vis des applications père. 0: Mode Visualisation : Aucune action de gestion n’est disponible, pas de blocage du père 1: Mode Gestion Libre : L’accès aux actions est disponible, le père n’est pas bloqué 2: Mode Gestion avec blocage applications père : les actions sont disponibles, le père est bloqué jusqu’à la fermeture de l’arbre Explorateurs applicatifs : Explorateurs depuis lesquels est accessible l’arbre paramétré. Règle Liens Gén. : Règle REB permettant de définir des branches génériques. Cette règle est exécutée pour chaque explorateur où est présent l’arbre paramétré. Plus d’infomations L’exécution de la va générer des sous branches de la branche principale de l’arbre : Le contexte en entrée de la requête : Toutes les variables critères de type IAP permettant d’identifier l’arbre et son application père. SCR.ARB_ArbRef : référence de l’arbre paramétré. SCR.RefExpApp : référence de l’explorateur applicatif dans le cas de l’affichage de l’arbre dans un explorateur applicatif. Les valeurs par défaut des variables critères utilisées par cette requête. Traitement à réaliser : Elle doit initialiser la liste standard WFEAPLiG contenant les différentes branches génériques telles que : WFEAPLiG.Nor contient le numéro d’ordre de la branche générique. WFEAPLiG.Libelle contient le libellé de la branche générique. WFEAPLiG.IcoOuvert contient la référence de l’icône à utiliser lorsque la branche est ouverte. WFEAPLiG.IcoSelect contient la référence de l’icône à utiliser lorsque la branche est sélectionnée. WFEAPLiG.IcoFerme contient la référence de l’icône à utiliser lorsque la branche est fermée. WFEAPLiG.Criteres contient la liste chaînée des valeurs des critères sous la forme « NomVarCri1,ValVarCri1,NomVarCri2,ValVarCri2,… » (exemple : SCR.AppFouRef,12045,VCR.DatLivIni,15/05/2006) En sortie de la requête : Pour chaque enregistrement de WFEAPLiG, création d’une sous branche dans l’explorateur. Lors du démarrage d’une application depuis une sous branche générique, les critères contenus dans WFEAPLiG.Criteres sont transmis aux requêtes de démarrage et de construction. Critères défaut : Paramétrage de la valeur défaut des critères de la règle de liens génériques. Typ. Ctx. App. : Type de récupération de critères lors d’un démarrage depuis une application à cœur standard : 1: Pas de relation : aucun critère n’est récupéré. 2: Identifiant : l’identifiant et le critère clé de l’application père sont récupérés. 3: Identifiant et Variables contextuelles : en plus de l’identifiant et du critère clé, les critères du contexte courant de l’application père sont récupérés 4: Identifiant et Liste de sélection : la liste des identifiant sélectionnés sur le père est récupérée 5: Identifiant, liste de sélection et variables contextuelles : tous les critères cités dans ce tableau sont récupérés Typ Ctx. Dia.: Type de récupération de critères lors d’un démarrage depuis une application à cœur paramétrable : 1: Pas de relation : aucun critère n’est récupéré. 2: Variables utiles : récupération sur le père des variables de type VCR déterminées dans la zone « Var Dem. Dia. » 3: Toutes les variables : récupération de toutes les variables SCR, VCR, VBP de l’application père. 4: Toutes les variables et tableur père éventuel : récupération de toutes les variables précédemment citées et si le père est une tableur dynamique, le contenu de WfTabValPere. Var. Dem. Dia. : Variables utiles au démarrage depuis une application à cœur paramétré. Accès à un drag&drop sur les variables VCR.

Onglet Définition

Type de chargement : Détermine si l’arbre sera chargé niveau par niveau ou complet au démarrage. Réf. Origine Arb : Zone uniquement en visualisation. Référence du nœud racine de l’arbre. Règ. Const : Requête de type REB de construction de l’arbre. Voir chapitre sur la construction d’un arbre par règle DIALOG. Exe. Règ Reinit : Drapeau indiquant si la requête de construction est ré exécutée lors d’une actualisation.

Onglet Interface

Icône défaut. : Icône par défaut des nœuds de l’arbre.

Onglet Actions

Règle démarrage : Référence de la requête optionnelle exécutée lors du démarrage de l’arbre. Elle permet d’initialiser les critères utilisés dans la requête de construction, et filtrer les actions disponibles parmi celles définies sur la structure de l’arbre. Plus d'infos Le contexte en entrée de la requête : Toutes les variables critères de type IAP permettant d’identifier l’arbre et son application père. SCR.ARB_ArbRef : référence arbre SCR.ARB_ActCtx : contexte de lancement, ici « DEM » SCR.ARB_LisAct : liste des références actions disponibles sur cet arbre parmi celles définies sur l’application. SCR.Titre : Titre de l’application récupéré sur sa définition. SCR.Icone : Icone de l’application récupéré sur sa définition. Liste des critères initialisée dans les branches de l’explorateur. Traitements à réaliser : Titre : Le titre de la liste paramétrée peut être modifié. Icône : il est possible de modifier l’icône qui est définie sur la structure de l’arbre. Initialiser tous les critères nécessaires à la construction de l’arbre. Le contexte en sortie de la requête : SCR.ARB_LisAct : Liste des références actions disponibles pour l’arbre parmi celles définies sur sa structure. SCR.Titre : Titre de l’application SCR.Icone : Icône de l’application Tous les critères initialisés dans la requête et présents en entrée, servant à la construction. Règle validation : Référence de la requête optionnelle exécutée lors de la validation de l’arbre. Plus d’infos Contexte en entrée : Toutes les variables critères de type IAP permettant d’identifier l’arbre et son application père. SCR.ARB_ArbRef SCR.ARB_ActCtx = « VAL » Traitements à réaliser Mise à jour de données. Initialisation de variables critères en vue de les transmettre à un père éventuel. Contexte de sortie : Toutes les variables SCR et VCR initialisées dans la requête ou dans une requête précédente. Règle abandon : Même fonctionnement que la règle de validation. Actions : Accès à l’application de définition des actions pour l’arbre. Règle : Règle de type RCT optionnelle permettant de gérer les actions.

Onglet Critères conditions

Saisie Critères : Comme pour une liste paramétrée, il est possible lorsque ce drapeau est à vrai d’avoir accès après le lancement de l’arbre à une fiche de saisie des critères de la requête de construction, accessible par une action. Critère Défaut : Valeurs par défaut des critères de la requête de construction. PSD Critères : Il est possible dans le cas ou la saisie des critères est possible, de renseigner une PSD pour la saisie des critères pour la règle de construction.

3. Actions de gestion sur les arbres

• Actions standard de gestion : création, modification, duplication, suppression…

• Accès aux nœuds: Action permettant d’ouvrir l’application de définition du détail des arbres.

• Cas d’Emploi dans les Actions: Présente la liste des cas d’utilisation de l’arbre (Explorateurs Applicatifs, AME, etc.).

• Créer un Raccourci: Affiche la fiche standard de définition d’un raccourci. Le raccourci créé permettra de lancer l’arbre directement depuis la barre de raccourcis du bureau.

4. Définition du détail de l’arbre

Onglet général

On va saisir ici la référence du nœud et celle de son père, cela va permettre de positionner le nœud dans l’arbre. La zone libellé initialise le libellé du nœud, l’icône, sera celle de ce nœud, et le bouton « Lst. Action » permet de définir la liste des actions disponibles sur ce nœud. Réf. Entête: Référence de l’arbre paramétré sur lequel on ajoute ce nœud. Num. Ordre: Numéro d’ordre, permet d’ordonner les nœuds dans l’arbre Référence: Référence du nœud. Réf. Père: Référence du nœud père Désignation: Désignation du nœud. Libellé: Libellé du nœud, c’est le texte qui sera affiché à coté Icône: Icône du nœud Lst. Action: « Drag & Drop » permettant de sélectionner parmi les actions définies sur l’entête de l’arbre, celles qui seront accessibles sur ce nœud.

Onglet Informations

Cet onglet contient l’initialisation des informations générales que porte le nœud. On peut y renseigner trois clés, cinq valeurs alphanumériques, cinq valeurs numériques, cinq date, cinq logique.

Onglet Couplage

Type Enfant Cou. : Type d’enfant du couplage sur ce nœud, dans le cas où l’arbre est utilisé comme père de couplage, évite la création de la requête de changement de fils. Voir le chapitre des Couplages. Réf. Enfant Cou. : Référence de l’enfant du couplage correspondant au type ci-dessus.

5. Construction d’un arbre

La structure de l’arbre à son démarrage peut être établie depuis l’application de gestion de structure de l’arbre, si celle-ci est statique, dans le cas ou elle peut dépendre de critères ou de données, une requête de type REB dite de construction de l’arbre permet de déterminer sa structure, à partir d’une liste standard DIALOG.

La méthode de construction d’un arbre paramétré sera différente selon son mode de chargement. Il existe deux modes de chargement :

Complet : au démarrage de l’arbre, toute sa structure est définie, elle ne pourra être modifiée que lors d’une actualisation. Cette structure initiale peut être définie statiquement depuis l’application de gestion de structure de l’arbre.

Par niveau : Une requête de construction sera nécessaire dans ce cas, le principe est que pour chaque ouverture de nœud, la requête de construction est exécutée, une liste standard DIALOG contiendra les nœuds à afficher.

La structure d’un arbre est déterminée par deux listes standard DIALOG :

WfArbEnt : liste accessible seulement en lecture, elle représente la structure de l’arbre au moment de l’exécution de la requête.

WfArbSor : liste en écriture. Elle contient soit une liste de nœuds fils du nœud ouvert dans le cas du mode par niveau, soit la structure complète de l’arbre.

Leur structure est la suivante :

Une troisième liste DIALOG permet de donner le chemin d’un nœud. Celle-ci sera utilisée, lors d’une actualisation ou d’un rafraîchissement, ou pour le mode « par niveau » lors de l’ouverture d’un nœud, et servira à donner des informations permettant de retracer le chemin de l’origine de l’arbre jusqu’au nœud concerné par l’action.

Construction d’un arbre complet

Le principe de ce mode est d’alimenter la totalité de la structure de l’arbre au démarrage de celui-ci. Lors du démarrage de l’arbre, suite à l’exécution de la requête de démarrage, la requête de construction est exécutée.

Dans le cas où tout ou partie de la structure de l’arbre a été initialisée dans le détail de l’arbre, celle-ci est pré chargée dans la liste WfArbSor. Cela permet de se dispenser de la requête qui va construire l’arbre.

Dans le cas où l’initialisation de WfArbSor par l’application de gestion de la structure de l’arbre n’est pas suffisante, la requête de construction de l’arbre va permettre de modifier cette liste et de la compléter.

En mode complet, le principe de filiation entre deux nœuds se base sur les champs NodIdeEnc et NodIdePer. Le champ NodIdeEnc doit être unique dans tout l’arbre, c’est la valeur à laquelle on fait référence dans le champs NodIdePer.

Enfin, lorsqu’une action nécessite une actualisation, ou un rafraîchissement, la requête de construction peut être exécutée, un critère permet d’identifier ce cas, la liste WfArbSor de vra entièrement être initialisée pour une actualisation, ou contenir les modifications sur les nœuds existant (il faut récupérer l’identifiant sur WfArbEnt et le recopier sur WfArbSor) pour un rafraîchissement.

Construction d’un arbre par niveau

La construction par niveau permet par rapport au chargement global d’améliorer les performances. La requête de construction va dans ce cas là être exécutée pour chaque ouverture de nœud, et elle va retourner la liste des nœuds fils de celui qui est en cours d’ouverture.

Dans le cas où tout ou partie de la structure de l’arbre a été initialisée dans l’application prévue à cet effet, la liste WfArbSor va être initialisée avec tous les fils du nœud en cours d’ouverture trouvés dans cette structure initiale.

La requête de construction de l’arbre va être exécutée dans un premier temps au démarrage pour renseigner le nœud d’origine. Ensuite, celle-ci va être exécutée à chaque ouverture de nœud, en donnant un contexte en entrée permettant d’identifier le nœud ouvert, puis, en sortie de la requête, la liste WfArbSor va contenir la liste des fils de ce nœud si il en existe.

Le système de filiation dans ce cas va se baser sur les champs NodIdeEnc et NodIdePer, sauf que pour NodIdeEnc, il ne sera pas nécessaire de l’initialiser dans la requête, DIAPASON va attribuer une valeur. L’initialisation de NodIdePer va se faire en lui attribuant la valeur de l’identifiant du nœud père passé en entrée de la requête (voir tableau récapitulatif).

Variables contextuelles pour une construction complète

Contexte en entrée :

Toutes les variables critères de type IAP permettant d’identifier l’arbre et son application père.

SCR.ARB_ArbRef

SCR.ARB_ActCtx = « CONS »

Si la requête est exécutée au démarrage de l’application :

SCR.ARB_ActCtxCons = « DEM »

La liste standard WfArbSor initialisée par le détail de l’arbre.

Si la requête est exécutée lors d’une actualisation :

SCR.ARB_ActCtxCons = « ACT »

SCR.RCT_TypeAction : Code de l’action ayant déclenché le réaffichage

SCR.ARB_NodIdeEnc : Identifiant du nœud courant

SCR.ARB_NodIdePer : Identifiant du nœud père du courant

La Liste standard WfArbEnt disponible en lecture contenant la structure actuelle de l’arbre

La liste standard WfCheEnt disponible en lecture contenant les nœuds menant au nœud courant

Si la requête est exécutée lors d’un réaffichage :

SCR.ARB_ActCtxCons = « REA »

SCR.RCT_TypeAction : Code de l’action ayant déclenché le réaffichage

SCR.ARB_NodIdeEnc : Identifiant du nœud courant

SCR.ARB_NodIdePer : Identifiant du nœud père du courant

La Liste standard WfArbEnt disponible en lecture contenant la structure actuelle de l’arbre

La liste standard WfCheEnt disponible en lecture contenant les nœuds menant au nœud courant.

Traitement à réaliser :

Il s’agit d’initialiser la liste WfArbSor avec toute la structure de l’arbre, si la requête est exécutée au démarrage.

S’il s’agit d’une actualisation, la liste WfArbSor doit être initialisée avec toute la structure de l’arbre, et la variable SCR.NodPosSor donnant l’identifiant du nœud de positionnement (par défaut le nœud courant).

S’il s’agit d’un rafraichissement, la liste WfArbSor doit être initialisée avec seulement les nœuds qui seront modifiés, ceux-ci ne changeant pas d’identifiant, ni de référence, et la variable SCR.NodPosSor donnant l’identifiant du nœud de positionnement (par défaut le nœud courant).

Contexte en sortie :

La liste WfArbSor

SCR.NodPosSor

Variables contextuelles pour une construction par niveau

Contexte en entrée :

Toutes les variables critères de type IAP permettant d’identifier l’arbre et son application père.

SCR.ARB_ArbRef

SCR.ARB_ActCtx = « CONS »

Si la requête est exécutée au démarrage de l’application :

SCR.ARB_ActCtxCons = « DEM »

La liste standard WfArbSor initialisée par la racine.

Si la requête est exécutée lors de l’ouverture d’un nœud

SCR.ARB_ActCtxCons = « OUV »

SCR.ARB_NodIdeEnc : Identifiant du nœud ouvert

SCR.ARB_NodIdePer : Identifiant du nœud père de celui ouvert

La Liste standard WfArbEnt disponible en lecture contenant la structure actuelle de l’arbre

La liste standard WfCheEnt disponible en lecture contenant les nœuds menant au nœud courant

La liste standard WfArbSor initialisée avec les nœuds fils du nœud ouvert qui ont été définis sur l’application de définition du détail de l’arbre.

Si la requête est exécutée lors d’une actualisation :

SCR.ARB_ActCtxCons = « ACT »

SCR.RCT_TypeAction : Code de l’action ayant déclenché le réaffichage

SCR.ARB_NodIdeEnc : Identifiant du nœud courant

SCR.ARB_NodIdePer : Identifiant du nœud père du courant

La Liste standard WfArbEnt disponible en lecture contenant la structure actuelle de l’arbre

La liste standard WfCheEnt disponible en lecture contenant les nœuds menant au nœud courant

Si la requête est exécutée lors d’un réaffichage :

SCR.ARB_ActCtxCons = « REA »

SCR.RCT_TypeAction : Code de l’action ayant déclenché le réaffichage

SCR.ARB_NodIdeEnc : Identifiant du nœud courant

SCR.ARB_NodIdePer : Identifiant du nœud père du courant

La Liste standard WfArbEnt disponible en lecture contenant la structure actuelle de l’arbre

La liste standard WfCheEnt disponible en lecture contenant les nœuds menant au nœud courant.

Traitement à réaliser :

Il s’agit d’initialiser la liste WfArbSor avec la racine de l’arbre, si la requête est exécutée au démarrage.

S’il s’agit de l’ouverture d’un nœud, la liste WfArbSor doit être initialisée avec la liste des nœuds enfants du nœud ouvert, la variable SCR.ARB_NodPosSor donnera l’identifiant du nœud de positionnement (par défaut le nœud courant).

S’il s’agit d’une actualisation, la liste WfArbSor doit être initialisée avec la liste des nœuds fils du nœud représenté par la variable SCR.ARB_NodIdeSor. Pour le nœud de positionnement en sortie de requête, deux solutions, soit le nœud de positionnement existe déjà, la variable SCR.ARB_NodPosSor sera l’identifiant de ce nœud de positionnement dans WfArbEnt, sinon la SCR.ARB_NodRefCre sera la référence du nœud parmi ceux qui sont dans WfArbSor.

S’il s’agit d’un rafraichissement, la liste WfArbSor doit être initialisée avec seulement les nœuds qui seront modifiés, ceux-ci ne changeant pas d’identifiant, ni de référence, et la variable SCR.ARB_NodPosSor donnant l’identifiant du nœud de positionnement (par défaut le nœud courant).

Contexte en sortie :

La liste WfArbSor

SCR.ARB_NodPosSor

SCR.ARB_NodIdeSor (uniquement si SCR.ARB_ActCtxCons = « ACT »)

SCR.ARB_NodRefCre (uniquement si SCR.ARB_ActCtxCons = « ACT »)

7. Définition des actions

Les actions d’un arbre paramétré vont toutes être définies sur l’application de gestion des arbres, de la même manière que celles d’une liste paramétrée, via l’application de définition des actions.

Lors de la construction de l’arbre, il sera nécessaire de déterminer les actions qui doivent y être actives.

8. Exemple : Arbre simple statique

Ce premier exemple est le plus simple, il permet de définir un arbre, dont la structure est entièrement pré déterminé via l’application de définition de structure de l’arbre. Celle-ci est accessible depuis une action sur la définition des arbres.

Informations générales

Dans l’application de définition de l’arbre, accessible de puis l’explorateur « studio DIAPASON », l’onglet généralité va nous servir à renseigner les informations permettant d’identifier notre arbre dans l’explorateur et en action :

La désignation sera présente dans le(s) explorateur(s) lançant l’arbre :

Elle sera également présente dans le cas où l’arbre est lancé depuis une action paramétrée définie dans une application à cœur standard :

Le libellé court lui sera présent sur la barre de commande pour représenter cette action :

Voici le résultat que l’on obtiendra en paramétrant cet exemple, on retrouve bien le titre et l’icône définis sur l’application :

Démarrage

Les différents démarrages, et la récupération des critères du père vont être paramétrés sur l’onglet « démarrage », dans le cas de l’exemple, aucun critère n’est nécessaire au démarrage, cet arbre sera démarré depuis l’explorateur de « Gestion Commerciale » :

Le mode de démarrage est « Visualisation », cet exemple n’ayant pas d’action de gestion, il est à noter que comme aucun critère n’est nécessaire pour démarrer, les valeurs de « Typ. Ctx. App. » et « Typ Ctx Dia » sont « Pas de relation », c'est-à-dire que rien n’est récupéré sur le père.

Paramétrage du fonctionnement de l’arbre

Les onglets « définition » et « Interface » permettent de piloter le fonctionnement de l’arbre

Cet exemple est un arbre statique, c'est-à-dire que toute sa structure est définie via l’application de gestion des nœuds. Le mode de chargement utilisé est complet, la structure n’étant pas sensible à un changement, il est inutile de cocher le champs « Exe Règ. Reinit », on peut donc se passer de règle de construction. La référence origine de l’arbre est obligatoire à sa création, une fois saisie, elle est automatiquement reportée dans les données concernant la structure pré initialisée de l’arbre.

Au niveau interface, les nœuds de cet exemple étant bien identifiés, et chacun d’entre eux ayant déjà une icône, l’icône défaut n’est pas renseignée.

Actions

Aucune action n’est prévue sur cet exemple, ni de modification des données lors du démarrage, ni d’initialisation de données en sortie, l’onglet est donc vide.

Critères Conditions

Cet exemple n’ayant pas de règles de construction, cet onglet est vide.

Initialisation de la structure des noeuds

Pour obtenir l’arbre de cet exemple, il faut initialiser sa structure :

L’enregistrement concernant l’origine a été créé lors de la création de l’entête de l’arbre, il ne reste donc qu’à renseigner la désignation permet d’identifier le nœud dans cette application, le libellé sera celui du nœud, de même pour l’icône. Cet exemple n’ayant pas d’action, le champ Lst Action est vide.