Artykuł
07/22/2011

Rozszerzone właściwości pola dla Analysis Services bazy danych (SSRS)

The SQL Server Usługi Analysis Services data processing extension supports extended field properties.Właściwości rozszerzone są dodatkowo do właściwości pole Value i IsMissing , które są dostępne na danych źródło i obsługiwany przez rozszerzenie przetwarzania danych.Właściwości rozszerzone nie są wyświetlane w okienku Dane raportu jako część kolekcji pól zestawu danych raportu.W raporcie mogą zawierać wartości właściwość rozszerzone pole, pisząc wyrażenia, które je określić wg nazwy przy użyciu wbudowane Fields kolekcja.

Właściwości rozszerzone obejmują wstępnie zdefiniowane właściwości i właściwości niestandardowe.właściwość wspólne dla wielu źródeł danych, które są mapowane do nazwy właściwość określonego pole i mogą być udostępniane za pośrednictwem wbudowane są wstępnie zdefiniowane właściwość Fields kolekcja według nazwy.właściwość niestandardowe są specyficzne dla każdego dostawca danych i mogą być udostępniane za pośrednictwem wbudowane Fields kolekcja tylko przy użyciu składni nazwy właściwość rozszerzone jako ciąg.

Podczas korzystania z Usługi Analysis Services projektant zapytań MDX w trybie graficznym, aby zdefiniować kwerendę, wstępnie zdefiniowany zestaw właściwości wymiar i właściwości komórka są automatycznie dodawane do kwerendy MDX.W raporcie można używać wyłącznie rozszerzonych właściwości jednoznacznie wymienionych w zapytaniu MDX.W razie potrzeby można zmodyfikować domyślny tekst polecenia MDX w celu uwzględnienia innych wymiarów czy niestandardowych właściwości zdefiniowanych w module.Aby uzyskać więcej informacji na temat rozszerzonych pól dostępnych w Usługi Analysis Services źródeł danych, zobacz Tworzenie i używanie wartości właściwości (MDX).

Praca z właściwościami pól w raporcie

Rozszerzone właściwości pól obejmują właściwości wstępnie zdefiniowane oraz właściwości specyficzne dla dostawcy danych.Nie są wyświetlane właściwości pole z listy pole na Danych raportu okienka, nawet jeżeli są one w kwerendzie zbudowane dla zestawu danych; dlatego nie można przeciągać właściwości pole na powierzchnię projektu swojego raportu.Zamiast tego należy przeciągnij pole na raport, a następnie zmień Value właściwość pola właściwość, który ma być używany.Na przykład jeśli komórka danych z moduł został sformatowany, można użyć FormattedValue właściwość pole przy użyciu następującego wyrażenie: =Fields!FieldName.FormattedValue.

Aby utworzyć odwołanie do rozszerzonej właściwości, która nie jest wstępnie zdefiniowana, należy w wyrażeniu użyć następującej składni:

Fields!FieldName("PropertyName")

Wstępnie zdefiniowane właściwości pól

Najczęściej wstępnie zdefiniowane właściwości pól dotyczą miar, poziomów lub wymiarów.właściwość wstępnie zdefiniowane pole muszą mieć odpowiadające im wartości przechowywanej w Usługi Analysis Services źródło danych.Jeśli taka wartość nie istnieje lub jeśli na poziomie (na przykład) zostanie określona właściwość pola dotycząca wyłącznie miary, dla właściwości będzie zwracana wartość null.

Aby utworzyć odwołanie do wstępnie zdefiniowanej właściwości z poziomu wyrażenia, można użyć dowolnej z poniższych składni:

Fields!FieldName.PropertyName
Fields!FieldName("PropertyName")

W poniższej tabeli przedstawiono listę wstępnie zdefiniowanych właściwości pól, których można używać.

Właściwość	Typ	Opis lub oczekiwana wartość
Value	Object	Określa wartość danych pola.
IsMissing	Boolean	Wskazuje, czy pole zostało odnalezione w wynikowym zestawie danych.
UniqueName	String	Zwraca w pełni kwalifikowaną nazwę poziomu.Na przykład UniqueName wartości dla pracownika może być [Employee].[Employee Department].[Department].&[Sales].&[North American Sales Manager].&[272].
BackgroundColor	String	Zwraca kolor tła zdefiniowany w bazie danych dla danego pola.
Color	String	Zwraca kolor pierwszego planu zdefiniowany w bazie danych dla danego elementu.
FontFamily	String	Zwraca nazwę czcionki zdefiniowanej w bazie danych dla danego elementu.
FontSize	String	Zwraca rozmiar (w punktach) czcionki zdefiniowanej w bazie danych dla danego elementu.
FontWeight	String	Zwraca grubość czcionki zdefiniowanej w bazie danych dla danego elementu.
FontStyle	String	Zwraca styl czcionki zdefiniowanej w bazie danych dla danego elementu.
TextDecoration	String	Zwraca specjalne formatowanie tekstu zdefiniowane w bazie danych dla danego elementu.
FormattedValue	String	Zwraca sformatowaną wartość miary lub kluczowej wartości.Na przykład FormattedValue dla właściwość Przydziału kwoty sprzedaży zwraca format waluty, na przykład 1,124,400.00 $.
Key	Object	Zwraca klucz poziomu.
LevelNumber	Integer	W przypadku hierarchii elementów nadrzędnych i podrzędnych zwraca numer poziomu lub wymiaru.
ParentUniqueName	String	W przypadku hierarchii elementów nadrzędnych i podrzędnych zwraca w pełni kwalifikowaną nazwę poziomu nadrzędnego.

