Ejemplos de expresiones (Reporting Services)

Las funciones de Visual Basic se pueden usar para manipular los datos que se muestran en los cuadros de texto o que se emplean en los parámetros, las propiedades u otras áreas del informe. En esta sección se ofrecen ejemplos que muestran algunas de estas funciones. En estos ejemplos se especifican constantes de Visual Basic como valores de enumeración (por ejemplo, DateInterval.Month). Aunque el editor de expresiones no admite Intellisense para esos valores, estos se compilan correctamente en una expresión.

Para obtener más información acerca de las funciones de Visual Basic, vea la documentación de Visual Basic.

Funciones de fecha

Funciones de cadena

Funciones de conversión

Funciones de decisión

Reporting Services proporciona funciones de informe adicionales que permiten manipular los datos de un informe. En esta sección, se ofrecen ejemplos de dos de estas funciones. Para obtener más información acerca de las funciones de informe y ejemplos, vea Usar las funciones de informe y de agregado integradas en expresiones (Reporting Services).

Cuando se diseña un informe, existe la posibilidad de mostrar el nombre del informe y el número de página en el pie del informe. Para ello, se utilizan las siguientes expresiones:

• La siguiente expresión proporciona el nombre del informe y la hora a la que se ejecutó. Puede colocarse en un cuadro de texto en el pie de página o en el cuerpo del informe. Para aplicar formato a la hora, se ha usado la cadena de formato de .NET Framework para fechas cortas:

  =Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")
  

• La siguiente expresión, situada en un cuadro de texto en el pie de página de un informe, devuelve el número de página y el total de páginas del informe:

  =Globals.PageNumber & " of " & Globals.TotalPages
  

En los ejemplos siguientes, se indica cómo mostrar el primer y el último valor de una página en el encabezado de página, de manera similar a lo que aparece en una lista de directorios. En el ejemplo se da por hecho que existe una región de datos que contiene un cuadro de texto denominado LastName.

• La siguiente expresión, situada en un cuadro de texto a la izquierda del encabezado de página, proporciona el primer valor del cuadro de texto LastName en la página:

  =First(ReportItems("LastName").Value)
  

• La expresión siguiente, situada en un cuadro de texto a la derecha del encabezado de página, proporciona el último valor del cuadro de texto LastName de la página:

  =Last(ReportItems("LastName").Value)
  

En el ejemplo siguiente, se indica cómo incluir un total para la página. En el ejemplo se supone que existe una región de datos que contiene un cuadro de texto denominado Cost.

• La siguiente expresión, situada en el encabezado o pie de página, proporciona la suma de los valores del cuadro de texto Cost para la página:

  =Sum(ReportItems("Cost").Value)
  

Es posible que en algunos informes se desee insertar un salto de página al final de un número de filas determinado, en lugar de (o además de) en los grupos o elementos de informe. Para ello, cree un grupo que contenga los grupos o registros de detalle que desee, agregue un salto de página al grupo y, a continuación, agregue una expresión de grupo para agrupar por un número concreto de filas.

• Si se coloca la expresión siguiente en la expresión de grupo, se asigna un número a cada conjunto de 25 filas. Cuando se define un salto de página para el grupo, el resultado de la expresión es un salto de página cada 25 filas.

  =CInt(Ceiling(RowNumber(Nothing)/25))
  

  Para permitir al usuario establecer un valor para el número de filas por página, cree un parámetro denominado RowsPerPage y base la expresión de grupo en dicho parámetro, tal y como se muestra en la expresión siguiente:

  =CInt(Ceiling(RowNumber(Nothing)/Parameters!RowsPerPage.Value))
  

  Para obtener más información acerca de cómo establecer saltos de página para un grupo, vea Cómo agregar un salto de página (Reporting Services).

• La expresión siguiente, cuando se utiliza en la propiedad Color de un cuadro de texto, cambia el color del texto en función del valor del campo Profit:

  =Iif(Fields!Profit.Value < 0, "Red", "Black")
  

• La siguiente expresión, cuando se utiliza en la propiedad BackgroundColor de un elemento de informe en una región de datos, alterna el color de fondo de cada fila entre verde claro y blanco:

  =Iif(RowNumber(Nothing) Mod 2, "PaleGreen", "White")
  

  Si se utiliza una expresión para un ámbito determinado, puede que sea necesario indicar el conjunto de datos para la función de agregado:

  =Iif(RowNumber("Employees") Mod 2, "PaleGreen", "White")
  

Es posible mostrar y ocultar los elementos de un informe mediante las propiedades de visibilidad del elemento de informe. En una región de datos, como una tabla, se pueden ocultar inicialmente las filas de detalles basándose en el valor de una expresión.

• La expresión siguiente, cuando se utiliza para la visibilidad inicial de las filas de detalles de un grupo, muestra las filas de detalles de todas las ventas que superen el 90 por ciento en el campo PctQuota:

  =Iif(Fields!PctQuota.Value>.9, False, True)
  

• La expresión siguiente, cuando se establece en la propiedad Hidden para una tabla, muestra la tabla solamente si tiene más de 12 filas:

  =IIF(CountRows()>12,true,false)
  

Puede personalizar las direcciones URL con datos de informe y, además, controlar de forma condicional si dichas direcciones URL se agregan como acciones para un cuadro de texto.

• La expresión siguiente, cuando se utiliza como acción en un cuadro de texto, genera una dirección URL personalizada que especifica el campo EmployeeID del conjunto de datos como un parámetro de URL.

  ="http://adventure-works/MyInfo?ID=" & Fields!EmployeeID.Value
  

  Para obtener más información, vea Cómo agregar un hipervínculo a una dirección URL (Reporting Services).

