Referencias de colección de parámetros integradas en un informe paginado (Generador de informes de Power BI).
SE APLICA A: Generador de informes de Power BI Power BI Desktop
Los parámetros de los informes paginados son una de las colecciones integradas a las que puede hacer referencia desde una expresión en el Generador de informes de Power BI Al incluir parámetros en una expresión, puede personalizar los datos y el aspecto de los informes basándose en las opciones seleccionadas por el usuario. Se pueden usar expresiones para cualquier propiedad de elemento de informe o de cuadro de texto que proporcione la opción (Fx) o <Expresión>. Las expresiones también se usan para controlar el contenido y el aspecto de los informes de otras maneras. Para más información, consulte Ejemplos de expresiones (Generador de informes de Power BI).
Cuando se comparan los valores de los parámetros en tiempo de ejecución con los valores de los campos del conjunto de datos, los tipos de datos de los dos elementos que se comparan deben coincidir. Los parámetros de informe pueden tener uno de los siguientes tipos: Boolean, DateTime, Integer, Float o Text, que representa el tipo de datos subyacente String. Es posible que tenga que convertir el tipo de datos del valor del parámetro para que coincida con el valor del conjunto de datos. Para más información, consulte Tipos de datos en expresiones (Generador de informes de Power BI).
Para incluir una referencia de parámetro en una expresión, debe entender cómo especificar la sintaxis correcta para la referencia de parámetro, que varía dependiendo de si el parámetro es de un solo valor o de varios valores.
Uso de un parámetro con un solo valor en una expresión
En la tabla siguiente se muestran ejemplos de la sintaxis que se debe usar cuando se incluye una referencia a un parámetro de un solo valor de cualquier tipo de datos en una expresión.
Ejemplo | Descripción |
---|---|
=Parameters! <NombreDelParámetro>.IsMultiValue |
Devuelve False. Comprueba si un parámetro es de varios valores. Si el valor es True, el parámetro es de varios valores y es una colección de objetos. Si el valor es False, el parámetro es de un solo valor y es un solo objeto. |
=Parameters! <NombreDelParámetro>.Count |
Devuelve el valor entero 1. Para un parámetro de un solo valor, el recuento es siempre 1. |
=Parameters! <NombreDelParámetro>.Label |
Devuelve la etiqueta del parámetro, se suele utilizar como nombre para mostrar de una lista desplegable de valores disponibles. |
=Parameters! <NombreDelParámetro>.Value |
Devuelve el valor del parámetro. Si no se ha establecido la propiedad Label, este valor aparece en la lista desplegable de valores disponibles. |
=CStr(Parameters! <NombreDelParámetro>.Value) |
Devuelve el valor del parámetro como una cadena. |
=Fields(Parameters! <NombreDelParámetro>.Value).Value |
Devuelve el valor del campo que tiene el mismo nombre que el parámetro. |
Para obtener más información sobre cómo usar parámetros en los filtros, consulte Agregar filtros de conjunto de datos, filtros de región de datos y filtros de grupo (Generador de informes de Power BI).
Uso de un parámetro de varios valores en una expresión
En la tabla siguiente se muestran ejemplos de la sintaxis que se debe usar cuando se incluye una referencia a un parámetro de varios valores de cualquier tipo de datos en una expresión.
Ejemplo | Descripción |
---|---|
=Parameters! <NombreDelParámetroVariosValores>.IsMultiValue |
Devuelve True o False. Comprueba si un parámetro es de varios valores. Si el valor es True, el parámetro es de varios valores y es una colección de objetos. Si el valor es False, el parámetro es de un solo valor y es un solo objeto. |
=Parameters! <NombreDelParámetroVariosValores>.Count |
Devuelve un valor entero. Se refiere al número de valores. Para un parámetro de un solo valor, el recuento es siempre 1. Para un parámetro de varios valores, el recuento es 0 o más. |
=Parameters! <NombreDelParámetroVariosValores>.Value(0) |
Devuelve el primer valor de un parámetro de varios valores. |
=Parameters! <NombreDelParámetroVariosValores>.Value(Parameters! <NombreDelParámetroVariosValores>.Count-1) |
Devuelve el último valor de un parámetro de varios valores. |
=Split("Value1,Value2,Value3",",") |
Devuelve una matriz de valores. Cree una matriz de valores para un parámetro de varios valores de tipo String . Puede utilizar cualquier delimitador del segundo parámetro para Split. Esta expresión puede utilizarse para establecer valores predeterminados para un parámetro de varios valores o para crear un parámetro de varios valores que se enviará a un subinforme o a un informe detallado. |
=Join(Parameters! <NombreDelParámetroVariosValores>.Value,", ") |
Devuelve un valor de tipo String formado por una lista de valores delimitada por comas en un parámetro de varios valores. Puede utilizar cualquier delimitador del segundo parámetro para Join. |
Para obtener más información sobre cómo usar parámetros en los filtros, consulte Parámetros de informe (Generador de informes y Diseñador de informes de Power BI).
Pasos siguientes
Cambiar el orden de un parámetro de informe paginado: Generador de informes de Power BI
Adición de un parámetro de varios valores a un informe paginado: Generador de informes de Power BI
Personalizar el panel Parámetros en un informe paginado: Generador de informes de Power BI