Campi & Formule

La scheda Campi & Formule permette di trovare le dipendenze di un campo o di una funzione globale selezionati.
In altre parole, potete individuare tutte le formule che usano un determinato campo o una determinata funzione globale.

Comprende due sotto-schede: Elenco, descritta qui sotto, e Albero delle dipendenze, che disegna le stesse dipendenze (vedere più sotto). La sotto-scheda scelta e l'ultimo campo selezionato vengono memorizzati per ogni database.

Perché è utile

Quando si modifica o si elimina un campo o una funzione globale, questa funzionalità aiuta a verificarne l'impatto sul resto del database.

Dipendenze del campo Invoice No in Campi & Formule

La sotto-scheda Elenco presenta due sezioni comprimibili:

  • Script di Tabella.Campo: il codice dell'elemento selezionato stesso — le formule e i trigger di un campo, o il codice di una funzione globale —, ogni script preceduto dal badge del suo livello, con il codice compresso sotto; «Nessuno script trovato per questo campo» se non ce ne sono;
  • Dipendenze (N), o Nessuna dipendenza: gli script che usano l'elemento selezionato.

Livelli d'impatto delle dipendenze

Esistono tre livelli d'impatto, rappresentati da tre badge diversi:

BadgeFormulaInterfaccia utenteVisualizzazione
Badge rossoSìSìSìIl campo è usato in una formula, in un trigger («On click», «Trigger after update», «Trigger on new record»), in una funzione globale, nel trigger «After Open» o in un'espressione di stampa. Qualsiasi modifica o eliminazione avrà effetto sul funzionamento del database.
Badge arancioneSìSìIl campo è usato da una regola d'interfaccia: «Display field only, if», «Writable if», «Readable if», «Trigger before view», «Trigger after hide», «Show as», «Show data as», le formule di una scelta dinamica o il vincolo di un collegamento. Modificarlo influirà solo sul comportamento dell'interfaccia utente, non sul funzionamento del database né sui calcoli dei dati.
Badge verdeSìIl campo è usato solo a scopo di visualizzazione: in una colonna di vista (la sua formula o la sua formattazione condizionale) o in una colonna di una tabella di stampa. Modificarlo influirà solo sulla presentazione dei dati, senza alterare il comportamento dell'interfaccia utente né i calcoli dei dati.

Il numero mostrato all'interno del badge indica il numero di dipendenze dirette; nell'elenco, il numero riportato nel badge di una dipendenza conta, invece, le sue dipendenze proprie. Dalla versione 3.2.0, questo numero viene contato allo stesso modo ovunque — elenco, albero e badge — senza gli script del campo stesso.

Capire le dipendenze

Un campo può avere più dipendenze, e ciascuna dipendenza può a sua volta averne di proprie.
Questa struttura gerarchica aiuta a capire come le modifiche a un campo o a una funzione si ripercuotono sul database.

Dipendenze annidate, espanse su tre livelli

Un clic su una riga dell'elenco espande le sue dipendenze proprie, un secondo clic le comprime; una freccia, a sinistra, segnala le righe che ne hanno. Un clic sul badge di una riga seleziona quel campo in Campi & Formule (tranne per una funzione globale o per il trigger «After Open»).

Uso diretto

Selezionate una tabella o la riga delle funzioni globali:

  • Fate clic nella zona di sinistra: l'elenco presenta le tabelle, precedute da due voci, il trigger «After Open» del database e le sue funzioni globali. Un clic su una tabella ne espande i campi.

Elenco delle tabelle, preceduto dal trigger «After Open» e dalle funzioni globali

Selezionate un campo o una funzione:

  • Digitate alcune lettere nella zona di destra: l'elenco mantiene solo gli elementi che le contengono, in tutte le tabelle. Un clic su un campo o su una funzione lo seleziona.

Filtro dei campi sulla parola «Date»

Compaiono anche i campi e le tabelle provenienti da altri database dello stesso team, con un'icona dedicata. Le dipendenze provenienti da un altro database già caricato da Ninox (un altro database che usa un campo di questo) compaiono anche nell'elenco e nell'albero, precedute dal nome del loro database; non si aprono da qui: un messaggio, in inglese («This element belongs to another database…»), invita ad aprire il loro database.

Usare l'editor dei campi

Nella finestra «Edit fields» di Ninox, ogni campo usato altrove porta il badge delle sue dipendenze.
Un clic su questo badge apre il pannello Ninext su Campi & Formule, con il campo selezionato. La pagina Modifica campo descrive in dettaglio questi badge e la navigazione da un campo all'altro.

Badge del campo Customer nella finestra Edit fields di Ninox

Il campo Customer selezionato in Campi & Formule

Accedere al campo o alla funzione selezionati

Fate clic sul pulsante rosso, a destra degli elenchi. Compare solo nella modalità di modifica di Ninox («Edit mode»), e diventa grigio finché una modifica resta da salvare o da annullare in Ninox. Per un campo, Ninext lo evidenzia nel modulo di Ninox, con una chiave inglese: un clic su questa chiave apre la finestra di modifica del campo. Se il campo non è visibile nel modulo, Ninext propone di aprire l'editor dei campi.

Aprire la finestra di modifica del campo selezionato

Per le funzioni globali, si apre l'editor del codice globale, con la funzione interessata evidenziata.

Aprire il codice globale sulla funzione selezionata

