Uso de parámetros en paneles en tiempo real

Los parámetros son los elementos básicos de los filtros en los paneles en tiempo real. Los administra a nivel de panel y los agrega a las consultas para filtrar los datos que se muestran en un visual. Una consulta puede utilizar uno o varios parámetros.

En este artículo se explica cómo crear y utilizar parámetros, filtros cruzados y desgloses en paneles. Puede filtrar los elementos visuales del panel seleccionando valores de parámetros en la barra de filtros o mediante filtros cruzados.

Los ejemplos de consulta que se usan en este artículo se basan en la tabla StormEvents de los datos de ejemplo de Análisis meteorológico disponibles en la galería de ejemplos.

Requisitos previos

• Un espacio de trabajo con una capacidad habilitada para Microsoft Fabric.
• Permisos del editor en un panel en tiempo real
• Un panel con objetos visuales

Visualización de la lista de parámetros

Para ver la lista de todos los parámetros del panel, seleccione Administrar>Parámetros.

Creación de un parámetro

Para crear un parámetro:

1. Seleccione el botón Nuevo parámetro en el menú superior. Se abrirá el panel Parámetros.
2. Seleccione + Agregar en la parte superior del panel derecho.
3. Rellene las propiedades pertinentes para el parámetro.
4. Seleccione Done (Listo) para crear el parámetro.

Propiedades

En el panel Agregar parámetro, configure las siguientes propiedades.

Administrar parámetros

Después de seleccionar Parámetros en la barra superior, puede ver la lista de parámetros existentes. En cada tarjeta de parámetros, seleccione el icono de edición para modificar el parámetro o seleccione Más [...] para duplicarlo, eliminarlo o moverlo.

Puede ver los siguientes indicadores en la tarjeta de parámetros:

• Nombre para mostrar del parámetro.
• Nombre de variable.
• Número de consultas que usan el parámetro .
• Páginas donde aparece el parámetro.

Puede reordenar las tarjetas de parámetros mediante arrastrar y colocar o mediante Mover a >.

Uso de parámetros en su consulta

Se debe usar un parámetro en la consulta antes de que el filtro afecte a ese objeto visual. Después de definir un parámetro, puede verlo en la barra de filtro de la página Consulta y en la consulta IntelliSense.

Tipos de parámetro

El panel admite los siguientes tipos de parámetros:

• Parámetro de intervalo de tiempo predeterminado
• Parámetros de valores fijos de selección única
• Parámetros de valores fijos de selección múltiple
• Parámetros basados en consultas de selección única
• Parámetros basados en consultas de selección múltiple
• Parámetros de texto libre
• Parámetros de orígenes de datos

En los ejemplos siguientes, se describe cómo usar los parámetros en una consulta para varios tipos de parámetros.

Parámetro de intervalo de tiempo predeterminado

Cada panel incluye un parámetro de intervalo de tiempo de forma predeterminada. Aparece como filtro solo cuando se usa en una consulta. Use las _startTime palabras clave y _endTime para aplicar el parámetro de intervalo de tiempo predeterminado, como se muestra en el ejemplo siguiente:

StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

Al guardar la consulta, el filtro de intervalo de tiempo aparece en el panel. Después, puede filtrar el objeto visual seleccionando un valor preestablecido en Intervalo de tiempo o seleccionando Intervalo de tiempo personalizado.

Parámetros de valores fijos de selección única

Los parámetros de valor fijo se basan en valores predefinidos que especifique. En el ejemplo siguiente se muestra cómo crear un parámetro de selección única y de valor fijo.

Crear un parámetro de valores fijos de selección único

1. Seleccione Parámetros para abrir el panel Parámetros y, a continuación, seleccione Nuevo parámetro.

2. Escriba los siguientes datos:

   • Etiqueta: tipo de evento

   • Tipo de parámetro: selección única

   • Variable name Nombre de la variable: _eventType

   • Tipo de datos: cadena

   • Anclar como filtro de panel: Seleccionado

   • Origen: valores fijos

     En este ejemplo, se usan los siguientes valores:

     Valor	Nombre para mostrar del parámetro
     Viento de tormenta	Viento de tormenta
     Granizo	Granizo
     Inundación repentina	Inundación repentina
     Sequía	Sequía
     Clima de invierno	Clima de invierno

   • Agregar un valor Seleccionar todo: Sin marcar

   • Valor predeterminado: viento de tormenta

3. Seleccione Done (Listo) para crear el parámetro.

El parámetro aparece en el panel Parámetros, pero todavía no se usa en ningún elemento visual.

Uso de un parámetro de valores fijos de selección única

1. Ejecute una consulta de ejemplo que use el nuevo parámetro Event Type mediante el nombre de la _eventType variable:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType == _eventType
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   El nuevo parámetro aparece en la lista de parámetros de la parte superior del panel.

2. Seleccione valores diferentes para actualizar los objetos visuales.

   

