1. Prima di iniziare
Il database AppSheet (ASDB) è il database nativo proprietario di AppSheet per organizzare e gestire i dati che alimentano le app AppSheet. La sua interfaccia e le prestazioni migliorate offrono un'esperienza migliore sia per il creatore dell'app sia per l'utente finale rispetto ad altre origini dati esterne di uso comune come Fogli Google, BigQuery e Cloud SQL. Il database AppSheet è un'opzione di dati predefinita per qualsiasi applicazione AppSheet.
Cosa imparerai a fare
- Come creare un nuovo database AppSheet con dati di esempio o dati importati da un foglio Google.
- Come personalizzare i dati nell'editor di database AppSheet.
- Come generare un'applicazione AppSheet da un database AppSheet.
- Come modificare il database e rigenerare le tabelle in AppSheet per tenere conto delle modifiche alla struttura delle tabelle.
Cosa creerai
Questo codelab ti guida alla generazione e alla personalizzazione di un nuovo database AppSheet, prima da zero con i dati predefiniti forniti da un database AppSheet e poi da dati esistenti in un foglio Google. Viene quindi illustrato come generare una nuova applicazione AppSheet da un database AppSheet. Infine, mostra come modificare una tabella di database nell'editor di database e poi rigenerarla nell'editor di app AppSheet.
Che cosa ti serve
- Accesso all'ambiente di sviluppo AppSheet ( appsheet.com).
2. Creare e personalizzare un nuovo database AppSheet da zero
Per iniziare, crea e personalizza un nuovo database AppSheet da zero utilizzando il database iniziale predefinito. In questo modo, puoi sperimentare l'editor del database senza interrompere i passaggi successivi del codelab.
- Vai alla home page di AppSheet ( appsheet.com), poi fai clic su Crea > Database > Nuovo database.

- Viene creato un nuovo database di esempio e viene visualizzato l'editor di database AppSheet.

- Personalizza il database modificando il nome da Database senza titolo a Database attività. (Fai doppio clic sul titolo predefinito, Database senza titolo, per modificare il nome del database.)
- Modifica il nome della tabella Tabella 1 in Attività. (Fai doppio clic sulla scheda per modificarla).
- Modifica la prima colonna da Titolo a Attività.
- Aggiungi un nuovo record facendo clic su + nell'angolo in alto a sinistra .

- Fai doppio clic sulla colonna Stato per vedere come vengono utilizzati i tipi Enum e Elemento del menu a discesa.

- (Facoltativo) Fai clic sui pulsanti dopo i segni = per colorare ogni opzione del menu a discesa.

- (Facoltativo) Sperimenta ulteriormente con l'editor aggiungendo nuove opzioni per l'enumerazione Stato (fai clic su Aggiungi opzione) insieme a nuovi colori.
- (Facoltativo) Sperimenta diversi tipi di colonne, come Colore, Avanzamento, Sì/No e Telefono, e poi osserva i loro comportamenti.

Continua a sperimentare con l'editor del database. Nei passaggi successivi, creerai un nuovo database.
3. Creare e personalizzare un nuovo database importando da un foglio Google
I passaggi successivi mostrano come importare i dati da un foglio Google.
Creare il database da un foglio
- Innanzitutto, crea una copia di questo foglio Google pubblico e rinominalo
ASDB: IO Codelab.
Come puoi notare, ha due schede: Attività e Proprietari.
- Come in precedenza, vai alla home page di AppSheet ( appsheet.com) e fai clic su Crea > Database > Importa da Fogli.

- Nel selettore di file di Google Drive, seleziona la tua copia del foglio
ASDB: IO Codelabo il nome che hai scelto.
Il risultato è un nuovo database AppSheet generato dai dati nel foglio.

Aggiungere un riferimento alla tabella Tasks
Successivamente, aggiungi un riferimento alla tabella Proprietari dalla tabella Attività.
- Nella tabella Tasks (Attività) del database AppSheet, fai doppio clic sulla colonna Owner (Proprietario) per modificarne le impostazioni.
- Modifica il tipo da Testo a Riferimenti > Riferimento.

- Imposta Tabella di riferimento su Proprietari e poi fai clic su Salva.

- Viene visualizzato un avviso relativo alla modifica del tipo di colonna. In questo caso, i dati di questa colonna sono compatibili con il nuovo tipo di colonna, quindi puoi fare clic su Sì per procedere.

- Il database AppSheet tenta quindi di abbinare le righe corrispondenti nella tabella Proprietari ai nomi nella tabella Attività. Poiché questo set di dati corrisponde, il database AppSheet deve compilare la colonna Proprietario con i riferimenti corretti alle righe Proprietari.

- Per testare il riferimento, fai clic su una cella Proprietario e aggiornala con un altro proprietario, ad esempio Sarah.

