Accueil > Utilisation de FileMaker Pro Advanced > Utilisation des outils de FileMaker Pro Advanced > Débogage de scripts (FileMaker Pro Advanced)

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) ;

•	déboguer un script activé par un déclencheur de script, un bouton ou un menu personnalisé ;

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

•	surveiller les rubriques, les variables et les calculs ;

•	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'étape est Exécuter script, le Script Debugger exécutera le sous-script et 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 la fenêtre 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 le 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. Vous pouvez également sélectionner le menu Outils > Commandes de débogage > Désactiver les déclencheurs de script ou Activer les déclencheurs de script.
Modifier le script	Ouvre le script actif dans la boîte de dialogue Modifier le script. Si le script actif est ouvert dans la fenêtre Espace de travail de script, amène la fenêtre Espace de travail de script au premier plan et affiche le script actif dans le volet de modification d’un script. Vous pouvez modifier un script pendant son exécution, mais une fois les modifications du script enregistrées, l'exécution est interrompue. Remarque : Pour modifier l’action de script associée aux boutons ou aux éléments de menu personnalisés, utilisez la boîte de dialogue Configuration du bouton ou Gérer les menus personnalisés.
Ouvrir/fermer le Visualiseur de données	Ouvrir (ou fermer) la fenêtre Visualiseur de données pour surveiller des rubriques, des variables et des formules de calcul particulières. Consultez la section Utilisation du Visualiseur de données (FileMaker Pro Advanced).
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.

Remarque  Lorsque vous utilisez Script Debugger pour faire défiler les scripts activés par un déclencheur de script, vous ne pouvez pas entrer en interaction avec les fenêtres du document, vous déplacer entre les rubriques ou les enregistrements, modifier les données, fermer la fenêtre ou quitter. Ce blocage de l'interaction se produit uniquement lorsqu'un script est déclenché par une action. Lorsque vous déboguez un script non activé par un déclencheur de script, vous pouvez entrer en interaction de manière habituelle avec les fenêtres du document, les rubriques et les enregistrements.

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

•	Définir l’action suivante est uniquement disponible pour le script en cours d’exécution.

•

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 chaque script, vous pouvez ouvrir une boîte de dialogue Modifier le script ou un onglet dans la fenêtre Espace de travail de script.

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

•	Lorsqu'un script Ouvrir fichier est chargé, le Script Debugger affiche SurOuverturePremiereFenetre.

•	Lorsqu'un script Fermer fichier est chargé, le Script Debugger affiche SurFermetureDerniereFenetre.

•

Lorsque vous déboguez un script appelé à partir d'un bouton, ce dernier est identifié dans la liste Appeler la pile par le nom du fichier et le modèle dans lesquels il se trouve. Le nom du bouton est le nom d'objet qui a été attribué dans l'Inspecteur. Si aucun nom n'a été attribué dans l'Inspecteur, l'intitulé <bouton sans nom>, suivi du nom du fichier et du modèle, apparaît dans la liste.

Lorsque Script Debugger s'arrête sur une action de script appelée par un bouton dans la liste des actions de script, le texte affiché au-dessus de la liste devient Bouton : <nom du bouton> ou devient Bouton : <bouton sans nom> si aucun nom n'a été attribué dans l'Inspecteur.

•

Lorsque vous déboguez un script appelé à partir d'un menu personnalisé, l'élément de menu est identifié dans la liste Appeler la pile par son nom et par le nom de fichier. Lorsque Script Debugger s’arrête sur une action de script appelée par un menu personnalisé dans la liste des actions de script, le texte affiché au-dessus de la liste devient Elément de menu : <texte d'élément de menu personnalisé>.

Rubriques connexes 

Création et modification de scripts

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