Parametri di configurazione sostituiti

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).

Nota: i parametri possono anche essere definiti 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 abilitare l'override per un parametro, puoi omettere la chiamata a setAllowOverride().

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:

1. 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.
2. 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.

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

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.

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 la condivisione accidentale di dati sensibili, esamina e verifica che l'origine dati e le credenziali per origine dati siano configurate correttamente prima di consentire la modifica di un parametro. Se un parametro consente di accedere a dati sensibili, valuta la possibilità di utilizzare le credenziali del visualizzatore per assicurarti che i visualizzatori del report possano vedere solo i suoi dati.

Parametri URL

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

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

1. Raccogliere i nomi dei parametri

   1. Modifica il report.
   2. Seleziona Risorsa -> Gestisci parametri URL del 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 valore 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 JSON è il seguente:

   {
     "ds0.zipcode": "94094"
   }
   

3. 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"
   

4. 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.

5. 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 controllo
• ds0.units è un input di 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. 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) è:

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