dai dati alla app

Gli appunti di questo post si riferiscono a come una app android può visualizzare i dati del Bilancio.
Riferimento principale: https://community.thunkable.com/t/introduction-to-apis/12067
Sito nel quale sviluppare la app, da PC: http://app.thunkable.com
Sito del bilancio in formato json: https://www.dati.lombardia.it/resource/jy22-j8r3.json
(Bilancio di previsione 2018-2020 Comune di Crema).

Entrare in  http://app.thunkable.com (cosa migliore: con le credenziali account google)
Una volta creato il NuovoProgetto (Progetti ==> Nuovo Progetto), si devono fare due cose:
1. preparare la schermata per l'utilizzatore , con i vari elementi (bottoni, immagini, testi, tabelle, etc): "Progettazione" in alto a sinistra.
2. preparare il programma che lavora associato agli elementi della schermata ("Blocchi").

Progettazione
Trascinare dalla lista a sinistra alla figura dello smartphone (Sotto screen1 per intenderci) un Pulsante, una Etichetta e un Web (Web è sotto Connettività e, trascinato nella immagine dello smartphone finirà in basso).

schermata con gli elementi dell'interfaccia-utente

Impostare Web1 cliccandoci sopra per far apparire a destra le sue proprietà e inserire l'indirizzo della Regione Lombardia che punta al file in versione  json del Bilancio e che estrae al massimo 5 righe del bilancio 2019 (tanto per cominciare):

https://www.dati.lombardia.it/resource/jy22-j8r3.json?$query=SELECT%20descrizione,preventivo_2019%20WHERE%20preventivo_2019%20>%200%20LIMIT%205

(oppure uno a piacere degli esempi json del post: 

https://bilanciocremaformatoaperto.blogspot.com/2019/02/estrazione-dati-direttamente-via-url.html   )

Ora passiamo a "Blocchi" per il programma. 

Cosa vogliamo dal programma? Partiamo dalla cosa più semplice, senza fronzoli.

Vogliamo per prima cosa far apparire i dati sul telefono quando si preme il Pulsante.

I dati verranno visualizzati nella Etichetta.

Blocchi

Cliccando su Blocchi ci si trova una pagina vuota:

Cliccando Pulsante1 appaiono le cose che si possono fare col pulsante (toccarlo, tenerci sopra il dito, etc): siccome ci interessa fare apparire i dati se tocchiamo/clicchiamo il pulsante, scegliamo il blocco in alto:

una volta deposto nella pagina, ci interessa che al click venga mandata una richiesta al web

Quindi sempre a sinistra scegliamo web e dalla lista scegliamo eseguiWeb1Ottieni 

e incastriamolo nel blocco che dice cosa fare se si clicca il Pulsante1:

A questo punto, quando si toccherà il pulsante, la richiesta verrà inviata e RegioneLombardia risponderà: occorre scrivere il programma che mostra i dati una volta che Regione Lombardia li ha rispediti allo smartphone.
Quindi da Web1 bisogna scegliere "quando lettura file completata"):

e, dopo averlo depositato sulla pagina, incastrarci dentro il blocchetto imposta_etichetta1_testo a :

e , una volta incastrato nel blocco quando lettura completata, sorvolare col mouse Contenuto risposta in modo da far apparire le due possibilità e scegliere "valore di ContenutoRisposta":

e trascinarlo per  incastrarlo nell'Imposta EtichettaTesto :

Fine.
Il programma è fatto in pratica da questi due elementi:
1. quando clicchi il pulsante, manda richiesta  e ottieni i dati
2. quando arriva la risposta, mostrala nell'etichetta

Ora bisogna provarlo con lo smartphone. Ci sono diverse possibilità. 

Una è creare il file apk e installarlo poi nello smartphone. La cosa richiede parecchi click. (in "Progettazione" Tendina "Compila" salva su computer, copiarlo nello smartphone installarlo nello smartphone.)

Un'altra, più utile quando si fanno i programmi pezzo per pezzo, è installare una apposita app nello smartphone con la quale lo smartphone è in collegamento perenne con il PC via rete wifi di casa propria e mostra quel che fa il programma in sviluppo senza doverlo installare tutte le volte che si fa una modifica. (solo alla fine, quando la app è pronta, si installerà l'apk definitivo una volta per tutte).

Va installata da qui:

https://play.google.com/store/apps/details?id=com.thunkable.appinventor.aicompanion3&hl=it 

e poi, aperta nello smartphone, le vanno date le autorizzazioni per accedere alle risorse necessarie alle app. 

Chiederà poi un codice (che identifica la app che si sta sviluppando): il codice da scrivere nello smartphone  è quello che appare con la tendina nel PC:

attendere che lo smartphone si connetta, in modo che appaia l'interfaccia appena progettata:

schermata iniziale

Ora occorre toccare il pulsante e vedere se i dati arrivano nell'Etichetta:

se tutto va bene , nello smartphone deve apparire questo

Una volta che il "passaggio" è aperto , non resta che sbizzarrirsi con la fantasia e la potenza dei blocchi di thunkable.

Prossimamente:
1. come modificare le richieste ("query") al sito SOCRATA della Regione
2. come analizzare i file json e estrarre le parti che interessano
3. come mostrare i dati con un po' di immagini