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.
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:
Ejemplos de ecuaciones de filtro (Generador de informes y SSRS)
Ejemplos de expresión de grupo (Generador de informes y SSRS)
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.
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:
Para obtener más información, vea Aplicar formato a texto y a marcadores de posición (Generador de informes y SSRS).
Volver 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
Volver 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] |
Volver 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 |
---|---|---|
Describe las constantes a las que puede tener acceso interactivamente para las propiedades que requieren valores constantes, por ejemplo los colores de fuente. |
="Blue" |
|
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 & "." |
|
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 |
|
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) |
Volver 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).
Volver al principio
En esta sección
Agregar una expresión (Generador de informes y SSRS)
Usar expresiones en informes (Generador de informes y SSRS)
Referencia de expresiones (Generador de informes y SSRS)
Volver al principio