Parametri

I parametri consentono di interagire con i dati forniti dall'utente. Ad esempio, puoi creare campi calcolati che includono l'input degli utenti che utilizzano il tuo report oppure ritrasmettere i valori alla query SQL utilizzata dall'origine dati. L'utilizzo dei parametri rende i report più interattivi. Puoi anche utilizzare i parametri per creare modelli di report.

Contenuti di questo articolo:

• Come funzionano i parametri
• Creare un parametro
• Parametri e connettori della community
• Modificare un parametro esistente
• Configurare un parametro
• Impostare i valori di un parametro
• Utilizzare i parametri
• Mostrare o nascondere i parametri nei report
• Copiare un componente con parametri
• Correggere i parametri non validi
• Risorse correlate

Come funzionano i parametri

I parametri agiscono come variabili in un linguaggio di programmazione. Esistono tre utilizzi principali per i parametri:

• Puoi usarli nei campi calcolati per visualizzare i risultati in base all'input dell'utente.
• Puoi ritrasferire i parametri alla query SQL personalizzata in un'origine dati BigQuery.
• Puoi ritrasferire i parametri a un connettore della community.

I parametri possono acquisire i dati:

• Da un valore predefinito per il parametro.
• Dal riquadro delle proprietà del componente.
• Da un controllo posizionato sul report.
• Dal link che rimanda al report.

I parametri si trovano in fondo agli elenchi di campi negli editor dei report e delle origini dati e sono visualizzati come campi viola.

Come i parametri condividono i dati nei report

Gli editor dei report e delle origini dati possono accedere a tutti i dati controllati dai parametri.

I parametri consentono agli editor dei report di richiedere dati diversi da quelli predefiniti. Prima di attivare i parametri per l'origine dati, assicurati di comprendere come le modifiche ai valori dei parametri potrebbero influire sui dati dei report. Alcuni parametri possono restituire dati relativamente "sicuri", come quelli meteorologici relativi a una nuova località. Tuttavia, altri parametri potrebbero consentire a qualcuno di richiedere set di dati completamente nuovi. Ad esempio, un parametro relativo al numero di conto bancario o il nome di una tabella di database potrebbe restituire dati che non intendevi condividere o magari riportare uno schema diverso, che potrebbe essere incompatibile con i grafici presenti nel report.

Creare un parametro

Puoi creare parametri nelle seguenti posizioni:

In un'origine dati

1. Modifica l'origine dati.
2. In alto a destra, fai clic su AGGIUNGI UN PARAMETRO.
   Puoi anche creare un parametro durante la modifica di un report selezionando un componente e facendo clic su AGGIUNGI UN PARAMETRO in basso a destra. Assicurati di selezionare un componente in base all'origine dati richiesta.
3. Configura le opzioni e il valore predefinito del parametro (vedi di seguito).

Durante la modifica di un report, puoi utilizzare il link + Aggiungi un parametro nel riquadro dei dati per creare un parametro nell'origine dati selezionata.

Nel connettore BigQuery

Puoi passare i parametri a una query SQL personalizzata nel connettore BigQuery. Il connettore BigQuery definisce diversi parametri standard che trasmettono le date di inizio e di fine del report, nonché l'indirizzo email dell'utente, se disponibile. Puoi anche passare parametri personalizzati. Scopri di più.

Parametri e connettori della community

Il connettore della community può includere parametri sostituibili che permettono agli editor dei report di modificare i valori predefiniti in un'origine dati. Se puoi modificare la connessione per un'origine dati creata con un connettore della community, puoi indicare quali parametri possono essere modificati dagli editor dei report:

1. Modifica l'origine dati.
2. In alto a sinistra, fai clic su MODIFICA CONNESSIONE.
3. Se il connettore fornisce parametri modificabili, questi vengono visualizzati nella parte inferiore della pagina. I connettori che consentono di definire parametri personalizzati includono le relative istruzioni nella pagina.
4. Utilizza le caselle di controllo Consenti la modifica di <nome parametro> nei report per consentire o impedire la modifica del parametro nei report.
5. In alto a destra, fai clic su RICONNETTI.

Dopo aver creato un'origine dati da un connettore della community, le modifiche ai parametri nel connettore non vengono visualizzate automaticamente nell'origine dati. Per visualizzare i parametri nuovi, rimossi o modificati, devi riconnettere l'origine dati.

Modificare un parametro esistente

Per modificare la configurazione di un parametro esistente:

1. Modifica l'origine dati che contiene il parametro.
2. Individua il parametro nell'elenco dei campi.
3. Fai clic sul simbolo @ a destra del nome del parametro.
4. Apporta le modifiche, poi fai clic su SALVA in basso a destra.

