Skip to main content
Skip table of contents

Tableurs dynamiques- Requête REB de type RTD


Cette requête REB de sous-type RTD permet de définir l’allure générale et le contenu du tableur. Pour cela, il est nécessaire de constituer trois listes pour créer un Tableur Dynamique :

  • « personnelle »,

  • WfTabGen,

  • WfTabStr.

A ce titre une REB est classée en tant que sous-type RTD si elle utilise la liste WfTabStr ou WfTabGen.

La première liste dite « personnelle » renfermera le contenu du tableur, la deuxième WfTabGen donne le comportement général du tableur, et la troisième, WfTabStr renvoie à la structure des colonnes.

Remarque : la notion de pré-initialisation de Tableur Dynamique permet de définir des tableurs simples avec dans la requête REB/RTD :

  • Rien : affiche un tableur avec n lignes vides. « n » est défini sur le tableur lui-même.

  • La liste personnelle seulement : affiche un tableur avec n lignes remplies d’informations. « n » est le nombre d’éléments dans la liste personnelle.

  • La liste personnelle et WfTabGen seulement : affiche un tableur avec n lignes remplies d’informations. « n » est le nombre d’éléments dans la liste personnelle. WfTabGen est ainsi personnalisable en fonction de critères saisis.

Remarque : Pour une liste personnelle devant contenir beaucoup d’enregistrements (à partir de 500 ou 1000), il est conseillé de référencer cette liste en tant que « Liste Optimisée » (TT) dans la définition de la liste.

Prenons le cas d’une table de valeurs « TabFour » constituée des champs Référence Fournisseur (RefFour), Famille Fournisseur (FamFour), Remise Fournisseur (RemFour) et Désignation Fournisseur (DesFour).

Contexte disponible dans la requête REB/RTD

  • Liste WfTabGen si tableur pré-initialisé

  • Liste WfTabStr si colonnes pré-initialisées

  • Variables et WfTabValPere du tableur dynamique lanceur selon le paramétrage

Liste personnelle dans la requête REB/RTD

Dans la requête REB/RTD, la première liste « Fournisseur » est basée sur le contenu de la table de valeurs « TabFour » ainsi que la table des fournisseurs « APFour » :

Remarque : Il est possible de piloter la couleur de fond ainsi que la couleur et les attributs du texte de chaque ligne du tableur lors de son premier affichage. Pour cela, la liste personnelle doit contenir un champ dont le nom est « LIS_LigAtt », et qui doit être rempli avec la syntaxe suivante :

PRENDRE Fournisseur LIS_LigAtt = CLO."LIG-BG=15;LIG-FG=VERT;LIG-AT=GRA"

Dans cet exemple, sur la ligne, on obtient une couleur de fond 15=marron02, et un texte vert et gras.

  • Syntaxe pour couleur du fond de la ligne : LIG-BG: Si le paramètre passé dans le champ LIS_LigAtt contient « LIG-BG= » suivi d’un code couleur, la couleur est appliquée à la ligne. Le code couleur doit faire partie de la liste suivante :

    • ROUGE

    • VERT

    • BLEU

    • MAUVE

    • JAUNE

    • ROSE

    • ORANGE

    • Un numéro de couleur DIAPASON (les couleurs sont visibles dans le « A propos de DIAPASON »)

    • Vide ou *DFT : couleur de fond normale (blanc)

  • Syntaxe pour couleur du texte de la ligne : LIG-FG. Si le paramètre passé dans le champ LIS_LigAtt contient « LIG-FG= » suivi d’un code couleur, la couleur est appliquée à la ligne. Le code couleur doit faire partie de la liste suivante :

    • ROUGE

    • VERT

    • BLEU

    • MAUVE

    • JAUNE

    • ROSE

    • ORANGE

    • Un numéro de couleur DIAPASON (les couleurs sont visibles dans le « A propos de DIAPASON »)

    • Vide ou *DFT : couleur de texte normale (noir).

  • Syntaxe pour les attributs du texte de la ligne : LIG-AT

    • Si le paramètre passé dans le champ LIS_LigAtt contient « LIG-AT= » suivi d’un code attribut, cet attribut est appliqué à la ligne. Le code attribut doit faire partie de la liste suivante :

    • GRA : gras

    • ITA : italique

    • BAR : barré

    • SOU : souligné

    • Vide ou *DFT : texte normal.

  • Syntaxe pour piloter les attributs avec une apparence : LIG-APP. Si le paramètre passé dans le champ LIS_LigAtt contient « LIG-APPT= » suivi d’un code apparence, cette apparence est appliquée à la ligne. L’apparence donnée doit être de type liste :

