Condividi tramite


Raccolta campi set di dati (Generatore report e SSRS)

I campi del set di dati rappresentano i dati di una connessione dati. Un campo può rappresentare dati numerici o non numerici. Ad esempio, gli importi delle vendite, le vendite totali, i nomi dei clienti, gli identificatori di database, gli URL, le immagini, i dati spaziali e gli indirizzi di posta elettronica. Nell'area di progettazione i campi vengono visualizzati come espressioni negli elementi del report, ad esempio caselle di testo, tabelle e grafici.

Un report include tre tipi di campi e li visualizza nel riquadro Dati report: campi del set di dati, campi calcolati del set di dati e campi predefiniti.

  • Campi del set di dati. I metadati che rappresentano l'insieme di campi che verranno restituiti quando la query del set di dati viene eseguita sulla fonte dati.

  • Campi calcolati del dataset. Campi aggiuntivi creati per il set di dati. Ogni campo calcolato viene creato valutando un'espressione definita dall'utente.

  • Campi integrati. Metadati che rappresentano una raccolta di campi forniti da Generatore report che forniscono informazioni sul report, ad esempio il nome del report o l'ora di elaborazione del report. Per altre informazioni, vedere Riferimenti alle raccolte predefinite Globals e Users (Generatore report e SSRS).

I nomi dei campi del set di dati vengono salvati come parte della definizione del set di dati del report. Per altre informazioni, vedere Set di dati incorporati del report e set di dati condivisi (Generatore report e SSRS).

Annotazioni

È possibile creare e modificare definizioni di report (con estensione rdl) in Generatore report e in Progettazione report in SQL Server Data Tools. Ogni ambiente di creazione offre diversi modi per creare, aprire e salvare report e elementi correlati. Per ulteriori informazioni, vedere Progettazione di report in Progettazione report e Generatore report (SSRS) sul sito Web di microsoft.com.

Campi e query del set di dati

I campi del set di dati vengono specificati dal comando query del set di dati e da tutti i campi calcolati definiti. La raccolta di campi visualizzati nel report dipende dal tipo di set di dati disponibile:

  • Set di dati condiviso. La raccolta di campi è l'elenco di campi per la query nella definizione del set di dati condiviso al momento dell'aggiunta diretta del set di dati condiviso al report o quando è stata aggiunta una parte del report che include il set di dati condiviso. La raccolta di campi locale non cambia quando la definizione del set di dati condiviso cambia nel server di report. Per aggiornare la raccolta di campi locale, è necessario aggiornare l'elenco per il set di dati condiviso locale.

  • Set di dati incorporato. L'elenco dei campi restituiti dall'esecuzione della query corrente sulla sorgente dati costituisce la raccolta di campi.

Per altre informazioni, vedere Aggiungere, modificare, aggiornare i campi nel riquadro dei dati del report (Generatore report e SSRS)

Campi calcolati

Per specificare manualmente un campo calcolato, creare un'espressione. I campi calcolati possono essere usati per creare nuovi valori che non esistono nell'origine dati. Ad esempio, un campo calcolato può rappresentare un nuovo valore, un ordinamento personalizzato per un set di valori di campo o un campo esistente convertito in un tipo di dati diverso.

I campi calcolati sono locali in un report e non possono essere salvati come parte di un set di dati condiviso.

Per altre informazioni, vedere Aggiungere, modificare, aggiornare i campi nel riquadro dati del report (Generatore report e SSRS).

Entità e campi di entità

Se stai lavorando con un'origine dati del modello di report, specifica gli enti e i campi delle entità come dati del report. Nel progettazione delle query per il modello di report, è possibile esplorare e selezionare in modo interattivo le entità correlate e scegliere i campi da includere nel set di dati del report. Dopo aver completato la progettazione della query, è possibile visualizzare la raccolta di identificatori di entità e campi di entità nel riquadro Dati report. Gli identificatori di entità vengono generati automaticamente dal modello di report e in genere non vengono visualizzati per l'utente finale.

Utilizzo delle proprietà dei campi estesi

Origini dati che supportano query multidimensionali, ad esempio SQL Server Analysis Services, supportano le proprietà dei campi nei campi. Le proprietà dei campi vengono visualizzate nel set di risultati per una query, ma non sono visibili nel riquadro Dati report . Sono ancora disponibili per l'uso nel report. Per fare riferimento a una proprietà per un campo, trascinare il campo nel report e modificare la proprietà Value predefinita con il nome del campo della proprietà desiderata. Ad esempio, in un cubo di Analysis Services è possibile definire i formati per i valori nelle celle del cubo. Il valore formattato è disponibile usando la proprietà FormattedValuefield . Per usare direttamente il valore anziché usare un valore e impostare la proprietà format della casella di testo, trascinare il campo nella casella di testo e modificare l'espressione =Fields!FieldName.Value predefinita in =Fields!FieldName.FormattedValue.

Annotazioni

Non tutte le Field proprietà possono essere usate per tutte le origini dati. Le Value proprietà e IsMissing sono definite per tutte le origini dati. Altre proprietà predefinite , ad esempio Key, UniqueNamee ParentUniqueName per le origini dati multidimensionali, sono supportate solo se l'origine dati fornisce tali proprietà. Le proprietà personalizzate sono supportate da alcuni provider di dati. Per ulteriori informazioni, consultare argomenti specifici riguardanti le proprietà estese dei campi per il tipo di origine dati del tuo sistema in Set di dati incorporati del report e set di dati condivisi (Generatore report e SSRS). Ad esempio, per un'origine dati di SQL ServerAnalysis Services, vedere Proprietà dei campi estesi per un database di Analysis Services (SSRS).

Informazioni sulle espressioni predefinite per i campi

