Tipi di dati nelle espressioni in un report impaginato (Generatore report)

  • Articolo

Si applica a:✅ Generatore di report Microsoft (SSRS) ✅ Power BI Report Builder ✅ Report Designer in SQL Server Data Tools

I tipi di dati rappresentano tipologie di dati diversi in un report impaginato per consentirne l'archiviazione e l'elaborazione in modo efficiente. I tipi di dati standard includono testo, noto anche come stringhe, numeri con e senza posizioni decimali, date e ore e immagini. I valori in un report devono essere costituiti da un tipo di dati RDL (Report Definition Language). È possibile formattare un valore in base alle proprie preferenze quando si lo visualizza in un report. Un campo che rappresenta la valuta, ad esempio, viene archiviato nella definizione del report come numero a virgola mobile, ma può essere visualizzato in diversi formati a seconda della proprietà di formattazione scelta.

Per altre informazioni sui formati di visualizzazione, vedere Formattazione degli elementi del report (Generatore report e SSRS).

Nota

È possibile creare e modificare file di definizioni di report impaginati (con estensione rdl) in Generatore report di Microsoft, Power BI Report Builder e Progettazione report di SQL Server Data Tools.

Tipi di dati RDL (Report Definition Language) e tipi di dati CLR (Common Language Runtime)

I valori specificati in un file RDL devono essere un tipo di dati RDL. Quando il report viene compilato ed elaborato, i tipi di dati RDL vengono convertiti in tipi di dati CLR. Nella tabella seguente viene visualizzata la conversione, contrassegnata come valore predefinito:

Tipo RDL Tipi CLR
String Valore predefinito: String

Chart, GUID, Timespan
Booleano Valore predefinito: Boolean
Intero Valore predefinito: Int64

Int16, Int32, Uint16, Uint64, Byte, Sbyte
Data/Ora Valore predefinito: DateTime

DateTimeOffset
Float Valore predefinito: Double

Single, Decimal
Binario Valore predefinito: Byte []
Variante Uno qualsiasi tra quelli riportati in precedenza eccetto Byte []
VariantArray Matrice di Variant
Serializable Variant oppure tipi contrassegnati con Serializable o che consentono di implementare ISerializable.

Informazioni sui tipi di dati e scrittura di espressioni

È importante comprendere i tipi di dati quando si scrivono espressioni per confrontare o combinare valori, ad esempio quando si definiscono espressioni di raggruppamento o di filtro o quando si calcolano le aggregazioni. Confronti e calcoli sono validi solo tra elementi dello stesso tipo di dati. Se i tipi di dati non corrispondono, è necessario convertire esplicitamente il tipo di dati nell'elemento del report utilizzando un'espressione.

Nell'elenco seguente sono descritti i casi in cui potrebbe essere necessario convertire i dati in un altro tipo di dati:

  • Confronto del valore di un parametro del report di un tipo di dati con un campo del set di dati di un altro tipo di dati.

  • Scrittura di espressioni di filtro che confrontano valori di tipi di dati differenti.

  • Scrittura di espressioni di ordinamento che combinano campi di tipi di dati diversi.

  • Scrittura di espressioni di raggruppamento che combinano campi di tipi di dati diversi.

  • Conversione da un tipo di dati a un altro tipo di dati di un valore recuperato dall'origine dati.

Determinazione del tipo di dati del report

Per determinare il tipo di dati di un elemento del report è possibile scrivere un'espressione. Ad esempio, per visualizzare il tipo di dati del campo MyField, aggiungere l'espressione =Fields!MyField.Value.GetType().ToString()a una cella della tabella. Il risultato indica il tipo di dati CLR usato per rappresentare MyField, ad esempio System.String o System.DateTime.

Conversione dei campi del set di dati in un altro tipo di dati