Liste WfTabGen dans la requête REB/RTD

Après avoir renseigné les éléments de la liste « personnelle », il est nécessaire de compléter la deuxième liste « WfTabGen » qui décrit les modes de gestion du tableur.

Les variables disponibles concernant cette deuxième liste sont les suivantes :

Champ

Type

Description

RefListe

Caractère

Référence de la liste « personnelle » à traiter. Cette liste sert au chargement initial des informations du tableur 

PreTit

Caractère

Titre de la fenêtre du tableur .

NB : Pour les tableurs dynamiques utilisés dans les procédures de stocks, cette information aura pour but d’affecter le titre de la procédure en saisie, si elle n’est pas définie le titre sera la désignation de la procédure de stock

PreCol

Caractère

Permet de désigner la (ou les) référence(s) de colonnes figée(s) (correspond au contenu de « NomCol » de la liste WfTabStr). Une colonne figée est une colonne qui reste à l’extrême gauche du tableur quelque soit le déplacement horizontal dans la fenêtre. Cette colonne est ainsi toujours visible. Si plusieurs références de colonne sont renseignées, la colonne figée contiendra le résultat d’une concaténation du contenu de ces colonnes 

CleCol

Caractère

Référence de la colonne qui servira de clé. Cette clé pourra servir à repérer des lignes

DebCol

Caractère

Référence de la colonne de positionnement au démarrage du tableur. Si non renseigné, le curseur sera sur la première colonne saisissable. Si la colonne renseignée correspond à la première colonne du tableur et qu'elle n'est pas affichée, le curseur se positionne sur la 1ère colonne du tableur. Cette valeur n’est prise en compte que si GesNum est égal à OUI.

RAcCol

Caractère

Liste des références des actions à ajouter sur chaque colonne (voir chapitre correspondant).

LAcCol

Caractère

Liste des libellés des actions à ajouter sur chaque colonne

DebLig

Numérique

Numéro de la ligne de positionnement au démarrage du tableur. Si non renseigné, le curseur sera sur la première ligne. Cette valeur n’est prise en compte que si GesNum est égal à OUI.

ActCre

Logique

Création de lignes disponible ?

ReqCre

Logique

Requête de contrôle local à exécuter après création de la ligne ?

ActMod

Logique

Modification disponible ?

ReqMod

Logique

Requête de contrôle local à exécuter si modification de la zone ? Dans ce cas, dès que l’utilisateur quitte la zone de quelque manière que ce soit, la requête s’exécute. (Dans le cas contraire, la requête de contrôle sera exécutée à chaque sortie de ligne.)

ActSup

Logique

Suppression de ligne disponible ?

ReqSup

Logique

Requête de contrôle local à exécuter après suppression de la ligne ?

GesNum

Logique

Gestion de la numérotation des lignes du tableur ? Permet également d’utiliser la fonction TAB-ACTION si initialisé à OUI

DebVueCol

Caractère

Référence de la colonne démarrant la vue (affichée en première colonne lors de l’accès au tableur).

DebVueLig

Numérique

Numérode ligne démarrant la vue (affichée en première ligne lors de l’accès au tableur)

L’écran présenté ci-dessous montre les différents champs de la liste WfTabGen initialisés. Les instructions précisent que l’utilisateur aura la possibilité de créer, supprimer, modifier les valeurs du Tableur Dynamique puisque les variables autorisant la création ou la modification ou la suppression ont la constante globale (CGL) initialisée à OUI. Le fait que « GesNum » soit également initialisé à OUI permettra d’utiliser la fonction TAB-ACTION. A l’entrée du tableur, le curseur sera sur la colonne « RemFour » de la ligne 2. 3 actions seront disponibles sur toutes les colonnes : « vider la cellule », « vider la ligne », « vider la colonne ».

Liste WfTabStr dans la requête REB/RTD

Après avoir défini le comportement général du tableur, l’utilisateur doit indiquer dans cette requête le comportement souhaité pour chaque colonne en utilisant la liste « WfTabStr ».

Celle-ci se compose des champs suivants :

Champ

Type

Description

NomCol

Caractère

Référence de la colonne; elle doit être égale à la référence d’un champ de la liste personnelle 

LibCol

Caractère

Libellé de la colonne (titre)

ForCol

Caractère

Format de la zone de saisie de la colonne

L+/- pour logique ;

D/JJ/MM/AAAA pour date ;

C/XX pour caractère (XX représente la longueur de la chaîne) ;

R/XX,XX- pour réel (XX,XX- représente la longueur et la capacité à gérer le signe du réel) ;

