Compartir vía

Referencias a la colección de parámetros en un informe paginado (Generador de informes)

  • Artículo

Se aplica a: Generador de informes de Microsoft (SSRS) Power BI Report Builder Diseñador de informes en SQL Server Data Tools

Los parámetros de informe paginado son una de las colecciones integradas a las que se puede hacer referencia desde una expresión. 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 <Expression>. Las expresiones también se usan para controlar el contenido y el aspecto de los informes de otras maneras. Para obtener más información, consulte Ejemplos de expresiones (Generador de informes).

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 obtener más información, consulte Tipos de datos en expresiones (Generador de informes).

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. La sintaxis varía en función de si el parámetro es un parámetro de valor único o de varios valores.

Nota:

Puede crear y modificar los archivos de definición de informes paginados (.rdl) en el Generador de informes de Microsoft, en Power BI Report Builder y en el Diseñador de informes de SQL Server Data Tools.

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! <ParameterName> .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! <ParameterName> .Count Devuelve el valor entero 1. Para un parámetro de un solo valor, el recuento es siempre 1.
=Parameters! <ParameterName> .Label Devuelve la etiqueta del parámetro, se suele utilizar como nombre para mostrar de una lista de valores disponibles.
=Parameters! <ParameterName> .Value Devuelve el valor del parámetro. Si no se ha establecido la propiedad Label, este valor aparece en la lista de valores disponibles.
=CStr(Parameters! <ParameterName> .Value) Devuelve el valor del parámetro como una cadena.
=Fields(Parameters! <ParameterName> .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).

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! <MultivalueParameterName> .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! <MultivalueParameterName> .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! <MultivalueParameterName> .Value(0) Devuelve el primer valor de un parámetro de varios valores.
=Parameters! <MultivalueParameterName> .Value(Parameters! <MultivalueParameterName> .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! <MultivalueParameterName> .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).

Contenido relacionado