Raccolta di campi del set di dati (Generatore report e SSRS)Dataset Fields Collection (Report Builder and SSRS)

I campi del set di dati rappresentano i dati provenienti da una connessione dati.Dataset fields represent the data from a data connection. Un campo può presentare dati numerici o non numerici.A field can represent either numeric or non-numeric data. Possono essere inclusi, ad esempio, importi delle vendite, vendite totali, nomi dei clienti, identificatori di database, URL, immagini, dati spaziali e indirizzi di posta elettronica.Examples include sales amounts, total sales, customer names, database identifiers, URLs, images, spatial data, and e-mail addresses. Nell'area di progettazione i campi vengono visualizzati come espressioni in elementi del report quali caselle di testo, tabelle e grafici.On the design surface, fields appear as expressions in report items such as text boxes, tables, and charts.

Un report dispone di tre tipi di campi che vengono visualizzati nel riquadro dei dati del report, ovvero i campi del set di dati, i campi calcolati del set di dati e i campi predefiniti.A report has three types of fields and displays them in the Report Data pane: dataset fields, dataset calculated fields, and built-in fields.

  • Campi del set di dati.Dataset fields. I metadati che rappresentano la raccolta dei campi che verranno restituiti quando viene eseguita la query del set di dati nell'origine dati.The metadata that represents the collection of fields that will be returned when the dataset query runs on the data source.

  • Campi calcolati del set di dati.Dataset calculated fields. I campi aggiuntivi creati dall'utente per il set di dati.Additional fields that you create for the dataset. Ogni campo calcolato viene creato valutando un'espressione definita dall'utente.Each calculated field is created by evaluating an expression that you define.

  • Campi predefiniti.Built-in fields. I metadati che rappresentano una raccolta dei campi forniti da Generatore report contenenti informazioni sui report quali il nome o l'ora di elaborazione del report.The metadata that represents a collection of fields provided by Report Builder that provide report information such as the report name or the time when the report was processed. Per altre informazioni, vedere Riferimenti alle raccolte predefinite Globals e Users (Generatore report e SSRS).For more information, see Built-in Globals and Users References (Report Builder and SSRS).

    I nomi dei campi del set di dati vengono salvati come parte della definizione del set di dati del report.Dataset field names are saved as part of the report dataset definition. Per altre informazioni, vedere Set di dati condivisi e incorporati del report (Generatore report e SSRS).For more information, see Report Embedded Datasets and Shared Datasets (Report Builder and SSRS).

Nota

È possibile creare e modificare file di definizioni report impaginati (con estensione rdl) in Generatore report e in Progettazione report di SQL Server Data Tools.You can create and modify paginated report definition (.rdl) files in Report Builder and in Report Designer in SQL Server Data Tools. Ogni ambiente di creazione offre modalità differenti per creare, aprire e salvare report ed elementi correlati.Each authoring environment provides different ways to create, open, and save reports and related items.

Campi del set di dati e queryDataset Fields and Queries

I campi del set di dati vengono specificati dal comando di query del set di dati e da qualsiasi campo calcolato definito dall'utente.Dataset fields are specified by the dataset query command and by any calculated fields that you define. La raccolta di campi visualizzata nel report dipende dal tipo di set di dati a disposizione:The collection of fields that you see in your report depends on the type of dataset you have:

  • Set di dati condivisi.Shared dataset. La raccolta di campi è costituita dall'elenco di campi per la query presente nella definizione del set di dati condiviso quando il set di dati condiviso è stato aggiunto direttamente al report oppure quando è stata aggiunta una parte di report nella quale era incluso il set di dati condiviso.The field collection is the list of fields for the query in the shared dataset definition at the time that you directly added the shared dataset to your report, or when you added a report part that included the shared dataset. La raccolta di campi locale non subisce variazioni quando viene modificata la definizione del set di dati condiviso sul server di report.The local field collection does not change when the shared dataset definition changes on the report server. Per aggiornare la raccolta di campi locale, è necessario aggiornare l'elenco per il set di dati condiviso locale.To update the local field collection, you must refresh the list for the local shared dataset.

  • Set di dati incorporato.Embedded dataset. La raccolta di campi è costituita dall'elenco di campi restituito tramite l'esecuzione della query corrente rispetto all'origine dati.The field collection is the list of fields that is returned from running the current query against the data source.

    Per altre informazioni, vedere Aggiunta, modifica e aggiornamento di campi nel riquadro dei dati del report (Generatore report e SSRS)For more information see, Add, Edit, Refresh Fields in the Report Data Pane (Report Builder and SSRS)

