Mise au point des scripts (FileMaker Pro Advanced)

Mise au point des 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 ;

•

mettre au point 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 la mise au point à partir de n'importe quelle action dans le script ;

•

afficher des sous-scripts lorsque vous exécutez les scripts ;

•

mettre au point des scripts avec privilèges d'accès ;

•

suspendre un script lorsque des erreurs de scripts surviennent ;

•

cliquer sur un numéro d'erreur de script pour ouvrir une rubrique d'aide ;

•

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 effectuer la mise au point des scripts :

1.

Pour activer le Script Debugger, choisissez le menu Outils > Script Debugger.

2.

Exécutez votre script.

3.

Choisissez l'une des options suivantes :

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 ainsi que saisir et présenter les actions dans des sous-scripts.

Si l'étape du script est Exécuter script, le Script Debugger passera à la première ligne du sous-script et attendra une entrée de l'utilisateur avant de passer à la ligne 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 étapes restantes du script et des sous-scripts 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 Définir l'étape suivante.

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 une boîte de dialogue Modifier le script distincte, 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 le faire défiler avec le bouton Action.

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.

Vous pouvez également choisir le menu Outils > Commandes de débogage > Désactiver les déclencheurs de script ou Activer les déclencheurs de script.

Définir/Effacer le point d'arrêt

Définir ou effacer un point d'arrêt pour la ligne sélectionnée.

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é. Vous pouvez définir ou effacer des points d'arrêt dans le Script Debugger ou lorsque vous créez des scripts. Pour définir un point d'arrêt lorsque vous créez des scripts, cliquez à gauche de l'action. Les points d'arrêt sont enregistrés avec le script dans lequel ils sont définis. Il est possible de poser des points d'arrêt sur plusieurs actions.

Remarque  Vous ne pouvez pas définir de points d'arrêt sur les actions appelées par un bouton ou un menu personnalisé.

Modifier le script

Ouvrez la boîte de dialogue Modifier le script pour modifier le script actif. 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 rubrique 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 (ex. : enregistrements et modèles). Vos privilèges en modification durent jusqu'à la fermeture du Script Debugger et du Visualiseur de données.

4.

Sélectionnez Suspendre en cas d'erreur si vous souhaitez mettre les scripts en pause lorsque des erreurs sont rencontrées.

Dans la zone Dernière erreur, cliquez sur le numéro d'erreur pour ouvrir une rubrique d'aide détaillant l'erreur. Consultez la rubrique Codes d'erreurs FileMaker Pro.

Remarque  Lorsque vous utilisez le 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.

Choisissez le menu Outils > Script Debugger.

Pour ouvrir Script Debugger à partir de la boîte de dialogue Gérer les scripts, sélectionnez un script, appuyez sur Maj et cliquez sur Actionner. Pour fermer le Script Debugger, appuyez sur la touche Ctrl (Windows) ou Command (Mac OS) et cliquez sur le bouton Actionner. Pour plus d'informations sur les raccourcis clavier, consultez les rubriques Raccourcis clavier de FileMaker Pro Advanced (Windows) et Raccourcis clavier de FileMaker Pro Advanced (Mac OS).

2.

Sélectionner une action de 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'étape suivante est uniquement disponible pour le script en cours d'exécution.

•

Pour simplifier la mise au point, le ScriptDebugger 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 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 étapes dans le 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 étapes de ce dernier s'affichent dans le Script Debugger. Pour modifier un script, sélectionnez Authentifier le script/Annuler l'authentification. 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 rubrique Modification des privilèges des scripts.

Si vous ouvrez le Visualiseur de données après avoir choisi Authentifier le script/Annuler l'authentification, vos privilèges d'accès sont préservés dans le Visualiseur de données et dans Script Debugger tant que vous ne fermez pas Script Debugger.

•

Vous pouvez ouvrir une boîte de dialogue Modifier le script par 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 le 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)

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 ainsi que saisir et présenter les actions dans des sous-scripts. Si l'étape du script est Exécuter script, le Script Debugger passera à la première ligne du sous-script et attendra une entrée de l'utilisateur avant de passer à la ligne 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 étapes restantes du script et des sous-scripts 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 Définir l'étape suivante.
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 une boîte de dialogue Modifier le script distincte, 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 le faire défiler avec le bouton Action.
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. Vous pouvez également choisir le menu Outils > Commandes de débogage > Désactiver les déclencheurs de script ou Activer les déclencheurs de script.
Définir/Effacer le point d'arrêt	Définir ou effacer un point d'arrêt pour la ligne sélectionnée. 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é. Vous pouvez définir ou effacer des points d'arrêt dans le Script Debugger ou lorsque vous créez des scripts. Pour définir un point d'arrêt lorsque vous créez des scripts, cliquez à gauche de l'action. Les points d'arrêt sont enregistrés avec le script dans lequel ils sont définis. Il est possible de poser des points d'arrêt sur plusieurs actions. Remarque Vous ne pouvez pas définir de points d'arrêt sur les actions appelées par un bouton ou un menu personnalisé.
Modifier le script	Ouvrez la boîte de dialogue Modifier le script pour modifier le script actif. 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 rubrique 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 (ex. : enregistrements et modèles). Vos privilèges en modification durent jusqu'à la fermeture du Script Debugger et du Visualiseur de données.

Rubriques de cette section

Désactivation des actions du script (FileMaker Pro Advanced)