Compartir a través de


Expresiones (Generador de informes y SSRS)

Las expresiones se utilizan ampliamente a lo largo de un informe para recuperar, calcular, mostrar, agrupar, ordenar, filtrar y parametrizar datos y darles formato. Muchas propiedades de elementos de informe pueden establecerse en una expresión. Las expresiones le ayudan a controlar el contenido, el diseño y la interactividad de un informe. Las expresiones se escriben en Microsoft Visual Basic, se guardan en la definición de informe y son evaluadas por el procesador de informes al ejecutar el informe.

A diferencia de aplicaciones como Microsoft Office Excel en que se trabaja directamente con datos en una hoja de cálculo, en un informe se trabaja con expresiones que son marcadores de posición para los datos. Para ver los datos reales de las expresiones evaluadas, debe obtener una vista previa del informe. Al ejecutar el informe, el procesador de informes evalúa cada expresión a medida que combina los datos del informe y elementos de diseño del informe, como tablas y gráficos.

Cuando diseña un informe, muchas expresiones de los elementos de informe se establecen automáticamente. Por ejemplo, al arrastrar un campo desde el panel de datos hasta una celda de la tabla en la superficie de diseño del informe, el valor del cuadro de texto se establece en una expresión simple para el campo. En la ilustración siguiente, el panel Datos de informe muestra los campos de conjunto de datos ID, Name, SalesTerritory, Code y Sales. Se han agregado tres campos a la tabla: [Name], [Code] y [Sales]. La notación [Name] en la superficie de diseño representa la expresión subyacente =Fields!Name.Value.

rs_DataDesignandPreview

Al obtener una vista previa del informe, el procesador de informes combina la región de datos de la tabla con los datos reales de la conexión de datos y muestra una fila en la tabla para cada fila del conjunto de resultados.

Para escribir expresiones manualmente, seleccione un elemento en la superficie de diseño y use los menús contextuales y los cuadros de diálogo para establecer las propiedades del elemento. Cuando vea el botón (fx) o el valor <Expression> en una lista desplegable, sabrá que puede establecer la propiedad en una expresión. Para obtener más información, vea Agregar una expresión (Generador de informes y SSRS).

Para obtener más información y ejemplos, vea los siguientes temas:

Para desarrollar expresiones complejas o expresiones que utilizan código personalizado o ensamblados personalizados, recomendamos utilizar el Diseñador de informes en SQL Server Data Tools (SSDT). Para obtener más información, vea Referencias a ensamblados y código personalizado en expresiones en el Diseñador de informes (SSRS).

[!NOTA]

Puede crear y modificar las definiciones de informe (.rdl) en el Generador de informes y en el Diseñador de informes en SQL Server Data Tools. Cada entorno de creación proporciona varias maneras de crear, abrir y guardar informes y elementos relacionados. Para obtener más información, vea la información sobre el diseño de informes en el Generador de informes y el Administrador de informes (SSRS) en el sitio web microsoft.com.

En este artículo

Descripción de las expresiones simples y complejas

Descripción de los símbolos de prefijo en expresiones simples

Escribir expresiones complejas

Validar las expresiones

En esta sección

Descripción de las expresiones simples y complejas

Las expresiones comienzan por un signo igual (=) y se escriben en Microsoft Visual Basic. Las expresiones pueden incluir una combinación de constantes, operadores y referencias a valores integrados (campos, colecciones y funciones) y a código externo o personalizado.

Puede utilizarlas para especificar el valor de muchas propiedades de elementos de informe. Las propiedades más comunes son los valores de los cuadros de texto y el texto de los marcadores de posición. Normalmente, si un cuadro de texto contiene solo una expresión, esta es el valor de la propiedad de cuadro de texto. Si un cuadro de texto contiene varias expresiones, cada una es el valor de texto del marcador de posición en el cuadro de texto.

De forma predeterminada, las expresiones aparecen en la superficie de diseño del informe como expresiones simples o expresiones complejas.

  • Simple: se trata de una expresión simple que contiene una referencia a un solo elemento de una colección integrada, como por ejemplo, un campo de conjunto de datos, un parámetro o un campo integrado. En la superficie de diseño, una expresión simple aparece entre corchetes. Por ejemplo, [FieldName] corresponde a la expresión =Fields!FieldName.Value subyacente. Las expresiones simples se crean automáticamente al crear el diseño del informe y arrastrar los elementos del panel Datos de informe a la superficie de diseño. Para obtener más información acerca de los símbolos que representan diferentes colecciones integradas, vea Descripción de los símbolos de prefijo para expresiones sencillas.

  • Complejas: las expresiones complejas contienen referencias a varias referencias, operadores y llamadas a función integradas. Una expresión compleja aparece como <<Expr>> cuando el valor de expresión incluye más de una referencia simple. Para ver la expresión, mantenga el mouse sobre ella y use la información sobre herramientas. Para modificar la expresión, ábrala en el cuadro de diálogo Expresión.

La siguiente figura muestra expresiones simples y complejas típicas para cuadros de texto y el texto de los marcadores de posición.

rs_ExpressionDefaultFormat

Para mostrar valores de ejemplo en lugar del texto de las expresiones, aplique el formato al cuadro de texto o al texto del marcador de posición. La siguiente figura muestra la superficie de diseño del informe alternada para mostrar los valores de ejemplo:

rs_ExpressionSampleValuesFormat

Para obtener más información, vea Aplicar formato a texto y a marcadores de posición (Generador de informes y SSRS).

Icono de flecha usado con el vínculo Volver al principioVolver al principio