Accesso diretto allo script

  • Fate clic sulla parte in grassetto di una riga dei risultati (qui «Show as»): l'editor di Ninox si apre sul codice che contiene la dipendenza, con la parte interessata evidenziata.
  • Il pulsante rosso che compare al passaggio del mouse, a destra della riga (nella modalità di modifica di Ninox), segue la stessa regola di quello in alto. Per una riga che appartiene a un campo (la sua formula, uno dei suoi trigger, il suo «Show as»…), seleziona quel campo nel suo modulo, e porta una chiave inglese in un riquadro; per le altre (trigger di tabella, colonna di vista, stampa, funzione globale, «After Open»), apre l'editor dello script, e porta solo una chiave inglese.

Aprire il codice di una dipendenza con un clic

Gli elenchi lunghi

Un elenco lungo viene visualizzato a blocchi di 100 righe. In fondo all'elenco, +100 mostra le 100 successive, e Tutti (N) mostra le N rimanenti.

Il badge al passaggio del mouse su un campo

Nella modalità di modifica di Ninox («Edit mode»), passando il mouse su un campo in un modulo compare un badge in alto a destra del campo. Riunisce, senza dover prima selezionare il campo:

ZonaAl passaggio del mouseAl clic
TipoIl tipo del campo, o il tipo restituito dalla sua formula.—
Fx (solo campi formula)La formula completa, con un pulsante Copia; gli errori vi sono sottolineati (ondulata rossa, a puntini color ambra per un avviso), e il passaggio del mouse sulla parte sottolineata ne mostra il messaggio.Apre l'editor delle formule di Ninox.
Chiave inglese rossa—Apre la finestra di modifica del campo.
Contatore delle dipendenzeUn'anteprima dell'albero delle dipendenze.Apre il pannello Ninext e seleziona il campo in Campi & Formule.

Il colore del contatore indica il livello d'impatto, come i badge qui sopra; «0», in grigio, segnala un campo da cui non dipende nulla. Il badge si disattiva nelle Impostazioni Ninext, sezione «Strumenti aggiuntivi»: Badge dipendenze al passaggio del mouse.

Al passaggio del mouse sul campo NET Total di un record, il badge di Ninext; al passaggio sul suo contatore, l'anteprima dell'albero delle dipendenze

L'albero delle dipendenze

La sotto-scheda Albero delle dipendenze disegna le dipendenze del campo selezionato, nei due sensi:

  • a sinistra, a monte, i campi letti dalla sua formula;
  • al centro, il campo stesso;
  • a destra, a valle, le formule che lo usano.

Bande numerate (-2, -1, 0, 1, 2…) indicano i livelli. Al passaggio del mouse su una cella, la sua catena si illumina e il resto si attenua; nel fumetto informativo del codice di una cella, il nome del suo genitore diretto è evidenziato. Anche una funzione globale si espande, verso i propri dipendenti (a partire dalla 3.2.0).

L'albero delle dipendenze del campo NET Total: bande numerate, un cluster e il suo piede, una cella sotto il mouse

In una cella:

  • il badge ricentra l'albero su quel campo, che diventa il campo selezionato;
  • l'icona Fx mostra il codice al passaggio del mouse e apre il suo editor al clic; il pulsante rosso segue la stessa regola che nell'elenco;
  • il badge rotondo + (Espandi) espande le dipendenze della cella, − (Comprimi) le comprime — è così che si espande una funzione globale; a monte, un secondo badge mostra o nasconde i figli fuori catena;
  • l'occhio barrato (Nascondi questa cella) nasconde la cella.

Oltre 10 elementi in una colonna, una cella «… +N» mostra gli altri.

I cluster. Le celle che condividono gli stessi genitori sono raggruppate in un riquadro, un cluster. Afferrate la sua maniglia per riordinarlo o spostarlo in un'altra colonna; una volta riordinato o spostato il cluster, una freccia circolare compare nel suo angolo e lo riporta al suo posto d'origine. Un cluster mostra 5 celle; i suoi pulsanti −5, +5 e Tutti (N) ne mostrano di meno o di più, una freccia lo riporta a 5 celle, e il suo piede indica quante ne restano nascoste.

La barra degli strumenti propone:

  • Copia come immagine: una finestra propone Copia (appunti) o Scarica PNG;
  • l'occhio, che mostra o nasconde le celle nascoste: compare solo se almeno una cella è nascosta, con il loro numero;
  • lo zoom indietro, la percentuale di zoom, lo zoom avanti e Adatta alla vista;
  • Schermo intero, da cui si esce con il suo pulsante o con il tasto Esc.

L'albero ricorda, per ogni campo, le sue celle nascoste e la disposizione dei suoi cluster. Quando cambiate campo, mantiene lo zoom in corso e centra il nuovo campo; un aggiornamento dello schema non cambia né lo zoom né la posizione.

Lo stesso albero compare in anteprima al passaggio del mouse sul contatore delle dipendenze del badge.

La cronologia di navigazione

L'icona a forma di impronte di passi, in cima al pannello Ninext, apre al passaggio del mouse o al clic l'elenco degli ultimi campi, funzioni globali e report consultati da Ninext — trigger «After Open» compreso. Un elemento consultato di nuovo scende in fondo all'elenco, senza duplicati; un clic lo seleziona di nuovo. L'elenco conserva 50 voci per la giornata; Cancella tutta la cronologia di navigazione lo svuota. Questa cronologia, riservata agli amministratori, si disattiva nelle Impostazioni Ninext, sezione «Miglioramenti interfaccia»: Cronologia di navigazione dello schema (amministratori).

Non confondetela con il pulsante Record consultati, con la stessa icona ma posto nella barra superiore di Ninox: proposto a tutti gli utenti, elenca i record aperti di recente (vedere Record consultati).