Listes sur Entités
Principe
Une liste sur entité permet de maintenir une vue délimitée (liste conditionnée) sur une entité. Ce type de filtre a été créée afin d’optimiser les temps de réponses des conditions complexes qui peuvent être paramétrées sur les listes applicatives.
La liste sur entité représente donc un ensemble d’éléments d’une entité (éléments définis par les clés de l’entité sous la forme de 5 niveaux : Clé1 à 5) qui se trouvent à un certain stade de gestion. Pour chaque élément, il est possible de définir des clés de tris (5 niveaux de mots directeurs) et de gérer éventuellement un statut qui permet de filtrer le stade de gestion.
Les listes sur entités peuvent par la suite être utilisées afin de définir une liste applicative, une liste paramétrée ou encore une action applicative métier.
Maintenance des listes
Lors de toute action standard sur une entité, DIAPASON recherche toutes les listes sur l’entité définies en mise à jour interactive; pour chacune d’entre elle, il exécute la requête REB libellée «Règle de mise à jour » qui permet d’indiquer à DIAPASON si la clé de l’entité courante doit faire partie ou non de la liste sur entité.
➡️ Contexte d’entrée :
SCR.LEN_Mode = ‘E’ pour mise à jour élémentaire
SCR.LEN_EntRef = Référence Entité GFD courante
SCR.LEN_Action = ‘CRE,DUP,MOD,REA,SUP,MOG*’
SCR.EntTEN = Entité GFD courante
SCR.EntCl1 à 5 = Clés d’identification de l’enregistrement courant
SCR.LEN_LisRef = référence liste sur entité à maintenir
Valeurs défauts des variables critères définies sur la liste sur entité
➡️ Contexte de sortie :
SCR.LEN_OK : Indique si mise à jour possible ou non (valeurs + ou -); si non et que la clé existe sur la liste, celle-ci est supprimée.
SCR.LEN_Statut : Valeur du statut de la clé (si gestion de statut sur la liste)
SCR.LEN_MDi1 à 5 : Mots directeurs rattachés à la clé (pour clé de tri) .
•Les listes sur entités non définies en mise à jour interactive peuvent être constituées par un traitement (à la demande ou répétitif). Ce traitement peut être exécuté sur les listes sur entités interactives. La requête REB libellée «Règle de mise à jour » est exécutée une seule fois; son contexte d’exécution est le suivant:
Contexte d’entrée :
SCR.LEN_Mode = ‘G’ pour mise à jour globale du contenu de la liste.
SCR.LEN_EntRef = Référence Entité GFD.
SCR.LEN_LisRef = référence liste sur entité à maintenir
Valeurs défauts des variables critères définies sur la liste sur entité
Contexte de sortie : la liste WfEntSel contient les clés de l’entité à rattacher à la liste :
WfEntSel.EntCl1 à 5 : clé de l’entité à rattacher à la liste
WfEntSel.Com : valeur du statut (si gestion par statut sur la liste).
SCR.LEN_MDi1 à 5 : Clés d’identification de l’enregistrement.
La fonction DIALOG ACT_LISTE-ENTITE permet de maintenir une clé d’entité sur une liste sur entité données en paramètre. Cette fonction DIALOG est visible dans tous les types de requêtes et permet de maintenir toutes les listes sur entités. La règle REB rattachée à la liste sur entité n’est pas exécutée (évolution à venir).
Si l’entité est de type « ligne » (ligne de commande, OF, etc.), les listes sur entités de l’entité père sont également maintenues via la règle REB correspondante avec le contexte suivant :
➡️ Contexte d’entrée :
SCR.LEN_Mode = ‘E’ pour mise à jour élémentaire
SCR.LEN_EntRef = Référence Entité GFD père suivie de ‘-LIG’
SCR.LEN_Action = ‘CRE,DUP,MOD,REA,SUP,MOG*’
SCR.EntTEN = Entité GFD courante
SCR.EntCl1 à 5 = Clés d’identification de l’enregistrement courant
SCR.LEN_LisRef = référence liste sur entité à maintenir
Valeurs défauts des variables critères définies sur la liste sur entité
Maintenance des statuts
La notion de statut permet de définir un stade intermédiaire de gestion (intérêt : filtre d’affichage indexé).
Le passage d’un statut à un autre peut être piloté par la requête REB de la règle de mise à jour ou par la fonction DIALOG ACT_LISTE-ENTITE.
Lors d’un affichage d’une liste sur entité via une LPA, LAP ou AME, pour un statut donné, deux possibilités de filtre :
La requête de génération de liens génériques de navigation donne le statut à afficher; sur chaque lien généré, la valeur du statut doit être renseignée dans le critère de la liste WFEAPLiG.Criteres sous la forme SCR.LEN_Statut,ValeurStatut;…
La requête REB de démarrage donne le statut à filtrer en initialisant la variable SCR.LEN_Statut.
Si cette variable critère contextuelle n’est pas renseignée, il n’y a pas de filtre d’affichage sur le statut : tous les éléments de la liste sur entité sont affichés, tout statut confondu.
Définition des Listes sur Entités
Onglet définition
Liste
Référence liste, identifiant unique.
Désignation
Descriptif de la liste sur entité
Mot Directeur
Information complémentaire pouvant être utilisée dans les fonctions de recherche, de filtre ou de tri.
Domaine
Référence domaine applicatif associé à la liste sur entité.
Famille
Référence famille d’objet. Zone facultative utilisée lors de l’extraction des libellés à traduire.
Sous-famille
Référence sous-famille d’objet. Zone facultative utilisée lors de l’extraction des libellés à traduire.
Commentaire
Information complémentaire. Texte libre.
Onglet Général
Mise à jour Interactive
Drapeau indiquant à DIAPASON si la maintenance de la liste sur entité doit être maintenue à chaque action de gestion (création, duplication, modification, suppression …) opérée sur la table relative à l’entité rattachée. Dans le cas où la valeur est Faux, la mise à jour du contenu de la liste devra être lancée manuellement par l’utilisateur à partir de l’action « Mise à Jour Contenu ».
Gestion Statuts
Drapeau indiquant si la gestion des statuts est activée sur la liste sur entité. L’utilisateur peut en effet définir ses propres statuts de façon à organiser les enregistrements en fonction de ses critères. Une application permet de définir les statuts (décrite ci-après).
Statut Défaut
Référence statut correspond à l’état par défaut d’un enregistrement dans la liste sur entité.
Règle de Mise à Jour
Requête de type REB dont le but est de pouvoir appliquer des règles particulières à la maintenance de la liste (filtrage des créations, affectation statut …).
Contexte d’exécution :
En entrée :
SCR.LEN_Mode = ‘E’ pour mise à jour élémentaire ou ‘G’ pour mise à jour globale du contenu de la liste.
SCR.LEN_EntRef = Référence Entité GFD courante
SCR.LEN_Action = ‘CRE,DUP,MOD,REA,SUP,MOG*’
SCR.EntTEN = Entité GFD courante
SCR.EntCl1 à 5 = Clés d’identification de l’enregistrement courant
SCR.LEN_LisRef = référence liste sur entité à maintenir
SCR.LEN_OK : Indique si mise à jour possible ou non. valeur défaut en entrée Faux. (‘-‘).
SCR,VCR* définis sur la liste sur entité
En sortie
SCR.LEN_OK : Indique si mise à jour possible ou non (valeurs + ou -)
SCR.LEN_Statut : Valeur du statut de l’enregistrement
SCR.LEN_MDi1 à 5 : Clés d’identification de l’enregistrement.
Critères Défaut
Bouton permettant d’initialiser les variables critères de la règle de mise à jour.
Contenu OK
Drapeau indiquant que l‘action de mise à jour du contenu de la liste s’est bien déroulé.
Date Mise à Jour
Date de dernière mise à jour du contenu de la liste.
Heure Mise à Jour
Heure de dernière mise à jour du contenu de la liste
Uti. Mise à Jour
Référence utilisateur à l’origine de la dernière mise à jour du contenu de la liste.
Sur cette application, les actions possibles sont :
Actions standards de la GFG : Création, Modification, Duplication, Suppression …
Mise à Jour Contenu … Listes Sélectionnées
Permet de mettre à jour le contenu des listes sur entités sélectionnées en exécutant la règle de mise à jour.
Mise à Jour Contenu … Listes à Problèmes
Permet de mettre à jour le contenu des listes sur entités sur lesquelles il y a un problème en exécutant la règle de mise à jour.
Mise à Jour Contenu … Listes à Supprimer
Permet de supprimer physiquement les listes sur entités supprimées logiquement. Le contenu des listes est également supprimé.
Mise à Jour Contenu … Toutes les Listes
Permet de mettre à jour le contenu de toutes les listes sur entités en exécutant la règle de mise à jour.
Visualisation Contenu
Permet de consulter le contenu de la liste sur entité courante.
Description de la liste :
Clé 1
Clé 1 de l’entité
Clé 2
Clé 2 de l’entité. Affiché uniquement si l’entité a au moins 2 clés
Clé 3
Clé 3 de l’entité. Affiché uniquement si l’entité a au moins 3 clés
Clé 4
Clé 4 de l’entité. Affiché uniquement si l’entité a au moins 4 clés
Clé 5
Clé 5 de l’entité. Affiché uniquement si l’entité a 5 clés
Mot Directeur 1
Mot directeur affecté à l’entité dans la règle de mise à jour en utilisant la variable SCR.LEN_MDi1.
Mot Directeur 2
Mot directeur affecté à l’entité dans la règle de mise à jour en utilisant la variable SCR.LEN_Mdi2.
Mot Directeur 3
Mot directeur affecté à l’entité dans la règle de mise à jour en utilisant la variable SCR.LEN_Mdi3.
Mot Directeur 4
Mot directeur affecté à l’entité dans la règle de mise à jour en utilisant la variable SCR.LEN_Mdi4.
Mot Directeur 5
Mot directeur affecté à l’entité dans la règle de mise à jour en utilisant la variable SCR.LEN_Mdi5.
Statut
Statut affecté à l’entité dans la règle de mise à jour en utilisant la variable SCR.LEN_Statut.
Gestion des Statuts
Il est possible de définir des statuts pour le suivi des enregistrements dans les listes sur entité.
La définition des statuts est disponible depuis l’explorateur applicatif ‘DIALOG’, branche ‘Paramétrage Work-Flow’, application ‘Statuts’.
Un statut est défini tel que :
Onglet « Définition »
Statut
Référence statut géré.
Désignation
Descriptif associé au statut défini.
Mot Directeur
Information complémentaire pouvant servir de clé de recherche, de filtre ou de tri.
Commentaire
Information complémentaire. Texte libre.
Cette application a pour but de maintenir une bibliothèque de statuts dont la gestion est libre et entièrement gérée par l’utilisateur via DIALOG (Règles de mise à jour, Règles de génération de liens génériques ).
Mise à Jour des Listes sur Entités
Depuis les applications GFDs
Les listes sur entités reposent sur la notion d’entité GFD de DIAPASON, aussi chaque application GFD peut maintenir de façon interactive chacune des listes sur entité définie dans DIAPASON pour l’entité courante. Il suffit pour cela que les listes sur entités soient paramétrées avec le drapeau ‘Mise à jour Interactive’ positionné à la valeur Vraie. Dans ce cas la règle de mise à jour associée est exécutée et renvoie comme résultat ‘OK’ ou ‘NOK’. Si le résultat est OK, l’enregistrement sera ajouté au contenu de la liste sur entité correspondante. Toutes les listes sur entités définies sur l’entité courante sont maintenues ainsi.
Depuis la Gestion des Listes sur Entités
Le contenu des listes sur entités peut être mis à jour par différentes actions disponibles sur l’application de définition des listes sur entités.