STUDIO ENR-ACT-PTR

Définition

BUT

Cette fonction permet de maintenir les nomenclatures de pointeurs.

TYPE

Caractère.

SYNTAXE

Variable = ENR-ACT-PTR ( )

PARAMETRES

Aucun.

Structures utilisées

Liste standard : WfPtrAct (Actions à réaliser)

Liste standard : WfPtrActStr (Structure)

Liste standard : WfPtrActVar (Variables)

Liste standard : WfPtrActIT (Informations Techniques)

Liste standard : WfPtrActPR (Propriétés Techniques)

Liste standard : WfPtrCmpVar (Variables et IT différentes)

Actions possibles

ICL : Clé de lecture d’une nomenclature

• Infos Entrée Obligatoires : Clé Entité

• Infos Sortie : Clé utilisable par le ENR-ACT-PTR

• Structures Entrée : WfPtrAct (ActCle) + WfPtrActVar

• Structures Sortie : WfPtrAct (Ent* + ActRes + ActErr)

Exemple (WfPtrAct) :

Renvoie (WfPtrAct) :

Exemple (WfPtrAct) :

Renvoie (WfPtrAct) :

INP : Lecture des Variables d’un pointeur

Remarque : Il est possible de lire seulement une partie des variables du pointeur.

• Infos Entrée Obligatoires : Clé Pointeur (EntTEn + EntCl1 + EntCl2 + EntCl3)

• Infos Entrée Facultatives : Liste de variables (pour initialiser juste ces variables)

• Infos Sortie : Liste de variables locales / contextuelles avec leurs valeurs

• Structures Entrée : WfPtrAct (ActCle) + WfPtrActVar

• Structures Sortie : WfPtrAct (ActRes + ActErr) + WfPtrActVar

Exemple (WfPtrAct) :

Renvoie (WfPtrActVar) :

IIT : Lecture des Informations Techniques d’un Pointeur

• Infos Entrée Obligatoires : Clé Pointeur

• Infos Sortie : Liste des IT avec leurs valeurs

• Structures Entrée : WfPtrAct (ActCle)

• Structures Sortie : WfPtrAct (ActRes + ActErr) + WfPtrActIT

Exemple (WfPtrAct) :

Renvoie (WfPtrActIT) :

IPR : Lecture des Propriétés Techniques d’un Pointeur

• Infos Entrée Obligatoires : Clé Pointeur

• Infos Sortie : Liste des propriétés avec leurs valeurs

• Structures Entrée : WfPtrAct (ActCle)

• Structures Sortie : WfPtrAct (ActRes + ActErr) + WfPtrActPR

Exemple (WfPtrAct) :

Renvoie (WfPtrActPR) :

INI : Lecture des Informations Techniques, Variables et Propriétés d’un Pointeur

• Infos Entrée Obligatoires : Clé Pointeur

• Infos Entrée Facultatives : Liste de variables

• Infos Sortie : Liste de variables locales / contextuelles + Liste des IT avec leurs valeurs + Liste des Propriétés avec leurs valeurs

• Structures Entrée : WfPtrAct (ActCle) + WfPtrActVar

• Structures Sortie : WfPtrAct (ActRes + ActErr) + WfPtrActVar + WfPtrActIT + WfPtrActPR

Exemple (WfPtrAct + WfPtrActVar + WfPtrActIT + WfPtrActPr) :

INH : Lecture des Variables d’un Pointeur et de ses pères

Cette fonction recherche la valeur d’une variable en remontant vers les contextes supérieurs pour toutes les variables non locales au pointeur.

• Infos Entrée Obligatoires : Clé Pointeur

• Infos Entrée Facultatives : Liste de variables

• Infos Sortie : Liste de variables locales / contextuelles / contextuelles des pères

• Structures Entrée : WfPtrAct (ActCle) + WfPtrActVar

• Structures Sortie : WfPtrAct (ActRes + ActErr) + WfPtrActVar

Exemple (WfPtrAct + WfPtrActVar) :

INA : Lecture de l’arborescence d’un pointeur

• Infos Entrée Obligatoires : Clé Pointeur

• Infos Sortie : Nomenclature récursive du pointeur

• Structures Entrée : WfPtrAct (Cle)

• Structures Sortie : WfPtrAct (ActRes + ActErr) + WfPtrActStr

INA-C : Lecture de l’arborescence d’un pointeur multi-niveau

