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)
.
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();
}
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:
- 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.
- 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.
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
.
![Parámetro de código postal habilitado](https://developers.google.cn/static/looker-studio/connector/images/allow-url-parameters.png?authuser=7&hl=es)
![Solo se puede modificar el parámetro Código postal](https://developers.google.cn/static/looker-studio/connector/images/allow-url-parameters-2.png?authuser=7&hl=es)
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:
- Edita el informe.
- Selecciona Recurso -> Administrar parámetros de URL del informe.
- 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.
- 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:
Recopila nombres de parámetros
- Edita el informe.
- Selecciona Recurso -> Administrar parámetros de URL del informe.
- 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
.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
oBOOLEAN
. 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 como94094
, el JSON es el siguiente:{ "ds0.zipcode": "94094" }
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"
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.
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ónds0.units
es una entrada de selección únicads1.countries
es una entrada de selección múltipleds1.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:
- Fuente de datos (predeterminada)
- Denunciar URL
- Panel de propiedades del informe, según las reglas de herencia de parámetros de fuentes de datos