FileMaker 2026 ajoute une nouvelle case dans les options avancées d'une rubrique, et j'ai mis un moment avant de bien saisir à quoi elle servait vraiment. Ce n'est pas un nouveau commentaire, ce n'est pas une aide contextuelle pour vos collègues développeurs : c'est une documentation qui ne parle qu'à un modèle d'IA, et qui ne sert strictement à rien tant que vous n'utilisez aucune fonctionnalité IA dans votre base. Voici ce que j'en ai compris, avec des exemples concrets.

Une case à part, à ne pas confondre avec le commentaire habituel

Chez nous, chaque rubrique porte déjà un commentaire (j'en parlais dans mon article sur les règles de nommage). FileMaker 2026 ajoute, dans le bouton Avancées de la boîte de dialogue Rubriques, un champ distinct : « Ajouter une annotation dans le langage de définition des données (DDL) » (Claris — Options avancées de rubrique). Le DDL, c'est le langage utilisé pour décrire la structure d'une base de données. Ce que vous écrivez dans cette case est automatiquement injecté dans le DDL que FileMaker envoie à un modèle d'IA lorsqu'une action comme « Exécuter une requête SQL en langage naturel » ou « Effectuer une recherche en langage naturel » a besoin de comprendre votre schéma (Claris — Meilleures pratiques pour le schéma de base de données avec la génération de requêtes DDL et SQL).

 

Boîte de dialogue Options avancées d'une rubrique dans FileMaker 2026, avec la case d'annotation DDL renseignée pour la rubrique EstFacture

 

Prenons un exemple que je cite souvent à mes équipes : une rubrique EstTermine, booléen à 0 ou 1 (en auto-entrée, remplacée par un calcul GetAsBoolean ( Self ) pour toujours stocker un vrai booléen). Si un utilisateur tape « montre-moi les dossiers non terminés » dans une recherche en langage naturel, le modèle ne voit qu'un champ nombre nommé EstTermine — rien ne lui dit ce que signifie 0, ni 1. Avec l'annotation « Booléen, 1 = dossier clôturé, 0 = dossier en cours, renseigné automatiquement par le script de clôture », le modèle peut traduire correctement la question en une requête sur EstTermine = 0.

Le piège à connaître avant de commencer : c'est tout ou rien, par table

C'est le point technique le plus important, et celui qui m'a fait le plus tiquer en testant la fonctionnalité : dès qu'une seule rubrique d'une table reçoit une annotation, le DDL généré pour cette table ne contient plus que les rubriques annotées. Toutes les autres disparaissent purement et simplement de ce que voit le modèle d'IA pour cette table (Claris — Meilleures pratiques pour le schéma de base de données avec la génération de requêtes DDL et SQL).

Concrètement, on ne peut pas annoter « au fil de l'eau », une rubrique de temps en temps, en se disant qu'on complétera plus tard. Commencer à annoter une table est une vraie décision : il faut couvrir toutes les rubriques que l'IA doit continuer à voir, sous peine de les rendre invisibles par effet de bord. C'est donc un gros travail à faire pour une base qui sera livrée à une IA. C'est un travail inutile dans tous les autres cas (autrement dit, pour le moment, la plupart des cas).

Ce qui vaut la peine d'être annoté, et comment écrire une bonne annotation

Dans la pratique, je ne conseille pas d'annoter toutes les rubriques d'une table. Je commence par celles qui sont réellement exposées à une requête IA — rubriques présentes sur les modèles ou une API, clés étrangères peu évidentes, rubriques calcul affichées à l'écran, drapeaux et statuts dont la valeur n'est pas auto-explicite. Les rubriques d'audit standard ou les champs texte déjà clairs peuvent attendre, et les variables globales temporaires n'ont en général aucun intérêt à être exposées.

Deux exemples qui reviennent souvent chez nous, en plus de EstTermine :

  • Une clé étrangère comme IdContact dans une table Adresses. Chez nous, un identifiant garde toujours le même nom d'une table à l'autre, ce qui est très lisible pour un développeur qui connaît la convention, mais reste ambigu pour un modèle qui découvre le schéma à froid : est-ce l'identifiant propre de la ligne, ou une référence vers une autre table ? Une annotation du type « Clé étrangère vers Contacts, un contact peut avoir plusieurs adresses » lève l'ambiguïté immédiatement.
  • Une liste de valeurs comme Statut (Brouillon, Validé, Annulé). Sans annotation, le modèle doit deviner la valeur exacte à comparer, avec le risque de se tromper de casse ou de mot. « Valeurs valides : Brouillon, Validé, Annulé » supprime ce pari.

On peut réutiliser ses commentaires existants

Pour une base déjà bien documentée avec le commentaire de rubrique classique, il existe un raccourci utile : « si une annotation est vide et que le commentaire commence par la balise spéciale [LLM], le texte du commentaire (sans la balise) est utilisé dans le DDL comme s'il s'agissait d'une annotation » (Claris — Meilleures pratiques pour le schéma de base de données avec la génération de requêtes DDL et SQL). Ça évite de tout ressaisir pour tester la fonctionnalité sur une base ancienne, et c'est un bon moyen de se faire une première idée avant de basculer proprement vers les annotations dédiées.

Ce qu'il faut retenir

L'annotation DDL n'a rien d'une nouvelle bonne pratique de commentaire à généraliser partout : c'est une documentation ciblée, écrite uniquement pour qu'un modèle d'IA interprète correctement votre schéma au moment où une fonctionnalité IA de FileMaker (ou un script maison) en a besoin. Le principal piège à éviter est le comportement tout-ou-rien par table, et la meilleure stratégie reste de n'annoter que ce qui sera réellement exposé à une requête IA — pas l'intégralité de la base. Pour une équipe qui commente déjà systématiquement ses rubriques, comme chez nous, c'est une extension à coût quasi nul plutôt qu'un nouveau chantier.

Je vous invite à lire les pages d'aide de Claris qui sont bien faites à propos de cette fonctionnalité.

Sources

Une question ? Un projet à étudier ?

15 + 1 =
hCaptcha *

Contactez-nous !

Merci de remplir le formulaire ci-contre.
Pour nous joindre directement, consulter notre page Contact.

 

Logo Claris Partner

Logo Claris MarketPlace

Logo Claris Partner Reseller

Copyright ©2020-2026 IU-DATA | Tous droits réservés | Mentions légales | Politique de confidentialité | CGV | Réalisation inPhobulle