Identique à la fonction « INA », mais lit en multi-niveau : les nomenclatures des articles standard de dernier niveau sont intégrées à WfPtrActStr.

• Infos Entrée Obligatoires : Clé Pointeur

• Infos Sortie : Nomenclature récursive du pointeur

• Structures Entrée : WfPtrAct (Cle)

• Structures Sortie : WfPtrAct (ActRes + ActErr) + WfPtrActStr

MOD : Modification des Variables, des Informations Techniques et des Propriétés Techniques

Remarque : La règle d’enregistrement des informations est la suivante :

• si la variable VBA à initialiser fait partie de la liste des variables définie dans le paramètre général NOMPTR-VLO (par défaut les « ge- » et les « di- »), la variable est locale. Sinon, elle est considérée comme contextuelle. Si le contexte est le même que le père, un nouveau contexte est créé et propagé aux fils de même contexte.

• si la variable est une SNO ou une VNO, elle est locale.

Remarque : La modification des IT écrase toujours les IT existantes pour un même pointeur, malgré que la clé des IT (Type + Sous-Type + Code) ne soit pas unique. Pour modifier une IT, il faut d’abord lire toutes les IT (action IIT), puis en modifier la valeur dans WfPtrActIT.

• Infos Entrée Obligatoires : Clé Pointeur

• Infos Entrée Facultatives : Liste de variables et/ou Liste des IT et/ou liste des Propriétés

• Infos Sortie : Résultat

• Structures Entrée : WfPtrAct (Cle) + WfPtrActVar + WfPtrActIT + WfPreActPR

• Structures Sortie : WfPtrAct (ActRes + ActErr)

Exemple (WfPtrAct + WfPtrActVar) : Modification désignation

AJU : Création d’un pointeur situé avant un pointeur donné

Remarques :

Si la création aboutit, WfPtrAct.ActRes contient la référence du pointeur créé.

La duplication correspond à un Copier-Coller.

Il n’est pas possible d’affecter de variable durant la création d’un pointeur. Il faut nécessairement faire 2 opérations pour la création et la maintenance d’un pointeur.

• Infos Entrée Obligatoires : Clé Pointeur courant

• Infos Entrée Facultatives : Variables + IT + Propriétés + Code duplication + Clé duplication

• Infos Sortie : Résultat

• Structures Entrée : WfPtrAct + WfPtrActVar + WfPtrActIT + WfPreActPR

• Structures Sortie : WfPtrAct (ActRes + ActErr)

Exemple d’ajout « simple » (WfPtrAct + WfPtrActVar) : Le nouveau pointeur créé va être au-dessus du pointeur « 0000100003 ».

Exemple de copier-coller (WfPtrAct) : Le pointeur de référence « 0000100004 » va être copié, ainsi que toute son arborescence puis être « collé » au-dessus du pointeur « 0000100003 ».

Exemple de copier-coller (WfPtrAct) : Le pointeur de référence « 0000100004 » va être copié seul, puis être « collé » au-dessus du pointeur « 0000100003 ». De plus, sa désignation va être changée.

AJD : Création d’un pointeur situé après un pointeur donné

Remarques :

Si la création aboutit, WfPtrAct.ActRes contient la référence du pointeur créé.

La duplication correspond à un Copier-Coller.

Il n’est pas possible d’affecter de variable durant la création d’un pointeur. Il faut nécessairement faire 2 opérations pour la création et la maintenance d’un pointeur.

• Infos Entrée Obligatoires : Clé Pointeur courant

• Infos Entrée Facultatives : Variables + IT + Propriétés + Code duplication + Clé duplication

• Infos Sortie : Résultat

• Structures Entrée : WfPtrAct + WfPtrActVar + WfPtrActIT + WfPreActPR

• Structures Sortie : WfPtrAct (ActRes + ActErr)

AJI : Création d’un pointeur situé au niveau Inférieur

Remarques :

Si la création aboutit, WfPtrAct.ActRes contient la référence du pointeur créé.

La duplication correspond à un Copier-Coller.

Il n’est pas possible d’affecter de variables durant la création d’un pointeur. Il faut nécessairement faire 2 opérations pour la création et la maintenance d’un pointeur.

• Infos Entrée Obligatoires : Clé Pointeur courant

• Infos Entrée Facultatives : Variables + IT + Propriétés + Code duplication + Clé duplication