E/XX pour entier (XX représente la longueur de la chaîne).

CreVal

Caractère

Valeur d’initialisation de la zone en création

CouCol

Caractère

Couleur du fond de la colonne. Les choix possibles sont :

Rouge, Vert, Bleu, Mauve, Jaune, Rose ou Orange

Indice couleur défini dans DIAPASON (voir « A Propos de DIAPASON », Onglet « Couleurs »)

RAcCol

Caractère

Liste des références des actions à ajouter sur cette colonne (voir chapitre correspondant).

LAcCol

Caractère

Liste des libellés des actions à ajouter sur cette colonne

NumCol

Numérique

Numéro de colonne dans le tableur, si initialisé à 0 pour toutes les colonnes, elles seront prises par ordre alphabétique

LarCol

Numérique

Largeur de la colonne (indépendant du format de la colonne)

AffCol

Logique

Colonne affichée ?

SaiCol

Logique

Colonne saisie ?

CtrCol

Logique

Colonne contrôlée ?

AidCol

Logique

Aide disponible sur la colonne ?

CreCol

Logique

Sur une ligne créée, possibilité ou non de saisir la zone

CumCol

Logique

Cumul colonne ?

ValCum

Logique

Cumul sur valeurs ?

Pour des valeurs numériques, si initialisé à « + » alors le cumul est réalisé sur les valeurs, sinon « - » le nombre de lignes est cumulé.

Pour des valeurs en mode caractère ou date, le cumul est donné en nombre de lignes.

Remarque : Il n’est pas nécessaire de renseigner la variable ValCum dans le cas d’une colonne cumulée non numérique.

InvCol

Logique

Colonne en inverse – vidéo ?

FigCol

Logique

Indique si la colonne est figée ou pas. Une colonne figée est cadrée à gauche du tableur et ne défile pas horizontalement.

Remarque : Ce statut est pris en compte seulement pour les colonnes qui sont le plus à gauche du tableur. Il ne peut pas y avoir de colonne figée après une colonne non figée.

Pour cette liste, il est nécessaire de définir autant de « Création liste WfTabStr » que de colonnes dans le tableur.

Dans notre exemple, nous avons quatre colonnes, donc quatre création d’enregistrement pour la liste « WfTabStr » : la première colonne s’intitulera « Référence Fournisseur », avec un format de 25 caractères et sera affichée en rouge. Elle sera figée. L’utilisateur pourra effectuer des créations. En outre, l’aide sera disponible. Le cumul permettra de compter le nombre de fournisseurs affichés.

La deuxième colonne « Famille Fournisseur » sera juste affichée sur 5 caractères alors qu’elle peut en contenir 25.

Remarques :

Si le format de certaines variables n’est pas initialisé, les variables logiques le seront par défaut à « +/- », les variables de type caractère à « C/10 », de type réel à « R/8.3 », les entiers à « E/8 » et de type date à « D/JJ/MM/AAAA ».

Pour arriver dans un Tableur Dynamique en mode d’affichage « Zones Saisissables » (les cellules non saisissables sont grisées), il faut dans la REB/RTD de définition du tableur alimenter la variable SCR.RTD_IniAsp (aspect de départ Tableur Dynamique) avec la valeur « S » : INIT SCR.RTD_IniAsp = CLO."S".

Pour arriver dans un Tableur Dynamique avec toutes les lignes sélectionnées, il faut dans la REB/RTD de définition du tableur alimenter la variable SCR.RTD_IniAsp (aspect de départ Tableur Dynamique) avec la valeur « SEL* » : INIT SCR.RTD_IniAsp = CLO."SEL*". ce point peur être combiné avec le précédent : INIT SCR.RTD_IniAsp = CLO."S,SEL*".

Positionnement de départ dans requête REB/RTD

Le positionnement au démarrage d’un Tableur Dynamique est géré automatiquement : c’est la première cellule saisissable (si saisie) ou la première cellule en haut à gauche. Il est possible de choisir la cellule de positionnement au départ. Pour cela il faut alimenter 2 informations dans la requête REB/RTD de construction du tableur :

  • WfTabGen.DebLig : indice de la ligne (= WfTabVal.NumLig)

  • WfTabGen.DebCol : référence de la colonne (= WfTabStr.RefCol)

Ces 2 informations ne sont pas obligatoires, et peuvent être dissociées (positionnement sur une ligne à la première colonne, ou sur une colonne de la première ligne seulement).

Remarque : Ces valeurs ne sont prises en compte que si WfTabGen.GesNum est VRAI.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.