Création et modification de scripts

Remarque  Pour plus d'informations sur les actions de script et leurs options, ainsi que des exemples, consultez la section Page de référence des actions de script. Consultez aussi 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 aussi sélectionner le menu Fichier > Gérer > Scripts.

  2. Dans Espace de travail de script, créez ou ouvrez un script.
    • Pour créer un script, cliquez sur Bouton Nouveau script. Dans le volet de modification d'un script, donnez un nom au nouveau script et appuyez sur Entrée ou Retour.
    • Pour afficher l'aperçu d'un script, cliquez sur le nom du script dans le volet de scripts. Cliquez sur Bouton Basculer en mode Edition pour fermer l'aperçu d'un script et revenir au volet de modification du script.
    • Pour modifier un script, double-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.

    Sinon, double-cliquez dans l'action de script qui se trouve dans le volet d'actions de script.

  4. Si l'action de script contient des options, indiquées par un texte entre crochets ([ ]) ou par Bouton Menu Action en regard de l'action de script, procédez de l'une des manières suivantes :
    • Cliquez sur le texte entre crochets, puis renseignez les options qui s'affichent.
    • Cliquez sur Bouton Menu Action, puis renseignez les options qui s'affichent.
    • 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 :
  6. Pour

    Faites ceci

    Ajouter une ligne au script

    Procédez de l'une des manières 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 Tri par ordre alphabétique pour afficher les actions de script par ordre alphabétique ou sur Bouton Tri 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 choisissez 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é.

  7. 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 (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, 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 au moyen des dossiers.

Désigner un script pour le transfert vers Raccourcis par FileMaker Pro et FileMaker Go

Faites un clic droit sur le script et sélectionnez Activer le transfert vers Raccourcis. Pour FileMaker Pro, consultez la section Exécution de scripts via l'application Raccourcis. Pour FileMaker Go, consultez le Guide de développement de FileMaker Go.

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 ne possédant pas un accès intégral peuvent se voir attribuer l’autorisation de modifier des scripts indiqués comme modifiables dans leur ensemble d’autorisations d’accès. Un accès intégral est nécessaire 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 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 autoriser l'exécution du script avec des 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 accédé à la boîte de dialogue Modifier le script en convertissant une action de bouton en script, vous pouvez appuyer sur les touches Ctrl+R (Windows) ou Commande-R (macOS) pour renommer le script.