È inoltre possibile convertire i campi del set di dati prima di utilizzarli in un report. Nell'elenco seguente vengono descritte le modalità di conversione di un campo del set di dati esistente:

  • Modificare la query del set di dati in modo da aggiungere un nuovo campo di query con i dati convertiti. Per le origini dati relazionali o multidimensionali, per eseguire la conversione vengono utilizzate le risorse dell'origine dati.

  • Creare un campo calcolato basato su un campo del set di dati del report esistente scrivendo un'espressione che converte tutti i dati di una colonna del set di risultati in una nuova colonna con un tipo di dati differente. L'espressione seguente, ad esempio, converte il campo Year da un valore di tipo Integer in un valore di tipo String: =CStr(Fields!Year.Value). Per altre informazioni, vedere Aggiungere, modificare e aggiornare campi nel riquadro dei dati del report (Generatore report e SSRS).

  • Controllare se l'estensione per l'elaborazione dati in uso include metadati per il recupero dei dati preformattati. Una query MDX di SQL Server Analysis Services include ad esempio una proprietà estesa FORMATTED_VALUE per i valori del cubo già formattati durante l'elaborazione del cubo. Per altre informazioni, vedere la sezione Proprietà di campo estese per un database di Analysis Services (SSRS).

Informazioni sui tipi di dati dei parametri

I parametri del report devono essere di uno dei cinque tipi di dati seguenti: Boolean, DateTime, Integer, Float o Text (anche noto come String). Quando una query del set di dati include parametri di query, i parametri del report vengono creati automaticamente e collegati ai parametri di query. Il tipo di dati predefinito per un parametro di report è String. Per modificare tale tipo di dati, selezionare il valore corretto nell'elenco a discesa Tipo di dati nella pagina Generale della finestra di dialogo Proprietà parametri report .

Nota

I parametri di report di tipo DateTime non supportano i millisecondi. Sebbene sia possibile creare un parametro basato su valori che includono millisecondi, non è possibile selezionare un valore da un elenco a discesa di valori disponibili contenente valori di tipo Date o Time che includono millisecondi.

Scrittura di espressioni che convertono tipi di dati o estraggono parti di dati

Quando si combinano testo e campi del set di dati utilizzando l'operatore di concatenazione (&), Common Language Runtime (CLR) fornisce in genere formati predefiniti. Per convertire in modo esplicito un parametro o un campo del set di dati in un tipo di dati specifico, è necessario utilizzare un metodo CLR o una funzione della libreria di runtime di Visual Basic.

Nella tabella seguente sono riportati alcuni esempi di conversione dei tipi di dati.

Tipo di conversione Esempio
Da DateTime a String =CStr(Fields!Date.Value)
Da String a DateTime =DateTime.Parse(Fields!DateTimeinStringFormat.Value)
Da String a DateTimeOffset =DateTimeOffset.Parse(Fields!DateTimeOffsetinStringFormat.Value)
Estrazione dell'anno =Year(Fields!TimeinStringFormat.Value)

-- or --

=Year(Fields!TimeinDateTimeFormat.Value)
Da Boolean a Integer =CInt(Parameters!BooleanField.Value)

- 1 è True e 0 è False.
Da Boolean a Integer =System.Convert.ToInt32(Fields!BooleanFormat.Value)

1 è True e 0 è False.
Solo la parte DateTime di un valore DateTimeOffset =Fields!MyDatetimeOffset.Value.DateTime
Solo la parte Offset di un valore DateTimeOffset =Fields!MyDatetimeOffset.Value.Offset

È inoltre possibile utilizzare la funzione Format per controllare il formato di visualizzazione del valore. Per altre informazioni, vedere Funzioni (Visual Basic).

Esempi avanzati

Quando ci si connette a un'origine dati con un provider di dati che non fornisce il supporto di conversione per tutti i tipi di dati dell'origine dati, il tipo di dati predefinito per i tipi di origine dati non supportati corrisponde a String. Negli esempi seguenti sono fornite le soluzioni per i tipi di dati specifici restituiti come stringa.

Concatenazione di una stringa e di un tipo di dati DateTimeOffset CLR

Per la maggior parte dei tipi di dati, CLR fornisce conversioni predefinite in modo da consentire la concatenazione di valori con tipi di dati diversi in una stringa mediante l'operatore &. Nell'espressione seguente, ad esempio, viene concatenato il testo "The date and time are: " con il campo del set di dati StartDate, che rappresenta un valore DateTime : ="The date and time are: " & Fields!StartDate.Value.

