Listes de Valeurs associées à des règles « RCT » - type [3]
En utilisant ces listes de valeurs, on pourra proposer des choix dynamiques à l’utilisateur, en fonction de la situation. On peut les utiliser pour réaliser le contrôle et l’aide sur des cellules de tableur dynamique, des champs de PSD, ou des critères (Tableurs, Documents, etc.).
Comment créer une liste de valeurs type “RCT” ?
Etape 1: On créé la liste de valeurs
La création des listes de valeur de type « RCT » est identique à celle des listes de valeurs manuelles, mais en choisissant le type « 3 » et en renseignant la règle correspondante:
On ne saisit pas le contenu d’une Liste de Valeurs RCT.
Etape 2 : On définit la requête
Les valeurs possibles sont dépendantes de la requête de type « RCT » renseignée sur la LVA. Les règles de type RCT des Tableurs Dynamiques peuvent convenir, mais certaines contraintes en réduisent le champ d’action :
Les valeurs des autres zones ne sont pas visibles.
Les valeurs des autres zones ne sont pas initialisables. L’utilisation du mot clé INIT-ZONE est donc sans effet.
La référence liste d’aide à utiliser est la référence de la variable courante (visible dans SCR.RCT_RefCol).
La valeur de la zone en cours (variable spécifique d’une GFD par exemple) est récupérée par l’utilisation du mot clé RECH-ZONE (Ligne-En-Cours et Colonne-En-Cours).
L’action menée est disponible dans la variable SCR.RCT_TypeAction et peut prendre les valeurs :
« CRE » création
« MOD » modification
« AID » sélection.
Complément sur les Listes d’Aide
Liste d’aide simple
1ère étape : CRE-SELINF suivi de plusieurs initialisations de variables comme :
INIT SDH LisInfinf qui se rapporte à la référence de la première colonne de la liste constituant l’aide (obligatoire).
INIT SDH LisInfRef qui correspond à la référence de la liste d’aide (obligatoire)
INIT SDH LisInfDes qui peut contenir d’autres informations relatives à l’entité (facultative).
2ème étape : INIT-LISTE-AIDE « Référence de l’aide » indique la référence de la liste d’aide.
PURGE-SELINF avec la référence de la liste. Cette instruction supprime la liste et permet d’éviter de se retrouver avec une liste d’aide contenant plusieurs fois les mêmes informations si la fonction d’aide est appelée plusieurs fois. Cette instruction doit être positionnée avant la création de la liste.
VLO.RefListAid = SCR.RCT_RefCol
PURGE-SELINF VLO.RefListAid
POUR CHAQUE ARTICLE :
CRE-SELINF :
INIT SDH.LisInfRef = VLO.RefListAid
INIT SDH.LisInfInf = SAS.GenRefArt
INIT SDH.LisInfDes = SAS.GenDesArt
FIN_BLOC
FIN_BLOC
INIT-LISTE-AIDE VLO.RefListAid
Liste d’aide simple avec colonnes supplémentaires
Pour avoir un affichage différent dans une liste d’aide, il faut indiquer en plus les valeurs à afficher dans SDH.LisInfCom, puis utiliser les instructions présentées dans les points suivants :
VLO.RefListAid = SCR.RCT_RefCol
PURGE-SELINF VLO.RefListAid
POUR CHAQUE ARTICLE :
CRE-SELINF :
INIT SDH.LisInfRef = VLO.RefListAid
INIT SDH.LisInfInf = SAS.GenRefArt
INIT SDH.LisInfDes = SAS.GenDesArt
INIT SDH.LisInfCom = SAS.GenMDiArt + CLO.“#“ + SAS.GenDeCArt
FIN_BLOC
FIN_BLOC
INIT-LISTE-AIDE VLO.RefListAid
La variable SDH.LisInfCom doit contenir la liste des valeurs souhaitées à l’affichage en dehors de SDH.LisInfInf et SDH.LisInfDes, séparées par un séparateur paramétrable (par défaut, il s’agit du caractère #).
Les différentes possibilités d’alimentation de la liste d’aide sont décrites ci-dessous et pilotées par des « CRE-SELINF » avec :
SDH.LisInfRef = VLO.RefListAid + CLO."*STRUCTURE"
SDH.LisInfInf = un code indiquant l’action souhaitée (voir tableau à la fin de ce chapitre)
SDH.LisInfDes = une suite d’informations séparée par défaut par des « # »
L’exemple de base est une liste de nombres, avec pour chacun une colonne qui indique si le nombre est premier. Les valeurs de la liste d’aide de base sont décrites dans le tableau ci-dessous.
LisInfInf | LisInfDes | LisInfCom |
01 | Un | 1#+ |
02 | Deux | 2#+ |
03 | Trois | 3#+ |
04 | Quatre | 4#- |
05 | Cinq | 5#+ |
06 | Six | 6#- |
07 | Sept | 7#+ |
08 | Huit | 8#- |
09 | Neuf | 9#- |
10 | Dix | 10#- |
Ajouter ou enlever des colonnes dans une liste d’aide simple
Les colonnes par défaut sont « Référence », « Désignation » et éventuellement « Commentaire », « Valide », « Icône » ou « Image ». Le paramétrage permet d’ajouter ou d’enlever des colonnes. Pour cela, il faut renseigner dans la requête des lignes tels que sur l’exemple ci-dessous :
CRE-SELINF :
INIT SDH.LisInfRef = VLO.RefListAid + CLO."*STRUCTURE"
INIT SDH.LisInfInf = CLO."COLAFFICHE"
INIT SDH.LisInfDes = CLO."1#R#2"
FIN_BLOC
Dans cet exemple, la liste d’aide sera composée d’une colonne nommée « COL-1 », puis de la colonne « Référence » et enfin une autre colonne « COL-2 ». Les noms de colonne doivent correspondre à l’indice de la valeur dans la SDH.LisInfCom (dans la liste d’aide d’origine), à part les cas suivants :
« R » qui symbolise la colonne « Référence »
« D » la colonne « Désignation »
« V » la colonne « Valide ». L’affichage de la colonne « Valide » va afficher les lignes supprimées (Valide = 1) en rouge barré.
Le contenu des colonnes est piloté dans la liste d’aide d’origine par SDH.LisInfCom qui doit contenir les valeurs des colonnes séparées par le séparateur choisi (« # » par défaut).
Pilotage des titres de colonnes d’une liste d’aide simple
Les titres de colonne par défaut sont « Référence », « Désignation » et éventuellement « Commentaire », « Valide », « Icône » ou « Image ». Le paramétrage permet de modifier ces titres. Vous devez renseigner dans la requête des lignes tels que sur l’exemple ci-dessous :
CRE-SELINF :
INIT SDH.LisInfRef = VLO.RefListAid + CLO."*STRUCTURE"
INIT SDH.LisInfInf = CLO."TITRES"
INIT SDH.LisInfDes = CLO."Nombre#Premier"
FIN_BLOC
Dans cet exemple, les titres de colonnes seront « Nombre » pour la première et « Premier » pour la seconde.
Pilotage des types de colonnes dans une liste d’aide simple
Les colonnes sont par défaut de type « Caractère ». Le paramétrage permet de choisir un type différent : ceci est utile pour appliquer des tris ou des filtres à ces colonnes. Vous devez renseigner dans la requête des lignes tels que sur l’exemple ci-dessous :
CRE-SELINF :
INIT SDH.LisInfRef = VLO.RefListAid + CLO."*STRUCTURE"
INIT SDH.LisInfInf = CLO."TYPES"
INIT SDH.LisInfDes = CLO."E#L"
FIN_BLOC
Dans cet exemple, la première colonne sera de type numérique et la seconde de type logique. Les types possibles sont les types DIAPASON : A, E, R, D ou L.
Pilotage des formats de colonnes dans une liste d’aide simple
Les formats de colonne par défaut sont « C/25 » pour la colonne « Référence », « C/50 » pour la colonne « Désignation » et éventuellement « C/100 » pour la colonne « Commentaire ». Le paramétrage permet de modifier ces formats. Vous devez renseigner dans la requête des lignes tels que sur l’exemple ci-dessous :
CRE-SELINF :
INIT SDH.LisInfRef = VLO.RefListAid + CLO."*STRUCTURE"
INIT SDH.LisInfInf = CLO."FORMATS"
INIT SDH.LisInfDes = CLO."E/2#"
FIN_BLOC
Dans ce exemple, les formats seront de 2 entiers pour la première colonne (doit être de type « entier ») et de 25 caractères pour la seconde.
Ajouter des colonnes « filtrables » dans une liste d’aide simple
Les colonnes ajoutées ne sont ni filtrables ni triables par défaut. Le paramétrage permet de rajouter jusqu’à 5 colonnes de type caractère pouvant bénéficier des filtres et tris. Pour cela, renseigner dans la requête des lignes les numéros des colonnes à filtrer tels que sur l’exemple ci-dessous :
CRE-SELINF :
INIT SDH.LisInfRef = VLO.RefListAid + CLO."*STRUCTURE"
INIT SDH.LisInfInf = CLO."FILTRES"
INIT SDH.LisInfDes = CLO."2#3"
FIN_BLOC
Dans cet exemple, les colonnes numéro 2 et 3 disposeront des fonctions de filtre et tri disponibles sur les listes.
Remarque : Cette fonctionnalité concerne uniquement les colonnes ajoutées, la fonctionnalité standard est déjà effective dans les colonnes standards. En conséquence, la numérotation pour cette fonction commence à la première colonne ajoutée, qui aura le numéro « 1 ».
Changer le séparateur des valeurs dans une liste d’aide simple
Le séparateur par défaut des valeurs est « # ». Ceci implique que les colonnes affichées ne doivent pas contenir ce caractère. Le paramétrage permet de le modifier. Il faut renseigner dans la requête des lignes tels que sur l’exemple ci-dessous :
CRE-SELINF :
INIT SDH.LisInfRef = VLO.RefListAid + CLO."*STRUCTURE"
INIT SDH.LisInfInf = CLO."SEPARATEUR"
INIT SDH.LisInfDes = CLO."%"
FIN_BLOC
Dans cet exemple, le séparateur des valeurs des colonnes sera « % ». Attention, le séparateur est aussi modifié pour les listes de formats, de types, etc.
Rappel des cas possibles pour une liste d’aide simple
Action | LisInfInf | LisInfDes |
Modification du séparateur « défaut » pour le « LisInfCom » | SEPARATEUR | Valeur du séparateur. Par défaut, la valeur est « # ». |
Affichage de colonnes différentes | COLAFFICHE | Liste chaînée des références de colonnes, séparées par le séparateur défini. Cas spéciaux : « R » (référence), « D » (désignation), « V » (validité de l’enregistrement), « IM » (image : LisInfIma) ou « IC » (icône : LisInfIco). |
Modification des titres des colonnes | TITRES | Liste chaînée des titres de colonnes, séparés par le séparateur défini. |
Modification des types des colonnes | TYPES | Liste chaînée des types de colonnes, séparés par le séparateur défini. |
Modification des formats des colonnes | FORMATS | Liste chaînée des formats de colonnes, séparés par le séparateur défini. |
Utilisation de colonnes pouvant être filtrées | FILTRES | Liste chaînée des références des colonnes (de type caractère, 5 au maximum) devant être filtrées, séparées par le séparateur défini. |
Remarque sur les listes d’aide
Les listes d’aide, comme toutes les listes de DIAPASON, bénéficient d’un enregistrement des paramètres de colonnes (couleur, position, etc.). En cas de modification de la liste d’aide par une des fonctions ci-dessus, si le résultat n’est pas visible à l’écran, il faut venir choisir le rechargement des colonnes par l’option sur la copie d’écran ci-dessous :