Ostrzeżenie

Istnieją wartości, jeśli tylko te właściwości rozszerzone pole źródło danych (na przykład Usługi Analysis Services moduł) zapewnia te wartości, gdy raport pobiera dane dla obiektów DataSet.Do wartości właściwości pól można odwoływać się w dowolnych wyrażeniach, używając składni opisanej w poniższej sekcji.Jednak te pola są specyficzne dla tego dostawcy danych, więc zmiany wprowadzane w tych wartościach nie są zapisywane w definicji raportu.

Przykład rozszerzonych właściwości

W celu zilustrowania koncepcji rozszerzonych właściwości poniżej zamieszczono przykładowe zapytanie MDX wraz z zestawem wyników. Zawierają one kilka właściwości elementów członkowskich, jakie są dostępne w atrybucie wymiaru zdefiniowanym dla modułuSą to następujące właściwości: MEMBER_CAPTION, UNIQUENAME, Properties("Nazwa dnia"), MEMBER_VALUE, PARENT_UNIQUE_NAME i MEMBER_KEY.

Ta kwerenda MDX jest uruchamiany przed AdventureWorks2008R2 moduł w AdventureWorks2008R2 DW bazy danych, z AdventureWorks2008R2 przykładowej bazy danych.

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]

Wykonanie zapytania z poziomu okienka zapytań MDX powoduje wyświetlenie zestawu wyników zawierającego 1158 wierszy.Pierwsze cztery wiersze pokazano w tabeli poniżej.

DateCaption	DateUniqueName	DateDayName	DateValueinOriginalDatatype	DateParentUniqueName	DateMemberKeyinOriginalDatatype
Wszystkie okresy	[Data].[Data].[Wszystkie okresy]	(null)	(null)	(null)	0
1‑lip‑01	[Data].[Data].&[1]	Niedziela	7/1/2001	[Data].[Data].[Wszystkie okresy]	1
2‑lip‑01	[Data].[Data].&[2]	Poniedziałek	7/2/2001	[Data].[Data].[Wszystkie okresy]	2
3‑lip‑01	[Data].[Data].&[3]	Wtorek	7/3/2001	[Data].[Data].[Wszystkie okresy]	3

Domyślne zapytania MDX utworzone za pomocą projektanta zapytań MDX w trybie graficznym zawierają tylko dwie właściwości wymiarów — MEMBER_CAPTION i UNIQUENAME.Wartości te zawsze są domyślnie typu danych String.

Jeśli właściwość elementu członkowskiego musi używać swojego oryginalnego typu danych, można odpowiednio zmodyfikować domyślną instrukcję MDX w tekstowym projektancie zapytań i dodać jeszcze jedną właściwość MEMBER_VALUE.W zamieszczonej poniżej przykładowej prostej instrukcji MDX do listy właściwości wymiarów, których wartości mają być pobierane, dodano właściwość MEMBER_VALUE.

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

W tabeli poniżej pokazano cztery pierwsze wiersze wyświetlane w okienku wyników zapytania MDX.

Miesiąc roku	Liczba zamówień
Styczeń	2,481
Luty	2,684
Marzec	2,749
Kwiecień	2,739

Mimo że właściwości stanowią część instrukcji SELECT wyrażenia MDX, nie są wyświetlane w kolumnach zestawu wyników.Funkcja właściwości rozszerzonych umożliwia jednak użycie tych danych w raporcie.In an MDX query result pane in SQL Server Management Studio, you can double-click on the cell and see the cell property values if they are set in the cube.Gdy zostanie kliknięcia pierwsza komórka w kolumnie Liczba zamówień zawierająca wartość 1379, pojawi się wyskakujące okienko z następującymi właściwościami komórki:

Właściwość	Wartość
CellOrdinal	0
VALUE	2481
BACK_COLOR	(null)
FORE_COLOR	(null)
FORMATTED_VALUE	2,481
FORMAT_STRING	#,#
FONT_NAME	(null)
FONT_SIZE	(null)
FONT_FLAGS	(null)

Jeśli tworzenie zestawu danych raportu z tej kwerendy i powiązanie zestawu danych do tabela, można wyświetlić właściwość wartość domyślna pole, na przykład =Fields!Month_of_Year!Value.Jeśli użytkownik zestaw to wyrażenie jako wyrażenie sortowania dla tabela wyników będzie Sortuj tabela alfabetycznie według miesiąca, ponieważ używa wartości pole String typu danych.Aby zawartość tabeli była sortowana z zachowaniem kolejności następowania po sobie miesięcy, należy użyć następującego wyrażenia: