Fonctionnement ( consultation )

Description

Ce modèle est appelé depuis une fonction, un bouton bas d'écran, un menu ou un menucontextuel. Ce modèle permet de visualiser un ensemble d'enregistrements d'une table,sélectionnés en fonction de critères saisis par l'utilisateur ou bien passés parprogramme. Ce modèle offre la possibilité d'afficher les résultats de la consultationsous forme d'un graphe.

Ergonomie

La consultation se présente avec un écran d'entête, comprenant les critèresprincipaux pour la sélection des enregistrements, et un onglet principal constitué d'unensemble d'enregistrements à afficher. Cet onglet est un tableau pour lequel chaque lignecorrespond à un enregistrement. On a ensuite la possibilité d'avoir divers ongletssupplémentaires. Attention ! ce modèle ne chargement pas automatiquement lesinformations dans ces onglets; le chargement des onglets doit se programmer dans l'actionLECTURE. Lorsque les critères sont nombreux, ils peuvent être regroupés dans un écranparticulier, qui sera affiché lorsque l'utilisateur clickera sur le bouton CRITERES. Lebouton GRAPHIQUE, permet l'affichage d'un graphe, à la condition de fournir les donnéesà afficher dans l'action GRAPH.

Normalisation des éléments du dictionnaire

   Ecran d'entête : doit se nommer "CONS" + code consultation +"1"

   Ecran de détail : doit se nommer "CONS" + code consultation +"2"

   Ces 2 écrans sont regroupés dans une fenêtre principale nommée "FCNS"+ code consultation. cette fenêtre est de type "plein écran".

   Ecran de critères : doit se nommer "CRIT" + code consultation. il estfacultatif.

   Cet écran est encapsulé dans une fenêtre de critères nommée "DCNS" +code consultation. cette fenêtre est de type "boite de dialogue". Elle estfacultative.

   Consultation : elle est identifiée par le code consultation sur 3 caractères.Attention ! pour le spécifique, ce code doit commencer par l'une des 3 lettres suivantes: X, Y ou Z. La consultation regroupe la fenêtre principale et la fenêtre de critères.

   Action: doit se nommer "CONS" + code consultation. Dans cette action, on préciseobligatoirement le code consultation. Et puis, il est possible de définir desparamètres.

   Fonction: doit se nommer "CONS" + code consultation. Dans cette fonction, on préciseobligatoirement l'action et éventuellement des valeurs pour les paramètres de cetteaction.

Les écrans

pour l'écran de détail de la fenêtre principale, la variable de bas de tableau doitse nommer NBLIG.

pour l'écran de critères, si l'on désire que le modèle gère la mémorisation desparamètres de cet écran, il faudra la présence du champ MEMO. De plus,si on veut que l'écran des détails de la fenêtre principale soit paramétrable, ilfaudra la présence du champ ECRAN. Le principe est le suivant : sur labase de l'écran de détail déclaré dans la fenêtre principale, l'utilisateur peut seconstruire un ensemble d'écrans de détail par la fonction Paramétrage / Paramètresgénéraux / Ecrans de consultation. Ces écrans pourront n'afficher que certainescolonnes et ceci dans un ordre qui peut être différent par rapport à l'écran de base. L'utilisateurchoisit l'un de ces écrans, par le champ ECRAN de la fenêtre de critères.

Les traitements

Le modèle est un traitement superviseur qui fait appel à deux traitementsannexes : le traitement standard et le traitement spécifique, s'il sontrenseignés dans le dictionnaire de l'action. Ces deux traitements Sontstructurés de la même façon, c'est à dire qu'ils commencent par une étiquette ACTION, qui traite lesdifférents évènements susceptibles d'arriver lors de l'exécution de lafonction.

Le traitement standard
Il est nommé CNSxxxSTD ( xxxest le code de la consultation). 
Ce traitement, fourni par ADONIX, ne doit absolument pas être modifié par lespécifique. 

Le traitement spécifique
Il doit se nommer CNSxxxSPE ( xxxest le code de la consultation). Ce traitement n'est pas fourni par Adonix, mais il peut être développé enspécifique (à la fois pour des fonctions standards pour lesquelles on désirefaire des ajouts et pour les fonctions spécifiques). 

Les Actions

Le traitement standard ou spécifique comment donc par cette étiquette$ACTION à écrire de la façon suivante ( ou XXXXXX est le code del'évènement ) : 

$ ACTION
Case ACTION
   When "XXXXXX" : Gosub XXXXXX
   When default
Endcase
Return

Chaqueévénement est identifié par un code alphanumérique, contenu dans la variable ACTION.S’il n’y a pas de traitement pour un événement, le fonctionnement dela fonctionn'en sera pas entravé. C'est dans le sous-programme $ACTION, que l'on faitl'aiguillage vers l'étiquette ajoutée. On précisera dans cette syntaxe"case ACTION", autant de lignes qu'il y a d'évènements àcompléter. Le $ACTION est appelé du traitement superviseur par GOSUB ; Celapermetdonc d'utiliser des variables locales au traitement superviseur. 

On trouvera ci-joint la liste des actions. Ontrouvera ensuite,  la description détaillée de ces actions. On y décritle contexte appelant et l'OBJectif de ces actions.

Ajout d'actions spécifiques sur le standard

Par défaut, pour un même évènement, l'action spécifique est appelée avant l'action standard. 

Elle peut annuler etremplacer l'action standard si elle positionne la variable GPE à lavaleur 1. 

Pour exécuter l'action standard avant l'action spécifique, dans ce cas, onduplique le traitement standard dans l'action spécifique, on y ajout letraitement spécifique puis on positionne la variable GPE à lavaleur 1. Exemple :

Traitement superviseur
GPE=0
Gosub  ACTION  From  trait_std             ( appel dustandard)
If GPE=0
   Gosub  ACTION  From  trait_spé.           ( appel du spécifique)
Endif

Traitement spécifique
$ ACTION
Case ACTION
   When "OUVRE" : Gosub OUVRE
   When default
Endcase
Return

$OUVRE
...                                                              ( action spécifique OUVRE)
GPE =1                                                    ( pas d’appel du standard suite au spécifique )
Return