• 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.

• Plusieurs triggers serveur peuvent être associés à un même fichier de données.
• Les triggers étant définis sur le serveur, ils sont pris en compte quelle que soit l'application cliente exécutée. La prise en compte d'un nouveau trigger défini sur le serveur est automatique.
• Les triggers serveur sont exécutés :
  • avec les fonctions HAjoute, HSupprime, HModifie, HEcrit, HRaye.
  • avec les fonctions TableAjoute, TableAjouteLigne, TableSupprime, TableModifie qui utilisent implicitement les fonctions HFSQL.
  • avec les requêtes INSERT (trigger HAjoute), UPDATE (trigger HModifie) et DELETE (trigger HSupprime).

Préalable

• sous le volet "Analyse", dans le groupe "Création", déroulez "Nouveau" et sélectionnez "Trigger".
• sélectionnez l'option "Nouveau trigger" du menu contextuel du volet ancrable "Analyse".
• affichez l'onglet "Triggers HF" de la fenêtre de description du fichier de données et cliquez sur le bouton "Créer un nouveau trigger".

• dans l'onglet "Général" :
  
  • le nom du trigger.
  • la procédure stockée WLangage qui est associée au trigger.
  • le mode de déclenchement du trigger (AVANT ou APRES l'exécution des fonctions HFSQL).
  • les fonctions HFSQL qui déclencheront le trigger.
• dans l'onglet "Général" :
  
  • les fichiers de données associés au trigger.

• dans le volet de l'analyse.
• directement dans le graphe de l'analyse : si un trigger serveur est associé à un fichier de données, une icône spécifique apparaît : .

Prise en compte des triggers serveur

• lors de la création des fichiers de données (fonction HCréation ou HCréationSiInexistant).
• avec la fonction HCréeTriggerServeur. Dans ce cas, il est également nécessaire de mettre à jour la procédure stockée correspondante avec la fonction HMiseAJourCollection.
• si nécessaire lors de la modification automatique des fichiers de données.

Procédure stockée liée au trigger

H.NomFichier	Chaîne de caractères : Nom logique du fichier de données dont le trigger est activé
H.Action	Caractère initialisé à "A" pour un trigger Avant, "P" pour un trigger après.
H.FonctionTrigger	Chaîne de caractères : Nom de la fonction HFSQL qui a déclenché le trigger. Avertissement La variable H.FonctionTrigger est dépréciée au profit de la variable H.NuméroFonctionTrigger. L'information donnée par la variable est indépendante de la langue utilisée pour l'exécution de l'application.
Nouveauté SaaS H.NuméroFonctionTrigger	Constante permettant de connaître la fonction qui a déclenché le trigger : htrgHAjoute : La fonction qui a déclenché le trigger est HAjoute. htrgHEcrit : La fonction qui a déclenché le trigger est HEcrit. htrgHModifie : La fonction qui a déclenché le trigger est HModifie. htrgHRaye : La fonction qui a déclenché le trigger est HRaye. htrgHSupprime : La fonction qui a déclenché le trigger est HSupprime.
H.AFaire	Pendant 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, etc.) 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, etc.) renvoie Faux. Le message d'erreur est le suivant : "L'action sur le fichier XXX a été interrompue par le trigger".

Tester une procédure stockée appelée par un trigger

1. Sélectionnez la procédure stockée à tester dans le volet de l'analyse.
2. Sélectionnez l'option "Tester la procédure" dans le menu contextuel de la procédure stockée.
3. La fenêtre de saisie des paramètres de la procédure s'affiche. Dans cette fenêtre, il est possible de :
   • Saisir les paramètres de la procédure.
   • Lancer le test de la procédure.
     Remarque : cette fenêtre peut être utilisée pour relancer plusieurs fois l'exécution en modifiant les paramètres.
4. Lorsque le test de la procédure est lancé :
   • Si nécessaire une mise à jour de la procédure stockée sur le serveur est proposée.
   • La procédure est lancée sur le serveur.
   • La valeur de retour de la procédure est affichée si nécessaire.

• Le port de débogage est le port 27281 par défaut. Il est nécessaire d'ouvrir ce port dans le firewall. Ce port peut être modifié dans le fichier HFConf.ini.
• Pour lancer le test d'une procédure stockée, il est nécessaire d'avoir le droit de débogage sur la base de données.
• Les traces utilisées dans les procédures stockées sont affichées dans le volet de trace du débogueur.
• Le code de la procédure stockée peut contenir des points d'arrêt : le débogueur sera alors lancé.
• Les éléments déployés sur le serveur sont utilisés lors du test.
• La fonction EnModeTest renvoie Vrai.

Les fonctions du WLangage