Passa al contenuto principale

JE5.1 - Leggere dati senza scrivere codice

In una frase. Un endpoint è una domanda ai dati con un nome: scegli l'archivio, i campi e i filtri, e la domanda è pronta per tabelle, form e flussi.

Per mostrare dei dati serve qualcuno che li vada a prendere. Di solito è un pezzo di programma scritto apposta. Nell'Endpoint Studio quella domanda la componi scegliendo dal catalogo, e la provi subito.

  1. Apri l'Endpoint Studio. Dal menu: Low-Code Platform › Dynamic Endpoints › Endpoint Studio. A sinistra il catalogo, al centro il disegno, in alto il nome ed Esegui.

  2. Scegli l'archivio. Cercalo nel catalogo a sinistra. Ogni riga dice quanti campi e quante relazioni ha.

  3. Scegli i campi. Un clic su ogni campo che vuoi leggere. In cima, l'anteprima della domanda si aggiorna a ogni clic.

    L'Endpoint Studio: tre campi scelti dall'archivio dei comuni, e sopra l'anteprima della domanda

    L'Endpoint Studio: tre campi scelti dall'archivio dei comuni, e sopra l'anteprima della domanda

  4. Aggiungi i collegamenti. Sotto i campi trovi le relazioni dell'archivio, quelle del catalogo. Con aggiungi join leggi anche i campi dell'archivio collegato, per esempio la descrizione della provincia.

  5. Aggiungi filtri e parametri. Un filtro può avere un valore fisso o un parametro: un valore che arriverà da fuori, per esempio dal form. Un parametro lasciato vuoto non filtra: la condizione viene tolta.

  6. Salva ed esegui. Dai un nome, Salva, poi Esegui. Il risultato compare in fondo, in una tabella.

Cosa ci guadagni. La stessa domanda la usano una tabella, una tendina di un form e un flusso. Se serve un campo in più lo aggiungi qui, una volta.

Nota. Per i casi che il disegno non copre resta la modalità in cui si scrive l'SQL a mano, solo per leggere e con dei controlli. È la strada da usare per ultima.

Per chi sviluppa. Ogni endpoint ha il suo indirizzo, mostrato in fondo allo studio nel riquadro Invocazione, e si può limitare ad alcuni ruoli. Gli strumenti sono in frontend/ade-next/src/studio/endpoint-studio. La domanda la esegue SIGEAnext.

Per approfondire.
• Endpoint Studio — raggruppare e contare: docs/guide/endpoint/endpoint-studio/README.md