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.
Scegli di scrivere. Nell'Endpoint Studio, Tipo › Scrittura. Nella tendina Come resta Disegnata.
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.
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
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.
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.
Cosa ci guadagni. Di ogni scrittura resta scritto chi l'ha fatta. E le regole di cancellazione del catalogo valgono anche qui.
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.
Per approfondire.
• Scritture disegnate: docs/guide/endpoint/scritture-disegnate/README.md