Per alcuni tipi di dati, potrebbe essere necessario includere la funzione ToString. Nell'espressione seguente, ad esempio, è riportato lo stesso esempio con il tipo di dati CLR DateTimeOffsetche include la data, l'ora e una differenza di fuso orario rispetto al fuso orario UTC: ="The time is: " & Fields!StartDate.Value.ToString().

Conversione del tipo di dati String in un tipo di dati DateTime CLR

Se un'estensione per l'elaborazione dati non supporta tutti i tipi di dati definiti in un'origine dati, i dati possono essere recuperati come testo. Un valore del tipo di dati datetimeoffset(7) può essere, ad esempio, recuperato come dati di tipo String. A Perth, in Australia, il valore stringa per il 1 luglio 2008, alle 6:05:07.9999999 AM sarebbe:

2008-07-01 06:05:07.9999999 +08:00

In questo esempio viene mostrata la data (1 luglio 2008), seguita dall'ora espressa con una precisione di 7 cifre (06:05:07.9999999 AM), seguita da una differenza di fuso orario dall'ora UTC espressa in ore e minuti (più 8 ore e 0 minuti). Per l'esempio seguente, questo valore è stato inserito in un campo String denominato MyDateTime.Value.

Per convertire questi dati in uno o più valori CLR, è possibile adottare una delle strategie seguenti:

  • In una casella di testo utilizzare un'espressione per estrarre parti della stringa. Ad esempio:

    • Nell'espressione seguente solo la parte relativa all'ora della differenza di fuso orario dall'ora UTC viene prima estratta e poi convertita in minuti: =CInt(Fields!MyDateTime.Value.Substring(Fields!MyDateTime.Value.Length-5,2)) * 60

      Il risultato è 480.

    • Nell'espressione seguente la stringa viene convertita in un valore di data e ora: =DateTime.Parse(Fields!MyDateTime.Value)

      Se la stringa MyDateTime.Value include una differenza dall'ora UTC, la funzione DateTime.Parse regola prima l'ora in base alla differenza dall'ora UTC, ovvero le 7.00, ora ottenuta sommando [+08:00] all'ora UTC 23.00 della sera precedente. La funzione DateTime.Parse applica quindi la differenza UTC del server di report locale e, se necessario, regola nuovamente l'ora in base all'ora legale. Ad esempio, a Redmond, Washington, la differenza tra ora locale e ora legale è [-07:00], ovvero 7 ore prima delle 23.00. Il risultato è il valore DateTime seguente: 2007-07-06 04:07:07 PM (6 luglio 2007 alle 16.07).

Per altre informazioni sulla conversione di stringhe in tipi di dati DateTime, vedere Analisi delle stringhe di data e ora, Formattazione di data e ora per impostazioni cultura specifiche e Scelta tra DateTime, DateTimeOffset e TimeZoneInfo.

  • Aggiungere un nuovo campo calcolato al set di dati del report che utilizza un'espressione per estrarre parti della stringa. Per altre informazioni, vedere Aggiungere, modificare e aggiornare campi nel riquadro dei dati del report (Generatore report e SSRS).

  • Modificare la query del set di dati del report per utilizzare le funzioni Transact-SQL per estrarre i valori di data e ora indipendentemente in modo da creare colonne separate. L'esempio seguente illustra come usare la funzione DatePart per aggiungere una colonna per l'anno e una colonna per il fuso orario UTC convertito in minuti:

    SELECT

    MyDateTime,

    DATEPART(year, MyDateTime) AS Year,

    DATEPART(tz, MyDateTime) AS OffsetinMinutes

    FROM MyDates

    Il set di risultati contiene tre colonne. La prima colonna indica la data e l'ora, la seconda indica l'anno e la terza indica la differenza UTC espressa in minuti. Nella riga seguente sono riportati dati di esempio:

    2008-07-01 06:05:07 2008 480

Per altre informazioni sui tipi di dati dei database di SQL Server, vedere Tipi di dati (Transact-SQL) e Funzioni e tipi di dati di data e ora (Transact-SQL).

Per altre informazioni sui tipi di dati di SQL Server Analysis Services, vedere Tipi di dati in Analysis Services.

Vedi anche

Formattazione degli elementi del report (Generatore di report e SSRS)