Avec la résolution 8, proposée par FileMaker France, vous avez décidé de prévoir la traçabilité de la saisie de vos données afin d’en favoriser une meilleure sécurité, cf. « Les résolutions FileMaker » (8). L’idée de la résolution 9 est presque la même, avec un objectif un peu différent :
9) Je documente mon script en utilisant l’action de script « Commentaire ». Je documente également mes calculs en utilisant // ou /**/ et je documente mes rubriques en utilisant l’option « Commentaire ».
Génial ! Je viens enfin de terminer ce script tordu ! Je m’y suis tellement cassé la tête que c’est certain, je m’en souviendrai toute ma vie…
Sauf que ! Les barrettes mémoire, il y en a dans mon ordinateur, mais ce n’est pas aussi simple dans mon pauvre crâne d’humain. Et voilà ! 7 mois après, je dois modifier un morceau de ce script, et je me souviens plus pourquoi j’ai fait comme cela…. Grrr!!!
Et que dire lorsque le développement est fait conjointement en équipe, ou que l’on doit repasser la suite à quelqu’un d’autre ?
Heureusement, FileMaker me permet de faire des commentaires…
Et oui, en bas des lignes de commande, il y en a une qui nous attend, rien que pour jouer les historiens. Et elle s’appelle : « Commentaire ». Diable ! Vais-je m’en souvenir ? 
On note que cette ligne de commande commence par un dièse #, indiquant à FileMaker qu’il ne faut pas s’en occuper pendant le déroulement su script. Elle est en gras, pour être plus visible au développeur. On double-clique dedans et on entre le texte que l’on veut.
N’hésitez surtout pas à mettre plusieurs lignes de commentaire à la suite si nécessaire. Vous vous direz merci quelques mois plus tard.
Commencez le script en rappelant qui fait ce script, à quelle date, pour quel usage. Parsemez l’ensemble du code de commentaires intermédiaires, pour séparer cela en étapes expliquées : ici je demande à l’utilisateur de confirmer s’il veut lancer le script ; là je vérifie qu’il y a bien une fiche liée telle qu’attendue, j’indique ce qu’il se passe s’il n’y en pas, ensuite je précise que je lance l’impression avec tel paramétrage d’imprimante, etc.
N’hésitez pas à détailler…
Voilà, de la même façon, profitez de la zone commentaire des rubriques, et parsemez les calculs qui le méritent de commentaires divers.
Tiens, si vous faisiez un commentaire à cet article, à propos de ces résolutions
Il suffit de cliquer sur le bouton-texte « aucun commentaire » si vous êtes le premier, ou de double-cliquer sur le titre de l’article pour afficher les commentaires et ajouter le vôtre.
Bons commentaires… À vendredi !
Michel Lansard
