...
SEQUENCE | MODE (Sauf CHECK) | CLES (pour CREAT) | UNITE | Avec Décalage | Description | EXEMPLE |
|---|---|---|---|---|---|---|
AVANT | LECT CREAT MODIF SUPPR ANNUL | E OU C Entête ou Corps | “_” | “-” + Description Libre | AVANTLECTE-TraitementXXX.evt AVANTLECTC-TraitementXXX.evt | |
TM | LECT CREAT MODIF SUPPR | CLES | E OU C Entête ou Corps | “_” | “-” + Description Libre | TMCREATCLESE-ControleXXX.evt TMCREATCLESC-ControleXXX.evt |
TR | LECT CREAT MODIF SUPPR | E OU C Entête ou Corps | “_” | “-” + Description Libre | TRMODIFE-ControleXXX.evt TRMODIFC-ControleXXX.evt | |
APRES | LECT CREAT MODIF SUPPR ANNUL | E OU C Entête ou Corps | “_” | “-” + Description Libre | APRESSUPPRE-ControleXXX.evt APRESSUPPRC-Controle.evt |
Exemple :
APRESLECTC
...
-XXX.evt | ||||||
CHECK | E OU C Entête ou Corps | “-” + Description Libre | CHECKE-XXX.evt CHECKC-XXX.evt |
Les séquences :
AVANT : se déclenche avant le lancement du mode, pour LECT c’est avant la recherche des informations, pour les autres, c’est au clic sur le bouton correspondant (création, modification, suppression ou annulation).
TM : se déclenche après le TR. et le traitement facultativement lancé automatiquement suite à une validation. Exemple : avant la liste des fournisseurs suite à la validation d’une création d’un article de nature « Acheté ».
Exemple : TMCREATE-XXX.evt
Remarque : on ne peut plus stopper la validation en générant une erreur (g_err%=1).
TR :se déclenche après le traitement potentiel lancé automatiquement suite à une validation. Exemple : avant la liste des fournisseurs suite à la validation d’une création d’un article de nature « Acheté ».
Exemple : TRCREATE_XXX.evt
Remarque : Il est possible de stopper la validation en générant une erreur (g_err%=1).
APRES : se déclenche après la validation/lecture.
Remarque : il n’est plus possible de stopper la validation.
CHECK : se déclenche après tabulation d’une zone de saisie
Exemple : Dans l’application “Clients”, le contenu du fichier ci-dessous teste la valeur du nom du client, pour interdire qu’il soit vide.
S’il est blanchi, alors il reprend sa valeur d’avant, c’est ce que contient la variable m_CLI.NomClient.
si la valeur d’avant est vide, alors la variable g_err% est alimentée avec la valeur 1 pour interdire la validation.
...
Les modes :
LECT : Lecture
CREAT : Création
MODIF : Modification
SUPPR : Suppression
ANNUL : Annulation
Remarque : Le mode n’est pas à préciser pour le CHECK
Les unités :
E : En-tête
C : Corps
Avec décalage
En ajoutant un « _ » à la fin du préfixe, on obtient un évènement qui se déclenche légèrement plus tard.
Les autres évènements
FIRSTPOINT : se déclenche à l’ouverture de l’application
LASTPOINT : se déclenche à la fermeture de l’application
DEBUTCORPS : se déclenche au passage dans le corps
FINCORPS : se déclenche au passage en en-tête
CANLOADAPPLICATION : pour bloquer le chargement d'une application. Il faut utiliser la variable "g_err%" pour indiquer à l'application si elle peut se charger ou non. Les variables g_mess1$ et g_mess2$ sont utilisées pour afficher un message.
Exemple de contenu du fichier :
...
Au chargement on obtient le message suivant :
...
CANQUITAPPLICATION : pour interdire de quitter une application. Il faut utiliser la variable "g_err%" pour indiquer à l'application si elle peut se fermer ou non. Les variables g_mess1$ et g_mess2$ sont utilisés pour afficher un message.
...
En quittant l’application on obtient le message suivant :
...
CanAlwaysCreate_E, CanAlwaysDuplicate_E, CanAlwaysModify_E et CanAlwaysDelete_E, CanAlwaysCreate_C, CanAlwaysDuplicate_C, CanAlwaysModify_C et CanAlwaysDelete_C : Ces évènements permettent respectivement de donner la possibilité de paramétrer ou non l'affichage des boutons "Création", "Duplication", "Modification" et "Suppression" pour les unités "Entête" (..._E) et/ou "Corps" (..._C). Ces évènements sont exécutés à l'ouverture de l'application concernée pour interdire l'action en fonction de conditions spécifiques ou non..
Il faut utiliser la variable globale "g_err%" et lui assigner la valeur 1 ou 0 :1 : Action interdite.
0 : Action autorisée.
Par exemple, dans le fichier "CanAlwaysCreate_E.evt" de l'application client, le fait d'écrire "g_err%=1" supprime le bouton "Création" et "Duplication" (car c'est une création) de l'application client lors de l'ouverture de l'application.
...