Parámetros

Los parámetros te permiten interactuar con datos proporcionados por los usuarios. Por ejemplo, puedes crear campos calculados que incluyan datos introducidos por las personas que usen tu informe o volver a transferir valores a la consulta de SQL que esté usando tu fuente de datos. Si usas parámetros, tus informes serán más interactivos. Los parámetros también permiten crear plantillas de informes.

Cómo funcionan los parámetros

Los parámetros actúan como las variables de un lenguaje de programación. Tienen tres usos principales:

  • Puedes usar parámetros en campos calculados para mostrar resultados que se basen en las entradas de los usuarios.
  • Puedes devolver parámetros a la consulta de SQL personalizada de una fuente de datos de BigQuery.
  • Puedes devolver parámetros a un conector comunitario.

Los datos de los parámetros pueden obtenerse de los sitios siguientes:

  • De un valor predeterminado definido para el parámetro.
  • Del panel de propiedades del componente
  • De un control incluido en el informe
  • Del enlace al informe

Los parámetros se encuentran en la parte inferior de las listas de campos en el editor del informe y el de la fuente de datos. Se muestran como campos de color morado.

Cómo comparten tus datos los parámetros en los informes

Cualquier otra persona que edite tus informes y fuentes de datos puede acceder a la información que esté controlada por parámetros. Los parámetros permiten que los editores de informes soliciten datos diferentes de los predeterminados.

Antes de habilitar los parámetros en una fuente de datos, asegúrate de entender cómo los cambios en los valores de los parámetros podrían verse reflejados en los datos de los informes. Algunos parámetros solo devuelven datos relativamente "seguros", como la información meteorológica en una configuración regional nueva. Sin embargo, otros parámetros podrían permitir que alguien solicitara otros conjuntos de datos totalmente distintos.

Por ejemplo, un parámetro de número de cuenta o el nombre de una tabla de base de datos podría devolver datos que no tenías intención de compartir, o mostrar un esquema diferente que no fuera compatible con los gráficos del informe.

Crear un parámetro

Puedes crear parámetros en los siguientes sitios:

  • Una fuente de datos
  • El conector de BigQuery

Crear un parámetro en una fuente de datos

  1. Edita la fuente de datos.
  2. En la parte superior derecha, haz clic en AÑADIR UN PARÁMETRO. También puedes crear parámetros mientras editas un informe. Para ello, debes seleccionar un componente y, en la parte inferior derecha, hacer clic en AÑADIR UN PARÁMETRO. El componente que selecciones debe basarse en la fuente de datos que quieras usar.
  3. Configura las opciones y el valor predeterminado del parámetro.

Al editar un informe, puedes usar el enlace +Añadir un parámetro del panel de datos para crear un parámetro en la fuente de datos seleccionada. Los parámetros que se añaden a nivel de informe también se añaden automáticamente a la fuente de datos y se pueden usar en varios informes con la misma conexión de fuente de datos.

Crear un parámetro en el conector de BigQuery

Puedes pasar parámetros a una consulta de SQL personalizada en el conector de BigQuery. El conector de BigQuery define varios parámetros estándar que transfieren la fecha de inicio y de finalización del informe, así como la dirección de correo del usuario, si está disponible. También puedes transferir parámetros personalizados. Más información sobre cómo conectarse a BigQuery

Parámetros y conectores comunitarios

El conector comunitario puede incluir parámetros anulables, que permiten a los editores de informes modificar los valores predeterminados de una fuente de datos. Si puedes editar la conexión de una fuente de datos creada con un conector comunitario, puedes especificar qué parámetros pueden modificar 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, 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.
  4. Marca o desmarca las casillas Permitir que <nombre de parámetro> se modifique en los informes para permitir o no que el parámetro se pueda editar en los informes.
  5. Arriba a la derecha, haz clic en VOLVER A CONECTAR.

Cuando crees una fuente de datos desde un conector comunitario, los cambios en los parámetros del conector no aparecerán en ella automáticamente. Tendrás que volver a conectar la fuente de datos para ver los parámetros nuevos, eliminados o modificados.

Editar parámetros

Para cambiar la configuración de un parámetro, sigue estos pasos:

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

Configurar parámetros

Utiliza 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 comunitario.

Nombre de parámetro: este nombre aparece en las listas de campos disponibles de los informes y las fuentes de datos. También es el nombre que usarás para hacer referencia al parámetro en un campo calculado.

ID de parámetro: se define de forma predeterminada. En Data Studio, el ID de parámetro se utiliza internamente para identificar el parámetro. Los lectores del informe no pueden verlo.

Tipo de datos: los parámetros pueden almacenar texto, números o valores booleanos (verdadero o falso).

Valores permitidos: especifica los valores que puede introducir el usuario.

Para especificar una lista de valores, elige esta opción e indica el valor aceptable junto con un nombre visible opcional. Haz clic en Añadir opción para añadir más elementos a la lista.

Para especificar un intervalo de valores permitidos, introduce un valor mínimo y un valor máximo.

Valor predeterminado: especifica un valor inicial para el parámetro.

Definir valores de parámetro

Puedes definir el valor de un parámetro de las siguientes formas:

Definir un valor predeterminado para el parámetro

Puedes definir un valor predeterminado para un parámetro mientras lo estás creando o editando.

Usar un control para obtener datos de los usuarios

Los controles son componentes que permiten a los usuarios interactuar con un informe. Para almacenar una entrada de usuario en un parámetro, añade el parámetro a la propiedad Campo Control de un control:

  1. Edita el informe.
  2. En la parte superior, haz clic en Icono de control. Añadir un control.
  3. Elige el tipo de control que quieres añadir.
  4. En el panel Propiedades, selecciona la pestaña CONFIGURACIÓN.
  5. Añade el parámetro a Campo Control.

