# 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 Prova](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/una-variabile-letta-da-un-endpoint-da-dove-viene-quando-si-rilegge-e-la-struttura-trovata-con-prova.png)
    
    *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 caricate](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/una-variabile-calcolata-in-una-tabella-la-somma-di-una-colonna-sulle-righe-caricate.png)
    
    *Una variabile calcolata in una tabella: la somma di una colonna sulle righe caricate*

<p class="callout success">**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.</p>

<p class="callout info">**Nota.** Con la casella **in uscita** una variabile si può leggere anche dal flusso che pilota il componente.</p>

<p class="callout info">**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}}`.</p>

<p class="callout info">**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`</p>