Automatisation de tâches grâce aux scripts > Création et modification de scripts
 

Création et modification de scripts

Remarque  Pour plus d'informations sur les actions de script et leurs options, ainsi que des exemples, consultez les sections Page de référence des actions de script (liste alphabétique) et Page de référence des actions de script (liste des catégories). Consultez également la section Exemples de scripts.

Pour créer ou modifier un script :

1. Sélectionnez le menu Scripts > Espace de travail de script.

Vous pouvez également sélectionner le menu Fichier > Gérer > Scripts.

L'Espace de travail de script s'ouvre. Vous créez et modifiez les scripts à l'aide des trois volets de cette fenêtre : le volet de scripts (à gauche), le volet de modification de script (au centre) et le volet d'actions de script (à droite).

2. Créez ou ouvrez un script :

Pour créer un script, cliquez sur Bouton Nouveau script. Dans le volet de modification d'un script, entrez un nom pour le nouveau script et appuyez sur Entrée ou Retour.

Pour afficher l'aperçu d'un script, cliquez sur son nom dans le volet de scripts. Cliquez sur Basculer en mode Edition pour passer de l'aperçu du script à sa modification.

Pour modifier l'aperçu d'un script, cliquez sur son nom dans le volet de scripts. Si le script est déjà ouvert dans le volet d'édition de script, cliquez sur l'onglet du script pour l'activer.

3. Tapez les premières lettres d'un nom d'action de script, puis sélectionnez l'action de script dans la liste qui apparaît.

Ou double-cliquez sur l'action de script dans le volet d'actions de script.

4. Si l'action de script comporte des options — indiquées par un texte entre crochets ([ ]) ou par Bouton de menu Action à la suite de l'action de script — effectuez une des opérations suivantes :

Cliquez sur le texte entre crochets, puis indiquez les options qui apparaissent.

Cliquez sur Bouton de menu Action, puis indiquez les options qui apparaissent.

Cliquez entre les crochets et modifiez le calcul ou cliquez sur Bouton Calcul pour ouvrir la Boîte de dialogue Calcul. Seuls certains calculs sont modifiables en ligne.

Remarque  Lorsque vous modifiez une action de script, vous pouvez voir l'option Rétablir. Cette option indique que les critères spécifiés lors de la dernière modification de l'action de script seront utilisés lors de l'exécution de l'action de script.

5. Exécutez l'une des actions suivantes lorsque vous travaillez dans le volet de modification d'un script :

 

Pour

Faites ceci

Ajouter une ligne au script

Effectuez l'une des opérations suivantes :

Appuyez sur Entrée ou Retour

Si la dernière ligne du script n'est pas vide, sélectionnez-la et appuyez sur la Flèche vers le bas.

Ajouter une ligne au-dessus la ligne sélectionnée

Appuyez sur Maj+Entrée ou Maj-Retour.

Vous déplacer entre les lignes du script

Appuyez sur la Flèche vers le haut ou la Flèche vers le bas.

Ajouter un commentaire à un script

Sur une ligne vide, tapez # ou sélectionnez Commentaire dans le volet d'actions de script. L'utilisation de l'action de script # (commentaire) dans votre script aide les autres personnes à consulter ou modifier ce script.

Ajouter une action de script à la catégorie Favoris

Dans le volet d'actions de script, sélectionnez l'action de script, puis cliquez sur Bouton étoile grise. Pour supprimer une action de script de la catégorie Favoris, sélectionnez celle-ci, puis cliquez sur Bouton étoile bleue.

Remarque  Vous ne pouvez pas ajouter d'action de script à la catégorie Favoris si le volet d'actions de script est trié par ordre alphabétique.

Afficher les informations sur une action de script

Dans le volet d'actions de script, cliquez sur l'action de script. Une description s'affiche sous la liste. Pour afficher davantage d'informations, cliquez sur Bouton d'aide.

Afficher les actions de script par ordre alphabétique ou par catégorie

Dans le volet d'actions de script, cliquez sur Bouton de tri alphabétique pour afficher les actions de script par ordre alphabétique ou cliquez sur Bouton de trie par catégorie pour les trier par catégorie.

Voir quels produits FileMaker prennent en charge une action de script

Cliquez sur Bouton Compatibilité et sélectionnez un produit. Toutes les actions de script compatibles avec le produit sont affichées.

Copier et coller une action de script

Consultez la section Copie et collage de scripts.

Dupliquer une action de script

Sélectionnez l'action de script, puis choisissez le menu Edition > Dupliquer (Windows) ou Dupliquer l'action (macOS).

Supprimer une action de script

Sélectionnez l'action de script, puis appuyez sur la touche Suppr.

Réorganiser les actions de script dans le script

Dans le volet de modification de script, faites glisser l'action de script vers un nouvel emplacement, dans le script.

Sélectionner plusieurs actions de script

Cliquez dessus en appuyant sur la touche Ctrl (Windows) ou Commande (macOS). Vous pouvez ajouter, dupliquer ou supprimer plusieurs actions.

Ouvrir un script inclus dans une option d'action de script

Cliquez sur l'option d'action de script en appuyant sur la touche Ctrl (Windows) ou Commande (macOS).

