Parametri di configurazione sostituiti

I parametri di configurazione sostituibili offrono la possibilità di consentire agli editor dei report di modificare i valori predefiniti di un'origine dati. Se definisci i parametri di configurazione come un'origine dati più flessibile e offre agli utenti un modo per creare modelli di report.

Ad esempio, un connettore che fornisce dati meteo potrebbe includere una località parametro che consente ai visualizzatori dei report di richiedere un report meteo da una lingua diverso da quello predefinito.

Questo documento descrive come vengono definiti i parametri sostituibili, attivati per la modifica e come i valori dei parametri possono essere modificati dagli utenti dei report. Per ulteriori informazioni 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 in tutto il documento:

Ruolo	Definizione
Sviluppatore connettore	Un utente che ha creato un connettore della community.
Proprietario dell'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 del connettore definisce i parametri di configurazione nel funzione getConfig() di un della community. Definire un parametro di configurazione come sostituibile dal connettore chiama setAllowOverride(true).

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

Nell'esempio seguente vengono definiti due parametri sostituibili: zipcode e units e 1 parametro non sostituibile: 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 di un parametro, puoi omettere la chiamata a setAllowOverride().

Quando evitare di definire un parametro come sostituibile

Ti consigliamo di scoprire come funzionano i connettori, le origini dati e i report la relazione tra loro consultando In che modo Looker Studio si connette ai tuoi 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 restituito è diverso da quello definito nell'origine dati, qualsiasi report dipende 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 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 i parametri di cui è possibile eseguire l'override modificato dagli editor dei report. Analogamente, gli editor dei report controllano quali possono essere modificati dai visualizzatori del report.

Consentire agli editor dei report di modificare i valori dei parametri

Il proprietario dell'origine dati stabilisce quali parametri possono essere modificati in report. Viene configurata durante la creazione o la modifica di un'origine dati e e applicabile solo ai parametri che sono stati definite come ignorabili dal Connector di sviluppo software. Se l'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 autorizzato solo zipcode a essere modificati nei report. Nel report, l'editor di report ha la possibilità di modificare il valore del parametro zipcode.

Consentire ai visualizzatori dei report di modificare i valori dei parametri.

Gli editor di report controllano quali parametri possono essere modificati dai visualizzatori dei 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 per consentire la modifica dei parametri è limitatamente 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 zipcode nei report (Figura 2), quindi solo gli editor dei report può consentire la modifica di zipcode da parte dei visualizzatori del report. Il report editor non avrà accesso o visibilità per consentire il parametro units modificati dai visualizzatori dei report.

Figura 1: configurazione del connettore.

Figura 2: gestione dei parametri.

di Gemini Advanced.

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

Parametri URL

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

1. Modifica il report.
2. Seleziona Risorsa -> Gestisci i 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 sono salvate automaticamente.
4. Fai clic su Chiudi in alto a destra.

Modifica dei valori dei parametri

Gli editor di report possono modificare i valori dei parametri utilizzando il riquadro delle proprietà del report. mentre i visualizzatori del 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 parametro, consulta: Modificare i parametri in un report.

Parametri URL del report

Per i parametri che che possono essere modificate nell'URL del report, i valori possono essere impostato tramite un oggetto JSON con codifica URL aggiunto all'URL del report in modalità di visualizzazione.

Per creare una configurazione di URL:

1. Raccogli i nomi dei parametri

   1. Modifica il report.
   2. Seleziona Risorsa -> Gestisci i parametri URL del report.
   3. Prendi nota del nome dei parametri che intendi impostare tramite il report URL.

   Ad esempio, nella figura sotto il nome del parametro è ds0.zipcode.

   

2. crea l'oggetto parametro

   I parametri vengono definiti tramite un oggetto JSON. Le chiavi per i valori parametro sono i nomi dei parametri.

   {
     "parameterName": parameterValue
   }
   

   I tipi di valore parametro sono STRING, NUMBER o BOOLEAN. Per per i parametri che accettano più valori (ovvero, menu a discesa a selezione multipla) utilizzano un un array di valori.

   Ad esempio, se il nome del parametro è ds0.zipcode, per impostare il codice postale su 94094, il formato 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 [encodeURIComponent] per codificarlo nell'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

   Una volta ottenuto l'oggetto parametro codificato nell'URL, aggiungilo alla vista report URL che utilizza 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 relativi ai tuoi il report e la pagina.

5. Utilizza l'URL

   L'URL del report sostituirà i parametri definiti nei parametri JSON. in base all'ereditarietà dei parametri.

Esempio di oggetto parametro

Il seguente oggetto parametro mostra come impostare più parametri. Inoltre, illustra l'impostazione dei valori dei parametri per i diversi tipi di input.

• ds0.includeToday è l'input di una 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 il parametro è impostato. I parametri impostati in località con precedenza più alta hanno la precedenza impostati con posizioni di precedenza inferiori. L'ordine di precedenza (da dal più basso al più alto) è:

1. Origine dati (valore predefinito)
2. URL del report
3. Riquadro delle proprietà del report, che segue l'origine dati di ereditarietà dei parametri.