Esempi di espressioni (Generatore report 3.0 e SSRS)

È possibile utilizzare le funzioni di Visual Basic per modificare i dati visualizzati nelle caselle di testo o utilizzati per parametri, proprietà o altre aree del report. In questa sezione vengono forniti esempi che illustrano alcune di queste funzioni. Per ulteriori informazioni, vedere la pagina relativa ai membri della libreria di runtime di Visual Basic in MSDN.

In .NET Framework sono disponibili molte opzioni di formato personalizzato, ad esempio per formati di data specifici. Per ulteriori informazioni, vedere Formattazione dei tipi di dati in MSDN.

Funzioni matematiche

Funzioni di data

Funzioni per i valori stringa

Lookup

LookupSet

Funzioni di conversione

Funzioni condizionali

In un'espressione è possibile aggiungere un riferimento a funzioni per i report aggiuntive tramite le quali vengono modificati i dati di un report. In questa sezione vengono forniti esempi di due funzioni per i report. Per ulteriori informazioni sulle funzioni per i report ed esempi, vedere Riferimento a funzioni di aggregazione (Generatore report 3.0 e SSRS).

Se si desidera che nel piè di pagina del report vengano visualizzati il nome del report e il numero di pagina, è possibile utilizzare le espressioni seguenti:

• L'espressione seguente restituisce il nome del report e la data di esecuzione. Può essere inserita in una casella di testo nel piè di pagina del report oppure nel corpo del report. Per la formattazione dell'ora viene utilizzata la stringa di formattazione di .NET Framework per la data breve:

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

• L'espressione seguente, inserita in una casella di testo nel piè di pagina di un report, restituisce il numero di pagina e le pagine totali del report:

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

Negli esempi seguenti viene illustrato come visualizzare il primo e l'ultimo valore di una pagina nell'intestazione di pagina. Si suppone che sia presente un'area dati contenente una casella di testo denominata LastName.

• L'espressione seguente, inserita in una casella di testo a sinistra dell'intestazione di pagina, restituisce il primo valore della casella di testo LastName nella pagina:

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

• L'espressione seguente, se inserita in una casella di testo a destra dell'intestazione di pagina, restituisce l'ultimo valore della casella di testo LastName nella pagina:

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

Nell'esempio seguente viene illustrato come visualizzare un totale di pagina. Si suppone che sia presente un'area dati contenente una casella di testo denominata Cost.

• L'espressione seguente, inserita nell'intestazione o nel piè di pagina, restituisce la somma dei valori presenti nella casella di testo Cost nella pagina:

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

In alcuni report può essere necessario inserire un'interruzione di pagina alla fine di un numero di righe specificato anziché alla fine di gruppi o elementi del report oppure in aggiunta a questi. A tale scopo, creare un gruppo che contiene i gruppi o i record di dettaglio desiderati, aggiungere un'interruzione di pagina al gruppo, quindi aggiungere un'espressione di raggruppamento per eseguire il raggruppamento in base al numero di righe specificato.

• L'espressione seguente, se inserita nell'espressione di raggruppamento, assegna un numero a ogni set di 25 righe. Se si definisce un'interruzione di pagina per il gruppo, si ottiene un'interruzione di pagina ogni 25 righe.

  =Ceiling(RowNumber(Nothing)/25)
  

  Per consentire all'utente di impostare un valore relativo al numero di righe per pagina, creare un parametro denominato RowsPerPage su cui basare l'espressione di raggruppamento, come illustrato nell'espressione seguente:

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

  Per ulteriori informazioni sull'impostazione delle interruzioni di pagina per un gruppo, vedere Procedura: Aggiunta di un'interruzione di pagina (Generatore report 3.0 e SSRS).

• L'espressione seguente, se utilizzata nella proprietà Color di una casella di testo, cambia il colore del testo a seconda del valore del campo Profit:

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

  È anche possibile utilizzare la variabile oggetto MeVisual Basic. Questa variabile consente di fare riferimento in un altro modo al valore di una casella di testo.

  =Iif(Me.Value < 0, "Red", "Black")

• L'espressione seguente, se utilizzata nella proprietà BackgroundColor di un elemento del report in un'area dati, alterna il verde chiaro e il bianco come colore di sfondo di ogni riga:

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

  Se si utilizza un'espressione per un ambito specifico, potrebbe essere necessario indicare il set di dati per la funzione di aggregazione.

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

Per specificare i colori per un grafico con forme, è possibile utilizzare codice personalizzato per controllare l'ordine in base al quale i colori vengono mappati ai valori dei punti dati. In questo modo è possibile utilizzare colori coerenti per più grafici con gli stessi gruppi di categorie. Per ulteriori informazioni, vedere Procedura: Specifica di colori coerenti in più grafici con forme (Generatore report 3.0 e SSRS).

È possibile visualizzare e nascondere elementi in un report utilizzando le proprietà di visibilità per gli elementi del report. In un'area dati, ad esempio una tabella, è possibile nascondere inizialmente le righe di dettaglio in base al valore di un'espressione.

• L'espressione seguente, se utilizzata per la visibilità iniziale delle righe di dettaglio in un gruppo, visualizza le righe di dettaglio per tutte le vendite con un valore superiore al 90 percento nel campo PctQuota:

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

• L'espressione seguente, se impostata nella proprietà Hidden di una tabella, visualizza la tabella solo se contiene più di 12 righe:

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