Campi calcolatiCalculated Fields

Un campo calcolato viene specificato manualmente creando un'espressione.You specify a calculated field manually by creating an expression. I campi calcolati possono essere utilizzati per creare nuovi valori che non esistono nell'origine dati.Calculated fields can be used to create new values that do not exist on the data source. Un campo calcolato può rappresentare ad esempio un nuovo valore, un ordinamento personalizzato per un set di valori del campo o un campo esistente convertito in un tipo di dati diverso.For example, a calculated field can represent a new value, a custom sort order for a set of field values, or an existing field that is converted to a different data type.

I campi calcolati sono locali in un report e non possono essere salvati come parte di un set di dati condiviso.Calculated fields are local to a report and cannot be saved as part of a shared dataset.

Per altre informazioni, vedere Aggiunta, modifica e aggiornamento di campi nel riquadro dei dati del report (Generatore report e SSRS).For more information, see Add, Edit, Refresh Fields in the Report Data Pane (Report Builder and SSRS).

Entità e campi di entitàEntities and Entity Fields

Se si utilizza un'origine dati del modello di report, è necessario specificare le entità e i campi delle entità come dati del report in uso.If you are working with a report model data source, you specify the entities and entity fields as your report data. In Progettazione query per un modello di report è possibile esplorare in modo interattivo e selezionare le entità correlate, nonché scegliere i campi che si desidera includere nel set di dati del report.In the query designer for a report model, you can interactively explore and select related entities and choose the fields that you want to include in your report dataset. Dopo aver completato la progettazione della query, è possibile vedere la raccolta di identificatori di entità e campi di entità nel riquadro dei dati del report.After you finish designing the query, you can see the collection of entity identifiers and entity fields in the Report Data pane. Gli identificatori di entità vengono generati automaticamente dal modello di report e in genere non vengono visualizzati dall'utente finale.Entity identifiers are generated automatically by the report model and are typically not displayed for the end user.

Utilizzo delle proprietà di campo esteseUsing Extended Field Properties

Le origini dati che supportano query multidimensionali, ad esempio SQL ServerSQL Server Analysis ServicesAnalysis Services, supportano anche le proprietà di campo per i campi.Data sources that support multidimensional queries, such as SQL ServerSQL Server Analysis ServicesAnalysis Services, support field properties on fields. Tali proprietà vengono visualizzate nel set di risultati per una query, ma non sono visibili nel riquadro Dati report .Field properties appear in the result set for a query, but are not visible in the Report Data pane. È possibile comunque usarle nel report.They are still available to use in your report. Per fare riferimento a una proprietà per un campo, trascinare il campo nel report e modificare la proprietà predefinita Value impostandola sul nome del campo della proprietà desiderata.To refer to a property for a field, drag the field onto the report, and change the default property Value to the field name of the property you want. In un cubo di Analysis ServicesAnalysis Services , ad esempio, è possibile definire formati per i valori presenti nelle celle del cubo.For example, in an Analysis ServicesAnalysis Services cube, you can define formats for values in the cube cells. Il valore formattato è disponibile se si usa la proprietà di campo FormattedValue.The formatted value is available by using the field property FormattedValue. Per usare direttamente il valore anziché usare un valore e impostare la proprietà del formato della casella di testo, trascinare il campo nella casella di testo e impostare l'espressione predefinita =Fields!FieldName.Value su =Fields!FieldName.FormattedValue.To use the value directly instead of using a value and setting the format property of the text box, drag the field to the text box and change the default expression =Fields!FieldName.Value to =Fields!FieldName.FormattedValue.

