Aiuto funzioni
La scheda Aiuto funzioni esiste dalla versione 3.0; il fumetto di aiuto alla sintassi degli editor di Ninox, dalla versione 3.1. A partire dalla versione 3.2.0 (beta), il fumetto si fa da parte davanti all'elenco di completamento automatico.
La scheda Aiuto funzioni documenta ciò che potete scrivere nelle vostre formule: le funzioni di Ninox, quelle aggiunte da Ninext, e le funzioni globali del vostro database. Negli editor di script di Ninox, un fumetto di aiuto alla sintassi ne dà l'essenziale proprio nel punto in cui scrivete.
La scheda è riservata agli amministratori. Mostra solo la sua icona, una pergamena, dopo la scheda Panoramica schema; il nome compare al passaggio del mouse. La scheda e il fumetto si disattivano nelle Impostazioni Ninext, sezione «Strumenti aggiuntivi»: Aiuto interattivo.
Scegliere una funzione
In cima alla scheda, il selettore ha due zone, come quello di Campi & Formule: a sinistra le categorie, a destra le funzioni. Digitate alcune lettere nella zona di destra: l'elenco mantiene solo le funzioni che le contengono. Ogni funzione è preceduta dall'icona del tipo di valore che restituisce.
L'elenco riunisce tre fonti:
| Categoria | Contenuto |
|---|---|
| ★ Ninext | Ciò che Ninext aggiunge al linguaggio: callNinoxFunction, Native JS (#{ … }#), Badge, gli eventi dei campi vista e dei pulsanti, onNinextLoaded, le attività IA. |
| ★ Global functions | Le funzioni globali del vostro database, lette nel suo codice globale. |
| Categorie di Ninox (Aggregation, Date, Text…) | Le funzioni di Ninox, e le parole chiave del suo linguaggio (select, let, if…). |
Le due categorie contrassegnate da una stella vengono per prime, su sfondo arancione chiaro; seguono le categorie di Ninox, in ordine alfabetico. Le funzioni di Ninext sono descritte nella lingua di Ninox (in inglese per una lingua che Ninext non conosce); quelle di Ninox sono descritte in inglese.
Le voci delle attività IA (aiTaskStart, aiTaskStatus, aiTaskCancel e «AI Tasks») compaiono nell'elenco, ma non servono ancora: si basano sul server ninext.fr, che non è ancora aperto.
Che cosa mostra una scheda di funzione
- Come titolo, il nome della funzione e il tipo di valore che restituisce, poi la sua descrizione.
- Le sue firme («Signatures»): ogni modo di chiamarla, con i suoi parametri e il loro tipo. Per una parola chiave o un'aggiunta di Ninext, è la sua sintassi («Syntax»).
- Degli esempi («Example» o «Examples»), colorati come nell'editor di Ninox.
- Per una funzione globale, il suo codice completo («Script»), con le righe numerate, insieme al commento che la precede.
- Un link 📖 Documentation verso la pagina della funzione nella documentazione di Ninox o in quella di Ninext (non per una funzione globale).
- I link «See Also» verso le funzioni vicine. Dopo un tale salto, il pulsante ←, a sinistra del titolo, riporta alla scheda precedente.
Al passaggio del mouse, ogni firma, ogni esempio e il codice mostrano un pulsante di copia. Le intestazioni della scheda («Signatures», «Syntax», «Examples», «Script», «See Also») restano in inglese, qualunque sia la lingua.
L'interruttore Aiuto interattivo
Sotto il selettore, a destra, l'interruttore Aiuto interattivo attiva o disattiva il fumetto di aiuto alla sintassi negli editor di Ninox. È attivo per impostazione predefinita. Il suo stato viene ricordato dal vostro browser: vale per tutti i database aperti in questo browser, e solo lì.
Non confondetelo con l'impostazione con lo stesso nome delle Impostazioni Ninext: disattivata, questa impostazione rimuove la scheda e il fumetto per tutti gli amministratori del database.
Il fumetto di aiuto alla sintassi
In un editor di script di Ninox, posate il cursore sul nome di una funzione — di Ninox, di Ninext, o una funzione globale del database — o su una parola chiave: sotto il cursore si apre un fumetto. Mostra la firma, la descrizione e un esempio. Si richiude quando il cursore lascia il nome.
- Quando la funzione ha più firme, le frecce ‹ e ›, o i punti posti tra di esse, passano dall'una all'altra.
- Il pulsante a forma di pergamena, in alto a destra del fumetto, mostra la scheda completa della funzione nella scheda Aiuto funzioni, e chiude il fumetto.
- Il fumetto si fa da parte finché l'elenco di completamento automatico di Ninox è aperto, e durante una selezione di testo.
Nella Console, lo stesso fumetto si apre quando il cursore è all'interno di un nome; fornisce anche informazioni sulle variabili locali, sui campi della tabella del contesto e sulle parole chiave. Mentre digitate gli argomenti di una funzione, sopra il cursore compare inoltre una guida alla sintassi, con il parametro in corso evidenziato; questa resta visualizzata accanto all'elenco di completamento automatico. I fumetti della Console non dipendono né da questo interruttore né dall'impostazione Aiuto interattivo.