• Infos Sortie : Résultat

• Structures Entrée : WfPtrAct + WfPtrActVar + WfPtrActIT + WfPreActPR

• Structures Sortie : WfPtrAct (ActRes + ActErr)

AJP : Création premier pointeur d’une nomenclature

Remarques : Si la création aboutit, WfPtrAct.ActRes contient la référence du pointeur créé.

• Infos Entrée Obligatoires : Clé Pointeur courant

• Infos Entrée Facultatives : Variables + IT + Propriétés + Code duplication + Clé duplication

• Infos Sortie : Résultat

• Structures Entrée : WfPtrAct + WfPtrActVar + WfPtrActIT + WfPreActPR

• Structures Sortie : WfPtrAct (ActRes + ActErr)

Exemple de création de la nomenclature pour l’article standard 228 (WfPtrAct + WfPtrActVar) :

SUP : Suppression d’un pointeur et de son arborescence

• Infos Entrée Obligatoires : Clé Pointeur courant

• Infos Sortie : Résultat

• Structure Entrée-Sortie : WfPtrAct (ActRes + ActErr)

Exemple de suppression du pointeur « 0000100003 » et de sa nomenclature (WfPtrAct) :

Les IT et Propriétés liées au pointeur sont supprimées également.

SUL : Suppression d’un pointeur

Remarque : La suppression d’un pointeur rattache toute son arborescence de descendants à son pointeur père. La suppression du pointeur de plus haut niveau n’est pas autorisée.

• Infos Entrée Obligatoires : Clé Pointeur courant

• Infos Sortie : Résultat

• Structure Entrée-Sortie : WfPtrAct (ActRes + ActErr)

Exemple de suppression du pointeur « 0000100003 » (WfPtrAct) :

SUT : Suppression totale d’une nomenclature

• Infos Entrée Obligatoires : Clé Pointeur courant

• Infos Sortie : Résultat

• Structure Entrée-Sortie : WfPtrAct (ActRes + ActErr)

Exemple de suppression de la nomenclature de l’article standard 228 (WfPtrAct) :

SIT : Suppression des Informations Techniques d’un Pointeur

• Infos Entrée Obligatoires : Clé Pointeur courant

• Infos Sortie : Résultat

• Structures Entrée : WfPtrAct

• Structures Sortie : WfPtrAct (ActRes + ActErr)

SPR : Suppression des Propriétés Techniques d’un Pointeur

• Infos Entrée Obligatoires : Clé Pointeur courant

• Infos Sortie : Résultat

• Structures Entrée : WfPtrAct

• Structures Sortie : WfPtrAct (ActRes + ActErr)

DTR : Début d’une Transaction

Remarque : La notion de transaction permet de gérer l’intégrité de toutes les mises à jour effectuées entre le début transaction et la fin. Si le mot-clé LC-ERREUR est utilisé pendant une transaction, toutes les mises à jour sont annulées.

Marque le début une transaction pour les actions entre les actions DTR et FTR.

Exemple de Début de Transaction (WfPtrAct) :

FTR : Fin d’une Transaction

Marque la fin une transaction pour les actions entre les actions DTR et FTR.

Exemple de Fin de Transaction (WfPtrAct) :

CTX : Rechargement du contexte

Force un rechargement de contexte (lecture arborescence complète). Cette action n’est utile que si la nomenclature sur laquelle travaille la fonction a été modifiée par un autre traitement.

Exemple de rechargement de contexte pour l’article standard 228 (WfPtrAct) :

RPE : Recherche du père d’un pointeur

• Infos Entrée Obligatoires : Clé Pointeur

• Infos Sortie : Référence du Pointeur père

• Structures Entrée : WfPtrAct (ActCle)

• Structures Sortie : WfPtrAct (ActRes + ActErr)

Exemple (WfPtrAct) :

Renvoie (WfPtrAct) :

RFS : Recherche des fils d’un pointeur

• Infos Entrée Obligatoires : Clé Pointeur

• Infos Sortie : Liste chaînée des références de tous les descendants du Pointeur

• Structures Entrée : WfPtrAct (ActCle)

• Structures Sortie : WfPtrAct (ActRes + ActErr)

Exemple (WfPtrAct) :

Renvoie (WfPtrAct) :

CPE : Recherche du contexte du père

• Infos Entrée Obligatoires : Clé Pointeur

