# JE5.3 - Scritture disegnate

**In una frase.** Anche inserire, modificare e cancellare si dichiara a blocchi: cosa scrivere, dove e su quali righe. L'istruzione la costruisce il motore, e la puoi guardare prima che parta.

Scrivere nei dati è la parte più delicata. Un'istruzione scritta a mano con un errore di battitura può toccare le righe sbagliate. Qui non scrivi l'istruzione: scegli archivio e campi dal catalogo, e il motore rifiuta le scritture pericolose.

1. **Scegli di scrivere.** Nell'Endpoint Studio, **Tipo › Scrittura**. Nella tendina **Come** resta **Disegnata**.
2. **Rispondi alle tre domande.**
    
    
    - **Scrittura**: inserire, modificare o cancellare, e su quale archivio.
    - **Valori da scrivere**: campo e valore. Il valore può essere un parametro che arriva da fuori.
    - **Su quali righe**: gli stessi filtri di una lettura.
3. **Guarda l'anteprima.** Premi **Mostra l'SQL**: il motore costruisce l'istruzione e la mostra, senza scrivere niente. Accanto metti dei valori di prova.
    
    ![Una modifica disegnata: il valore, le righe da toccare e l'anteprima dell'istruzione, che non scrive niente](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/una-modifica-disegnata-il-valore-le-righe-da-toccare-e-lanteprima-dellistruzione-che-non-scrive-niente.png)
    
    *Una modifica disegnata: il valore, le righe da toccare e l'anteprima dell'istruzione, che non scrive niente*
4. **Usala in un flusso.** Più scritture si mettono in fila in un flusso. Con **Scrive tutto o niente** passano tutte insieme, o non ne passa nessuna.

Il motore non fa partire:

- una modifica o una cancellazione **senza filtro**, perché toccherebbe tutte le righe;
- una scrittura su un campo che non esiste;
- una scrittura su un archivio che non è nel catalogo.

In tutti e tre i casi il messaggio dice a chi disegna cosa correggere.

<p class="callout warning">**Attenzione.** Le scritture disegnate sono spente finché chi gestisce l'installazione non le accende, e solo sugli archivi che elenca. Hanno i loro test, ma non sono ancora state usate su dati veri: si provano prima sull'ambiente di prova.</p>

<p class="callout success">**Cosa ci guadagni.** Di ogni scrittura resta scritto chi l'ha fatta. E le regole di cancellazione del catalogo valgono anche qui.</p>

<p class="callout info">**Per chi sviluppa.** Le variabili dell'installazione sono `LOWCODE_MUTATION_ENABLED` e `LOWCODE_MUTATION_TABLES`. Nell'istruzione i valori viaggiano sempre come parametri, mai come testo.</p>

<p class="callout info">**Per approfondire.**  
• Scritture disegnate: `docs/guide/endpoint/scritture-disegnate/README.md`</p>