Erweiterte Feldeigenschaften für eine Analysis Services-Datenbank (SSRS)Extended Field Properties for an Analysis Services Database (SSRS)

Die SQL ServerSQL Server Analysis ServicesAnalysis Services -Datenverarbeitungserweiterung unterstützt erweiterte Feldeigenschaften.The SQL ServerSQL Server Analysis ServicesAnalysis Services data processing extension supports extended field properties. Erweiterte Feldeigenschaften sind zusätzlich zu den für die Datenquelle verfügbaren und von der Datenverarbeitungserweiterung unterstützten Feldeigenschaften Value und IsMissing vorhanden.Extended field properties are properties in addition to the field properties Value and IsMissing that are available on the data source and supported by the data processing extension. Erweiterte Eigenschaften werden im Berichtsdatenbereich nicht als Teil der Feldauflistung für ein Berichtsdataset angezeigt.Extended properties do not appear in the Report Data pane as part of the field collection for a report dataset. Sie können erweiterte Feldeigenschaftswerte in den Bericht einbeziehen, indem Sie Ausdrücke schreiben, die deren Namen in der integrierten Fields -Sammlung angeben.You can include extended field property values in your report by writing expressions that specify them by name using the built-in Fields collection.

Erweiterte Eigenschaften umfassen vordefinierte Eigenschaften und benutzerdefinierte Eigenschaften.Extended properties include predefined properties and custom properties. Vordefinierte Eigenschaften werden für mehrere Datenquellen gemeinsam verwendet und bestimmten Feldeigenschaftsnamen zugeordnet. Sie sind über die integrierte Fields -Sammlung nach Namen verfügbar.Predefined properties are properties common to multiple data sources that are mapped to specific field property names and can be accessed through the built-in Fields collection by name. Benutzerdefinierte Eigenschaften werden spezifisch für jeden Datenanbieter definiert. Auf diese Eigenschaften kann über die integrierte Fields -Sammlung nur mithilfe von Syntax zugegriffen werden, in der der erweiterte Eigenschaftsname als Zeichenfolge verwendet wird.Custom properties are specific to each data provider and can be accessed through the built-in Fields collection only through syntax using the extended property name as a string.

Wenn Sie die Abfrage mit dem Analysis ServicesAnalysis Services -MDX-Abfrage-Designer im grafischen Modus definieren, wird der MDX-Abfrage automatisch ein vordefinierter Satz von Zelleneigenschaften und Dimensionseigenschaften hinzugefügt.When you use the Analysis ServicesAnalysis Services MDX query designer in graphical mode to define your query, a predefined set of cell properties and dimension properties are automatically added to the MDX query. Sie können nur erweiterte Eigenschaften verwenden, die in der MDX-Abfrage im Bericht explizit aufgeführt werden.You can only use extended properties that are specifically listed in the MDX query in your report. Je nach Bericht möchten Sie möglicherweise den MDX-Standardbefehlstext so ändern, dass weitere im Cube definierte Dimensions- oder benutzerdefinierte Eigenschaften aufgenommen werden.Depending on your report, you may want to modify the default MDX command text to include other dimension or custom properties defined in the cube. Weitere Informationen über erweiterte Felder in Analysis ServicesAnalysis Services -Datenquellen finden Sie unter erstellen und Verwenden von Eigenschaftswerten ( MDX ) .For more information about extended fields available in Analysis ServicesAnalysis Services data sources, see Creating and Using Property Values (MDX).

Arbeiten mit Feldeigenschaften in einem BerichtWorking with Field Properties in a Report

