PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Qu'est-ce qu'un trigger ?
  • Définition
  • Types de triggers disponibles
  • Manipuler les triggers par programmation
  • Les fonctions du WLangage
  • Créer un trigger
  • Créer une procédure exécutée par un trigger
  • Tests automatiques et triggers
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Qu'est-ce qu'un trigger ?

Définition

Un trigger est une procédure WLangage appelée automatiquement par le moteur HFSQL à chaque modification (ajout, suppression, modification, ...) d'un enregistrement d'un fichier de données.
Un trigger permet d'associer un traitement WLangage à une ou plusieurs fonctions HFSQL (HAjoute, HModifie, HSupprime, ...) sans se préoccuper de l'emplacement de ces fonctions dans le code source. Même s'il s'agit d'une fenêtre ou d'un code créé par un assistant, les triggers associés aux fonctions HFSQL utilisées sont exécutés.
Remarque : Les triggers fonctionnent également avec les fonctions de gestion des champs Table fichier : TableAjoute, TableAjouteLigne, TableModifie, TableModifieLigne, TableSupprime, ...
L'utilisation d'un trigger permet de :
  • Diminuer la taille du code. Par exemple, les traitements associés à une ou plusieurs fonctions HFSQL (vérification de doublon, test de cohérence des données, ...) peuvent être regroupés grâce à l'utilisation d'un trigger.
  • Simplifier la lecture du code.
  • Simplifier les évolutions futures de l'application.
Les triggers s'appliquent sur tous les types de fichiers de données :
  • HFSQL
  • Accès natifs (Oracle, AS/400, ...)
  • ODBC
  • OLE DB
Remarques :
  • Avec une base de données HFSQL Client/Serveur, il est également possible de définir des triggers serveur. Pour plus de détails, consultez Triggers serveur.
  • Lors de modification de fichiers de données via une requête, seuls les triggers serveurs peuvent être déclenchés. Les triggers simples ou triggers client ne sont pas déclenchés.
Versions 17 et supérieures
iPhone/iPad Cette fonctionnalité est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonctionnalité est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonctionnalité est désormais disponible pour les applications iPhone/iPad.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Types de triggers disponibles
Deux types de triggers sont disponibles :
  • Les triggers "AVANT" :
    Un trigger "AVANT" est appelé :
    • avant l'exécution d'une fonction HFSQL (HAjoute, HModifie, HSupprime, ...).
    • avant l'exécution d'une fonction de gestion des champs Table fichier.
      Un trigger "AVANT" permet par exemple de vérifier la cohérence des données des rubriques d'un enregistrement. Avec ce type de trigger, il est possible d'initialiser une variable HFSQL pour annuler l'exécution de la fonction HFSQL associée.
  • Les triggers "APRÈS" :
    Un trigger "APRÈS" est appelé :
    • après l'exécution d'une fonction HFSQL (sauf si le programme a été interrompu pendant l'exécution de cette fonction).
    • après l'exécution d'une fonction de gestion des champs Table fichier.
      Un trigger "APRÈS" permet par exemple de gérer le traitement des erreurs.
Manipuler les triggers par programmation

Les fonctions du WLangage

Plusieurs fonctions permettent de manipuler les triggers :
Versions 09 et supérieures
HActiveTrigger
Nouveauté 09
HActiveTrigger
HActiveTrigger
Ré-active un trigger précédemment désactivé avec la fonction HDésactiveTrigger.
Versions 09 et supérieures
HDécritTrigger
Nouveauté 09
HDécritTrigger
HDécritTrigger
Ajoute ou modifie un trigger sur un fichier de données HFSQL.
Versions 09 et supérieures
HDésactiveTrigger
Nouveauté 09
HDésactiveTrigger
HDésactiveTrigger
Désactive un trigger.
Versions 09 et supérieures
HDétruitTrigger
Nouveauté 09
HDétruitTrigger
HDétruitTrigger
Détruit un trigger.
Versions 09 et supérieures
HGèreTrigger
Nouveauté 09
HGèreTrigger
HGèreTrigger
Active ou désactive la gestion des triggers.
Versions 09 et supérieures
HListeTrigger
Nouveauté 09
HListeTrigger
HListeTrigger
Renvoie la liste des triggers appliqués sur un ou plusieurs fichiers de données HFSQL.

Créer un trigger

Pour créer un trigger "AVANT" ou un trigger "APRÈS", utilisez la fonction HDécritTrigger dans le traitement d'initialisation du projet. Le trigger peut être créé :
A chaque exécution d'un trigger, la procédure WLangage associée est exécutée.
Remarque : Un trigger est global au projet.

Créer une procédure exécutée par un trigger

Une procédure de type trigger ne reçoit aucun paramètre. Toutefois, un certain nombre de variables d'état HFSQL est positionné avant chaque appel :
H.NomFichierChaîne de caractères : Nom logique du fichier dont le trigger est activé.
H.ActionCaractère initialisé à "A" pour un trigger Avant, "P" pour un trigger après.
H.FonctionTriggerChaîne de caractères : Nom de la fonction HFSQL qui a déclenché le trigger.
H.AFairePendant l'exécution d'un trigger avant :
  • annulation de l'exécution de la fonction HFSQL en cours en affectant "A" à la variable d'état HFSQL : H.AFaire = "A".
    Dans ce cas, l'action n'est pas effectuée et la fonction (HAjoute, HModifie, ...) renvoie Vrai (pas d'erreur).
  • annulation de l'exécution de la fonction HFSQL en cours en affectant "E" à la variable d'état HFSQL : H.AFaire = "E".
    Dans ce cas, l'action n'est pas effectuée et la fonction (HAjoute, HModifie, ...) renvoie Faux. Le message d'erreur est le suivant : "L'action sur le fichier XXX a été interrompue par le trigger".
Remarque : Dans le cas où un trigger "AVANT" et un trigger "APRÈS" sont associés à une fonction HFSQL, si le trigger "AVANT" annule l'exécution de la fonction HFSQL (en positionnant H.AFaire à "A") le trigger "APRÈS" n'est pas déclenché.
Le mot-clé MonFichier permet de connaître et de manipuler dans le code de la procédure le nom du fichier sur lequel le trigger a été déclenché. Dans le cas d'un trigger "APRES", si la commande HFSQL ne s'est pas exécutée correctement, la procédure associée au trigger n'est pas exécutée.

Tests automatiques et triggers

Si des tests automatiques déclenchent des triggers utilisant des boîtes de dialogue (fonctions OuiNon, Confirmer, ...), il est nécessaire de désactiver ces boîtes de dialogue pendant l'exécution du test grâce à la fonction EnModeTestAutomatique.
Liste des exemples associés :
WD Trigger Exemples didactiques (WINDEV) : WD Trigger
[ + ] Cet exemple montre comment utiliser les triggers avec WINDEV.
Un trigger est une procédure en WLangage appelée automatiquement par le moteur HFSQL à chaque exécution d'une fonction HFSQL.

Dans cet exemple, nous abordons deux thèmes principaux :
1/ comment brancher un trigger sur une fonction HFSQL
2/ quel code utiliser dans la fonction appelée par le trigger.

Résumé de l'exemple livré avec WINDEV :
Cette application permet de saisir les notes de frais des collaborateurs d'une société.
Deux modes sont utilisables :
- le mode avec les droits en lecture/écriture
- le mode avec les droits en lecture seulement.
Ce sont les triggers qui permettront de contrôler l'accès aux fichiers en fonction du mode en cours.
Dans l'exemple, les triggers permettent également d'écrire dans un fichier journal les différents événements.
Ce fichier journal est directement consultable dans l'application.
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire