Livello di programmazione: principiante
Durata: 5 minuti
Tipo di progetto: Funzione personalizzata
Obiettivi
- Scopri cosa fa la soluzione.
- Scopri cosa fanno i servizi Apps Script all'interno di questa soluzione.
- Configura lo script.
- Esegui lo script.
Informazioni su questa soluzione
Se hai dati strutturati simili in più fogli di un foglio di lavoro, ad esempio metriche relative all'assistenza clienti per i membri del team, puoi utilizzare questa funzione personalizzata per creare un riepilogo di ogni foglio. Questa soluzione è incentrata sulle richieste di assistenza clienti, ma può essere personalizzata in base alle proprie esigenze.
Come funziona
La funzione personalizzata, denominata getSheetsData()
, riassume i dati di ogni foglio nel foglio di lavoro in base alla colonna Stato del foglio. Lo script ignora i fogli che non devono essere inclusi nell'aggregazione, ad esempio i fogli ReadMe e ReadMe.
Servizi Apps Script
Questa soluzione utilizza il seguente servizio:
- Servizio fogli di lavoro: recupera i fogli da riassumere e conta il numero di elementi che corrispondono a una stringa specificata. Successivamente, lo script aggiunge le informazioni calcolate a un intervallo relativo al punto in cui la funzione personalizzata è stata chiamata nel foglio di lavoro.
Prerequisiti
Per utilizzare questo esempio, devi disporre dei seguenti prerequisiti:
- Un Account Google (gli account Google Workspace potrebbero richiedere l'approvazione dell'amministratore).
- Un browser web con accesso a internet.
Configura lo script
Fai clic sul pulsante qui sotto per creare una copia del foglio di lavoro Riassumi la funzione personalizzata dei dati del foglio di lavoro. Il progetto Apps Script per questa soluzione è allegato al foglio di lavoro.
Crea una copia
Esegui lo script
- Nel foglio di lavoro copiato, vai al foglio Riepilogo.
- Fai clic sulla cella
A4
. La funzionegetSheetsData()
si trova in questa cella. - Vai a uno dei fogli del proprietario e aggiorna o aggiungi dati al foglio. Ecco alcune azioni che puoi provare a eseguire:
- Aggiungi una nuova riga con informazioni sui biglietti di esempio.
- Nella colonna Stato, modifica lo stato di un ticket esistente.
- Modifica la posizione della colonna Stato. Ad esempio, nel foglio Owner1, sposta la colonna Owner1 (Stato) dalla colonna C alla colonna D.
- Vai al foglio Riepilogo ed esamina la tabella di riepilogo aggiornata che
getSheetsData()
ha creato dalla cellaA4
. Potrebbe essere necessario selezionare la casella di controllo nella riga 10 per aggiornare i risultati memorizzati nella cache della funzione personalizzata. Google memorizza nella cache le funzioni personalizzate per ottimizzare le prestazioni.- Se hai aggiunto o aggiornato righe, lo script aggiorna i conteggi dei ticket e dello stato.
- Se hai spostato la posizione della colonna Stato, lo script continuerà a funzionare come previsto con il nuovo indice di colonna.
Rivedi il codice
Per esaminare il codice Apps Script di questa soluzione, fai clic su Visualizza codice sorgente di seguito:
Visualizza codice sorgente
Code.gs
Modifiche
Puoi modificare la funzione personalizzata come preferisci in base alle tue esigenze. Di seguito è riportata un'aggiunta facoltativa per aggiornare manualmente i risultati delle funzioni personalizzate.
Aggiorna risultati memorizzati nella cache
A differenza delle funzioni integrate, Google memorizza nella cache funzioni personalizzate per ottimizzare le prestazioni. Ciò significa che se modifichi qualcosa all'interno della funzione personalizzata, ad esempio un valore in fase di calcolo, l'aggiornamento potrebbe non essere forzato immediatamente. Per aggiornare manualmente il risultato della funzione, svolgi i seguenti passaggi:
- Aggiungi una casella di controllo a una cella vuota facendo clic su Inserisci > Casella di controllo.
- Aggiungi la cella contenente la casella di controllo come parametro della funzione personalizzata, ad esempio
getSheetsData(B11)
. - Seleziona o deseleziona la casella di controllo per aggiornare i risultati delle funzioni personalizzate.
Collaboratori
Questo campione è gestito da Google con l'aiuto degli Esperti Google Developers.