Zu erweiterten Feldeigenschaften zählen vordefinierte Eigenschaften und datenanbieterspezifische Eigenschaften.Extended field properties include predefined properties and data provider-specific properties. Feldeigenschaften werden nicht in der Feldliste im Berichtsdatenbereich angezeigt, obwohl sie in der für ein Dataset erstellten Abfrage vorhanden sind. Deshalb können Sie keine Feldeigenschaften in Ihre Berichtsentwurfsoberfläche ziehen.Field properties do not appear with the field list in the Report Data pane, even though they are in the query built for a dataset; therefore, you cannot drag field properties onto your report design surface. Stattdessen ziehen Sie das Feld in den Bericht und ändern anschließend die Value -Eigenschaft des Felds in die gewünschte Eigenschaft.Instead, you must drag the field onto the report and then change the Value property of the field to the property that you want to use. Wenn z.B. die Zelldaten aus einem Cube bereits formatiert sind, können Sie die FormattedValue-Feldeigenschaft mithilfe des folgenden Ausdrucks verwenden: =Fields!FieldName.FormattedValue.For example, if the cell data from a cube has already been formatted, you can use the FormattedValue field property by using the following expression: =Fields!FieldName.FormattedValue.

Verwenden Sie die folgende Syntax in einem Ausdruck, um auf eine erweiterte Eigenschaft zu verweisen, die nicht vordefiniert ist:To refer to an extended property that is not predefined, use the following syntax in an expression:

  • Fields!FieldName("PropertyName")Fields!FieldName("PropertyName")

Vordefinierte FeldeigenschaftenPredefined Field Properties

Vordefinierte Feldeigenschaften werden in den meisten Fällen auf Measures, Ebenen oder Dimensionen angewendet.In most cases, predefined field properties apply to measures, levels, or dimensions. Für eine vordefinierte Feldeigenschaft muss ein entsprechender Wert in der Analysis ServicesAnalysis Services -Datenquelle gespeichert sein.A predefined field property must have a corresponding value stored in the Analysis ServicesAnalysis Services data source. Wenn kein Wert vorhanden ist, oder wenn Sie z. B. eine nur Measure-bezogene Feldeigenschaft auf einer Ebene angeben, gibt die Eigenschaft einen NULL-Wert zurück.If a value does not exist, or if you specify a measure-only field property on a level (for example), the property returns a null value.

Sie können jede der folgenden Syntaxangaben verwenden, um aus einem Ausdruck auf eine vordefinierte Eigenschaft zu verweisen:You can use either of the following syntaxes to refer to a predefined property from an expression:

  • Fields!FieldName.PropertyNameFields!FieldName.PropertyName

  • Fields!FieldName("PropertyName")Fields!FieldName("PropertyName")

    In der folgenden Tabelle wird eine Liste der zur Verfügung stehenden vordefinierten Feldeigenschaften bereitgestellt.The following table provides a list of predefined field properties that you can use.

EigenschaftProperty TypType Beschreibung oder erwarteter WertDescription or expected value
ValueValue ObjektObject Gibt den Datenwert des Felds an.Specifies the data value of the field.
IsMissingIsMissing BooleanBoolean Gibt an, ob das Feld im resultierenden Dataset gefunden wurde.Indicates whether the field was found in the resulting data set.
UniqueNameUniqueName StringString Gibt den vollqualifizierten Namen einer Ebene zurück.Returns the fully qualified name of a level. Der UniqueName-Wert für einen Mitarbeiter könnte z.B. wie folgt lauten: [Employee].[Employee Department].[Department].&[Sales].&[North American Sales Manager].&[272]For example, the UniqueName value for an employee might be [Employee].[Employee Department].[Department].&[Sales].&[North American Sales Manager].&[272].
BackgroundColorBackgroundColor StringString Gibt die Hintergrundfarbe zurück, die in der Datenbank für das Feld definiert ist.Returns the background color defined in the database for the field.
FarbeColor StringString Gibt die Vordergrundfarbe zurück, die in der Datenbank für das Element definiert ist.Returns the foreground color defined in the database for the item.
FontFamilyFontFamily StringString Gibt den Namen der Schriftart an, die in der Datenbank für das Element definiert ist.Returns the name of the font defined in the database for the item.
FontSizeFontSize StringString Gibt den Schriftgrad an, der in der Datenbank für das Element definiert ist.Returns the point size of the font defined in the database for the item.
SchriftbreiteFontWeight StringString Gibt die Schriftbreite an, die in der Datenbank für das Element definiert ist.Returns the weight of the font defined in the database for the item.
FontStyleFontStyle StringString Gibt den Schriftschnitt an, der in der Datenbank für das Element definiert ist.Returns the style of the font defined in the database for the item.
TextDecorationTextDecoration StringString Gibt spezielle Textformatierungen zurück, die in der Datenbank für das Element definiert sind.Returns special text formatting defined in the database for the item.
FormattedValueFormattedValue StringString Gibt einen formatierten Wert für ein Measure oder eine Kennzahl zurück.Returns a formatted value for a measure or key figure. Die FormattedValue -Eigenschaft für Verkaufsquote gibt beispielsweise ein Währungsformat wie 1.124.400,00 € zurück.For example, the FormattedValue property for Sales Amount Quota returns a currency format like $1,124,400.00.
KeyKey ObjektObject Gibt den Schlüssel für eine Ebene zurück.Returns the key for a level.
LevelNumberLevelNumber IntegerInteger Gibt bei Über-/Unterordnungshierarchien die Nummer der Ebene oder Dimension zurück.For parent-child hierarchies, returns the level or dimension number.
ParentUniqueNameParentUniqueName StringString Gibt bei Über-/Unterordnungshierarchien einen vollqualifizierten Namen der übergeordneten Ebene zurück.For parent-child hierarchies, returns a fully qualified name of the parent level.