Exécuter le script

Cliquez sur Bouton d'exécution de script.

Remarque  Un astérisque (*) à la suite du nom du script indique que le script a été modifié, mais pas enregistré.

6. Fermez l'onglet, puis cliquez sur Enregistrer.

Vous pouvez également sélectionner le menu Fichier > Enregistrer le script dans l'Espace de travail de script (Windows) ou le menu Scripts > Enregistrer le script dans la barre de menus FileMaker Pro Advanced (macOS).

Pour gérer les scripts :

 

Pour

Faites ceci

Renommer, dupliquer ou supprimer un script

Cliquez avec le bouton droit de la souris sur le nom du script et faites votre sélection dans le menu. Vous pouvez également cliquer deux fois sur le nom du script dans le volet de modification de script pour renommer un script.

Réorganiser les scripts

Faites glisser le nom de script sur un nouvel emplacement dans la liste.

Imprimer un script

Windows : dans l'Espace de travail de script, choisissez le menu Fichier > Imprimer script.

macOS : dans la barre de menus FileMaker Pro Advanced, choisissez le menu Fichier > Imprimer.

Exécuter un script avec les privilèges d'accès intégral

Cliquez avec le bouton droit sur le script et sélectionnez Accorder les privilèges d'accès intégral. Consultez la section « Exécution de scripts avec les privilèges d'accès intégral » ci-dessous.

Gérer les dossiers dans le volet de scripts

Consultez la section Gestion des scripts à l'aide des dossiers.

Exécution des scripts avec privilèges d'accès intégral

La définition d'un script pour qu'il soit exécuté avec les privilèges d'accès intégral permet aux utilisateurs ayant des accès et des privilèges limités d'exécuter des tâches sous forme de scripts qu'ils ne peuvent habituellement pas exécuter, comme l'exportation ou la suppression d'enregistrements.

Les privilèges d'accès ne sont pas modifiés, mais le script se voit accorder plus de privilèges que l'utilisateur. En outre, l'accès intégral n'est pas transmis aux sous-scripts suivants, sauf si cette fonction a également été activée dans le script.

Seuls les utilisateurs disposant du jeu de privilèges d'Accès intégral peuvent définir des scripts pour qu'ils soient exécutés avec des privilèges d'accès intégral. Seuls les utilisateurs ayant un accès intégral peuvent modifier ou supprimer des scripts pour lesquels cette fonction a été activée.

Un script ne peut être exécuté avec des privilèges d'accès intégral que dans le fichier dans lequel le script est défini. Les scripts ne peuvent pas écraser les restrictions d'accès aux fichiers externes. Par exemple, un script qui est défini pour être exécuté avec les privilèges d'accès intégral ne peut supprimer des enregistrements dans un fichier externe d'accès restreint.

Les utilisateurs disposant de privilèges en accès intégral peuvent être autorisés à modifier les scripts marqués comme modifiables dans le jeu de privilèges qui leur est attribué. Des privilèges en accès intégral sont requis pour créer, dupliquer, importer et/ou supprimer des scripts.

Remarques 

Pour visualiser les problèmes à mesure que vous concevez un script, cliquez sur l'onglet du volet de modification de script avec le bouton droit de la souris, puis sélectionnez Détecter des problèmes. FileMaker Pro Advanced vérifie le script et met en surbrillance les lignes problématiques, comme les options manquantes. (Tous les problèmes ne sont pas détectés.) Les lignes apparaissent en surbrillance dans la couleur définie par défaut pour le problème, dans l'onglet Coloration de la syntaxe des préférences de l'Espace de travail de script.

Pour modifier le code couleur des actions de script et des conditions comme les problèmes, ouvrez l'Espace de travail de script, allez dans le menu Affichage > Préférences (Windows) ou le menu Affichage > Préférences de l'Espace de travail de script (macOS), puis cliquez sur l'onglet Coloration de la syntaxe.

Pour modifier un script dans une nouvelle fenêtre, cliquez sur un onglet du volet de modification de script avec le bouton droit de la souris, puis choisissez Déplacer l'onglet dans la nouvelle fenêtre, ou appuyez sur Alt (Windows) ou Option (OS X) et double-cliquez sur un script dans le volet de scripts. Le script s'ouvre dans la boîte de dialogue Modifier le script.

Pour permettre au script d'être exécuté avec les privilèges d'accès intégral, sélectionnez le menu Fichier > Accorder des privilèges d'accès intégral (Windows) ou le menu Scripts > Accorder des privilèges d'accès intégral (macOS).

Si vous avez ouvert la boîte de dialogue Modifier le script en convertissant une action de bouton en script, vous pouvez appuyer sur Ctrl+R (Windows ) ou Commande-R (macOS) pour renommer le script.

Rubriques connexes 

Utilisation des opérateurs dans les formules

Page de référence des actions de script (liste des catégories)

Page de référence des actions de script (liste alphabétique)

Utilisation des boutons et des barres de boutons dans les modèles

Utilisation du menu Scripts

Modification des privilèges des scripts

Publication de bases de données sur le Web

Débogage de scripts

Désactivation des actions de script