Parametri di configurazione sostituiti

I parametri di configurazione sostituibili offrono la possibilità di consentire 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.

Ad esempio, un connettore che fornisce dati meteorologici potrebbe includere un parametro di posizione che consenta ai visualizzatori del report di richiedere un report meteo da una località diversa da quella predefinita.

Questo documento descrive come vengono definiti i parametri sostituibili, come vengono abilitati per la modifica e come i valori dei parametri possono essere modificati dagli utenti dei 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 viene fatto riferimento nel documento:

Ruolo	Definizione
Sviluppatore di connettori	Un utente che ha creato un connettore della community.
Proprietario dell'origine dati	Un utente che ha creato e possiede un'origine dati.
Editor del report	Un utente con accesso alla modalità di modifica di un report.
Visualizzatore del report	Un utente con accesso in modalità di visualizzazione a un report.

Definizione dei parametri di cui è possibile eseguire l'override

Lo sviluppatore del 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).

Nota: i parametri possono essere definiti anche come parte di una query personalizzata BigQuery.

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();
}

Nota: il valore predefinito per allowOverride è false. Se non vuoi attivare l'override per un parametro, puoi omettere la chiamata a setAllowOverride().

Quando evitare di definire un parametro come sostituibile

Ti consigliamo di scoprire come funzionano connettori, origini dati e report in relazione tra loro consultando l'articolo In che modo Looker Studio si connette ai dati.

Evita di definire un parametro come sostituibile nei seguenti casi:

1. Quando il valore di un parametro influisce sullo schema.
   • Se un utente modifica un valore del parametro e lo schema dei nuovi dati restituiti è diverso da quello definito nell'origine dati, qualsiasi report che dipende dall'origine dati potrebbe non funzionare a causa dei campi mancanti.
2. Se un valore parametro controlla dati sensibili. Ad es. selezione dell'account.
   • Non definire un parametro come sostituibile se vuoi evitare la visualizzazione o la condivisione involontaria di dati sensibili.

Attivazione dei parametri per gli utenti dei report

I proprietari delle origini dati controllano quali parametri sostituibili possono essere modificati dagli editor dei report. Analogamente, gli editor dei report controllano quali parametri possono essere modificati dai visualizzatori dei report.

Consenti agli editor dei report di modificare i valori dei parametri

Il proprietario dell'origine dati controlla quali parametri possono essere modificati nei report. Questa opzione viene configurata durante la creazione o la modifica di un'origine dati ed è applicabile solo ai parametri che sono stati definiti come sovrascrivibili dallo sviluppatore del connettore. Se questa opzione è attivata, gli editor dei report potranno modificare i parametri in un report.

Nell'esempio seguente, un connettore ha due parametri definiti come sostituibili: zipcode e units. Il proprietario dell'origine dati ha consentito la modifica di zipcode solo nei report. Nel report, l'editor del report ha la possibilità di modificare il valore del parametro zipcode.

Consenti ai visualizzatori dei report di modificare i valori dei parametri

Gli editor dei report controllano quali parametri possono essere modificati dai visualizzatori dei report. I valori dei parametri possono essere modificati tramite l'URL del report da qualsiasi visualizzatore del report.

Nota :il controllo di un editor del report sulla possibilità di modificare i parametri è limitato ai parametri consentiti dal proprietario dell'origine dati.

Ad esempio, considera un connettore con due parametri definiti come sostituibili: zipcode e units (figura 1). Se il proprietario dell'origine dati ha consentito la modifica di zipcode nei report (figura 2), gli editor dei report potranno solo consentire la modifica di zipcode da parte dei visualizzatori dei report. L'editor dei report non avrà accesso o visibilità per consentire la modifica del parametro units da parte degli spettatori dei report.

Figura 1: configurazione del connettore.

Figura 2: gestione dei parametri.

Avviso: i visualizzatori dei report potranno accedere a tutti i dati controllati dai parametri. Per evitare di condividere involontariamente dati sensibili, rivedi e conferma che l'origine dati e le credenziali dell'origine dati siano configurate correttamente prima di consentire la modifica di un parametro. Se un parametro consente l'accesso a dati sensibili, valuta la possibilità di utilizzare le credenziali del visualizzatore per assicurarti che i visualizzatori del report possano vedere solo i propri dati.

Parametri URL

Per consentire ai visualizzatori dei report di modificare i valori dei parametri tramite l'URL del report:

1. Modifica il report.
2. Seleziona Risorsa -> Gestisci parametri report.
3. Utilizza le caselle di controllo Consenti la modifica nell'URL del report per consentire o impedire la modifica dei valori dei parametri nell'URL del report. Le modifiche vengono salvate automaticamente.
4. Fai clic su Chiudi in alto a destra.

Modificare i valori dei parametri

Gli editor dei report possono modificare i valori dei parametri utilizzando il riquadro delle proprietà del report, mentre i visualizzatori dei report possono modificarli tramite l'URL del report.

Riquadro delle proprietà del report

Per scoprire come un editor di report può impostare i valori dei parametri, consulta Modificare i parametri in un report.

Parametri URL del report

Per i parametri che possono essere modificati nell'URL del report, i valori possono essere impostati tramite un oggetto JSON codificato tramite URL aggiunto all'URL del report in modalità di visualizzazione.

Per creare una configurazione URL:

1. Raccogliere i nomi dei parametri

   1. Modifica il report.
   2. Seleziona Risorsa -> Gestisci parametri report.
   3. 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.

   

2. 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 valori dei parametri sono STRING, NUMBER o BOOLEAN. 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 su 94094, il codice JSON è il seguente:

   {
     "ds0.zipcode": "94094"
   }
   

3. Codifica URL dell'oggetto parametro

   Dopo aver creato l'oggetto parametro, utilizza JSON.stringify() per trasformarlo in una stringa, quindi utilizza [encodeURIComponent] per codificarlo tramite URL.

   var params = {
     "ds0.zipcode": "94094"
   };
   var paramsAsString = JSON.stringify(params);
   var encodedParams = encodeURIComponent(paramsAsString)
   

   Il risultato è la seguente stringa codificata:

   "%7B%22ds0.zipcode%22%3A%2294094%22%7D"
   

4. Creare l'URL del report

   Una volta ottenuto l'oggetto parametro codificato tramite URL, aggiungilo all'URL della visualizzazione del 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.

5. Utilizzare l'URL

   L'URL del report sostituirà i parametri definiti nell'oggetto dei 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 della casella di controllo
• ds0.units è un input a selezione singola
• ds1.countries è un input a selezione multipla
• ds1.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 il parametro. I parametri impostati nelle posizioni con precedenza più alta sostituiscono quelli impostati nelle posizioni con precedenza inferiore. L'ordine di precedenza (dalla più bassa alla più alta) è:

1. Origine dati (valore predefinito)
2. URL della segnalazione
3. Riquadro delle proprietà del report, seguendo le regole di ereditarietà dei parametri dell'origine dati.