• Infos Sortie : Référence du Contexte du père

• Structures Entrée : WfPtrAct (ActCle)

• Structures Sortie : WfPtrAct (ActRes + ActErr)

Exemple (WfPtrAct) :

Renvoie (WfPtrAct) :

CPC : Recherche du contexte précédent

Renvoie le premier contexte récursivement au-dessus différent du contexte courant.

• Infos Entrée Obligatoires : Clé Pointeur

• Infos Sortie : Référence du Contexte précédent

• Structures Entrée : WfPtrAct (ActCle)

• Structures Sortie : WfPtrAct (ActRes + ActErr)

Exemple (WfPtrAct) :

Renvoie (WfPtrAct) :

CMP : Comparaison de 2 Nomenclatures

Renvoie la liste des différences entre deux nomenclatures de pointeurs. Ces nomenclatures peuvent être de types différents (article / ligne de commande). Il faut remplir les clés pour la première nomenclature (Ent*) et pour celle à comparer avec celle-ci (Cmp*). Les valeurs données pour EntTEn, EntCl1, EntCl2 et EntCl3 correspondent à :

• EntTEn : type de nomenclature (P ou LC)

• EntCl1 : référence article (si EntTEn = « P » ou au numéro de commande (si « LC »)

• EntCl2 : numéro de ligne de commande si EntTEn = « LC »

• EntCl3 : référence pointeur de départ de comparaison (facultatif).

Les valeurs données pour la deuxième nomenclature sont :

• CmpTEn : type de nomenclature (P ou LC)

• CmpCl1 : référence article (si EntTEn = « P » ou au numéro de commande (si « LC »)

• CmpCl2 : numéro de ligne de commande si EntTEn = « LC »

• CmpCl3 : référence pointeur de départ de comparaison (facultatif).

• Infos Entrée Obligatoires : Clé Pointeur 1, Clé Pointeur 2, Scénario de Comparaison

• Infos Sortie : Liste de variables locales / contextuelles + Liste des IT différentes avec leurs valeurs respectives + Liste des Propriétés différentes avec leurs valeurs respectives

• Structures Entrée : WfPtrAct

• Structures Sortie : WfPtrAct (ActRes + ActErr) + WfPtrCmpVar

Exemple (WfPtrAct) :

Renvoie (WfPtrAct + WfPtrCmpVar : voir structure) :

Exemple : comparaison de la nomenclature de l’article standard 228 et de celle de l’article standard 229 avec le scénario de comparaison SCE1 :

Remarque : la comparaison s’effectue sur la nomenclature complète (depuis le pointeur de plus haut niveau) puisque EntCl3 et CmpCl3 sont vides.

Nomenclature article 228 :

Nomenclature article 229 :

Renvoie WfPtrCmpVar dont le contenu est le suivant :

Cet enregistrement de WfPtrCmpVar signifie qu’un pointeur est présent uniquement dans la première nomenclature (donnée par les clés Ent*).

Exemple : comparaison de la nomenclature de l’article standard 228 et de celle de l’article standard 229 avec le scénario de comparaison SCE2 qui compare la quantité de lien :

Nomenclature article 228 :

Nomenclature article 229 :

Renvoie WfPtrCmpVar dont le contenu est le suivant :

Cet enregistrement de WfPtrCmpVar signifie que la variable VBA.ge-coef-emp a une valeur différente entre les deux nomenclatures : 1,5 dans la première nomenclature (donnée par les clés Ent*) et 2,5 dans la deuxième nomenclature (donnée par les clés Cmp*).

RAZ : Remise à zéro du moteur de nomenclature

Fonction particulière à n’utiliser que sur une nomenclature vide (après suppression de tous les pointeurs et avant une recréation intégrale de celle-ci). Cette action remet les compteurs de numéro de pointeur à 0 (chaque pointeur est renuméroté sur tout le niveau après une opération sur son niveau).

ENR-D : Création optimisée de plusieurs pointeurS

Fonction particulière à n’utiliser que quand on insère plusieurs pointeurs. Cette action recalcule les numéros de pointeur (chaque pointeur est renuméroté sur tout le niveau après une opération sur son niveau) en fin de création en masse de pointeurs. A utiliser en combinaison avec AJU-D, AJI-D et MOD-D remplaçant respectivement AJU, AJI et MOD ainsi que RPE-D et RFS-D remplaçant RPE et RFS.