Los parámetros te permiten interactuar con los datos proporcionados por el usuario. Por ejemplo, puedes crear campos calculados que incluyan entradas de las personas que usan tu informe o pasar valores a la consulta en SQL que usa tu fuente de datos. El uso de parámetros hace que tus informes sean más interactivos. También puedes usar parámetros para crear plantillas de informes.
Cómo funcionan los parámetros
Los parámetros actúan como variables en un lenguaje de programación. Los parámetros tienen 3 usos principales:
- Puedes usar parámetros en campos calculados para mostrar resultados según la entrada del usuario.
- Puedes pasar parámetros a la consulta en SQL personalizada en una fuente de datos de BigQuery.
- Puedes pasar parámetros a un conector de comunidad.
Los parámetros pueden obtener sus datos de los siguientes lugares:
- Desde un valor predeterminado definido para el parámetro
- Desde el panel de propiedades del componente.
- Desde un control ubicado en el informe.
- Desde el vínculo al informe.
Encontrarás los parámetros en la parte inferior de las listas de campos en los editores de informes y fuentes de datos. Los parámetros aparecen como campos púrpura.
Cómo los parámetros comparten tus datos en los informes
Los editores de tus informes y fuentes de datos pueden acceder a cualquier dato controlado por parámetros. Los parámetros permiten que los editores de informes soliciten datos que difieran de los predeterminados.
Antes de habilitar los parámetros para tu fuente de datos, asegúrate de comprender cómo los cambios en los valores de los parámetros podrían afectar los datos de tus informes. Es posible que algunos parámetros solo muestren datos relativamente "seguros", como el clima en una configuración regional nueva. Sin embargo, otros parámetros podrían permitir que alguien solicite conjuntos de datos completamente nuevos.
Por ejemplo, un parámetro de número de cuenta o el nombre de una tabla de base de datos podría mostrar datos que no deseas compartir o un esquema diferente, que podría ser incompatible con los gráficos existentes en el informe.
Crea un parámetro
Puedes crear parámetros en los siguientes lugares:
En una fuente de datos
- Edita la fuente de datos.
- En la esquina superior derecha, haz clic en AGREGAR UN PARÁMETRO. También puedes crear un parámetro mientras editas un informe. Para ello, selecciona un componente y, luego, haz clic en AGREGAR UN PÁRMETRO en la parte inferior derecha. Asegúrate de seleccionar un componente según la fuente de datos deseada.
- Configura las opciones y el valor predeterminado del parámetro (consulta a continuación).
Mientras editas un informe, puedes usar el vínculo +Agregar un parámetro en el panel de datos para crear un parámetro en la fuente de datos seleccionada.
En el conector de BigQuery
Puedes pasar parámetros a una consulta en SQL personalizada en el conector de BigQuery. El conector de BigQuery define varios parámetros estándar que pasan la fecha de inicio y finalización del informe, y la dirección de correo electrónico del usuario, si está disponible. También puedes pasar parámetros personalizados. Obtén más información.
Parámetros y conectores de Comunidad
El conector de Comunidad puede incluir parámetros anulables, que permiten que los editores de informes modifiquen sus valores predeterminados en una fuente de datos. Si puedes editar la conexión de una fuente de datos creada con un conector de Community, puedes especificar qué parámetros pueden cambiar los editores de informes:
- Edita la fuente de datos.
- En la esquina superior izquierda, haz clic en EDITAR CONEXIÓN.
- Si el conector proporciona parámetros editables, estos aparecerán en la parte inferior de la página. Los conectores que te permiten definir parámetros personalizados incluirán instrucciones en la página.
- Usa las casillas de verificación Permitir que se modifique <nombre del parámetro> en los informes para permitir o no la edición del parámetro en los informes.
- En la esquina superior derecha, haz clic en RECONNECTAR.
Una vez que crees una fuente de datos a partir de un conector de la comunidad, los cambios en los parámetros de ese conector no aparecerán en la fuente de datos automáticamente. Deberás volver a conectar la fuente de datos para ver los parámetros nuevos, quitados o modificados.
Cómo editar un parámetro existente
Para cambiar la configuración de un parámetro existente, sigue estos pasos:
- Edita la fuente de datos que contiene el parámetro.
- Busca el parámetro en la lista de campos.
- Haz clic en el signo @ a la derecha del nombre del parámetro.
- Realiza los cambios que desees y, luego, en la parte inferior derecha, haz clic en GUARDAR.
Configura un parámetro
Usa estas opciones para configurar un parámetro en la fuente de datos. Para conocer los parámetros del conector de BigQuery y del conector de la comunidad, consulta los artículos a los que se hace referencia anteriormente.
Nombre del parámetro : Verás este nombre en las listas de campos de tus informes y fuentes de datos. Este también es el nombre que usarás para hacer referencia al parámetro en un campo calculado.
ID del parámetro : Se establece de forma predeterminada. Looker Studio usa el ID del parámetro de forma interna para identificarlo. Los usuarios del informe no lo verán.
Tipo de datos : Los parámetros pueden almacenar valores de texto, números o booleanos (verdadero/falso).
Valores permitidos : Especifica los valores que puede ingresar el usuario.
Para especificar una lista de valores, elige esa opción y, luego, ingresa el valor aceptable junto con un nombre visible opcional. Haz clic en Agregar opción para agregar más elementos a la lista.
Para especificar un rango de valores permitidos, ingresa los valores mínimo y máximo del rango.
Valor predeterminado : Especifica un valor inicial para el parámetro.
Configura los valores de parámetros
Puedes establecer el valor de un parámetro de las siguientes maneras:
Establece un valor predeterminado para el parámetro
Puedes establecer valores predeterminados para un parámetro cuando lo creas. Para ajustar el valor predeterminado, sigue los pasos anteriores para editar el parámetro.
Usa un control para obtener entradas de los usuarios
Los controles son componentes que permiten que las personas interactúen con un informe. Para almacenar la entrada del usuario en un parámetro, agrégalo a la propiedad Campo de control de un control:
- Edita tu informe.
- En la parte superior, haz clic en
Agregar un control. - Elige el tipo de control que deseas agregar.
- En el panel Properties, selecciona la pestaña SETUP.
- Agrega el parámetro al campo de control.
Obtén más información sobre los controles.
Anula los valores de parámetros predeterminados en un componente
Para anular los valores predeterminados de los parámetros, edita los componentes individuales del informe:
- Edita tu informe.
- Selecciona un componente según una fuente de datos que incluya parámetros.
- En la parte inferior de la pestaña DATA del componente, edita los valores de los parámetros predeterminados.
También puedes editar parámetros a nivel del informe y de la página:
- Edita tu informe.
- Selecciona File > Report Settings o Page > Current Page Settings.
- Edita los valores de los parámetros.
Herencia de parámetros
Los parámetros siguen las mismas reglas de herencia que las propiedades de filtro. Específicamente, los parámetros de los componentes de precedencia más alta anulan los parámetros de los componentes de precedencia más baja. El orden de prioridad (de menor a mayor) es el siguiente:
- Fuente de datos (predeterminada)
- Informe
- Página
- Grupo
- Gráfico o control individuales
Modifica los parámetros a través del vínculo del informe
La configuración de parámetros a través de la URL del informe permite a los desarrolladores y usuarios avanzados crear informes que se pueden configurar de forma programática.
Los parámetros de informes de Looker Studio y sus valores correspondientes se pasan como cadenas JSON con codificación de URL que se agregan a la URL del informe con el parámetro de consulta "params".
Obtén más información en la Guía para desarrolladores.
Cómo administrar los parámetros de URL de los informes
De forma predeterminada, los parámetros de tus informes no se pueden editar a través de la URL del informe.
Para seleccionar qué parámetros pueden modificar los usuarios del informe, sigue estos pasos:
- Edita tu informe.
- Selecciona Recurso > Administrar parámetros de URL de informes.
- En la columna Allow setting through report URL, marca los parámetros que deseas permitir.
Esta página también muestra el parámetro de URL para cada parámetro. Este es el nombre que usarás, no el nombre del parámetro, cuando construyas el objeto de parámetro codificado. Para editar este nombre, haz clic en el lápiz de edición. Cada parámetro de URL de un informe debe ser único.
Editar el nombre del parámetro de URL no afecta la forma en que se usa el parámetro en el informe.
Usa parámetros
Una vez creados, puedes usar los parámetros en los campos calculados y los componentes de informes de la misma manera que lo harías con las dimensiones y las métricas.
Usa un parámetro en un campo calculado
Puedes usar un parámetro de la misma manera que usarías una dimensión o métrica en un campo calculado.
Ejemplo de campo calculado con parámetro
Por ejemplo, supongamos que deseas visualizar las ventas previstas permitiendo que alguien ingrese un multiplicador a tus ventas del último trimestre.
Primero, crea el parámetro para contener el multiplicador de previsión:
- Accede a Looker Studio.
- Edita tu fuente de datos.
- En la esquina superior derecha, haz clic en AGREGAR UN PARÁMETRO .
- Asigna un nombre al parámetro (por ejemplo, "Multiplicador de previsión").
- Establece el Tipo de datos en Número .
- Para simplificar, deja la opción Valores permitidos configurada en Cualquier valor .
Puedes usar las otras opciones para permitir que el usuario elija entre una lista de valores o restringir su entrada a un rango de valores. - Establece el valor predeterminado en 1.
- Haz clic en Guardar .
- Para volver a la lista de campos de la fuente de datos, a la izquierda, haz clic en TODOS LOS CAMPOS .
A continuación, crea el campo calculado:
- En la esquina superior derecha, haz clic en AGREGAR UN CAMPO .
- Asigna un nombre al campo (por ejemplo, "Pronóstico de ventas con parámetro").
- En la fórmula, multiplica el campo "Ventas" de tu fuente de datos por el parámetro Multiplicador de previsión . Por ejemplo, si tu fuente de datos tiene un campo llamado Ingresos , ingresa lo siguiente:
Ingresos \* Multiplicador de previsión - Haz clic en Guardar .
A continuación, agrega un control para recopilar la entrada del usuario:
- Edita o crea un informe.
- Si es necesario, agrega tu fuente de datos al informe.
- En la parte superior, haz clic en Agregar un control .
- Selecciona el control cuadro de entrada .
El control de cuadro de entrada te permite escribir los valores de los parámetros directamente. Otros tipos de controles te permiten seleccionar de una lista, usar un control deslizante o activar o desactivar valores booleanos con una casilla de verificación. - A la derecha, en las propiedades de DATOS, agrega el parámetro Multiplicador de previsión que creaste anteriormente.
Por último, visualiza el campo calculado parametrizado en un gráfico.
- En la parte superior, haz clic en
Agregar un gráfico . - Para simplificar, selecciona un cuadro de evaluación .
- A la derecha, en las propiedades de DATOS, agrega el campo calculado Pronóstico de ventas con parámetro como la métrica.
Ahora, pruébala:
- En la esquina superior derecha, haz clic en Ver .
- Ingresa un número en el control Multiplicador de previsión y, luego, presiona Intro.
- Verás que el valor del cuadro de evaluación cambia a medida que se multiplica por el valor que ingreses.
Usa un parámetro en una visualización
Puedes agregar un parámetro a un gráfico, de la misma manera que lo harías con una dimensión o una métrica. Si usas un parámetro numérico como métrica, su valor se agrega.
Cómo ocultar o mostrar parámetros en los informes
Puedes ocultar o mostrar los parámetros que creaste en una fuente de datos:
- Edita tu fuente de datos.
- Busca el parámetro.
- A la derecha del parámetro, haz clic en
Opciones. - Haz clic en Mostrar (si el parámetro está oculto) o Ocultar (si el parámetro está visible).
Si ocultas un parámetro, se quitará de la lista de campos del panel Datos y se dañarán los componentes que lo usen. Si el parámetro se usa en un campo calculado, la fórmula usa el valor predeterminado del parámetro.
Cómo copiar un componente con parámetros
Cuando copias un componente, se copian sus valores de parámetros tal como se establecen en el panel de propiedades. Para anular los parámetros de la copia, edita el componente.
Corrige los parámetros no válidos
Si cambia la configuración del parámetro en el conector, es posible que se dañen los gráficos que usen esos parámetros. Por ejemplo, el desarrollador del conector puede quitar la capacidad de anular un valor de parámetro, y el valor que proporcionaste en el informe ya no muestra datos válidos. En este caso, verás un mensaje de error en todos los gráficos afectados por ese cambio.
Para solucionar este problema, busca el componente que contiene el parámetro ahora no válido. Luego, en la sección Parameters de las propiedades DATA de ese componente, haz clic en Fix Invalid Values.
Recuerda que los parámetros se pueden establecer a nivel del informe, la página y el grupo, así como en gráficos individuales, por lo que es posible que debas buscar en varios lugares para encontrar y corregir el error.