Passa al contenuto principale

JE7.2 - Le variabili dei componenti

In una frase. Una variabile è un valore con un nome che un form o una tabella conosce: può leggerlo da un endpoint, riceverlo da fuori, averlo fisso o calcolarlo.

Le variabili servono a far parlare i pezzi fra loro. Una tendina che si riempie con le regioni lette dai dati, un form che riceve il numero dell'ordine dal flusso, il totale di una colonna: sono tutte variabili.

  1. Apri la scheda Variabili. C'è nel Form Builder e nel Table Builder. Aggiungi variabile e dalle un nome.

  2. Scegli da dove viene.

    • Da un endpoint: legge il valore dai dati.
    • In ingresso: arriva da fuori, dal flusso o dalla schermata che apre questa. Puoi dire quanto vale se non arriva, e se è obbligatoria.
    • Costante: un valore fisso, deciso qui.
    • Calcolata: una formula su quello che il componente ha già.

    Una variabile letta da un endpoint: da dove viene, quando si rilegge, e la struttura trovata con ProvaUna variabile letta da un endpoint: da dove viene, quando si rilegge, e la struttura trovata con Prova

    Una variabile letta da un endpoint: da dove viene, quando si rilegge, e la struttura trovata con Prova

  3. Premi Prova. Per una variabile letta da un endpoint, Prova mostra cosa arriva: ogni campo con il tipo e un esempio del valore vero. Se la lettura fallisce lo dice, con il motivo.

  4. Scegli quando si rilegge. Al caricamento (una volta), Quando cambia… (solo quando cambiano i campi che indichi), Ad ogni cambio. Il secondo è quasi sempre quello giusto: il terzo rilegge a ogni lettera digitata.

  5. Usala. Nel form una variabile riempie le opzioni di una tendina o entra in una regola. Nella tabella una variabile calcolata vede le righe caricate e quelle scelte: così fai la somma di una colonna.

    Una variabile calcolata in una tabella: la somma di una colonna sulle righe caricateUna variabile calcolata in una tabella: la somma di una colonna sulle righe caricate

    Una variabile calcolata in una tabella: la somma di una colonna sulle righe caricate

Cosa ci guadagni. I valori non si scrivono a mano: si scelgono da un elenco che conosce i nomi veri. Un nome sbagliato che «sembra giusto» era la causa più frequente di schermate vuote.

Nota. Con la casella in uscita una variabile si può leggere anche dal flusso che pilota il componente.

Per chi sviluppa. In una tabella la formula vede righe e selezione, e funzioni come sumBy(righe, 'importo'). Nei flussi i valori dell'installazione si leggono come {{$site.chiave}}, quelli del ciclo come {{$item}}.

Per approfondire.
• Le variabili dei componenti disegnati: docs/guide/variabili/variabili-componenti/README.md
• Variabili e condizioni — lo standard: docs/guide/variabili/variabili-e-condizioni/README.md