Hinweis

Für diese erweiterten Feldeigenschaften sind nur Werte vorhanden, wenn diese Werte beim Ausführen des Berichts und Abrufen der Daten für die Datasets von der Datenquelle (z.B. dem Analysis ServicesAnalysis Services -Cube) bereitgestellt werden.Values exist for these extended field properties only if the data source (for example, the Analysis ServicesAnalysis Services cube) provides these values when your report runs and retrieves the data for its datasets. Sie können anschließend von einem beliebigen Ausdruck aus mithilfe der im folgenden Abschnitt erläuterten Syntax auf diese Feldeigenschaftswerte verweisen.You can then refer to those field property values from any expression using the syntax described in the following section. Da diese Felder nur für diesen Datenanbieter vorhanden sind, werden jedoch Änderungen, die Sie an diesen Werten vornehmen, nicht mit der Berichtsdefinition gespeichert.However, because these fields are specific to this data provider, changes that you make to these values are not saved with the report definition.

Beispiele für erweiterte EigenschaftenExample Extended Properties

Zur Veranschaulichung erweiterter Eigenschaften enthalten die folgende MDX-Abfrage und das Resultset mehrere Elementeigenschaften, die von einem für einen Cube definierten Dimensionsattribut verfügbar sind.To illustrate extended properties, the following MDX query and result set include several member properties available from a dimension attribute defined for a cube. Dabei handelt es sich um die Elementeigenschaften MEMBER_CAPTION, UNIQUENAME, Properties("Day Name"), MEMBER_VALUE, PARENT_UNIQUE_NAME und MEMBER_KEY.The member properties included are MEMBER_CAPTION, UNIQUENAME, Properties("Day Name"), MEMBER_VALUE, PARENT_UNIQUE_NAME, and MEMBER_KEY.

Diese MDX-Abfrage wird für den AdventureWorks2012AdventureWorks2012 -Cube in der AdventureWorks2012AdventureWorks2012 -DW-Datenbank ausgeführt, die mit den AdventureWorks2012AdventureWorks2012 -Beispieldatenbanken geliefert wurde.This MDX query runs against the AdventureWorks2012AdventureWorks2012 cube in the AdventureWorks2012AdventureWorks2012 DW database, included with the AdventureWorks2012AdventureWorks2012 sample databases.