Parámetros de valores fijos de selección múltiple

Los parámetros de valor fijo se basan en valores predefinidos que especifique. En el ejemplo siguiente se muestra cómo crear y usar un parámetro de valor fijo de selección múltiple.

Crear un parámetro de valores fijos de selección múltiple

1. Seleccione Parámetros para abrir el panel Parámetros y, a continuación, seleccione Nuevo parámetro.

2. Rellene los detalles como se describe en Creación de un parámetro de valores fijos de selección única, con los siguientes cambios:

   • Etiqueta: tipo de evento
   • Tipo de parámetro: selección múltiple
   • Variable name Nombre de la variable: _eventType

3. Seleccione Done (Listo) para crear el parámetro.

El nuevo parámetro aparece en el panel Parámetros, pero todavía no lo has usado en ninguna visualización.

Usar un parámetro de valores fijos de selección múltiple

1. Ejecute una consulta de ejemplo que use el nuevo parámetro Event Type y la _eventType variable .

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   El nuevo parámetro aparece en la lista de parámetros de la parte superior del panel.

2. Seleccione uno o más valores diferentes para actualizar los objetos visuales.

   

Parámetros basados en consultas de selección única

Los valores de parámetros basados en consultas se obtienen durante la carga del cuadro de mando al ejecutar la consulta de parámetros. En el ejemplo siguiente, se muestra cómo crear un parámetro de selección única basado en consulta.

Crear un parámetro basado en una consulta de selección única

1. Seleccione Parámetros para abrir el panel Parámetros y, a continuación, seleccione Nuevo parámetro.

2. Rellene los detalles como se describe en Creación de un parámetro de valores fijos de selección única, con los siguientes cambios:

   • Etiqueta: Estado

   • Variable name Nombre de la variable: _state

   • Origen: Consulta

   • Origen de datos: StormEventsSample

   • Seleccione Editar consulta y escriba la consulta siguiente. Seleccione Listo.

     StormEvents
     | where StartTime between (_startTime.._endTime)
     | where EventType in (_eventType) or isempty(_eventType)
     | summarize TotalEvents = count() by State
     | top 5 by TotalEvents
     | project State
     

   • Valor: Estado

   • Nombre para mostrar: Estado

   • Valor predeterminado: elija un valor predeterminado.

3. Seleccione Done (Listo) para crear el parámetro.

Uso de un parámetro basado en una consulta de selección única

1. La siguiente consulta de ejemplo con el nuevo parámetro State utiliza la variable _state:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State == _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   El nuevo parámetro aparece en la lista de parámetros de la parte superior del panel.

2. Seleccione valores diferentes para actualizar los objetos visuales.

Parámetros basados en consultas de selección múltiple

Los valores de parámetros basados en consultas proceden de ejecutar una consulta especificada por el usuario cuando se carga el panel. En el ejemplo siguiente se muestra cómo crear un parámetro basado en consultas de selección múltiple.

Crear un parámetro basado en una consulta de selección múltiple

1. Seleccione Parámetros para abrir el panel Parámetros y, a continuación, seleccione + Nuevo parámetro.

2. Escriba los detalles como se describe en Creación de un parámetro basado en consultas de selección única, con los siguientes cambios:

   • Etiqueta: Estado
   • Tipo de parámetro: selección múltiple
   • Variable name Nombre de la variable: _state

3. Seleccione Done (Listo) para crear el parámetro.

Usar un parámetro basado en consultas de selección múltiple

1. La siguiente consulta de ejemplo utiliza el nuevo parámetro State mediante la variable _state.

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State in (_state) or isempty(_state)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Nota:

   En este ejemplo se usa la opción Seleccionar todo al comprobar si hay valores vacíos mediante la función isempty().

   El nuevo parámetro aparece en la lista de parámetros de la parte superior del panel.

2. Seleccione uno o más valores diferentes para actualizar los objetos visuales.

Parámetros de texto libre

Los parámetros de texto libre no contienen ningún valor. Le permiten introducir su propio valor.

Creación de un parámetro de texto libre

1. Seleccione Parámetros para abrir el panel Parámetros y, a continuación, seleccione + Nuevo parámetro.
2. Escriba los siguientes datos:
   • Etiqueta: Estado
   • Tipo de parámetro: Texto libre
   • Variable name Nombre de la variable: _state
   • Tipo de datos: cadena
   • Valor predeterminado: Sin valor predeterminado
3. Seleccione Done (Listo) para crear el parámetro.

Usar un parámetro de texto libre

1. Ejecute una consulta de ejemplo con el nuevo parámetro State mediante el nombre de variable _state:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State contains _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

Parámetros de orígenes de datos

Después de agregar orígenes de datos al panel, puede crear un parámetro que seleccione uno o varios de los orígenes de datos disponibles. Use este parámetro en iconos y otros parámetros.

Creación de un parámetro de origen de datos

