Champs & Formules
L'onglet Champs & Formules permet de trouver les dépendances d'un champ ou d'une fonction globale sélectionnés.
Autrement dit, vous pouvez repérer toutes les formules qui utilisent un champ ou une fonction globale donnés.
Il comporte deux sous-onglets : Liste, décrite ci-dessous, et Arbre de dépendance, qui dessine les mêmes dépendances (voir plus bas). Le sous-onglet choisi et le dernier champ sélectionné sont mémorisés pour chaque base.
En quoi c'est utile
Lorsque vous modifiez ou supprimez un champ ou une fonction globale, cette fonctionnalité vous aide à vérifier son incidence sur le reste de la base de données.
Le sous-onglet Liste présente deux sections repliables :
- Scripts de Table.Champ : le code de l'élément sélectionné lui-même — les formules et déclencheurs d'un champ, ou le code d'une fonction globale —, chaque script précédé de la pastille de son niveau, son code replié dessous ; « Aucun script trouvé pour ce champ » s'il n'y en a pas ;
- Dépendances (N), ou Aucune dépendance : les scripts qui utilisent l'élément sélectionné.
Niveaux d'incidence des dépendances
Il existe trois niveaux d'incidence, représentés par trois badges différents :
| Badge | Formule | Interface utilisateur | Affichage | |
|---|---|---|---|---|
 | Oui | Oui | Oui | Le champ est utilisé dans une formule, dans un déclencheur (« On click », « Trigger after update », « Trigger on new record »), dans une fonction globale, dans le déclencheur « After Open » ou dans une expression d'impression. Toute modification ou suppression aura une incidence sur le fonctionnement de la base de données. |
 | Oui | Oui | Le champ est utilisé par une règle d'interface : « Display field only, if », « Writable if », « Readable if », « Trigger before view », « Trigger after hide », « Show as », « Show data as », les formules d'un choix dynamique ou la contrainte d'un lien. Le modifier n'aura d'incidence que sur le comportement de l'interface utilisateur, ni sur le fonctionnement de la base ni sur les calculs. | |
 | Oui | Le champ ne sert qu'à l'affichage : dans une colonne de vue (sa formule ou sa mise en forme conditionnelle) ou dans une colonne d'un tableau d'impression. Le modifier n'aura d'incidence que sur la présentation des données, sans altérer le comportement de l'interface utilisateur ni les calculs. |
