Utilizzo delle espressioni (Generatore report 2.0)
In Reporting Services le espressioni sono utilizzate nella definizione del report per specificare o calcolare valori per parametri, query, filtri, proprietà degli elementi del report, definizioni di gruppo e di ordinamento, proprietà delle caselle di testo, segnalibri, mappe documento, contenuto dinamico dell'intestazione e del piè di pagina, immagini e definizioni delle origini dati dinamiche. In questo argomento vengono forniti esempi delle numerose posizioni in cui è possibile utilizzare le espressioni per modificare il contenuto o l'aspetto di un report. Non si tratta tuttavia di un elenco completo. È possibile impostare un'espressione per qualsiasi proprietà in una finestra di dialogo in cui è visualizzato il pulsante di espressione (fx) o in un elenco a discesa in cui è visualizzato <Espressione...>.
Le espressioni possono essere semplici o complesse. Le espressioni semplici contengono un riferimento a un solo campo del set di dati, un solo parametro o un solo campo predefinito Le espressioni complesse possono contenere più riferimenti incorporati, operatori e chiamate di funzione. Ad esempio, un'espressione complessa potrebbe includere la funzione Sum applicata al campo Sales.
Le espressioni sono scritte in MicrosoftVisual Basic. Un'espressione inizia con un segno di uguale (=) seguito da una combinazione di riferimenti a raccolte predefinite, quali parametri e campi di set di dati, costanti, funzioni e operatori.
Utilizzo di espressioni semplici
e vengono visualizzate tra parentesi nell'area di progettazione e nelle finestre di dialogo. Un campo del set di dati viene ad esempio visualizzato come [ProductID]. Le espressioni semplici vengono create automaticamente quando si trascina un campo da un set di dati in una casella di testo. Viene creato un segnaposto e l'espressione definisce il valore sottostante. È inoltre possibile digitare le espressioni direttamente in una cella o in una casella di testo dell'area dati, sia nell'area di progettazione che in una finestra di dialogo, ad esempio [ProductID].
Nella tabella seguente sono elencati esempi delle modalità di utilizzo delle espressioni semplici. Viene fornita la descrizione della funzionalità, della proprietà da impostare, della finestra di dialogo in genere utilizzata per l'impostazione e del valore per la proprietà. È possibile digitare l'espressione semplice direttamente nell'area di progettazione, in una finestra di dialogo o nel riquadro Proprietà oppure modificarla nella finestra di dialogo Espressione, procedendo come per qualsiasi espressione.
Funzionalità |
Proprietà, contesto e finestra di dialogo |
Valore proprietà |
|---|---|---|
Specificare un campo del set di dati da visualizzare in una casella di testo. |
Proprietà Value per un segnaposto in una casella di testo. Utilizzare la Finestra di dialogo Proprietà segnaposto, Generale (Generatore report 2.0). |
[Sales] |
Aggregare valori per un gruppo. |
Proprietà Value per un segnaposto in una riga associata a un gruppo Tablix. Utilizzare la Finestra di dialogo Proprietà casella di testo, Generale (Generatore report 2.0). |
[Sum(Sales)] |
Includere un numero di pagina. |
Proprietà Value per un segnaposto in una casella di testo posizionata in un'intestazione di pagina. Utilizzare la Finestra di dialogo Proprietà casella di testo, Generale (Generatore report 2.0). |
[&PageNumber] |
Visualizzare un valore di parametro selezionato. |
Proprietà Value per un segnaposto in una casella di testo nell'area di progettazione. Utilizzare la Finestra di dialogo Proprietà casella di testo, Generale (Generatore report 2.0). |
[@SalesThreshold] |
Specificare una definizione di gruppo per un'area dati. |
Espressione di raggruppamento nel gruppo Tablix. Utilizzare la Finestra di dialogo Proprietà gruppo Tablix, Generale (Generatore report 2.0). |
[Category] |
Escludere un valore di campo specifico da una tabella. |
Equazione di filtro nella Tablix. Utilizzare la Finestra di dialogo Proprietà Tablix, Filtri (Generatore report 2.0). |
Come tipo di dati, selezionare Integer. [Quantity] > 100 |
Includere solo un valore specifico per un filtro di gruppo. |
Equazione di filtro nel gruppo Tablix. Utilizzare la Finestra di dialogo Proprietà gruppo Tablix, Filtri (Generatore report 2.0). |
[Category] = Clothing |
Escludere valori specifici per più campi da un set di dati. |
Equazione di filtro per un gruppo in una Tablix. Utilizzare la Finestra di dialogo Proprietà Tablix, Filtri (Generatore report 2.0). |
=[Color] <> Red =[Color] <> Blue |
Specificare l'ordinamento in base a un campo esistente in una tabella. |
Espressione di ordinamento nella Tablix. Utilizzare la Finestra di dialogo Proprietà Tablix, Ordinamento (Generatore report 2.0). |
[SizeSortOrder] |
Collegare un parametro di query a un parametro di report. |
Raccolta di parametri nel set di dati. Utilizzare la Finestra di dialogo Proprietà set di dati, Parametri (Generatore report 2.0). |
[@Category] [@Category] |
Passare un parametro da un report principale a un sottoreport. |
Raccolta di parametri nel sottoreport. Utilizzare la Finestra di dialogo Proprietà sottoreport, Parametri (Generatore report 2.0). |
[@Category] [@Category] |
Per ulteriori esempi, vedere Esempi di espressione (Generatore report 2.0).
Utilizzo di espressioni complesse
Le espressioni complesse possono contenere più riferimenti, operatori e chiamate di funzione predefiniti e vengono visualizzate nell'area di progettazione come <<Expr>>. Per visualizzare o modificare il testo dell'espressione, è necessario aprire la finestra di dialogo Espressione o digitare direttamente nel riquadro Proprietà. Nella tabella seguente sono elencate le modalità di utilizzo standard di un'espressione complessa per visualizzare o organizzare i dati oppure modificare l'aspetto del report. Vengono ad esempio fornite indicazioni sulla proprietà da impostare, sulla finestra di dialogo in genere utilizzata per l'impostazione e sul valore per la proprietà. È possibile digitare un'espressione direttamente in una finestra di dialogo, nell'area di progettazione o nel riquadro Proprietà.
Funzionalità |
Proprietà, contesto e finestra di dialogo |
Valore proprietà |
|---|---|---|
Calcolare i valori di aggregazione per un set di dati. |
Proprietà Value per un segnaposto in una casella di testo. Utilizzare la Finestra di dialogo Proprietà segnaposto, Generale (Generatore report 2.0). |
=First(Fields!Sales.Value,"DataSet1") |
Concatenare testo ed espressioni nella stessa casella di testo. |
Proprietà Value per un segnaposto in una casella di testo posizionata in un'intestazione o in un piè di pagina. Utilizzare la Finestra di dialogo Proprietà Tablix, Filtri (Generatore report 2.0). |
="This report began processing at " & Globals!ExecutionTime |
Calcolare un valore di aggregazione per un set di dati in un ambito diverso. |
Proprietà Value per un segnaposto in una casella di testo posizionata in un gruppo Tablix. Utilizzare la Finestra di dialogo Proprietà Tablix, Filtri (Generatore report 2.0). |
=Max(Fields!Total.Value,"DataSet2) |
Formattare i dati in una casella di testo in base al valore. |
Proprietà Color per un segnaposto in una casella di testo nella riga dei dettagli di una Tablix. Utilizzare la Finestra di dialogo Proprietà casella di testo, Carattere (Generatore report 2.0). |
=IIF(Fields!TotalDue.Value < 10000,"Red","Black") |
Calcolare un valore una volta per farvi riferimento in tutto il report. |
Proprietà Value per una variabile del report. Utilizzare la Finestra di dialogo Proprietà report, Variabili (Generatore report 2.0). Per ulteriori informazioni sulle variabili, vedere Utilizzo di riferimenti a raccolte di variabili di report e di gruppo nelle espressioni (Generatore report 2.0). |
=Variables!MyCalculation.Value |
Includere valori specifici per più campi di un set di dati. |
Equazione di filtro per un gruppo in una Tablix. Utilizzare la Finestra di dialogo Proprietà Tablix, Filtri (Generatore report 2.0). |
Come tipo di dati, selezionare Boolean. =IIF(InStr(Fields!Subcat.Value,"Shorts")=0 AND (Fields!Size.Value="M" OR Fields!Size.Value="S"),TRUE, FALSE) = TRUE |
Nascondere una casella di testo nell'area di progettazione, la cui visibilità può essere attivata o disattivata dall'utente mediante un parametro booleano denominato Show. |
Proprietà Hiddenin una casella di testo. Utilizzare la Finestra di dialogo Proprietà casella di testo, Visibilità (Generatore report 2.0). |
=Not Parameters!Show<boolean parameter>.Value |
Specificare il contenuto dinamico dell'intestazione o del piè di pagina. |
Proprietà Value per un segnaposto in una casella di testo posizionata nell'intestazione o nel piè di pagina. Utilizzare la Finestra di dialogo Proprietà Tablix, Filtri (Generatore report 2.0). |
="Page " & Globals!PageNumber & " of " & Globals!TotalPages |
Specificare un'origine dati in modo dinamico utilizzando un parametro. |
Stringa di connessione nell'origine dati. Utilizzare la Finestra di dialogo Proprietà origine dati, Generale (Generatore report 2.0). |
="Data Source=" & Parameters!ServerName.Value & ";initial catalog=AdventureWorks" |
Identificare tutti i valori per un parametro multivalore scelto dall'utente. |
Proprietà Value per un segnaposto in una casella di testo. Utilizzare la Finestra di dialogo Proprietà Tablix, Filtri (Generatore report 2.0). |
=Join(Parameters!MyMultivalueParameter.Value,", ") |
Specificare interruzioni di pagina ogni 20 righe in una Tablix senza altri gruppi. |
Espressione di raggruppamento per un gruppo in una Tablix. Utilizzare la Finestra di dialogo Proprietà gruppo Tablix, Generale (Generatore report 2.0). Proprietà PageBreak per il gruppo nella Tablix. Utilizzare la Finestra di dialogo Proprietà gruppo Tablix, Interruzioni di pagina (Generatore report 2.0). Impostare Tra ogni istanza di un gruppo. |
=Ceiling(RowNumber(Nothing)/20) |
Specificare la visibilità condizionale in base a un parametro. |
Proprietà Hidden per una Tablix. Utilizzare la Finestra di dialogo Proprietà Tablix, Visibilità (Generatore report 2.0). |
=Not Parameters!<boolean parameter>.Value |
Specificare una data formattata per una lingua specifica. |
Proprietà Value per un segnaposto di una casella di testo in un'area dati. Utilizzare la Finestra di dialogo Proprietà casella di testo, Generale (Generatore report 2.0). |
=Fields!OrderDate.Value.ToString(System.Globalization.CultureInfo.CreateSpecificCulture("de-DE")) |
Concatenare una stringa e un numero nel formato di percentuale a due cifre decimali. |
Proprietà Value per un segnaposto di una casella di testo in un'area dati. Utilizzare la Finestra di dialogo Proprietà casella di testo, Generale (Generatore report 2.0). |
="Growth Percent: " & Format(Fields!Growth.Value,"p2") |
Per ulteriori esempi, vedere Esempi di espressione (Generatore report 2.0).
Vedere anche