Expresiones en el Generador de informes de Power BI

SE APLICA A: Power BI Report Builder Power BI Desktop

En los informes paginados de Power BI Report Builder se usan ampliamente expresiones para recuperar, calcular, mostrar, agrupar, ordenar, filtrar, parametrizar y dar formato a los datos.

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 su informe. Las expresiones se escriben en Microsoft Visual Basic, se guardan en la definición de informe y el procesador de informes las evalúa al ejecutar el informe.

A diferencia de aplicaciones como Microsoft Excel, donde se trabaja con datos directamente en una hoja de cálculo, en un informe se trabaja con expresiones que actúan como 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 del conjunto de datos ID, Name, SalesTerritory, Code, and 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.

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 complejas.

• Simples: las expresiones simples contienen una referencia a un único elemento de una colección integrada, 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.Valuesubyacente. Las expresiones simples se crean automáticamente al crear el diseño del informe y arrastrar elementos desde el panel Datos de informe a la superficie de diseño. Para más información sobre los símbolos que representan diferentes colecciones integradas, consulte Descripción de los símbolos de prefijo para expresiones simples.

• Complejas: las expresiones complejas contienen referencias a varias referencias integradas, operadores y llamadas de función. 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:

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

Las expresiones simples usan símbolos para indicar si la referencia es 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 de 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]

Escritura de 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.

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 & "."
Recopilaciones integradas	Describe las colecciones integradas que puede incluir en una expresión; por ejemplo, Fields, Parametersy Variables.	=Fields!Sales.Value =Parameters!Store.Value =Variables!MyCalculation.Value
Informes integrados y funciones 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 código y ensamblados personalizados en expresiones en Report Builder	Describe cómo obtener acceso a las clases integradas de CLR xref:System.Math y xref:System.Convert, otras clases de CLR, funciones de biblioteca en tiempo de ejecución de Visual Basic o 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)

Validación de 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 [Sum] 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.

• En el caso del valor de una propiedad de fuente, el valor debe evaluarse 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 mensaje de error en el informe representado.

Pasos siguientes

• ¿Qué son los informes paginados en Power BI?