Una casella di testo può essere un elemento del report 'casella di testo' nel corpo del report o una casella di testo in una cella in un'area dati 'Tablix'. Quando si collega un campo a una casella di testo, la posizione della casella di testo determina l'espressione predefinita per il riferimento al campo. Nel corpo del report, un'espressione di valore della casella di testo deve specificare un'aggregazione e un set di dati. Se nel report è presente un solo set di dati, questa espressione predefinita viene creata automaticamente. Per un campo che rappresenta un valore numerico, la funzione di aggregazione predefinita è Sum. Per un campo che rappresenta un valore non numerico, l'aggregazione predefinita è First.

In un'area dati Tablix l'espressione di campo predefinita dipende dalle appartenenze a righe e gruppi della casella di testo a cui si aggiunge il campo. L'espressione di campo per il campo Sales, se aggiunta a una casella di testo nella riga di dettaglio di una tabella, è [Sales]. Se si aggiunge lo stesso campo a una casella di testo in un'intestazione di gruppo, l'espressione predefinita è (Sum[Sales]), perché l'intestazione del gruppo visualizza i valori di riepilogo per il gruppo, non i valori di dettaglio. Quando il report viene eseguito, l'elaboratore di report valuta ogni espressione e sostituisce il risultato nel report.

Per altre informazioni sulle espressioni, vedere Espressioni (Generatore report e SSRS).

Tipi di dati dei campi

Quando si crea un set di dati, i tipi di dati dei campi nell'origine dati potrebbero non essere esattamente i tipi di dati usati in un report. I tipi di dati possono passare attraverso uno o due livelli di mapping. L'estensione per l'elaborazione dati o il provider di dati può eseguire il mapping dei tipi di dati dall'origine dati ai tipi di dati CLR (Common Language Runtime). I tipi di dati restituiti dalle estensioni per l'elaborazione dati vengono mappati a un subset di tipi di dati CLR (Common Language Runtime) di .NET Framework.

Nell'origine dati i dati vengono archiviati nei tipi di dati supportati dall'origine dati. Ad esempio, i dati in un database di SQL Server devono essere uno dei tipi di dati di SQL Server supportati, nvarchar ad esempio o datetime. Quando si recuperano dati dall'origine dati, i dati passano attraverso un'estensione per l'elaborazione dati o un provider di dati associato al tipo di origine dati. A seconda dell'estensione per l'elaborazione dati, i dati possono essere convertiti dai tipi di dati usati dall'origine dati in tipi di dati supportati dall'estensione per l'elaborazione dati. Reporting Services usa i tipi di dati supportati da Common Language Runtime (CLR) installati con SQL Server Data Tools (SSDT). Il provider di dati esegue il mapping di ogni colonna nel set di risultati dal tipo di dati nativo a un tipo di dati CLR (Common Language Runtime) di .NET Framework.

In ogni fase, i dati sono rappresentati dai tipi di dati come descritto nell'elenco seguente:

  • Origine dati Tipi di dati supportati dalla versione del tipo di origine dati a cui ci si connette.

    Ad esempio, i tipi di dati tipici per un'origine dati di SQL Server includono int, datetimee varchar. I tipi di dati introdotti da SQL Server 2008 hanno aggiunto il supporto per date, time, datetimetze datetime2. Per altre informazioni, vedere Tipi di dati (Transact-SQL).

  • Estensione per il provider di dati o l'elaborazione dati Tipi di dati supportati dalla versione del provider di dati dell'estensione per l'elaborazione dati selezionata quando ci si connette all'origine dati. I provider di dati basati su .NET Framework usano tipi di dati supportati da CLR. Per altre informazioni sui tipi di dati del provider di dati .NET Framework, vedere Mapping dei tipi di dati (ADO.NET) e Utilizzo dei tipi di base su MSDN.

    Ad esempio, i tipi di dati tipici supportati da .NET Framework includono Int32 e String. Le date e gli orari del calendario sono supportati dalla struttura DateTime. .NET Framework 2.0 Service Pack 1 ha introdotto il supporto per la struttura DateTimeOffset per le date con un offset del fuso orario.

    Annotazioni

    Il server di report usa i provider di dati installati e configurati nel server di report. I client di creazione di report in modalità anteprima usano le estensioni per l'elaborazione dati installate e configurate nel computer client. È necessario testare il report sia nel client di report che nell'ambiente del server di report.

  • Processore report I tipi di dati sono basati sulla versione di CLR installata durante l'installazione di Reporting Services.

    Ad esempio, i tipi di dati usati dall'elaboratore di report per i nuovi tipi di data e ora introdotti in SQL Server 2008 sono illustrati nella tabella seguente:

    Tipo di dati SQL Tipo di dati CLR Descrizione
    Date DateTime Solo data
    Time TimeSpan Solo ora
    DateTimeTZ DateTimeOffset Data e ora con differenza di fuso orario
    DateTime2 DateTime Data e ora con millisecondi frazionari

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

Per altre informazioni sull'inclusione di riferimenti a un campo del set di dati da un'espressione, vedere Tipi di dati nelle espressioni (Generatore report e SSRS).

Rilevamento di campi mancanti in fase di esecuzione

Quando il report viene elaborato, il set di risultati per un set di dati potrebbe non contenere valori per tutte le colonne specificate perché le colonne non esistono più nell'origine dati. È possibile utilizzare la proprietà del campo IsMissing per rilevare se i valori per un campo sono stati restituiti in fase di esecuzione. Per altre informazioni, vedere Riferimenti alla raccolta di campi del set di dati (Generatore report e SSRS).

Vedere anche

Finestra di dialogo Proprietà set di dati, Campi (Generatore di report)
Parti del report e set di dati in Report Builder
Set di dati condivisi e incorporati del report (Generatore di report e SSRS)