Una volta selezionato, il nuovo valore (Sarah) viene visualizzato nella cella Proprietario (nella tabella Attività).

Modificare la colonna Etichetta della tabella a cui viene fatto riferimento
Il database AppSheet ti consente di selezionare una colonna Etichetta per qualsiasi tabella. In questo modo puoi specificare la colonna che vuoi visualizzare in una tabella principale. Ciò regola anche ciò che viene mostrato nella tabella principale in un'app frontend AppSheet collegata. Quindi, anziché visualizzare la colonna Nome della tabella Proprietari nella tabella Attività (mostrata in precedenza), potresti visualizzare la colonna Email della tabella Proprietari.
- Per farlo, modifica la colonna Etichetta nella tabella Proprietari in Email passando il mouse sul lato destro dell'intestazione della colonna Email e facendo clic sui tre puntini verticali.

Viene visualizzato il menu contestuale della colonna.

- Seleziona Usa la colonna come etichetta nel menu contestuale per impostare l'etichetta della colonna sulla colonna Email.

- Per verificare che la colonna Email sia selezionata come etichetta della colonna che fa riferimento alla tabella Attività, fai clic sulla scheda della tabella Attività e nota che ora la colonna Proprietario mostra gli indirizzi email. Potresti dover aggiornare il browser per visualizzare la colonna Proprietario aggiornata.

4. Generare un'app AppSheet da un database AppSheet
Una volta completate le personalizzazioni del database, puoi generare un'app AppSheet direttamente dal database. Questa opzione è utile se vuoi un'interfaccia utente frontend personalizzata, devi aggiungere automazioni o filtri di sicurezza e così via. Per farlo:
- Fai clic su App sul lato destro dell'editor ASDB.

Viene richiamato il menu contestuale a destra per generare una nuova app.

- Fai clic su Nuova app AppSheet per generare una nuova app.

Mentre l'app viene generata, nota che l'app presenta un avviso:
Column "Owner" in Tasks_Schema has a reference to an unknown table or slice "Owners". Open the column definition to select a source table.
Questo perché l'app generata ha solo la tabella Attività e la colonna Proprietario fa riferimento a una tabella sconosciuta, Proprietari.
Per risolvere il problema, aggiungi la tabella Proprietari all'app AppSheet.
- Nella pagina Dati dell'editor AppSheet, fai clic su +.

- Nel menu contestuale Aggiungi dati, seleziona Database AppSheet come origine dati.

- Quindi seleziona il database ASDB: IO Codelab (o il nome che hai dato al database nei passaggi precedenti).

- Nella finestra di dialogo successiva, seleziona la casella di controllo predefinita SELEZIONA TUTTO e poi fai clic su Aggiungi all'app.

Man mano che la tabella Proprietari viene aggiunta all'app, l'errore Riferimento non viene più visualizzato.

- Ora che è stata aggiunta la nuova tabella Proprietari di AppSheet, puoi creare una nuova visualizzazione per mostrare questi dati facendo clic sulla pagina Visualizzazioni in AppSheet e su + accanto a NAVIGAZIONE PRINCIPALE.

- Nella finestra di dialogo Aggiungi una nuova visualizzazione, fai clic su Crea una nuova visualizzazione.

- Man mano che viene creata la nuova vista, imposta le seguenti opzioni:
Nome visualizzazione: Proprietari Per questi dati: Proprietari Tipo di visualizzazione: scheda

Congratulazioni, la tua app è stata completata.
- Per testare il riferimento tra Attività e Proprietari, fai clic sulla visualizzazione Proprietari o Attività nell'anteprima mobile, quindi seleziona un record per visualizzare i record correlati (a cui viene fatto riferimento).

Ad esempio, puoi fare clic sulla visualizzazione Proprietari e poi su un record per visualizzarlo in dettaglio e vedere i relativi record Attività.

5. Modificare il database e rigenerare la tabella Attività
Ora che hai creato un database AppSheet e generato una nuova app, prova a modificare una tabella nel database. Modifica il tipo di dati di una colonna e osserva cosa succede nell'app AppSheet collegata.
- Nella tabella Tasks del database, imposta il tipo della colonna Due Date su Data e ora > Data.

Quando torni all'app AppSheet, viene rilevato che il database è stato aggiornato con un avviso:
App Schema for table 'Tasks' is out of sync with the schema in AppSheet database. Please regenerate the table structure

- Per rigenerare, fai clic sull'icona
rigenera nell'angolo in alto a destra. - Viene visualizzata una finestra di dialogo di avviso:

- Fai clic su Rigenera per continuare. In questo modo, il tipo della colonna Data di scadenza nell'app viene aggiornato al tipo Data e viene attivato l'elemento di input del selettore di data nel modulo Modifica per i record di attività.

6. Complimenti
Hai completato il codelab sul database AppSheet (ASDB).
Further reading
- Sito di documentazione ufficiale del database AppSheet