Configurare un parametro

Utilizza queste opzioni per configurare un parametro nell'origine dati. Per i parametri del connettore BigQuery e del connettore della community, consulta gli articoli indicati in precedenza.

Nome parametro: questo nome viene visualizzato negli elenchi dei campi disponibili nei report e nelle origini dati. Questo è anche il nome che utilizzerai per fare riferimento al parametro in un campo calcolato.

ID parametro: assegnato per impostazione predefinita. L'ID parametro viene utilizzato internamente da Looker Studio per identificare il parametro e non è visibile ai visualizzatori del report.

La modifica dell'ID parametro comporterà l'interruzione dei componenti e dei campi calcolati che includono il parametro.

Tipo di dati: i parametri possono memorizzare testo, numeri o valori booleani (vero/falso).

Valori consentiti: specifica i valori che possono essere inseriti dall'utente.

Per specificare un elenco di valori, scegli l'opzione corrispondente, poi inserisci il valore accettabile con un nome visualizzato facoltativo. Fai clic su Aggiungi opzione per aggiungere altre voci all'elenco.

Per specificare un intervallo di valori consentiti, inserisci i valori minimo e massimo per l'intervallo.

Valore predefinito: specifica un valore iniziale per il parametro.

Impostare i valori di un parametro

Puoi impostare il valore di un parametro nei modi indicati di seguito.

Impostare un valore predefinito per il parametro

Puoi impostare valori predefiniti per un parametro al momento della sua creazione. Per cambiare il valore predefinito, segui la procedura sopra riportata per modificare il parametro.

Utilizzare un controllo per acquisire l'input degli utenti

I controlli sono componenti che consentono agli utenti di interagire con un report. Per memorizzare l'input utente in un parametro, aggiungi quest'ultimo alla proprietà Campo del controllo di un controllo:

1. Modifica il report.
2. In alto, fai clic su Aggiungi un controllo.
3. Scegli il tipo di controllo da aggiungere.

4. Nel riquadro Proprietà, seleziona la scheda CONFIGURAZIONE.

5. Aggiungi il parametro al campo del controllo.

Scopri di più sui controlli.

Sostituire i valori predefiniti dei parametri in un componente

Puoi ignorare i valori predefiniti dei parametri modificando singoli componenti nel report:

1. Modifica il report.
2. Seleziona un componente in base a un'origine dati che include parametri.
3. Nella parte inferiore della scheda DATI del componente, modifica i valori predefiniti dei parametri.

Puoi modificare i parametri anche a livello di report e di pagina:

1. Modifica il report.
2. Seleziona File > Impostazioni report o Pagina > Impostazioni pagina corrente.
3. Modifica i valori parametro.

Eredità dei parametri

I parametri seguono le stesse regole sull'eredità delle proprietà del filtro. In particolare, i parametri dei componenti con precedenza più alta sostituiscono quelli dei componenti con precedenza inferiore. L'ordine di precedenza (dalla più bassa alla più alta) è:

1. Origine dati (valore predefinito)
2. Report
3. Pagina
4. Gruppo
5. Grafico o controllo singolo

Modificare i parametri tramite il link del report

L'impostazione dei parametri tramite l'URL del report consente agli sviluppatori e agli utenti avanzati di creare report che possono essere configurati in modo programmatico.

I parametri dei report di Looker Studio e i valori corrispondenti vengono trasmessi come stringhe JSON codificate tramite URL aggiunte all'URL del report utilizzando il parametro di query "params".

Scopri di più nella Guida per gli sviluppatori.

Gestire i parametri URL dei report

Per impostazione predefinita, i parametri dei report non sono modificabili tramite l'URL del report.

Per selezionare i parametri che gli utenti dei report possono modificare:

1. Modifica il report.
2. Seleziona Risorsa > Gestisci parametri URL del report.
3. Nella colonna Consenti impostazione tramite URL del report seleziona i parametri da consentire.

Questa pagina mostra anche il parametro URL per ogni parametro. Non si tratta del nome parametro, bensì del nome che utilizzerai quando crei l'oggetto parametro codificato. Puoi modificare questo nome facendo clic sull'icona a forma di matita. Ciascun parametro URL in un report deve essere univoco.

La modifica del nome del parametro URL non influisce su come viene utilizzato il parametro nel report.

Utilizzare i parametri

Una volta creati, puoi utilizzare i parametri nei campi calcolati e nei componenti del rapporto, esattamente come faresti con le dimensioni e le metriche.

Utilizzare un parametro in un campo calcolato

Puoi utilizzare un parametro nello stesso modo in cui useresti una dimensione o una metrica in un campo calcolato.