WITH MEMBER [Measures].[DateCaption]   
      AS '[Date].[Date].CURRENTMEMBER.MEMBER_CAPTION'   
   MEMBER [Measures].[DateUniqueName]   
      AS '[Date].[Date].CURRENTMEMBER.UNIQUENAME'   
   MEMBER [Measures].[DateDayName]   
      AS '[Date].[Date].Properties("Day Name")'   
   MEMBER [Measures].[DateValueinOriginalDatatype]   
      AS '[Date].[Date].CURRENTMEMBER.MEMBER_VALUE'   
   MEMBER [Measures].[DateParentUniqueName]   
      AS '[Date].[Date].CURRENTMEMBER.PARENT_UNIQUE_NAME'   
   MEMBER [Measures].[DateMemberKeyinOriginalDatatype]   
      AS '[Date].[Date].CURRENTMEMBER.MEMBER_KEY'   
SELECT {  
   [Measures].[DateCaption],   
   [Measures].[DateUniqueName],   
   [Measures].[DateDayName],   
   [Measures].[DateValueinOriginalDatatype],  
   [Measures].[DateParentUniqueName],  
   [Measures].[DateMemberKeyinOriginalDatatype]  
   } ON COLUMNS , [Date].[Date].ALLMEMBERS ON ROWS   
FROM [Adventure Works]  

Wenn Sie diese Abfrage in einem MDX-Abfragebereich ausführen, erhalten Sie ein Resultset mit 1158 Zeilen.When you run this query in an MDX query pane, you get a result set with 1158 rows. Die ersten vier Zeilen sind in der nachfolgenden Tabelle angegeben.The first four rows are shown in the following table.

DateCaptionDateCaption DateUniqueNameDateUniqueName DateDayNameDateDayName DateValueinOriginalDatatypeDateValueinOriginalDatatype DateParentUniqueNameDateParentUniqueName DateMemberKeyinOriginalDatatypeDateMemberKeyinOriginalDatatype
All PeriodsAll Periods [Date].[Date].[All Periods][Date].[Date].[All Periods] (null)(null) (null)(null) (null)(null) 00
1-Jul-011-Jul-01 [Date].[Date].&[1][Date].[Date].&[1] SonntagSunday 7/1/20017/1/2001 [Date].[Date].[All Periods][Date].[Date].[All Periods] 11
2-Jul-012-Jul-01 [Date].[Date].&[2][Date].[Date].&[2] MontagMonday 7/2/20017/2/2001 [Date].[Date].[All Periods][Date].[Date].[All Periods] 22
3-Jul-013-Jul-01 [Date].[Date].&[3][Date].[Date].&[3] DienstagTuesday 7/3/20017/3/2001 [Date].[Date].[All Periods][Date].[Date].[All Periods] 33

Im grafischen Modus des MDX-Abfrage-Designers erstellte MDX-Standardabfragen enthalten nur die Dimensionseigenschaften MEMBER_CAPTION und UNIQUENAME.Default MDX queries built using the MDX Query Designer in graphical mode only include MEMBER_CAPTION and UNIQUENAME for dimension properties. In der Standardeinstellung sind diese Werte stets vom Datentyp String.By default, these values always are data type String.

Wenn Sie eine Elementeigenschaft im ursprünglichen Datentyp benötigen, können Sie die zusätzliche Eigenschaft MEMBER_VALUE einbeziehen, indem Sie die MDX-Standardanweisung im textbasierten Abfrage-Designer ändern.If you need a member property in its original data type, you can include an additional property MEMBER_VALUE by modifying the default MDX statement in the text-based query designer. In der folgenden einfachen MDX-Anweisung wurde MEMBER_VALUE der Liste der abzurufenden Dimensionseigenschaften hinzugefügt.In the following simple MDX statement, MEMBER_VALUE has been added to the list of dimension properties to retrieve.

SELECT NON EMPTY {[Measures].[Order Count]} ON COLUMNS,   
NON EMPTY { ([Date].[Month of Year].[Month of Year] ) }   
DIMENSION PROPERTIES   
   MEMBER_CAPTION, MEMBER_UNIQUE_NAME, MEMBER_VALUE ON ROWS   
