Accueil > Conception et création de solutions > Création et gestion des modèles et des rapports > Configuration des déclencheurs de script

Configuration des déclencheurs de script

Vous pouvez configurer un déclencheur de script pour exiger l'exécution d'un script lorsqu'un événement se produit. Par exemple, vous pouvez utiliser un déclencheur de script pour exécuter un script qui saisit automatiquement des données dans les rubriques en fonction des saisies d'une autre rubrique.

Certains déclencheurs exécutent le script avant qu'un événement ne soit traité par le moteur de base de données. D'autres déclencheurs exécutent le script après qu'un événement a été traité par le moteur de base de données. Par exemple, vous pouvez utiliser le déclencheur de script SurEntreeObjet pour exécuter un script après la saisie dans une rubrique. (La rubrique correspond à l'objet ; la saisie dans la rubrique correspond à l'événement.)

Les déclencheurs de script peuvent être activés par les actions des utilisateurs ou par les scripts. Par exemple, vous pouvez utiliser le déclencheur de script SurEntreeObjet pour activer un script qui s'exécute à la saisie dans une rubrique, soit parce que l'utilisateur a cliqué dans cette rubrique, soit du fait de l'action de script Aller à l'objet.

Vous pouvez configurer l'activation d'un déclencheur de script :

•	lorsqu'un utilisateur ouvre un modèle en particulier Consultez la section Définition des déclencheurs de script pour les modèles.

•	lorsqu'un utilisateur ouvre, modifie ou quitte un ou plusieurs objets d'un modèle Consultez la section Définition des déclencheurs de script pour les objets.

•	lorsqu’un fichier est ouvert ou fermé ou que l’état de lecture d’un fichier multimédia est modifié. Pour plus d'informations sur l'utilisation des scripts, consultez la section Définitions d'options de fichier

Pour afficher les modèles et les objets du modèle associés à des déclencheurs de script, en mode Modèle, sélectionnez le menu Affichage > Afficher > Déclencheurs de script.

Voici les déclencheurs de script disponibles :

 

Zone du déclencheur	Déclencheur de script	Avant le traitement	Après le traitement
Objet	SurEntreeObjet		X
	SurFrappeClavierObjet	X
	SurModificationObjet		X
	SurValidationObjet	X
	SurEnregistrementObjet		X
	SurSortieObjet	X
	SurChangementPanneau	X
	SurChangementObjetAVPlayer		X
Modèle	SurChargementEnregistrement		X
	SurValidationEnregistrement	X
	SurRetablirEnregistrement	X
	SurFrappeClavierModele	X
	SurEntreeModele		X
	SurSortieModele	X
	SurModificationTailleModele		X
	SurEntreeMode		X
	SurSortieMode	X
	SurChangementVue		X
	SurGesteAppui	X
	SurRéceptionCommandeExterne		X
Options de fichier	SurOuverturePremiereFenetre		X
	SurFermetureDerniereFenetre	X
	SurOuvertureFenetre	X
	SurFermetureFenetre		X
	SurModificationFichierAVPlayer		X

Chronologie des déclencheurs de script

Lorsqu'un même événement active plusieurs déclencheurs de script, ces derniers s'exécutent dans l'ordre relatif suivant :

1.	SurOuverturePremiereFenetre

2.	SurOuvertureFenetre

3.	SurEntreeModele

4.	SurEntreeMode

5.	SurChargementEnregistrement

6.	SurModifcationTailleModele

7.	SurEntreeObjet

8.	SurFrappeClavierObjet

9.	SurFrappeClavierModele

10.	SurGesteAppui

11.	SurModificationLecteurAVObjet

12.	SurModificationFichierAVPlayer

13.	SurRéceptionCommandeExterne

14.	SurChangementPanneau

15.	SurModificationObjet

16.	SurValidationObjet

17.	SurEnregistrementObjet

18.	SurSortieObjet

19.	SurValidationEnregistrement ou SurRetablirEnregistrement

20.	SurChangementVue

21.	SurSortieMode

22.	SurSortieModele

23.	SurFermetureFenetre

24.	SurFermetureDerniereFenetre

Remarques

•	Les scripts exécutés par des déclencheurs de script utilisent les privilèges existants. A moins qu'il ne soit défini pour s'exécuter avec tous les privilèges, le script s'exécute habituellement à l'aide des privilèges de l'utilisateur.

•

Dans la Publication Web personnalisée, les déclencheurs de script ne peuvent être activés que par un script et non par l'intervention de l'utilisateur. Par exemple, si un utilisateur effectue une tabulation dans une rubrique pour laquelle un déclencheur de script SurEntreeObjet est activé, le déclencheur ne s'active pas. Si une action de script entraîne un déplacement dans cette rubrique, le déclencheur de script s'active.

•

Certains déclencheurs de script permettent d'annuler l'événement d'activation si le script qu'ils exécutent renvoie la valeur Faux. Lorsqu'une commande ou un événement sont ainsi annulés, le code d'erreur renvoyé est 20. Pour plus d'informations, consultez le Obtenir ( DernièreErreur ) function. Si le script exécuté par le déclencheur de script SurFermetureDerniereFenetre renvoie pour valeur Faux, le fichier ne pourra pas être fermé.

•

Les déclencheurs de script SurOuverturePremiereFenetre et SurOuvertureFenetre s'affichent dans l'outil Script Debugger lorsqu'un script doit s'exécuter à l'ouverture d'un fichier ; les déclencheurs de script SurFermetureDerniereFenetre et SurFermetureFenetre s'affichent dans l'outil Script Debugger lorsqu'un script doit s'exécuter à la fermeture d'un fichier.

•	Windows : Les combinaisons impliquant les touches Alt et Ctrl ne permettent pas d'activer les déclencheurs de script.

•	OS X : Les combinaisons impliquant la touche Commande ne permettent pas d'activer les déclencheurs de script.

Rubriques connexes 

Débogage de scripts (FileMaker Pro Advanced)

Utilisation du Visualiseur de données (FileMaker Pro Advanced)