Passa al contenuto principale

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 nienteUna modifica disegnata: il valore, le righe da toccare e l'anteprima dell'istruzione, che non scrive niente

    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.

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