Définition de la requête REB de mise à jour des enregistrements hiérarchiques

Cette requête (REB) est exécutée sur un enregistrement hiérarchique lorsque celui-ci est modifié ou lorsqu’un de ses fils direct ou indirect est modifié.

Il existe différentes fonctions afin d’intervenir sur les éléments de la hiérarchie.

HIE-LEC-CTX

Cette fonction permet d’accéder en lecture sur une caractéristique du nœud. Elle prendra comme paramètres les variables suivantes :

• NŒUD : nœud sur lequel on effectue la lecture

• TYPE : type de la donnée lue (caractère, logique, numérique, date)

• NOM-VARIABLE : nom de la variable consultée. Diapason propose la liste des attributs de l’enregistrement hiérarchique mais il est aussi possible de lire la valeur d’une colonne. Pour cela, on entrera dans ce paramètre la référence de la colonne.

• VALEUR : résultat de la recherche

La fonction HIE-LEC-CTX donne accès aux informations suivantes :

• De type caractère :

  • NodRef : référence du nœud (renseigné dans WfArbSor)

  • NodRefPere : référence du nœud père. (renseigné dans WfArbSor)

  • NodLib : Libellé du nœud

  • NodIco : Icône ouvert du nœud

  • NodIcoFer : Icône fermé du noeud

  • NodLisSty : apparence du nœud

  • NodCl1-2-3 : clés du nœud

  • NodVa1-2-3-4-5 valeurs alphanumériques

• De type numérique :

  • NodNOr : numéro d’ordre (renseigné dans WfArbSor)

  • NodNu1-2-3-4-5 : valeurs numériques

• De type date :

  • NodDa1-2-3-4-5 : valeurs dates

• De type logique :

  • NodDNi : indique si on est sur un nœud de dernier niveau

  • NodOuv : indique si le nœud est ouvert

  • NodLo1-2-3-4-5 : valeurs logiques.

HIE-INI-CTX

Cette fonction permet de modifier le contenu ou un attribut de l’enregistrement hiérarchique. On retrouvera en entrée les paramètres suivants :

• NŒUD : nœud sur lequel on effectue l’écriture

• TYPE : type de la donnée que l’on va modifier

• NOM-VARIABLE : nom de la variable modifiée. Diapason propose la liste des attributs de l’enregistrement hiérarchique mais il est aussi possible de modifier la valeur d’une colonne. Pour cela, on entrera dans ce paramètre la référence de la colonne.

• VALEUR : valeur que l’on donne.

PARCOURS TABLEUR POUR HIERARCHIE DES LIGNES LIEES 

Cette instruction permet de parcourir tous les enregistrements du tableur dynamique lié à un nœud. Elle prendra les paramètres suivants :

• NŒUD : référence du nœud sur lequel on effectue la recherche.

• LIGNE-PARCOURUE : ligne que l’on est entrain de parcourir.

• ERREUR : code erreur du parcours

PARCOURS ARBRE HIERARCHIQUE

• DES ENFANTS DIRECTS DU NŒUD : Cette instruction permet de parcourir tous les enregistrements de la hiérarchie qui sont des fils directs d’un nœud.

• DES ENFANTS DU NŒUD : Cette instruction permet de parcourir tous les enregistrements de la hiérarchie qui sont des fils directs ou indirects d’un nœud.

• DU NŒUD : Cette instruction positionne sur le nœud courant.

• DU PERE DU NŒUD : Cette instruction permet de retrouver le père d’un nœud.

On trouvera les paramètres suivants en entrée :

• NŒUD : référence du nœud sur lequel on effectue la recherche.

• NOEUD-PARCOURU : référence du nœud que l’on est entrain de parcourir.

• ERREUR= code erreur du parcours