FROM [Adventure Works]  
CELL PROPERTIES   
   VALUE, BACK_COLOR, FORE_COLOR,   
   FORMATTED_VALUE, FORMAT_STRING,   
   FONT_NAME, FONT_SIZE, FONT_FLAGS  

Die folgende Tabelle enthält die ersten vier Zeilen des Ergebnisses im MDX-Ergebnisbereich.The first four rows of the result in the MDX Results pane appear in the following table.

MonatMonth of Year Anzahl BestellungenOrder Count
JanuaryJanuary 2,4812,481
FebruarFebruary 2,6842,684
MarchMarch 2,7492,749
AprilApril 2,7392,739

Obwohl die Eigenschaften Teil der MDX-Select-Anweisung sind, werden sie nicht in den Spalten des Resultsets angezeigt.Even though the properties are part of the MDX select statement, they do not appear in the result set columns. Die Daten sind jedoch für einen Bericht verfügbar und können mit der Funktion für erweiterte Eigenschaften angezeigt werden.Nevertheless, the data is available for a report by using the extended properties feature. Doppelklicken Sie in einem MDX-Abfrageergebnisbereich in SQL ServerSQL Server Management StudioManagement Studioauf die Zelle, um die Zelleigenschaftswerte anzuzeigen (sofern diese Werte im Cube festgelegt sind).In an MDX query result pane in SQL ServerSQL Server Management StudioManagement Studio, you can double-click on the cell and see the cell property values if they are set in the cube. Wenn Sie auf die erste Zelle "Anzahl Bestellungen" mit dem Wert 1.379 klicken, wird ein Popupfenster mit den folgenden Zelleigenschaften angezeigt:If you double-click on the first Order Count cell that contains 1,379, you will see a pop-up window with the following cell properties:

EigenschaftProperty ValueValue
CellOrdinalCellOrdinal 00
ValueVALUE 24812481
BACK_COLORBACK_COLOR (null)(null)
FORE_COLORFORE_COLOR (null)(null)
FORMATTED_VALUEFORMATTED_VALUE 2,4812,481
FORMAT_STRINGFORMAT_STRING #,##,#
FONT_NAMEFONT_NAME (null)(null)
FONT_SIZEFONT_SIZE (null)(null)
FONT_FLAGSFONT_FLAGS (null)(null)

Wenn Sie mit dieser Abfrage ein Berichtsdataset erstellen und dieses an eine Tabelle binden, können Sie die VALUE-Standardeigenschaft für ein Feld anzeigen, z. B. =Fields!Month_of_Year!Value.If you create a report dataset with this query and bind the dataset to a table, you can see the default VALUE property for a field, for example, =Fields!Month_of_Year!Value. Wenn Sie diesen Ausdruck als Sortierausdruck für die Tabelle festgelegt haben, wird die Tabelle im Ergebnis alphabetisch nach Monat sortiert, da das Value-Feld den Datentyp String annimmt.If you set this expression as the sort expression for the table, your results will be to sort the table alphabetically by month because the Value field uses a String data type. Wenn die Tabelle in der Reihenfolge der Monate im Jahr sortiert werden soll, d. h. Januar zuerst und Dezember zuletzt, verwenden Sie den folgenden Ausdruck:To sort the table in so that the months are in the order they occur in the year with January first and December last, use the following expression:

=Fields!Month_of_Year("MEMBER_VALUE")  

Mit diesem Ausdruck werden die Werte im Feld entsprechend ihres ursprünglichen Datentyps in der Datenquelle sortiert.This sorts the value of the field in its original integer data type from the data source.

Siehe auchSee Also

Ausdrücke (Berichts-Generator und SSRS) Expressions (Report Builder and SSRS)
Integrierte Auflistungen in Ausdrücken ( Berichts-Generator und SSRS ) Built-in Collections in Expressions (Report Builder and SSRS)
Datasetfeldauflistung ( Berichts-Generator und SSRS )Dataset Fields Collection (Report Builder and SSRS)