Le nombre affiché à l'intérieur du badge indique le nombre de dépendances directes ; dans la liste, le nombre inscrit dans la pastille d'une dépendance compte, lui, ses propres dépendances. Depuis la version 3.2.0, ce nombre est compté de la même façon partout — liste, arbre et badges —, sans les scripts du champ lui-même.
Comprendre les dépendances
Un champ peut avoir plusieurs dépendances, et chaque dépendance peut elle-même en avoir d'autres.
Cette structure hiérarchique aide à comprendre comment une modification d'un champ ou d'une fonction se répercute sur la base de données.
Un clic sur une ligne de la liste déplie ses propres dépendances, un second clic les replie ; un chevron, à gauche, signale les lignes qui en ont. Un clic sur la pastille d'une ligne sélectionne ce champ dans Champs & Formules (sauf pour une fonction globale ou le déclencheur « After Open »).
Utilisation directe
Sélectionnez une table ou la ligne des fonctions globales :
- Cliquez dans la zone de gauche : la liste présente les tables, précédées de deux entrées, le déclencheur « After Open » de la base et ses fonctions globales. Un clic sur une table déplie ses champs.
Sélectionnez un champ ou une fonction :
- Tapez quelques lettres dans la zone de droite : la liste ne garde que les éléments qui les contiennent, dans toutes les tables. Un clic sur un champ ou une fonction le sélectionne.
Les champs et les tables qui viennent d'autres bases de la même équipe apparaissent eux aussi, avec une icône dédiée. Les dépendances venues d'une autre base déjà chargée par Ninox (une autre base qui utilise un champ de celle-ci) figurent aussi dans la liste et dans l'arbre, précédées du nom de leur base ; elles ne s'ouvrent pas d'ici : un message, en anglais (« This element belongs to another database… »), invite à ouvrir leur base.
Depuis l'éditeur de champ
Dans la fenêtre « Edit fields » de Ninox, chaque champ utilisé ailleurs porte la pastille de ses dépendances.
Un clic sur cette pastille ouvre le panneau Ninext sur Champs & Formules, le champ sélectionné. La page Édition de champ détaille ces pastilles et la navigation d'un champ à l'autre.
Accéder au champ ou à la fonction sélectionnés
Cliquez sur le bouton rouge, à droite des listes. Il n'apparaît qu'en mode édition de Ninox (« Edit mode »), et se grise tant qu'une modification reste à enregistrer ou à annuler dans Ninox. Pour un champ, Ninext le met en évidence dans le formulaire de Ninox, avec une clé : un clic sur cette clé ouvre la fenêtre d'édition du champ. Si le champ n'est pas visible sur le formulaire, Ninext propose d'ouvrir l'éditeur de champs.
Pour les fonctions globales, l'éditeur du code global s'ouvre, la fonction concernée étant mise en évidence.
Accès direct au script
- Cliquez sur le passage en gras d'une ligne de résultat (ici « Show as ») : l'éditeur de Ninox s'ouvre sur le code qui contient la dépendance, la partie concernée étant mise en évidence.
- Le bouton rouge qui apparaît au survol, à droite de la ligne (en mode édition de Ninox), suit la même règle que celui du haut. Pour une ligne qui appartient à un champ (sa formule, un de ses déclencheurs, son « Show as »…), il sélectionne ce champ dans son formulaire, et porte une clé dans un cadre ; pour les autres (déclencheur de table, colonne de vue, impression, fonction globale, « After Open »), il ouvre l'éditeur du script, et ne porte qu'une clé.
Les longues listes
Une longue liste s'affiche par tranches de 100 lignes. En bas de liste, +100 affiche les 100 suivantes, et Tout (N) affiche les N restantes.
Le badge au survol d'un champ
En mode édition de Ninox (« Edit mode »), survoler un champ dans un formulaire fait apparaître un badge en haut à droite du champ. Il réunit, sans avoir à sélectionner le champ au préalable :
| Zone | Au survol | Au clic |
|---|---|---|
| Type | Le type du champ, ou le type que renvoie sa formule. | — |
| Fx (champs formule seulement) | La formule complète, avec un bouton Copier ; les erreurs y sont soulignées (vaguelette rouge, pointillé ambre pour un avertissement), et le survol du passage souligné en donne le message. | Ouvre l'éditeur de formule de Ninox. |
| Clé rouge | — | Ouvre la fenêtre d'édition du champ. |
| Compteur de dépendances | Un aperçu de l'arbre des dépendances. | Ouvre le panneau Ninext et sélectionne le champ dans Champs & Formules. |
La couleur du compteur dit le niveau d'incidence, comme les badges ci-dessus ; « 0 », grisé, signale un champ dont rien ne dépend. Le badge se désactive dans les Paramètres Ninext, section « Outils supplémentaires » : Badge de dépendances au survol.
L'arbre des dépendances
Le sous-onglet Arbre de dépendance dessine les dépendances du champ sélectionné, dans les deux sens :
- à gauche, en amont, les champs que lit sa formule ;
- au centre, le champ lui-même ;
- à droite, en aval, les formules qui l'utilisent.
Des bandes numérotées (-2, -1, 0, 1, 2…) marquent les niveaux. Au survol d'une cellule, sa chaîne s'illumine et le reste s'atténue ; dans l'infobulle de code d'une cellule, le nom de son parent direct est surligné. Une fonction globale se déplie elle aussi, vers ses propres dépendants (à partir de la 3.2.0).
Dans une cellule :
- la pastille recentre l'arbre sur ce champ, qui devient le champ sélectionné ;
- l'icône Fx montre le code au survol et ouvre son éditeur au clic ; le bouton rouge suit la même règle que dans la liste ;
- le badge rond + (Étendre) déplie les dépendances de la cellule, − (Réduire) les replie — c'est ainsi que se déplie une fonction globale ; en amont, un second badge affiche ou masque les enfants hors chaîne ;
- l'œil barré (Masquer cette cellule) cache la cellule.
Au-delà de 10 éléments dans une colonne, une cellule « … +N » affiche les autres.
Les grappes. Les cellules qui partagent les mêmes parents sont regroupées dans un cadre, une grappe. Saisissez sa poignée pour la réordonner ou la déplacer vers une autre colonne ; une fois la grappe réordonnée ou déplacée, une flèche circulaire apparaît à son coin et la remet à sa place d'origine. Une grappe montre 5 cellules ; ses boutons −5, +5 et Tout (N) en affichent moins ou davantage, une flèche la ramène à 5 cellules, et son pied indique combien restent masquées.
La barre d'outils propose :
- Copier comme image : une fenêtre propose Copier (presse-papier) ou Télécharger PNG ;
- l'œil, qui affiche ou masque les cellules cachées : il n'apparaît que si une cellule au moins est cachée, avec leur nombre ;
- le zoom arrière, le pourcentage de zoom, le zoom avant et Ajuster à la vue ;
- Plein écran, que l'on quitte par son bouton ou par la touche Échap.
L'arbre retient, pour chaque champ, ses cellules cachées et la disposition de ses grappes. Quand vous changez de champ, il garde le zoom en cours et centre le nouveau champ ; un rafraîchissement du schéma ne change ni le zoom ni la position.
Le même arbre s'affiche en aperçu au survol du compteur de dépendances du badge.
L'historique de navigation
L'icône en forme d'empreintes de pas, en tête du panneau Ninext, ouvre au survol ou au clic la liste des derniers champs, fonctions globales et rapports consultés par Ninext — déclencheur « After Open » compris. Un élément consulté de nouveau descend en bas de la liste, sans doublon ; un clic le sélectionne de nouveau. La liste garde 50 entrées pour la journée ; Effacer tout l'historique de navigation la vide. Cet historique, réservé aux administrateurs, se désactive dans les Paramètres Ninext, section « Améliorations de l'interface » : Historique de navigation du schéma (administrateurs).
Ne le confondez pas avec le bouton Fiches consultées, de même icône mais placé dans la barre du haut de Ninox : proposé à tous les utilisateurs, il liste les fiches ouvertes récemment (voir Fiches consultées).