Parámetros de configuración reemplazables

Los parámetros de configuración anulables proporcionan la opción de permitir que los editores de informes modifiquen los valores predeterminados en una fuente de datos. Definir los parámetros de configuración como anulables hace que una fuente de datos sea más flexible y les brinda a los usuarios una forma de crear plantillas de informes configurables por el usuario.

Por ejemplo, un conector que proporciona datos meteorológicos podría incluir un parámetro de ubicación que permita a los usuarios de informes solicitar un informe meteorológico de una configuración regional diferente de la predeterminada.

En este documento, se describe cómo los usuarios de informes pueden definir y habilitar los parámetros anulables, y cómo los usuarios de informes pueden modificar los valores de los parámetros. Para obtener más información sobre cómo se usan los parámetros en Looker Studio, consulta Parámetros de la fuente de datos.

Roles

Los roles del usuario a los que se hace referencia en el documento:

Rol	Definición
Desarrollador de conectores	Un usuario que compiló un conector de comunidad.
Propietario de la fuente de datos	Usuario que creó una fuente de datos y es propietaria de una
Editor de informes	Un usuario con acceso de modo de edición a un informe.
Visualizador de informes	Un usuario con acceso de modo de lectura a un informe.

Define parámetros anulables

El desarrollador de conector define los parámetros de configuración en la función getConfig() de un conector de comunidad. Para definir un parámetro de configuración como anulable, el conector llama a setAllowOverride(true).

Nota: Los parámetros también se pueden definir como parte de una consulta personalizada de BigQuery.

En el siguiente ejemplo, se definen 2 parámetros anulables: zipcode y units, y 1 parámetro que no se puede anular: 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: El valor predeterminado de allowOverride es false. Si no deseas habilitar la anulación para un parámetro, puedes omitir la llamada a setAllowOverride().

Cuándo evitar definir un parámetro como anulable

Se recomienda revisar cómo Looker Studio se conecta a tus datos para aprender cómo funcionan los conectores, las fuentes de datos y los informes en relación entre sí.

Evita definir un parámetro como anulable en los siguientes casos:

1. Cuando el valor de un parámetro afecta el esquema.
   • Si un usuario cambia un valor de parámetro y el esquema de los datos nuevos que se muestran es diferente al definido en la fuente de datos, cualquier informe que dependa de la fuente de datos podría fallar debido a campos faltantes.
2. Si el valor de un parámetro controla datos sensibles. (p.ej., selección de la cuenta).
   • No definas un parámetro como anulable si deseas evitar la visualización o el uso compartido no intencional de datos sensibles.

Habilita parámetros para los usuarios de informes

Los propietarios de la fuente de datos controlan qué parámetros anulables pueden modificar los editores de informes. Del mismo modo, los editores de informes controlan qué parámetros pueden modificar los lectores de informes.

Permitir que los editores de informes modifiquen los valores de los parámetros

El propietario de la fuente de datos controla qué parámetros se pueden modificar en los informes. Esto se configura durante la creación o edición de una fuente de datos y solo se aplica a los parámetros que el desarrollador del conector definió como anulables. Si se habilita, los editores de informes podrán modificar parámetros en un informe.

En el siguiente ejemplo, un conector tiene 2 parámetros definidos como anulables: zipcode y units. El propietario de la fuente de datos solo permitió que se modifique zipcode en los informes. En el informe, el editor de informes tiene la opción de modificar el valor del parámetro zipcode.

Permitir que los lectores de informes modifiquen los valores de los parámetros

Los editores de informes controlan qué parámetros pueden modificar los lectores de informes. Cualquier visualizador del informe puede modificar los valores de los parámetros mediante la URL del informe.

Nota: El control de un editor de informes para permitir la modificación de parámetros está limitado a los parámetros que permite el propietario de la fuente de datos.

Por ejemplo, considera un conector que tiene 2 parámetros definidos como anulables: zipcode y units (figura 1). Si el propietario de la fuente de datos permitió que se modifique zipcode en los informes (figura 2), los editores de informes solo podrán permitir que los lectores de informes modifiquen zipcode. El editor de informes no tendrá acceso ni visibilidad para permitir que los visualizadores del informe modifiquen el parámetro units.

Figura 1: Configuración del conector.

Figura 2: Administra parámetros.