Nota

Solo alcune proprietà Field possono essere usate per tutte le origini dati.Not all Field properties can be used for all data sources. Le proprietà Value e IsMissing vengono definite per tutte le origini dati.The Value and IsMissing properties are defined for all data sources. Altre proprietà predefinite, ad esempio Key, UniqueNamee ParentUniqueName per origini dati multidimensionali, sono supportate solo se sono disponibili nell'origine dati.Other predefined properties (such as Key, UniqueName, and ParentUniqueName for multidimensional data sources) are supported only if the data source provides those properties. Le proprietà personalizzate sono supportate da alcuni provider di dati.Custom properties are supported by some data providers. Per altre informazioni, vedere gli argomenti specifici sulle proprietà di campo estese per il tipo di origine dati in Set di dati condivisi e incorporati del report (Generatore report e SSRS).For more information, see specific topics about extended field properties for your data source type in Report Embedded Datasets and Shared Datasets (Report Builder and SSRS). Ad esempio, per un'origine dati SQL ServerSQL Server Analysis ServicesAnalysis Services, vedere Proprietà di campo estese per un database di Analysis Services (SSRS).For example, for a SQL ServerSQL Server Analysis ServicesAnalysis Services data source, see Extended Field Properties for an Analysis Services Database (SSRS).

Informazioni sulle espressioni predefinite per i campiUnderstanding Default Expressions for Fields

Una casella di testo può essere un elemento di report casella di testo nel corpo del report oppure essere presente in una cella di un'area dati Tablix.A text box can be a text box report item in the report body, or a text box in a cell in a tablix data region. Quando si collega un campo a una casella di testo, la posizione di quest'ultima determina l'espressione predefinita per il riferimento di campo.When you link a field with a text box, the location of the text box determines the default expression for the field reference. Nel corpo del report un'espressione del valore della casella di testo deve specificare un'aggregazione e un set di dati.In the report body, a text box value expression must specify an aggregate and a dataset. Se nel report è presente un unico set di dati, tale espressione predefinita viene creata automaticamente.If only one dataset exists in the report, this default expression is created for you. Per un campo che rappresenta un valore numerico, la funzione di aggregazione predefinita è Sum,For a field that represents a numeric value, the default aggregate function is Sum. mentre per un campo che rappresenta un valore non numerico l'aggregazione predefinita è First.For a field that represents a non-numeric value, the default aggregate is First.

In un'area dati Tablix l'espressione predefinita del campo dipende dalle appartenenze a una riga e a un gruppo della casella di testo aggiunta al campo.In a tablix data region, the default field expression depends on the row and group memberships of the text box that you add the field to. Se a una casella di testo nella riga di dettaglio di una tabella viene aggiunto il campo Sales, l'espressione relativa è [Sales].The field expression for the field Sales, when added to a text box in the detail row of a table, is [Sales]. Se si aggiunge lo stesso campo a una casella di testo in un'intestazione del gruppo, l'espressione predefinita è (Sum[Sales]), poiché nell'intestazione del gruppo vengono visualizzati i valori di riepilogo per il gruppo, non quelli dettagliati.If you add the same field to a text box in a group header, the default expression is (Sum[Sales]), because the group header displays summary values for the group, not detail values. Durante l'esecuzione del report, l'elaboratore di report valuta ogni espressione e sostituisce il risultato nel report.When the report runs, the report processor evaluates each expression and substitutes the result in the report.

Per altre informazioni sulle espressioni, vedere Espressioni (Generatore report e SSRS).For more information about expressions, see Expressions (Report Builder and SSRS).

Tipi di dati dei campiField Data Types

