SEL_TABLE
Description
Cette action est appelée en tout début du modèle, avant l'affichage de la fenêtre de sélection.
Modèle
Sélection sur table
Utilisation
Elle sert principalement à construire la fenêtre de sélection. Nous avons deux possibilités pour préparer cette fenêtre :
soit
faire appel à la fenêtre de sélection principale définie dans l'OBJet (ceci est
faisable si la table à explorer est gérée par un OBJet)
soit
construire totalement cette fenêtre de sélection.
Elle peut servir à interrompre le traitement en positionnant OK = 0.
Elle peut servir à modifier le nombre d'éléments à afficher dans la fenêtre de sélection, en modifiant la variable adxmxl. Il n'est pas nécessaire de la sauvegarder, le superviseur s'en charge.
cas d'appel de la fenêtre de sélection de l'OBJet
C'est le cas le plus simple. On utilise les paramètres de l'OBJet pour afficher la fenêtre principale de cet OBJet. Les variables à renseigner sont les suivantes :
OBJET
: Char, longueur 5.
Elle permet d'identifier l'OBJet, afin de récupérer les informations nécessaires à
l'affichage de la fenêtre.
Cette variable est à renseigner obligatoirement.
SUPP
: Char, longueur 30.
Lorsque l'OBJet a 2 éléments de clé, elle permet de filtrer les enregistrements de la
table sur une valeur du 1er champs de clé.
Donc, si l'on veut ce filtre, on renseigne cette variable, par la valeur du 1er champs de
clé.
OPTIONS
: Char, longueur 10.
Elle permet de filtrer les enregistrements sur des filtres pré-définis dans l'OBJet. On
y renseigne donc les codes de "filtres de sélections" définis dans l'OBJet que
l'on désire appliquer.
En ajoutant le caractère "#", on filtre les enregistrements actifs (
c'est à dire ceux dont le champ [F]ENAFLG=2 ) et on exécute l'action FILTRE de l'OBJet.
En ajoutant le caractère "|", on trie les
enregistrements sur le 1er champ de clé puis sur le 2ème.
En ajoutant le caractère "$", on ouvre la table de
l'OBJet avec l'abréviation du dictionnaire, même si celle-ci est déjà ouverte. Cela
permet d'éviter des filtres résiduels ou un repositionnement parasite de la classe [F].
La pagination est automatiquement prise en compte par le Superviseur.
cas de création d'une fenêtre de sélection
Dans ce cas, la fenêtre est à construire, complètement. On devra ouvrir ( si elle ne l'est pas déjà ) la table sur laquelle est basée la sélection. On devra, en plus, préciser que cette classe [F] est la classe, par défaut. Nous sommes limités à 16 colonnes dans la construction de la fenêtre. Pour définir la fenêtre, nous avons à disposition les variables suivantes :
NBCOL
: Integer
C'est le nombre de colonnes à afficher dans la fenêtre. Le nombre
de colonnes est limité à 16.
TIT(NBCOL)
: Char, longueur 30, dimensionné.
C'est le titre de la colonne. C'est à renseigner pour chaque colonne prévue dans la
fenêtre.
COL(NBCOL)
: Char, longueur 50, dimensionné.
C'est le nom du champ à afficher dans la colonne. C'est à renseigner pour chaque colonne
prévue dans la fenêtre.
TIT(0)
: Char, longueur 30.
C'est le titre de la fenêtre.
DEFPAG=1
: le Superviseur prends en charge la pagination.
Dans les deux cas de figure :
Il est possible de modifier les valeurs par défaut des variables suivantes :
ORDRE
: Char, longueur 250.
Elle permet d'indiquer l'ordre de tri des enregistrements.
Lorsqu'on est sur une fenêtre issue d'un OBJet, le superviseur trie, sur la
clé précisée sur l'onglet "sélection" sinon il trie sur la clé primaire.
Lorsque la clé n'est pas précisée dans l'onglet "sélection" de
l'OBJet, le
superviseur prend donc la clé primaire. Lorsque cette clé primaire est
composée de deux éléments, le superviseur trie, par défaut, sur le dernier
élément ou bien sur l'ensemble de la clé si on précise OPTIONS="|"
dans cette action.
Lorsqu'on est sur une fenêtre construite, le superviseur trie, par défaut, les enregistrements sur la première colonne déclarée dans la fenêtre.
Cette variable nous donne la possibilité de trier les enregistrements d'une autre
façon. On indique dans cette variable le nom d'un ou plusieurs champs appartenant à la
table mais pas forcément à la fenêtre. Les nom de champs sont séparés entre eux par
le caractère ";".
Exemple : ORDRE = "[F:ADI]NUMTAB;[F:ADI]CODE"
SENS
: Integer
Elle permet d'indiquer le sens de tri des enregistrements.
Par défaut, le tri est ascendant. On précisera la valeur 2 dans cette variable pour
avoir un tri descendant.
START
: Char, longueur 250.
Elle permet d'identifier la colonne qui alimentera le champ duquel la fenêtre a été
activée, lorsque l'utilisateur aura fait son choix.
Lorsqu'on est sur une fenêtre issue d'un OBJet, le superviseur prend par défaut,
le champ de la clé primaire. Pour une clé à 2 composantes, le superviseur prend
par défaut le deuxième élément de clé sinon il prend le
premier lorsqu'on précise OPTIONS="|" dans cette action.
Lorsqu'on est sur une fenêtre construite, le superviseur prend par défaut, la première
colonne déclarée dans la fenêtre.
Cette variable nous donne la possibilité de prendre une autre colonne. On indique dans
cette variable le nom d'un champ appartenant à la fenêtre.
EXPSTART
: Char, longueur 250.
Elle permet d'indiquer l'enregistrement sur lequel sera positionné le curseur.
Par défaut, le curseur sera positionné sur le premier enregistrement dont le champ
identifié par la variable START est supérieure ou égal à la valeur saisie. Cependant,
il est possible d'indiquer le placement du curseur par sa propre expression.
Syntaxe identique que pour la variable CRITERE.
CRITERE
(1..7) : Char, longueur 250.
ces champs permettent d'indiquer un filtre de sélection des enregistrements de la table.
CRITCAR
: Char, longueur 250.
ce champ permet de positonner le curseur sur l'élément indiqué. Syntaxe
identique que pour la variable CRITERE.
SIZLIG
& SIZCOL : integer
Elles permettent de modifier la taille de la fenêtre qui est de 10 lignes et 60 colonnes
par défaut.
Ces 2 variables sont initialisées de la façon suivante : SIZLIG = 80 & SIZCOL = 240.
SIZLIG indique un nombre de lignes exprimé en 1/8 de ligne.
SIZCOL indique un nombre de colonnes exprimé en 1/4 de colonne.
Exemple :
# fenêtre de sélection s'appuyant sur la description de l'objet ITS, sur la
quelle on indique :
# le filtre de sélection CRITERE, l'ordre de tri ORDRE, le champ qui sera récupéré
en retour de la sélection START
$S_ITV
Ifclalev([F:ITS])=0:LocalFileITMSALES:Endif
Ifclalev([F:ITM])=0:LocalFileITMMASTER:Endif
Ifclalev([F:ATZ])=0:LocalFileATABZON:Endif
LocalCharCODFIC:CODFIC = "ITMSALES"
Link [ITS] With [ITM]ITM0=[ITS]ITMREFAs [KITS]
DefaultFile [KITS]
ORDRE = 'ITMREF'
START = 'ITMREF'
CRITERE='[F:ITM]ITMSTA=1 & [F:ITM]ITMREF>="'+VALEUR+'"'
OBJET="ITS"
Return