• La expresión siguiente controla de forma condicional si debe agregarse una dirección URL a un cuadro de texto. Esta expresión depende de un parámetro denominado IncludeURLs que permite a un usuario decidir si deben incluirse direcciones URL activas en un informe. Esta expresión se establece como una acción en un cuadro de texto. Si establece el parámetro en FALSE y, a continuación, ve el informe, puede exportar el informe a Microsoft Excel sin hipervínculos.

  =IIF(Parameters!IncludeURLs.Value,"http://adventure-works.com/productcatalog",Nothing)
  

Pueden utilizarse expresiones en un parámetro para modificar su valor predeterminado. Por ejemplo, puede usar un parámetro que filtre datos para un usuario determinado basándose en el identificador de usuario con el que se ejecuta el informe.

• La siguiente expresión, cuando se usa como valor predeterminado para un parámetro, obtiene el identificador de usuario de la persona que ejecuta el informe:

  =User!UserID
  

• Para hacer referencia a un parámetro en un parámetro de consulta, una expresión de filtro, un cuadro de texto u otras áreas del informe, use la colección global Parameters. En este ejemplo se da por supuesto que el parámetro se denomina Department:

  =Parameters!Department.Value
  

• Pueden crearse parámetros en un informe y establecerse como ocultos. Cuando se ejecuta el informe en el servidor de informes, el parámetro no se muestra en la barra de herramientas y el lector del informe no puede cambiar el valor predeterminado. Puede usar un parámetro oculto establecido en un valor predeterminado como constante personalizada. Puede usar este valor en cualquier expresión, incluida una expresión de campo. La expresión siguiente identifica el campo especificado por el valor de parámetro predeterminado para el parámetro denominado ParameterField:

  =Fields(Parameters!ParameterField.Value).Value
  

  Para obtener más información, vea Establecer las propiedades de los parámetros de un informe publicado.

Puede inicializar el valor de una variable de grupo local en un ámbito de grupo determinado y, a continuación, incluir una referencia a esa variable en expresiones. Una forma de usar una variable de grupo con código personalizado es implementar un agregado personalizado. Para obtener más información, vea Usar variables de grupo en Reporting Services 2008 para agregados personalizados (en inglés).

Para obtener más información acerca de las variables, vea Usar referencias a las colecciones de variables de informe y de grupo en expresiones (Reporting Services).

En el ejemplo siguiente se llama a un método incrustado denominado FixSpelling, que sustituye todas las repeticiones del texto "Bike" por el texto "Bicycle" en SubCategory.Value.

=Code.FixSpelling(Fields!SubCategory.Value)

Cuando el código siguiente se incrusta en una definición de informe, muestra una implementación del método FixSpelling. En este ejemplo se muestra cómo hacer referencia a la clase System.Text..::..StringBuilder de .NET Framework. Para obtener más información, vea Cómo agregar código a un informe (Reporting Services) y Cómo agregar una referencia de ensamblado a un informe (Reporting Services).

Public Function FixSpelling(ByVal s As String) As String
   Dim strBuilder As New System.Text.StringBuilder(s)
   If s.Contains("Bike") Then
      strBuilder.Replace("Bike", "Bicycle")
      Return strBuilder.ToString()
      Else : Return s
   End If
End Function

Algunos valores de una expresión pueden evaluarse como NULL o como indefinidos durante el procesamiento del informe. Esto puede provocar errores en tiempo de ejecución que hacen que en el cuadro de texto se muestre #Error en lugar de la expresión evaluada. La función IIF es especialmente sensible a este comportamiento porque, a diferencia de lo que ocurre en una instrucción If-Then-Else, se evalúa cada una de las partes de la sentencia IIF (incluidas las llamadas a función) antes de que pasen a la rutina que comprueba si es true o false. La instrucción =IIF(Fields!Sales.Value is NOTHING, 0, Fields!Sales.Value) genera #Error en el informe representado si el valor de Fields!Sales.Value es NOTHING.

Para evitar esta condición, use una de las estrategias siguientes:

• Establezca el numerador en 0 y el denominador en 1 si el valor del campo B es 0 o un valor no definido; en caso contrario, establezca el numerador en el valor del campo A y el denominador en el valor del campo B.

  =IIF(Field!B.Value=0, 0, Field!A.Value / IIF(Field!B.Value =0, 1, Field!B.Value))
  

• Use una función de código personalizado para devolver el valor de la expresión. En el ejemplo siguiente, se devuelve la diferencia porcentual entre un valor actual y un valor anterior. Esto puede usarse para calcular la diferencia entre dos valores consecutivos cualesquiera, y controla el caso extremo de la primera comparación (cuando no hay ningún valor anterior) y los casos en los que el valor anterior o el valor actual es null (Nothing en Visual Basic).

  Public Function GetDeltaPercentage(ByVal PreviousValue, ByVal CurrentValue) As Object
      If IsNothing(PreviousValue) OR IsNothing(CurrentValue) Then
          Return Nothing
      Else if PreviousValue = 0 OR CurrentValue = 0 Then
          Return Nothing
      Else 
          Return (CurrentValue - PreviousValue) / CurrentValue
      End If
  End Function
  

  La expresión siguiente muestra cómo se llama a este código personalizado desde un cuadro de texto:

  =Code.GetDeltaPercentage(Previous(Sum(Fields!Sales.Value),"ColumnGroupByYear"), Sum(Fields!Sales.Value))