Quando si crea un set di dati, i tipi di dati dei campi nell'origine dati potrebbero non corrispondere esattamente ai tipi di dati utilizzati in un report.When you create a dataset, the data types of the fields on the data source may not be exactly the data types used in a report. Ai tipi di dati possono essere applicati uno o due livelli di mapping.Data types may go through one or two mapping layers. L'estensione per l'elaborazione dati o il provider di dati può eseguire il mapping dei tipi di dati dall'origine dati a tipi di dati CLR (Common Language Runtime).The data processing extension or data provider may map data types from the data source to common language runtime (CLR) data types. I tipi di dati restituiti dalle estensioni per l'elaborazione dei dati vengono su cui viene eseguito il mapping a un subset di tipi di dati CLR da .NET Framework.NET Framework.The data types returned by data processing extensions are mapped to a subset of common language runtime (CLR) data types from the .NET Framework.NET Framework.

Nell'origine dati i dati vengono archiviati in tipi di dati supportati dall'origine stessa.On the data source, the data is stored in data types supported by the data source. I dati presenti in un database di SQL ServerSQL Server , ad esempio, devono essere di un tipo supportato da SQL ServerSQL Server , come nvarchar o datetime.For example, data in a SQL ServerSQL Server database must be one of the supported SQL ServerSQL Server data types such as nvarchar or datetime. Quando vengono recuperati dall'origine dati, i dati vengono passati attraverso un'estensione per l'elaborazione dati o un provider di dati associato al tipo di origine dati.When you retrieve data from the data source, the data passes through a data processing extension or data provider that is associated with the data source type. In base all'estensione per l'elaborazione dati, i dati possono essere convertiti dai tipi utilizzati dall'origine dati in tipi di dati supportati dall'estensione per l'elaborazione dati.Depending on the data processing extension, data may be converted from the data types used by data source into data types supported by the data processing extension. Reporting ServicesReporting Services usa i tipi di dati supportati da Common Language Runtime (CLR) installato con SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT). uses data types supported by the common language runtime (CLR) that is installed with SQL Server Data Tools (SSDT)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 di .NET Framework.NET Framework :The data provider maps each column in the result set from the native data type to a .NET Framework.NET Framework common language runtime (CLR) data type.

