I parametri di configurazione sostituibili consentono agli editor dei report di modificare i valori predefiniti in un'origine dati. La definizione dei parametri di configurazione come sostituibili rende un'origine dati più flessibile e consente agli utenti di creare modelli di report configurabili dall'utente.
Ad esempio, un connettore che fornisce dati meteo potrebbe includere un parametro relativo alla località che consente ai visualizzatori dei report di richiedere un report meteo da un'impostazione internazionale diversa da quella predefinita.
Questo documento descrive come vengono definiti i parametri di cui è possibile eseguire l'override, come vengono abilitati la modifica e come i valori dei parametri possono essere modificati dagli utenti del report. Per scoprire di più su come vengono utilizzati i parametri in Looker Studio, consulta Parametri delle origini dati.
Ruoli
I ruoli utente a cui si fa riferimento nel documento:
Ruolo | Definizione |
---|---|
Sviluppatore del connettore | Un utente che ha creato un connettore della community. |
Proprietario origine dati | Un utente che ha creato un'origine dati e ne è proprietario. |
Editor di report | Un utente con accesso in modalità di modifica a un report. |
Visualizzatore report | Un utente con accesso in modalità di visualizzazione a un report. |
Definizione dei parametri di cui è possibile eseguire l'override
Lo sviluppatore connettore definisce i parametri di configurazione nella funzione getConfig()
di un connettore della community. Per definire un parametro di configurazione come sostituibile, il connettore chiama setAllowOverride(true)
.
L'esempio seguente definisce due parametri di cui è possibile eseguire l'override: zipcode
e units
e un parametro di cui non è possibile eseguire l'override: days-to-forcecast
.
function getConfig(request) {
var config = cc.getConfig();
// A
config
.newTextInput()
.setId("zipcode")
.setName("ZIP Code")
.setAllowOverride(true);
// B
config
.newSelectSingle()
.setId("units")
.setName("Units")
.addOption(
config
.newOptionBuilder()
.setLabel("Metric")
.setValue("metric")
)
.addOption(
config
.newOptionBuilder()
.setLabel("Imperial")
.setValue("imperial")
)
.setAllowOverride(true);
// C
config
.newTextInput()
.setId("days-to-forecast")
.setName("Days to forecast")
.setAllowOverride(false);
return config.build();
}
Quando evitare di definire un parametro come sostituibile
Per sapere in che modo i connettori, le origini dati e i report funzionano in relazione tra loro, consulta l'articolo In che modo Looker Studio si connette ai dati.
Evita di definire un parametro come sostituibile nei seguenti casi:
- Quando il valore di un parametro influisce sullo schema.
- Se un utente modifica un valore parametro e lo schema dei nuovi dati restituiti è diverso da quello definito nell'origine dati, qualsiasi report dipendente dall'origine dati potrebbe non funzionare a causa di campi mancanti.
- Se un valore parametro controlla dati sensibili. Ad es. selezione dell'account.
- Non definire un parametro come override se vuoi impedire la visualizzazione o la condivisione involontaria di dati sensibili.
Attivare i parametri per gli utenti del report
I proprietari delle origini dati controllano quali parametri sottoponibili a override possono essere modificati dagli editor dei report. Analogamente, gli editor del report controllano quali parametri possono essere modificati dai visualizzatori del report.
Consenti agli editor del report di modificare i valori dei parametri
Il proprietario dell'origine dati controlla quali parametri è possibile modificare nei report. Viene configurato durante la creazione o la modifica di un'origine dati ed è applicabile solo ai parametri che sono stati definiti come ignorabili dallo sviluppatore del connettore. Se questa opzione è abilitata, gli editor del report potranno modificare i parametri in un report.
Nell'esempio seguente, un connettore ha due parametri definiti come override:
zipcode
e units
. Il proprietario dell'origine dati ha consentito la modifica
solo di zipcode
nei report. Nel report, l'editor del report consente di modificare il valore del parametro zipcode
.
Consenti ai visualizzatori del report di modificare i valori dei parametri.
Gli editor dei report controllano quali parametri possono essere modificati dai visualizzatori del report. I valori dei parametri possono quindi essere modificati tramite l'URL del report da qualsiasi visualizzatore del report.
Ad esempio, considera un connettore con 2 parametri definiti come override:
zipcode
e units
(figura 1). Se il proprietario dell'origine dati ha consentito la modifica di zipcode
nei report (figura 2), gli editor del report saranno in grado di consentire la modifica di zipcode
solo ai visualizzatori del report. L'editor del report non avrà accesso o visibilità per consentire la modifica del parametro units
da parte dei visualizzatori del report.
![Parametro codice postale attivato](https://developers.google.cn/static/looker-studio/connector/images/allow-url-parameters.png?authuser=8&hl=it)
![Puoi modificare solo il parametro Codice postale](https://developers.google.cn/static/looker-studio/connector/images/allow-url-parameters-2.png?authuser=8&hl=it)
Parametri URL
Per consentire ai visualizzatori del report di modificare i valori dei parametri tramite l'URL del report:
- Modifica il report.
- Seleziona Risorsa -> Gestisci parametri URL del report.
- Utilizza le caselle di controllo Consenti la modifica nell'URL del report per consentire o non consentire la modifica dei valori dei parametri nell'URL del report. Le modifiche vengono salvate automaticamente.
- Fai clic su Chiudi in alto a destra.
Modifica dei valori dei parametri
Gli editor dei report possono modificare i valori dei parametri tramite il riquadro delle proprietà del report, mentre i visualizzatori dei report possono modificare i valori dei parametri tramite l'URL del report.
Riquadro delle proprietà del report
Per informazioni su come un editor di report può impostare i valori dei parametri, consulta Modificare i parametri in un report.
Parametri URL per i report
Per i parametri di cui è consentita la modifica nell'URL del report, i valori possono essere impostati tramite un oggetto JSON con codifica URL aggiunto all'URL del report in modalità di visualizzazione.
Per creare una configurazione di URL:
Raccogliere i nomi dei parametri
- Modifica il report.
- Seleziona Risorsa -> Gestisci parametri URL del report.
- Prendi nota del nome dei parametri che intendi impostare tramite l'URL del report.
Ad esempio, nella figura seguente il nome del parametro è
ds0.zipcode
.Crea l'oggetto parametro
I parametri sono definiti tramite un oggetto JSON. Le chiavi per i valori dei parametri sono i nomi dei parametri.
{ "parameterName": parameterValue }
I tipi di valore dei parametri sono
STRING
,NUMBER
oBOOLEAN
. Per i parametri che accettano più valori (ad es. menu a discesa a selezione multipla), utilizza un array di valori.Ad esempio, se il nome del parametro è
ds0.zipcode
, per impostare il codice postale su94094
, il JSON è il seguente:{ "ds0.zipcode": "94094" }
Codifica nell'URL l'oggetto parametro
Dopo aver creato l'oggetto parametro, utilizza JSON.stringify() per trasformarlo in una stringa, quindi utilizza [encodeURIComponente] per codificarlo tramite URL.
var params = { "ds0.zipcode": "94094" }; var paramsAsString = JSON.stringify(params); var encodedParams = encodeURIComponent(paramsAsString)
Questo genera la seguente stringa codificata:
"%7B%22ds0.zipcode%22%3A%2294094%22%7D"
Creare l'URL del report
Quando hai l'oggetto parametro codificato nell'URL, aggiungilo all'URL della vista report utilizzando il parametro di query
params
.https://lookerstudio.google.com/reporting/REPORT_ID/page/PAGE_ID?params=%7B%22ds0.zipcode%22%3A%2294094%22%7D
Assicurati di sostituire REPORT_ID e PAGE_ID con i valori del report e della pagina.
Usa l'URL
L'URL del report sostituirà i parametri come definiti nell'oggetto Parametri JSON in base all'ereditarietà dei parametri.
Esempio di oggetto parametro
Il seguente oggetto parametro mostra come impostare più parametri. Illustra inoltre l'impostazione dei valori dei parametri per i diversi tipi di input.
ds0.includeToday
è un input di casella di controllods0.units
è un input di selezione singolads1.countries
è un input a selezione multiplads1.labelName
è un input di testo.
{
"ds0.includeToday": true,
"ds0.units": "Metric",
"ds1.countries": ["Canada", "Mexico"],
"ds1.labelName": "Population"
}
Eredità dei parametri
Il valore utilizzato per un parametro segue un ordine di precedenza in base a dove è impostato. I parametri impostati nelle località con precedenza più alta sostituiscono quelli impostati nelle località con precedenza più bassa. L'ordine di precedenza (dal più basso al più alto) è:
- Origine dati (valore predefinito)
- URL del report
- Riquadro delle proprietà del report, seguendo le regole di ereditarietà dei parametri dell'origine dati.