Advertencia: Los lectores de informes podrán acceder a cualquier dato controlado por parámetros. Para evitar compartir datos sensibles de forma involuntaria, revisa y confirma que la fuente de datos y las credenciales de la fuente de datos estén configuradas de forma correcta antes de permitir que se modifique un parámetro. Si un parámetro habilita el acceso a datos sensibles, considera usar credenciales del usuario para garantizar que los visualizadores de informes solo puedan ver sus datos.

Parámetros de URL

Para permitir que los lectores de informes editen los valores de los parámetros a través de la URL del informe, sigue estos pasos:

1. Edita el informe.
2. Selecciona Recurso -> Administrar parámetros de URL del informe.
3. Usa las casillas de verificación Permitir que se modifiquen en la URL del informe para permitir o rechazar la modificación de los valores de los parámetros en la URL del informe. Los cambios se guardan automáticamente.
4. En la esquina superior derecha, haz clic en Cerrar.

Modifica los valores de los parámetros

Los editores de informes pueden modificar los valores de los parámetros mediante el panel de propiedades del informe, mientras que los lectores de informes pueden modificar los valores de los parámetros mediante la URL del informe.

Panel de propiedades del informe

Para obtener información sobre cómo un editor de informes puede establecer valores de parámetros, consulta Modifica los parámetros de un informe.

Parámetros de URL de informes

En el caso de los parámetros que pueden modificarse en la URL del informe, los valores se pueden configurar a través de un objeto JSON con codificación URL adjunta a la URL del informe en modo de vista.

Para crear una configuración de URL, haz lo siguiente:

1. Recopila nombres de parámetros

   1. Edita el informe.
   2. Selecciona Recurso -> Administrar parámetros de URL del informe.
   3. Anota el nombre de los parámetros que deseas establecer a través de la URL del informe.

   Por ejemplo, en la siguiente figura, el nombre del parámetro es ds0.zipcode.

   

2. Crea el objeto de parámetro

   Los parámetros se definen a través de un objeto JSON. Las claves de los valores del parámetro son los nombres de los parámetros.

   {
     "parameterName": parameterValue
   }
   

   Los tipos de valor del parámetro son STRING, NUMBER o BOOLEAN. Para los parámetros que aceptan varios valores (es decir, menús desplegables de selección múltiple), usa un array de valores.

   Por ejemplo, si el nombre del parámetro es ds0.zipcode, para establecer el código postal como 94094, el JSON es el siguiente:

   {
     "ds0.zipcode": "94094"
   }
   

3. Codifica el objeto de parámetro en formato URL

   Después de crear el objeto de parámetro, usa JSON.stringify() para convertirlo en una string y, luego, usa [encodeURIComponent] para codificarlo en formato URL.

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

   Esto da como resultado la siguiente string codificada:

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

4. Crea la URL del informe

   Una vez que tengas el objeto de parámetro codificado de URL, agrégalo a la URL de vista de informes con el parámetro de consulta params.

   https://lookerstudio.google.com/reporting/REPORT_ID/page/PAGE_ID?params=%7B%22ds0.zipcode%22%3A%2294094%22%7D

   Asegúrate de reemplazar REPORT_ID y PAGE_ID con los valores de tu informe y página.

5. Usar la URL

   La URL del informe anulará los parámetros definidos en el objeto de parámetros JSON según la herencia de parámetros.

Ejemplo de objeto de parámetro

En el siguiente objeto de parámetro, se muestra cómo configurar varios parámetros. También se ilustra la configuración de valores de parámetros para los diferentes tipos de entrada.

• ds0.includeToday es una entrada de casilla de verificación
• ds0.units es una entrada de selección única
• ds1.countries es una entrada de selección múltiple
• ds1.labelName es una entrada de texto.

  {
    "ds0.includeToday": true,
    "ds0.units": "Metric",
    "ds1.countries": ["Canada", "Mexico"],
    "ds1.labelName": "Population"
  }

Herencia de parámetros

El valor que se usa para un parámetro sigue un orden de prioridad según dónde se configura el parámetro. Los parámetros establecidos en ubicaciones de prioridad más alta anulan los parámetros establecidos en ubicaciones de prioridad más baja. El orden de precedencia (de menor a mayor) es el siguiente:

1. Fuente de datos (predeterminada)
2. Denunciar URL
3. Panel de propiedades del informe, según las reglas de herencia de parámetros de fuentes de datos