Documentation Ninext
Ninext est un complément qui étend les capacités de Ninox. Il apporte des améliorations à l'interface utilisateur, à l'interface de développement, ainsi que des outils de maintenance et de débogage du code.
Ninext a d'abord été créé pour répondre à nos propres besoins en développement Ninox. Nous avons décidé de le partager largement, afin de contribuer à l'adoption de Ninox par les développeurs.
C'est donc un outil entièrement gratuit, que nous maintenons.
Ninext existe sous deux formes :
- le plugin (version 3.x), qui s'installe depuis le menu des plugins de Ninox, dans la Web App : c'est la version active et maintenue — voir Version plugin ;
- la version classique (2.3.7), chargée par un script placé dans le déclencheur « After Open » de la base : elle est figée, et ne reste proposée qu'aux utilisateurs des applications Mac et smartphone de Ninox, qui ne prennent pas encore en charge les plugins — voir Version classique.
Où trouver quoi
Ninext ne se limite pas à son panneau : il ajoute aussi des commandes aux éditeurs de script, aux formulaires et aux vues de Ninox. Voici où trouver les fonctions du plugin, et qui y a accès. La plupart s'activent ou se désactivent dans les Paramètres Ninext.
Dans le panneau Ninext
Le panneau s'ouvre depuis le menu des plugins de Ninox, en mode édition (« Edit mode ») (voir Panneau Ninext). Ses outils sont réservés aux administrateurs de la base.
| Fonction | Ce qu'elle fait |
|---|---|
| Champs & Formules | Donne accès à toutes les fonctions globales et à tous les champs de toutes les tables, à leurs dépendances dans l'ensemble du code, et à l'arbre des dépendances. |
| Traceur de débogage | Relève l'état des variables chaque fois que votre code atteint une instruction debug(). |
| Console | Exécute du code Ninox à la volée, et le met au point pas à pas. |
| Erreurs | Montre les erreurs et les avertissements présents dans le code de la base, et mène au code en cause. |
| Profilage | Mesure le temps d'évaluation des formules. |
| Recherche de code | Cherche dans tout le code source, expressions régulières comprises. |
| Aperçu du schéma | Dessine le schéma de la base : ses tables et leurs liaisons. |
| Aide aux fonctions | Donne l'aide des fonctions de Ninox et de celles que Ninext ajoute. |
| Historique de navigation | L'icône en forme d'empreintes de pas, à gauche des onglets : les derniers champs, fonctions globales et rapports consultés dans Ninext. |
| Paramètres Ninext | L'engrenage qui apparaît au survol du numéro de version, à droite des onglets : chaque outil s'y active ou s'y désactive. |
Dans la barre du haut de Ninox
| Fonction | Ce qu'elle fait | Pour qui |
|---|---|---|
| Menu des plugins | L'icône en forme de pièce de puzzle, en mode édition : elle ouvre le panneau Ninext, et « Manage plugin » installe le plugin ou le met à jour. | Administrateurs |
| Fiches consultées | L'icône en forme d'empreintes de pas, juste à gauche des icônes de Ninox : la liste des fiches récemment consultées, qui se rouvrent d'un clic. | Tous les utilisateurs |
Dans les éditeurs de script de Ninox
Dans le grand éditeur de formule et dans le panneau d'un champ ou d'une table, pour les administrateurs :
| Fonction | Ce qu'elle fait |
|---|---|
| Soulignage des erreurs | Souligne les erreurs et les avertissements pendant la frappe ; le survol du passage souligné en donne l'explication. Les autres occurrences du mot sélectionné sont surlignées. |
| Mettre en forme | Au survol de l'éditeur, en haut à droite, ou par Ctrl + Maj + F (⌘ + Maj + F sur Mac) : remet le code d'aplomb, sans l'exécuter. |
| Déboguer dans la Console | Au survol de l'éditeur, en haut à droite : emporte le code dans la Console, pour le mettre au point. |
| Bulle d'aide à la syntaxe | Le curseur posé sur une fonction affiche ses signatures, avec un bouton qui ouvre son aide. |
Dans les formulaires et les vues de Ninox
| Fonction | Ce qu'elle fait | Pour qui |
|---|---|---|
| Badge au survol d'un champ | En mode édition, au survol d'un champ : son type, sa formule, l'accès à son édition et le nombre de ses dépendances. | Administrateurs |
| Pastilles de la fenêtre « Edit fields » | Une pastille sur chaque champ que d'autres éléments de la base utilisent. | Administrateurs |
| Copier, coller, dupliquer et supprimer des champs | Au clavier, sur le champ sélectionné, en mode édition. | Administrateurs |
| Badges | Des badges sur les onglets Fichiers et Commentaires, et sur les onglets que vous personnalisez. | Tous les utilisateurs |
| Filtres de colonnes | Dans une vue tableau, une pastille par colonne filtrée. | Tous les utilisateurs |
| Événement de champ vue | Un clic sur une cellule d'un champ vue exécute votre fonction onclick ; la sélection d'une fiche dans la vue d'une table, votre fonction onselected. | Tous les utilisateurs |
| Événement de bouton | La fonction onUpdate d'un bouton change son libellé, son infobulle, sa couleur ou son badge. | Tous les utilisateurs |
Dans votre code
Ces fonctions s'écrivent dans vos scripts, et agissent chez chaque utilisateur de la base :
| Fonction | Ce qu'elle fait |
|---|---|
| Native JS | Exécute du JavaScript à l'intérieur d'un script Ninox, entre #{ et }#. |
onNinextLoaded | Une fonction du déclencheur « After Open », que Ninext appelle une fois chargé. |
ninext.callNinoxFunction | Appelle une fonction Ninox depuis du HTML ou du JavaScript. |
L'équipe U Man Genius