• L'espressione seguente, se impostata nella proprietà Hidden di una colonna, visualizza la colonna solo se il campo esiste nel set di dati del report dopo il recupero dei dati dall'origine dati:

  =IIF(Fields!Column_1.IsMissing, true, false)
  

È possibile personalizzare gli URL utilizzando i dati del report e inoltre controllare in base a condizioni specifiche se gli URL vengono aggiunti come azione per una casella di testo.

• L'espressione seguente, se utilizzata come azione per una casella di testo, genera un URL personalizzato in cui è specificato il campo del set di dati EmployeeID come parametro.

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

  Per ulteriori informazioni, vedere Procedura: Aggiunta di un collegamento ipertestuale a un URL (Generatore report 3.0 e SSRS).

• L'espressione seguente controlla in base a specifiche condizioni se aggiungere un URL in una casella di testo. L'espressione dipende da un parametro denominato IncludeURLs che consente all'utente di decidere se includere o meno URL attivi in un report. Questa espressione viene impostata come azione per una casella di testo. Se si imposta il parametro su False e quindi si visualizza il report, è possibile esportare il report in Microsoft Excel senza collegamenti ipertestuali.

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

È possibile utilizzare espressioni in un parametro per modificare il valore predefinito del parametro. Ad esempio, è possibile utilizzare un parametro per filtrare i dati relativi a un utente specifico sulla base dell'ID utente utilizzato per eseguire il report.

• L'espressione seguente, se utilizzata come valore predefinito di un parametro, recupera l'ID utente della persona che esegue il report:

  =User!UserID
  

• Per fare riferimento a un parametro incluso in un parametro di query, un'espressione di filtro, una casella di testo o un'altra area del report, utilizzare la raccolta globale Parameters. In questo esempio si presuppone che il parametro sia denominato Department:

  =Parameters!Department.Value
  

• I parametri possono essere creati in un report ma impostati come nascosti. Quando il report viene eseguito nel server di report, il parametro non viene visualizzato sulla barra degli strumenti e il lettore del report non può modificare il valore predefinito. È possibile utilizzare un parametro nascosto impostato su un valore predefinito come costante personalizzata. È possibile utilizzare questo valore in qualsiasi espressione, anche in un'espressione di campo. L'espressione seguente identifica il campo specificato dal valore del parametro predefinito per il parametro denominato ParameterField:

  =Fields(Parameters!ParameterField.Value).Value
  

È possibile inizializzare il valore di una variabile di gruppo locale all'interno di un particolare ambito del gruppo e quindi includere un riferimento a tale variabile nelle espressioni. Una delle modalità di utilizzo di una variabile di gruppo con codice personalizzato consiste nell'implementare un'aggregazione personalizzata. Per ulteriori informazioni, vedere Using Group Variables in Reporting Services 2008 for Custom Aggregation.

Per ulteriori informazioni sulle variabili, vedere Utilizzo di riferimenti a raccolte di variabili di report e di gruppo (Generatore report 3.0 e SSRS).

Nell'esempio seguente viene chiamato un metodo incorporato denominato FixSpelling, che sostituisce tutte le occorrenze del testo "Bike" con "Bicycle" in SubCategory.Value.

=Code.FixSpelling(Fields!SubCategory.Value)

Il codice seguente, se incorporato in una definizione del report, indica un'implementazione del metodo FixSpelling. In questo esempio viene illustrato come fare riferimento alla classe System.Text..::..StringBuilder di .NET Framework. Per ulteriori informazioni, vedere Procedura: Aggiungere codice a un report (SSRS).

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

Alcuni valori di un'espressione possono restituire un valore Null o non definito in fase di elaborazione del report. In questo modo possono verificarsi errori di run-time che generano la visualizzazione di #Errore nella casella di testo anziché dell'espressione valutata. Questo comportamento influisce in modo particolare sulla funzione IIF in quanto, a differenza di un'istruzione If-Then-Else, ogni parte dell'istruzione IIF (incluse le chiamate a funzioni) viene valutata prima di essere passata alla routine che verifica se il risultato è true o false. L'istruzione =IIF(Fields!Sales.Value is NOTHING, 0, Fields!Sales.Value) genera #Errore nel report visualizzabile se Fields!Sales.Value è NOTHING.

Per evitare questa condizione, utilizzare una delle strategie seguenti:

• Impostare il numeratore su 0 e il denominatore su 1 se il valore per il campo B è 0 o non definito; in caso contrario, impostare il numeratore sul valore per il campo A e il denominatore sul valore per il campo B.

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

• Utilizzare una funzione di codice personalizzata per restituire il valore per l'espressione. Nell'esempio seguente viene restituita la differenza in percentuale tra un valore corrente e uno precedente. Questa funzione può essere utilizzata per calcolare la differenza tra due valori successivi e consente di gestire il caso limite del primo confronto (quando non è disponibile alcun valore precedente) e i casi in cui il valore precedente o il valore corrente sia null (Nothing in 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
  

  Nell'espressione seguente viene illustrato come chiamare questo codice personalizzato da una casella di testo:

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

  In questo modo si evitano eccezioni in fase di esecuzione ed è ora possibile utilizzare un'espressione come =IIF(Me.Value < 0, "red", "black") nella proprietà Color della casella di testo a seconda se i valori sono maggiori o minori di 0.