Más información sobre los controles

Anular los valores de parámetro predeterminados en un componente

Puedes anular los valores predeterminados de los parámetros editando componentes concretos del informe:

  1. Edita el 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ámetro predeterminados.

También puedes editar parámetros de informes y páginas siguiendo estos pasos:

  1. Edita el 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 filtrado. Concretamente, 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 (opción predeterminada)
  2. Denunciar
  3. Página
  4. Grupo
  5. Gráfico o control individual

El hecho de ajustar los parámetros mediante la URL del informe permite a los desarrolladores y a los usuarios avanzados crear informes que se pueden configurar de forma programática.

Los parámetros de informe de Data Studio y sus valores correspondientes se pasan como cadenas JSON codificadas que se añaden a la URL del informe mediante el parámetro de consulta "params".

Consulta más información en la guía para desarrolladores.

Gestionar parámetros del informe

De forma predeterminada, los parámetros de los informes no se pueden editar mediante la URL del informe.

Para seleccionar qué parámetros pueden editar los usuarios del informe, sigue estos pasos:

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

En esta página también se muestra el parámetro de URL de 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 modificarlo, haz clic en el icono del lápiz. Cada parámetro de URL de un informe debe ser único.

Cambiar el nombre del parámetro de URL no afecta a cómo se usa el parámetro en el informe.

Usar parámetros

Una vez creados, puedes usar parámetros en campos calculados y componentes de informes de forma similar a como usarías dimensiones y métricas.

Usar un parámetro en un campo calculado

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

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

Por ejemplo, supongamos que quieres visualizar las ventas previstas permitiendo que alguien introduzca un multiplicador de las ventas del último trimestre.

Primero, crea el parámetro que debe incluir el multiplicador de previsión:

  1. Inicia sesión en Data Studio.
  2. Edita la fuente de datos.
  3. En la parte superior derecha, haz clic en AÑADIR UN PARÁMETRO.
  4. Asigna un nombre al parámetro (por ejemplo, "Multiplicador de previsión").
  5. En Tipo de datos, selecciona Número.
  6. Para simplificar, deja la opción Valores permitidos establecida en Cualquier valor.

    Puedes usar las otras opciones para que el usuario elija los valores que quiera de una lista o restringir la entrada a un intervalo de valores.
  7. En Valor predeterminado, elige 1.
  8. Haz clic en Guardar.
  9. Para volver a la lista de campos de la fuente de datos, haz clic en la opción TODOS LOS CAMPOS, situada en la parte izquierda de la pantalla.

A continuación, crea el campo calculado:

  1. En la parte superior derecha, haz clic en AÑADIR UN CAMPO.
  2. Asigna un nombre al campo (por ejemplo, "Previsión 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, introduce lo siguiente:

    Revenue * Forecast multiplier
  4. Haz clic en Guardar.

A continuación, añade un control para recoger la entrada del usuario:

  1. Edita o crea un informe.
  2. Si es necesario, añade la fuente de datos al informe.
  3. En la parte superior, haz clic en Icono de control. /> Añadir un control .
  4. Selecciona el control Cuadro de entrada.

    El control de cuadro de entrada te permite escribir valores de parámetros directamente. Otros tipos de controles te permiten seleccionar un valor de una lista, usar un control deslizante o activar o desactivar valores booleanos con una casilla.
  5. A la derecha, en Propiedades de DATOS, añade el parámetro Forecast multiplier que has creado anteriormente.

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

  1. En la parte superior, haz clic en Icono de añadir un gráfico. Añadir un gráfico.
  2. Para simplificar el proceso, selecciona una tarjeta de resultados.
  3. A la derecha, en Propiedades de DATOS, añade el campo calculado Sales forecast with parameter como métrica.

Ahora, pruébalo:

  1. En la parte superior derecha, haz clic en Ver.
  2. Introduzca un número en el control Multiplicador de previsión y, a continuación, pulse Intro.
  3. Verás que el valor de la tarjeta de resultados cambia, ya que se multiplica por el valor que introduzcas.

Usar un parámetro en una visualización

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

Mostrar u ocultar parámetros en los informes

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

  1. Edita la fuente de datos.
  2. Busca el parámetro.
  3. A la derecha del parámetro, haz clic en Más opciones. Opciones.
  4. Haz clic en Mostrar (si el parámetro está oculto) o en Ocultar (si el parámetro está visible).

Al ocultar un parámetro, este se quita de la lista de campos del panel Datos, y los componentes que lo utilizan dejan de funcionar. Si el parámetro se usa en un campo calculado, la fórmula utilizará el valor predeterminado.

Copiar componentes con parámetros

Al copiar un componente, se copian los valores de sus parámetros tal como se han definido en el panel de propiedades. Puedes anular los parámetros de la copia editando el componente.

Corregir parámetros no válidos

Si la configuración de los parámetros cambia en el conector, es posible que los gráficos que usen esos parámetros dejen de funcionar. Por ejemplo, el desarrollador del conector puede eliminar la posibilidad de anular el valor de un parámetro, y el valor que has proporcionado en el informe ya no devuelve datos válidos. En este caso, aparecerá un mensaje de error en los gráficos afectados por ese cambio.

Para solucionar este problema, busca el componente que contiene el parámetro que ya no es válido. A continuación, haz clic en Corregir valores no válidos, en la sección Parámetros del panel de propiedades DATOS de ese componente.

Recuerda que los parámetros se pueden definir a nivel de informe, página y grupo, así como en gráficos concretos, por lo que puede que tengas que buscar en varios sitios para encontrar y corregir el error.

Acerca de los controles