Parámetros

Los parámetros te permiten interactuar con los datos proporcionados por el usuario. Por ejemplo, puedes crear campos calculados que incluyan la entrada de las personas que usan el informe o pasar valores de vuelta a la consulta en SQL que se usa en la fuente de datos. Usar parámetros hace que los 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 tres usos principales:

• Los parámetros se pueden usar en campos calculados para mostrar resultados basados en la entrada del usuario.
• Los parámetros se pueden pasar de vuelta a la consulta en SQL personalizada en una fuente de datos de BigQuery.
• Los parámetros se pueden pasar de vuelta a un conector de comunidad.

Los parámetros pueden obtener sus datos de las siguientes fuentes:

• De un valor predeterminado definido para el parámetro
• Del panel de propiedades de los componentes
• De un control colocado en el informe
• Del 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 morados.

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 que esté 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 nueva ubicación. 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ían mostrar datos que no tenías la intención de compartir. Cualquiera de estos podría mostrar un esquema diferente, que podría ser incompatible con los gráficos existentes en el informe.

Cómo crear un parámetro

Puedes crear parámetros en los siguientes lugares:

• Una fuente de datos
• El conector de BigQuery

Cómo crear un parámetro en una fuente de datos

1. Edita la fuente de datos.
2. 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, en la esquina inferior derecha, haz clic en AGREGAR UN PARÁMETRO. Asegúrate de seleccionar un componente basado en la fuente de datos deseada.
3. Configura las opciones y el valor predeterminado del parámetro.

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.

Cómo crear un parámetro 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ándares 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 para conectarte a BigQuery.

Parámetros y conectores de comunidad

Los conectores de comunidad pueden 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 comunidad, puedes especificar qué parámetros pueden cambiar los editores de informes:

1. Edita la fuente de datos.
2. En la esquina superior izquierda, haz clic en EDITAR CONEXIÓN.
3. Si el conector proporciona parámetros editables, estos aparecerán en la parte inferior de la página. Los conectores que te permitan definir parámetros personalizados incluirán instrucciones en la página.
4. Usa las casillas de verificación Permitir que <nombre del parámetro> se modifique en los informes para permitir o denegar la edición del parámetro en los informes.
5. En la esquina superior derecha, haz clic en VOLVER A CONECTAR.

Una vez que crees una fuente de datos a partir de un conector de comunidad, los cambios en los parámetros de ese conector no aparecerán automáticamente en la fuente de datos. 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, haz lo siguiente:

1. Edita la fuente de datos que contiene el parámetro.
2. Ubica el parámetro en la lista de campos.
3. Haz clic en el signo @ a la derecha del nombre del parámetro.
4. Realiza los cambios que desees y, en la parte inferior derecha, haz clic en GUARDAR.

Cómo configurar un parámetro

Usa estas opciones para configurar un parámetro en la fuente de datos. Consulta las páginas correspondientes si usas el conector de BigQuery o un conector de comunidad.

Nombre del parámetro : Verás este nombre en las listas de campos de tus informes y fuentes de datos. 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. Data Studio usa el ID del parámetro de forma interna para identificar el parámetro. Los usuarios que ven el informe no lo ven.

**Importante:** Si cambias el ID del parámetro, se interrumpirán los componentes y los campos calculados que incluyan el parámetro.