Fórmulas del modelo de informe

Cuando diseñe una consulta para un conjunto de datos que use un modelo de informe como origen de datos, puede crear fórmulas. Las fórmulas son los cálculos que se realizan en los valores de un informe que están basados en los datos de un modelo de informe.

Para obtener más información, vea Utilizar fórmulas en consultas de modelo de informe (Generador de informes y SSRS).

Volver al principio

Icono de flecha usado con el vínculo Volver al principioVolver al principio

Descripción de los símbolos de prefijo en expresiones simples

Las expresiones simples usan símbolos para indicar si la referencia es a un campo, un parámetro, una colección integrada o la colección ReportItems. En la tabla siguiente, se muestran ejemplos de texto mostrado junto con el texto de la expresión correspondiente:

Elemento

Ejemplo de texto mostrado

Ejemplo de texto de expresión

Campos de conjunto de datos

[Sales]

[SUM(Sales)]

[FIRST(Store)]

=Fields!Sales.Value

=Sum(Fields!Sales.Value)

=First(Fields!Store.Value)

Parámetros del informe

[@Param]

[@Param.Label]

=Parameters!Param.Value

=Parameters!Param.Label

Campos integrados

[&ReportName]

=Globals!ReportName.Value

Caracteres literales usados para el texto mostrado

\[Sales\]

[Sales]

Icono de flecha usado con el vínculo Volver al principioVolver al principio

Escribir expresiones complejas

Las expresiones pueden incluir referencias a funciones, operadores, constantes, campos, parámetros, elementos de colecciones integradas y referencias a código personalizado incrustado o a ensamblados personalizados.

[!NOTA]

Para desarrollar expresiones complejas o expresiones que utilizan código personalizado o ensamblados personalizados, recomendamos utilizar el Diseñador de informes en SQL Server SQL Server Data Tools (SSDT). Para obtener más información, vea Referencias a ensamblados y código personalizado en expresiones en el Diseñador de informes (SSRS).

En la tabla siguiente se enumeran los tipos de referencias que se pueden incluir en una expresión:

Referencias

Descripción

Ejemplo

Constantes

Describe las constantes a las que puede tener acceso interactivamente para las propiedades que requieren valores constantes, por ejemplo los colores de fuente.

="Blue"

Operadores

Describe los operadores que puede utilizar para combinar referencias en una expresión. Por ejemplo, el operador & se utiliza para concatenar cadenas.

="The report ran at: " & Globals!ExecutionTime & "."

Colecciones integradas

Describe las colecciones integradas que puede incluir en una expresión; por ejemplo, Fields, Parameters y Variables.

=Fields!Sales.Value

=Parameters!Store.Value

=Variables!MyCalculation.Value

Funciones integradas de informe y de agregado

Describe funciones integradas, como Sum o Previous, a las que puede tener acceso desde una expresión.

=Previous(Sum(Fields!Sales.Value))

Referencias a ensamblados y código personalizado en expresiones en el Diseñador de informes (SSRS)

Describe cómo puede obtener acceso a las clases integradas de CLR Math y Convert, a otras clases de CLR, a funciones de biblioteca en tiempo de ejecución de Visual Basic o a métodos de un ensamblado externo.

Describe cómo puede tener acceso a código personalizado incrustado en un informe, o que se compila e instala como un ensamblado personalizado en el cliente de informes y en el servidor de informes.

=Sum(Fields!Sales.Value)

=CDate(Fields!SalesDate.Value)

=DateAdd("d",3,Fields!BirthDate.Value)

=Code.ToUSD(Fields!StandardCost.Value)

Icono de flecha usado con el vínculo Volver al principioVolver al principio

Validar las expresiones

Cuando cree una expresión para una propiedad de elemento de informe determinada, las referencias que puede incluir en una expresión dependen de los valores que la propiedad del elemento de informe pueda aceptar y del ámbito en el que se evalúa la propiedad. Por ejemplo:

  • De forma predeterminada, la expresión [Suma] calcula la suma de los datos que están en el ámbito en el momento en que se evalúa la expresión. Para una celda de la tabla, el ámbito depende de la fila y las pertenencias a los grupos de columnas. Para obtener más información, vea Ámbito de expresión para los totales, agregados y colecciones integradas (Generador de informes y SSRS).

  • Para el valor de una propiedad Font, el valor se debe evaluar como el nombre de una fuente.

  • La sintaxis de la expresión se valida en tiempo de diseño. La validación del ámbito de la expresión se produce al publicar el informe. En el caso de la validación que depende de los datos reales, los errores se pueden detectar solo en tiempo de ejecución. Algunas de estas expresiones generan #Error como un mensaje de error en el informe representado. Para ayudar a determinar los problemas de este tipo de error, debe utilizar el Diseñador de informes en SQL Server Data Tools (SSDT). El Diseñador de informes proporciona un ventana de salida que proporciona más información acerca de estos errores.

Para obtener más información, vea Referencia de expresiones (Generador de informes y SSRS).

Icono de flecha usado con el vínculo Volver al principioVolver al principio

En esta sección

Agregar una expresión (Generador de informes y SSRS)

Usar expresiones en informes (Generador de informes y SSRS)

Ámbito de expresión para los totales, agregados y colecciones integradas (Generador de informes y SSRS)

Referencia de expresiones (Generador de informes y SSRS)

Icono de flecha usado con el vínculo Volver al principioVolver al principio

Vea también

Referencia

Expresión (cuadro de diálogo)

Expresión (cuadro de diálogo del Generador de informes)