1. Seleccione Parámetros para abrir el panel Parámetros y, a continuación, seleccione + Nuevo parámetro.

2. Escriba los siguientes datos:

   • Etiqueta: Origen
   • Tipo de parámetro: origen de datos
   • Mostrar en páginas: seleccionar todo
   • Valores: Seleccionar todo
   • Valor predeterminado: StormEvents

   

3. Seleccione Listo.

La lista de parámetros de la parte superior del panel ahora muestra el nuevo parámetro.

Uso de un parámetro de origen de datos

1. Vaya a la consulta de un icono nuevo o existente.

2. En Origen, seleccione el nombre del nuevo parámetro en Parámetros de origen de datos, como el nuevo parámetro Origen.

   

3. Seleccione Aplicar cambios.

4. Use el parámetro Origen para cambiar el origen de datos de esta consulta conectada.

Parámetros de filtro cruzado

Un filtro cruzado es una característica de un panel que se usa para seleccionar un valor en un objeto visual y filtrar los datos de otros objetos visuales en el mismo panel. El uso de filtros cruzados consigue el mismo resultado que si se selecciona el valor equivalente del parámetro en la lista de parámetros de la parte superior del panel.

Definición de filtros cruzados

Para crear un filtro cruzado, active la opción en el objeto visual y, a continuación, especifique el parámetro que filtra los datos.

1. Vaya a la consulta del icono donde desea agregar filtros cruzados.

2. Seleccione Visual.

3. En el panel derecho, seleccione Interacciones y active los filtros cruzados.

4. Opcionalmente, especifique el tipo de Interacción. El valor predeterminado es Point ,donde se selecciona un valor en el objeto visual. Para seleccionar un intervalo de valores, como en un gráfico de tiempo, seleccione Arrastrar.

5. Especifique la columna que proporciona el valor y un parámetro que filtra la consulta de los objetos visuales.

   Importante

   La columna y el parámetro deben ser del mismo tipo de datos.

Interactuar con tus datos usando el filtro cruzado

Después de definir el filtro cruzado, úselo para interactuar con los datos. En los objetos visuales en los que se definen filtros cruzados, seleccione puntos de datos y use sus valores para filtrar la página del panel actual. Para los objetos visuales de tabla, haga clic con el botón derecho en la celda pertinente y, a continuación, seleccione Filtro cruzado.

Puede restablecer el filtro cruzado seleccionando Restablecer en la parte superior del visual en el que lo seleccionó.

Uso de obtenciones de detalles como parámetros de panel

Las acciones de obtención de detalles le permiten seleccionar un valor en un elemento visual y usarlo para filtrar elementos visuales en una página de destino del mismo panel. Cuando se abre la página de destino, el valor se preselecciona en los filtros pertinentes. Los objetos visuales de la página, como gráficos de líneas o de dispersión, solo muestran datos relacionados. Esta característica es útil cuando desea profundizar desde una página de resumen a una página de detalles. Para obtener información sobre la creación de páginas, consulte Añadir página.

Definir un drillthrough

Para crear un desglose, active la opción en el elemento visual y, a continuación, especifique uno o varios parámetros de desglose que filtren los datos.

1. En su página principal, entre en el modo de edición.

2. Edite el objeto visual en el que desea agregar una obtención de detalles. Asegúrese de que la pestaña Visual esté seleccionada.

   

3. En el panel derecho, seleccione Interacciones y, a continuación, active la exploración en profundidad.

   

4. En Drillthrough, seleccione Crear nuevo y especifique la siguiente información. Opcionalmente, seleccione Agregar otro par para agregar varios parámetros para una página de destino. Repita este paso para agregar detalles a otras páginas del panel actual mediante distintos parámetros.

   Campo	Descripción
   Página de destino	Una o varias páginas de destino a las que explorar en profundidad mediante los parámetros definidos.
   Columna	Columna del resultado de la consulta que se va a usar como valor para un parámetro en la página de destino.
   Parámetro	Parámetro usado para filtrar objetos visuales en la página de destino mediante el valor de columna.
   Notas	Descripción breve opcional.

   Importante

   Los pares de columna y parámetro deben ser del mismo tipo de datos.

   

Interactúe con sus datos mediante desgloses

Después de definir los desgloses, úselos para interactuar con sus datos. En los objetos visuales o tablas en los que define una exploración en profundidad, haga clic con el botón derecho en un punto de datos y, a continuación, seleccione Ir a>página de destino. Los valores del punto de datos filtran los objetos visuales de la página de destino.

Uso de la búsqueda de filtros para filtros de selección única y de selección múltiple

En filtros de selección única y selección múltiple, escriba el valor que desee. El filtro se actualiza para mostrar solo los valores que coinciden con el término de búsqueda.

Contenido relacionado

• Visualización de datos con paneles en tiempo real
• Personalizar los elementos visuales del panel en tiempo real