Tipo de datos : Los parámetros pueden almacenar texto, números o valores booleanos (verdadero o 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.

Cómo configurar 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.
• Usa un control para obtener información de los usuarios.
• Anula los valores de parámetros predeterminados en un componente.
• Modifica los parámetros a través del vínculo del informe.

Establece un valor predeterminado para el parámetro

Puedes establecer valores predeterminados para un parámetro cuando lo creas o lo editas.

Usa un control para obtener información 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, agrega ese parámetro a la propiedad Campo de control de un control:

1. Edita tu informe.
2. En la parte superior, haz clic en Agregar un control.
3. Elige el tipo de control que deseas agregar.
4. En el panel Propiedades, selecciona la pestaña CONFIGURACIÓN.
5. 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:

1. Edita tu informe.
2. Selecciona un componente basado en una fuente de datos que incluya parámetros.
3. En la parte inferior de la pestaña DATOS del componente, edita los valores de parámetros predeterminados.

También puedes editar parámetros a nivel del informe y de la página:

1. Edita tu informe.
2. Selecciona Archivo > Configuración del informe o Página > Configuración de la página actual.
3. Edita los valores de los parámetros.

Herencia de parámetros

Los parámetros siguen las mismas reglas de herencia que las propiedades de los filtros. Específicamente, los parámetros de los componentes de mayor prioridad anulan los parámetros de los componentes de menor prioridad. El orden de prioridad (de menor a mayor) es el siguiente:

1. Fuente de datos (predeterminado)
2. Informe
3. Página
4. Grupo
5. Gráfico o control individual

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 que los desarrolladores y los usuarios avanzados creen informes que se puedan configurar de forma programática.

Los parámetros de los informes de Data Studio y sus valores correspondientes se pasan como cadenas JSON codificadas en 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.

Administrar parámetros del informe

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, haz lo siguiente:

1. Edita tu informe.
2. Selecciona Recurso > Administrar variables (parámetros).
3. En la columna Permitir que se modifique en la URL del informe , marca los parámetros que deseas permitir.

En esta página, también se muestra el parámetro de URL para cada parámetro. Este es el nombre que usarás, no el nombre del parámetro, cuando crees 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.

Cómo usar parámetros

Una vez que los crees, podrás usar los parámetros en los campos calculados y los componentes de informes de la misma manera que usarías las dimensiones y las métricas.

Cómo usar un parámetro en un campo calculado

Puedes usar un parámetro de la misma manera que usarías una dimensión o una métrica en un campo calculado.

Campo calculado con un parámetro. Haz clic para expandir.

Por ejemplo, supongamos que deseas visualizar las ventas pronosticadas permitiendo que alguien ingrese un multiplicador a tus ventas del último trimestre.

Primero, crea el parámetro para contener el multiplicador de pronóstico:

1. Accede a Data Studio.
2. Edita tu fuente de datos.
3. En la esquina superior derecha, haz clic en AGREGAR UN PARÁMETRO.
4. Asigna un nombre al parámetro (por ejemplo, "Multiplicador de pronóstico").
5. Establece el Tipo de datos en Número.
6. Para simplificar, deja la opción Valores permitidos establecida en Cualquier valor.
   Puedes usar las otras opciones para permitir que el usuario elija de una lista de valores o restringir su entrada a un rango de valores.
7. Establece el Valor predeterminado en 1.
8. Haz clic en Guardar.
9. Para volver a la lista de campos de la fuente de datos, haz clic en TODOS LOS CAMPOS a la izquierda.

Luego, crea el campo calculado:

1. En la esquina superior derecha, haz clic en AGREGAR UN CAMPO .
2. Asigna un nombre al campo (por ejemplo, "Pronóstico de ventas con parámetro").
3. En la fórmula, multiplica el campo "Ventas" de tu fuente de datos por el parámetro Forecast multiplier. Por ejemplo, si tu fuente de datos tiene un campo llamado Ingresos, ingresa lo siguiente:
   Revenue * Forecast multiplier
4. Haz clic en Guardar.

A continuación, agrega un control para recopilar la entrada del usuario:

1. Edita o crea un informe.
2. Si es necesario, agrega tu fuente de datos al informe.
3. En la parte superior, haz clic en /> Agregar un control .
4. Selecciona el control casilla de entrada.
   El control Casilla de entrada te permite escribir valores de parámetros directamente. Otros tipos de controles te permiten seleccionar de una lista, usar un control deslizante o alternar valores booleanos con una casilla de verificación.
5. A la derecha, en Propiedades de DATOS, agrega el Forecast multiplier parámetro que creaste anteriormente.

Por último, visualiza el campo calculado parametrizado en un gráfico.

1. En la parte superior, haz clic en Agregar un gráfico.
2. Para simplificar, selecciona un Cuadro de evaluación.
3. A la derecha, en Propiedades de DATOS, agrega el Sales forecast with parameter campo calculado como la métrica.

Ahora hazlo tú mismo:

1. En la esquina superior derecha, haz clic en Ver.
2. Ingresa un número en el control Multiplicador de pronóstico y, luego, presiona Intro.
3. Verás que el valor del cuadro de evaluación cambia a medida que se multiplica por el valor que ingresas.

Cómo usar un parámetro en una visualización

Puedes agregar un parámetro a un gráfico de la misma manera que agregarías una dimensión o una métrica. Si usas un parámetro numérico como métrica, su valor se agrega.

Cómo mostrar u ocultar parámetros en los informes

Puedes mostrar u ocultar los parámetros que creaste en una fuente de datos:

1. Edita tu fuente de datos.
2. Ubica el parámetro.
3. A la derecha del parámetro, haz clic en Opciones.
4. Haz clic en Mostrar (si el parámetro está oculto) o en Ocultar (si el parámetro se muestra actualmente).

Si ocultas un parámetro, se quitará de la lista de campos del panel Datos y se interrumpirá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. Puedes anular los parámetros de la copia editando el componente.

Cómo corregir parámetros no válidos

Si cambia la configuración de parámetros en el conector, es posible que se interrumpan 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 los gráficos afectados por ese cambio.

Para solucionar este problema, ubica el componente que contiene el parámetro que ahora no es válido. Luego, en la sección Parámetros de las propiedades de DATOS de ese componente, haz clic en Corregir valores no válidos.

Recuerda que los parámetros se pueden establecer a nivel del informe, de la página y del grupo, así como en gráficos individuales, por lo que es posible que debas buscar en varios lugares para encontrar y corregir el error.

Recurso relacionado

Acerca de los controles