Esempio di campo calcolato con parametro

Ad esempio, supponi di voler visualizzare le vendite previste consentendo a un utente di inserire un moltiplicatore per le tue vendite del trimestre scorso.

In primo luogo, crea il parametro che conterrà il moltiplicatore di previsione:

1. Accedi a Looker Studio.
2. Modifica l'origine dati.
3. In alto a destra, fai clic su AGGIUNGI UN PARAMETRO.
4. Assegna un nome al parametro, ad esempio "Moltiplicatore di previsione".
5. Imposta Tipo di dati su Numero.
6. Per semplicità, lascia l'opzione Valori consentiti impostata su Qualsiasi valore.
   Puoi utilizzare le altre opzioni per consentire all'utente di scegliere da un elenco di valori oppure limitare l'immissione a un intervallo di valori.
7. Imposta il Valore predefinito su 1.
8. Fai clic su Salva.
9. Per tornare all'elenco dei campi dell'origine dati, fai clic su TUTTI I CAMPI a sinistra.

Crea quindi il campo calcolato:

1. In alto a destra, fai clic su AGGIUNGI UN CAMPO.
2. Assegna un nome al campo, ad esempio "Previsione delle vendite con parametro".
3. Nella formula, moltiplica il campo "Vendite" dell'origine dati per il parametro Moltiplicatore di previsione. Ad esempio, se l'origine dati ha un campo chiamato Entrate, inserisci:
   Entrate * moltiplicatore di previsione
4. Fai clic su Salva.

Poi, aggiungi un controllo per raccogliere l'input dell'utente:

1. Modifica o crea un rapporto.
2. Se necessario, aggiungi l'origine dati al report.
3. In alto, fai clic su Aggiungi un controllo.
4. Seleziona il controllo Casella di immissione.
   Il controllo Casella di immissione ti consente di digitare direttamente i valori dei parametri. Altri tipi di controlli ti permettono di selezionare elementi da un elenco, utilizzare il dispositivo di scorrimento o attivare/disattivare i valori booleani con una casella di controllo.
5. A destra, nelle proprietà DATI, aggiungi il parametro Moltiplicatore di previsione creato in precedenza.

Infine, visualizza in un grafico il campo calcolato con parametri.

1. Fai clic su  Aggiungi un grafico in alto.
2. Per semplicità, seleziona un prospetto.
3. A destra, nelle proprietà DATI, aggiungi il campo calcolato Previsione delle vendite con parametro come metrica.

Prova ora:

1. In alto a destra, fai clic su Visualizza.
2. Inserisci un numero nel controllo Moltiplicatore di previsione, quindi premi Invio.
3. Vedrai il valore che cambia nel prospetto quando viene moltiplicato per il valore che inserisci.

Utilizzare un parametro in una visualizzazione

Puoi aggiungere un parametro a un grafico, esattamente come faresti con una dimensione o una metrica. Se utilizzi un parametro numerico come metrica, il suo valore viene aggregato.

Mostrare o nascondere i parametri nei report

Puoi mostrare o nascondere i parametri che hai creato in un'origine dati:

1. Modifica l'origine dati.
2. Individua il parametro.
3. A destra del parametro, fai clic su Opzioni.
4. Fai clic su Mostra (se il parametro è attualmente nascosto) o Nascondi (se il parametro è attualmente visualizzato).

Se nascondi un parametro, questo verrà rimosso dall'elenco dei campi nel riquadro Dati e verranno interrotti tutti i componenti che lo utilizzano. Se il parametro viene utilizzato in un campo calcolato, la formula usa il valore predefinito del parametro.

Copiare un componente con parametri

Se copi un componente, vengono copiati i relativi valori dei parametri impostati nel riquadro delle proprietà. Puoi sostituire i parametri della copia modificando il componente.

Correggere i parametri non validi

Se nel connettore viene modificata la configurazione dei parametri, i grafici che utilizzano tali parametri potrebbero presentare errori. Ad esempio, se lo sviluppatore del connettore rimuove la possibilità di eseguire l'override di un valore parametro, il valore fornito nel rapporto non restituirà più dati validi. In questo caso, viene visualizzato un messaggio di errore in tutti i grafici interessati da tale modifica.

Per risolvere questo problema, individua il componente contenente il parametro now-invalid. Poi, nella sezione Parametri delle proprietà DATI di tale componente, fai clic su Correggi valori non validi.

Ricorda che i parametri possono essere impostati a livello di rapporto, pagina e gruppo, nonché per i singoli grafici, pertanto è possibile che tu debba cercare in diversi punti prima di trovare e correggere l'errore.

Risorse correlate

Informazioni sui controlli