In ogni fase i dati vengono rappresentati dai tipi di dati in base a quanto descritto nell'elenco seguente.At each stage, the data is represented by the data types as described in the following list:

  • Origine dati Tipi di dati supportati dalla versione del tipo di origine dati alla quale ci si sta connettendo.Data source The data types supported by the version of the type of data source to which you are connecting.

    Tra i tipi di dati utilizzati in genere per un'origine dati SQL ServerSQL Server sono inclusi ad esempio int, datetimee varchar.For example, typical data types for a SQL ServerSQL Server data source include int, datetime, and varchar. I tipi di dati introdotti da SQL Server 2008SQL Server 2008 hanno aggiunto il supporto per date, time, datetimetze datetime2.Data types introduced by SQL Server 2008SQL Server 2008 added support for date, time, datetimetz, and datetime2. Per altre informazioni, vedere Tipi di dati (Transact-SQL).For more information, see Data Types (Transact-SQL).

  • Provider di dati o estensione per l'elaborazione dati Tipi di dati supportati dalla versione del provider di dati dell'estensione per l'elaborazione dei dati selezionata al momento della connessione all'origine dei dati.Data provider or data processing extension The data types supported by the version of the data provider of the data processing extension you select when you connect to the data source. I provider di dati basati su .NET Framework.NET Framework usano tipi di dati supportati da CLR.Data providers based on the .NET Framework.NET Framework use data types supported by the CLR. Per altre informazioni sui tipi di dati del provider di dati .NET Framework.NET Framework , vedere Mapping di tipi di dati (ADO.NET) e Utilizzo dei tipi di base su MSDN.For more information about .NET Framework.NET Framework data provider data types, see Data Type Mappings (ADO.NET) and Working with Base Types on MSDN.

    Tra i tipi di dati supportati in genere da .NET Framework.NET Framework sono inclusi ad esempio Int32 e String.For example, typical data types supported by the .NET Framework.NET Framework include Int32 and String. Le date e le ore del calendario sono supportate dalla struttura DateTime .Calendar dates and times are supported by the DateTime structure. In .NET Framework.NET Framework 2.0 Service Pack 1 è stato introdotto il supporto per la struttura DateTimeOffset per le date con una differenza di fuso orario.The .NET Framework.NET Framework 2.0 Service Pack 1 introduced support for the DateTimeOffset structure for dates with a time zone offset.

    Nota

    Nel server di report vengono utilizzati i provider di dati installati e configurati nel server di report stesso.The report server uses the data providers that are installed and configured on the report server. Nei client di creazione dei report in modalità di anteprima vengono utilizzate le estensioni per l'elaborazione dati installate e configurate nel computer client.Report authoring clients in Preview mode use the installed and configured data processing extensions on the client machine. È necessario eseguire il test del report sia nell'ambiente del client che nell'ambiente del server di report.You must test your report in both the report client and the report server environment.

  • Elaborazione report Tipi di dati basati sulla versione di CLR installata al momento dell'installazione di Reporting ServicesReporting Services.Report processor The data types are based on the version of the CLR installed when you installed Reporting ServicesReporting Services.

    I tipi di dati usati ad esempio da Elaborazione report per i nuovi tipi date e time introdotti in SQL Server 2008SQL Server 2008 sono riportati nella tabella seguente:For example, the data types the report processor uses for the new date and time types introduced in SQL Server 2008SQL Server 2008 are shown in the following table:

    Tipo di dati SQLSQL Data Type Tipo di dati CLRCLR Data Type DescriptionDescription
    DateDate DateTimeDateTime Solo dataDate only
    TimeTime TimeSpanTimeSpan Solo oraTime only
    DateTimeTZDateTimeTZ DateTimeOffsetDateTimeOffset Data e ora con differenza di fuso orarioDate and time with time zone offset
    DateTime2DateTime2 DateTimeDateTime Data e ora con millisecondi frazionariDate and time with fractional milliseconds

    Per altre informazioni sui tipi di database di SQL ServerSQL Server , vedere Tipi di dati (motore di database) e Funzioni e tipi di dati di data e ora (Transact-SQL).For more information about SQL ServerSQL Server database types, see Data Types (Database Engine) and Date and Time Data Types and Functions (Transact-SQL).

    Per altre informazioni sull'inclusione di riferimenti in un campo del set di dati da un'espressione, vedere Tipi di dati nelle espressioni (Generatore report e SSRS).For more information about including references to a dataset field from an expression, see Data Types in Expressions (Report Builder and SSRS).

Rilevamento dei campi mancanti in fase di esecuzioneDetecting Missing Fields at Run Time

Quando il report viene elaborato, il set di risultati per un set di dati potrebbe non contenere valori per tutte le colonne specificate, in quanto tali colonne non sono più disponibili nell'origine dati.When the report is processed, the result set for a dataset may not contain values for all of the columns specified because the columns no longer exist on the data source. È possibile usare la proprietà del campo IsMissing per verificare se i valori di un campo sono stati restituiti in fase di esecuzione.You can use the field property IsMissing to detect whether values for a field were returned at run-time. Per altre informazioni, vedere Riferimenti alla raccolta di campi del set di dati (Generatore report e SSRS).For more information, see Dataset Fields Collection References (Report Builder and SSRS).

Vedere ancheSee Also

Finestra di dialogo Proprietà set di dati, Campi (Generatore report) Dataset Properties Dialog Box, Fields (Report Builder)
Parti del report e set di dati in Generatore report Report Parts and Datasets in Report Builder
Set di dati condivisi e incorporati del report (Generatore report e SSRS)Report Embedded Datasets and Shared Datasets (Report Builder and SSRS)