Débogage de scripts (FileMaker Pro Advanced)
Script Debugger est un outil interactif permettant de dépanner les
scripts de FileMaker.
Script Debugger vous permet de :
•déboguer des scripts exécutés depuis le menu Scripts ou les raccourcis clavier ;
•déboguer des scripts de démarrage (le menu Script Debugger est activé même si aucun fichier n’est ouvert) ;
•commencer un
sous-script pour l’exécuter action par action, ou terminer un sous-script ;
•définir ou effacer des points d’arrêt dans le script ;
•commencer le débogage à partir de n’importe quelle
action dans le script ;
•afficher des sous-scripts lorsque vous exécutez les scripts ;
•déboguer des scripts avec privilèges d’accès ;
•suspendre un script lorsque des erreurs de scripts surviennent ;
•désactiver ou activer temporairement les déclencheurs de script lorsque vous travaillez dans Script Debugger.
Pour déboguer les scripts :
1. Activez Script Debugger en effectuant l’une des opérations suivantes :
•Sélectionnez le menu Outils > Script Debugger, puis exécutez votre script.
•Sélectionnez le menu
Scripts >
Espace de travail de script, sélectionnez votre script, puis cliquez sur
. Pour enregistrer tous les scripts ouverts, puis déboguer le script, tenez enfoncée la touche Maj (Windows ) ou Option (OS X) et cliquez sur
.
2. Utilisez les commandes suivantes pour déboguer le script :
Choisir | Pour |
Pas à pas principal | Exécuter le script pas à pas sans sous-scripts. Si l’action de script est Exécuter le script, Script Debugger exécutera le sous-script puis passera à la ligne suivante du script d’appel. Le Script Debugger exécutera toutes les étapes du sous-script jusqu’à ce qu’il rencontre un point d’arrêt. |
Commencer la procédure | Exécuter le script pas à pas, et saisir et présenter les actions dans des sous-scripts. Si l’action de script est Exécuter script, Script Debugger passera à la première ligne du sous-script et attendra une entrée de l’utilisateur avant de passer à l’action de sous-script suivante. |
Terminer la procédure | Exécuter tous les étapes du script en cours et, dans le cas d’un sous-script, revenir à la ligne qui suit l’étape Exécuter script du script d’appel. S’il ne s’agit pas d’un sous-script, la commande Terminer la procédure indique au Script Debugger d’exécuter toutes les actions de script et de sous-script restantes jusqu’à ce qu’il rencontre un point d’arrêt. |
Définir l’action suivante | Régler le pointeur d’exécution des étapes sur l’action de script en surbrillance. Cette commande passe le contrôle à l’étape en surbrillance, mais ne l’exécute pas. L’action en surbrillance s’exécute à la reprise de l’exécution du script ou de l’étape de débogage. Toutes les actions de script comprises entre la dernière étape exécutée et la suivante désignée ne sont pas exécutées. Cliquez sur une action pour la mettre en surbrillance, puis sur . |
Exécuter Pause | Inverser entre pause et exécution de toutes les actions de script jusqu’à la fin d’un script ou un point d’arrêt. Lorsqu’un script est mis en pause, vous pouvez double-cliquer dessus dans la liste Appeler la pile pour le modifier. Chaque script actif s’ouvre dans un onglet distinct de l’Espace de travail de script, ce qui vous permet de modifier plusieurs scripts. L’exécution du script n’est pas interrompue tant que vous n’enregistrez pas les modifications. Lorsqu’un script est en pause, vous pouvez l’exécuter pas à pas avec . |
Interrompre script | Arrêter l’exécution d’un script. |
Activer/Désactiver les déclencheurs de script | Désactiver ou activer temporairement tous les déclencheurs de script d’un fichier. Vous devez avoir des privilèges d’accès Accès intégral pour désactiver un déclencheur de script. Les déclencheurs de script sont activés par défaut. A la fermeture de Script Debugger, tous les déclencheurs de script désactivés sont alors activés. |
Modifier le script | Ouvre le script actif dans la boîte de dialogue Modifier le script. Vous pouvez modifier un script pendant son exécution, mais une fois les modifications du script enregistrées, l’exécution est interrompue. |
Ouvrir/fermer le Visualiseur de données | |
Authentifier le script/Annuler l’authentification | Annuler le verrouillage du Script Debugger ou du Visualiseur de données pour les scripts n’autorisant pas les privilèges de modification. Vous devez avoir des privilèges d’accès intégral pour authentifier un script. Le plus haut niveau de privilèges s’applique à tous les scripts, mais pas aux autres éléments de fichiers (tels que les enregistrements et les modèles). Vos privilèges en modification durent jusqu’à la fermeture du Script Debugger et du Visualiseur de données. |
3. Sélectionnez Suspendre en cas d'erreur si vous souhaitez mettre les scripts en pause lorsque vous rencontrez des erreurs.
Affichage des sous-scripts
Vous pouvez afficher les sous-scripts au moment où vous naviguez entre les scripts du Script Debugger. Par exemple, si le script A appelle le script B, qui ensuite appelle à son tour le script C, vous pouvez visualiser les actions de chacun de ces trois scripts.
1. Sélectionnez le menu Outils> Script Debugger.
2. Exécutez un script qui appelle un sous-script.
3. Cliquez sur Commencer la procédure.
La liste Appeler la pile affiche le sous-script.
4. Sélectionnez un script dans la liste Appeler la pile pour afficher les actions de ce script dans la zone d’affichage.
Remarques
•Pour définir ou supprimer un point d’arrêt, cliquez sur le numéro de ligne à gauche de l’action de script. Les points d’arrêt permettent au Script Debugger d’exécuter de larges sections de script en ne générant des pauses que pour examiner la section marquée d’un point d’arrêt. Les points d’arrêt sont ignorés par FileMaker Pro lorsque le Script Debugger n’est pas utilisé. Il est possible de poser des points d’arrêt sur plusieurs actions. Vous ne pouvez pas définir de points d’arrêt sur les actions appelées par un bouton ou un menu personnalisé.
•Pour simplifier le débogage, le Script Debugger ignore certaines actions du script. L’action Autor. annulation utilisateur avec une option définie sur Non ne vous empêchera pas d’arrêter l’exécution d’un script. L’action de script Ajuster fenêtre associée aux options Masquer ou Réduire ne masquera ni ne réduira la fenêtre lors d’une exécution via les boutons Pas à pas principal
ou Commencer la procédure
.
•Lorsqu’un script dont les privilèges d’accès sont définis sur Modifiable exécute un script en accès Exécutable uniquement, ce dernier s’exécute entièrement sans afficher ses actions dans Script Debugger. Lorsqu’un script exécutable uniquement exécute un script dont les privilèges d’accès sont définis sur Modifiable, seules les actions de ce dernier s’affichent dans Script Debugger. Pour modifier un script, cliquez sur
dans Script Debugger. Pour plus d’informations sur les privilèges associés aux scripts et l’exécution de scripts avec tous les privilèges, consultez la section
Modification des privilèges des scripts.
Si vous ouvrez le Visualiseur de données après avoir cliqué sur
, vos privilèges d’accès sont préservés à la fois dans le Visualiseur de données et dans Script Debugger tant que vous ne fermez pas Script Debugger.
•Pour mettre au point un script de démarrage, ouvrez Script Debugger avant d’ouvrir votre fichier de base de données.
•Lorsque vous fermez Script Debugger alors qu’un script est en pause, se dernier reprend et se termine.
Rubriques connexes