Udostępnij za pośrednictwem

  • Artykuł

Using Extended Field Properties for an Analysis Services Dataset

The SQL Server Analysis Services data processing extension supports extended field properties.Właściwości rozszerzone są właściwości jako dodatek do właściwości pole Value i IsMissing które są dostępne w źródle danych i obsługiwanych 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.Może zawierać wartości właściwość rozszerzonych pole w raporcie za pomocą odpowiedniego wyrażenia, które je określić według nazw 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ści niestandardowe zdefiniowane są specyficzne dla każdego dostawca danych i mogą być udostępniane za pośrednictwem wbudowane Fields Kolekcja tylko przy użyciu składni przy użyciu nazwy właściwość rozszerzona jako ciąg znaków.

Po użyciu Analysis Services projektant kwerend MDX w trybie graficznym zdefiniować kwerendę, wstępnie zdefiniowany zestaw właściwości wymiaru 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 rozszerzonego pola dostępne w Analysis Services źródła danych, zobacz Tworzenie i używanie wartości właściwość (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 unikatowe dla dostawcy danych.Właściwości pole nie są wyświetlane z listy pole na Data raportu Okienko nawet jeśli w kwerendzie, przeznaczony dla danych; z tego powodu, można przeciągnąć właściwości pole na Twój obszar projektu raportu. Zamiast tego, należy przeciągnąć pole na raport i zmień Value Właściwość pola, które ma być właściwość, która ma być używany. Na przykład, jeśli dane komórka z moduł już 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 Analysis Services urządzenie źródłowe 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 może być wartością dla pracownika [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 Właściwość Przydział kwota sprzedaży zwraca format waluty, takich jak 1,124,400.00 zł.

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.

Wstępnie zdefiniowane właściwości pól są wyświetlane w oknie funkcji IntelliSense w edytorze wyrażeń podczas wprowadzania składni pola.Aby uzyskać więcej informacji zobacz Using Built-in Collections in Expressions (Reporting Services).

Uwaga

Do tych rozszerzonego pole właściwości tylko wówczas, gdy istnieją wartości urządzenie źródłowe danych (na przykład Analysis Services Moduł) zapewnia te wartości, gdy raport jest uruchamiany i pobiera dane dla jego zestawów danych. 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 uruchamiana przed AdventureWorks kostki wielowymiarowej w AdventureWorks Baza danych DW, dołączone do AdventureWorks Przykładowe 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

01.07.01

[Data]. [Data]. &[1]

Niedziela

7/1/2001

[Data].[Data].[Wszystkie okresy]

1

02.07.01

[Data]. [Data]. &[2]

Poniedziałek

7/2/2001

[Data].[Data].[Wszystkie okresy]

2

03.07.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.Domyślnie wartości te są zawsze 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 iż właściwości stanową element 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)

Po utworzeniu danych raportu z tej kwerendy i powiązać zestaw danych do tabela, można wyświetlić domyślne właściwość VALUE dla pole, na przykład =Fields!Month_of_Year!Value. Jeśli użytkownik zestaw tego wyrażenia jako wyrażenie sortowania dla tabela wyniki będzie sortowanie tabela alfabetycznie według miesięcy, ponieważ korzysta z pole wartości String Typ 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:

=Fields!Month_of_Year("MEMBER_VALUE")

Wyrażenie spowoduje posortowanie zawartości pola zgodnie z pierwotnym typem danych „liczba całkowita” ustawionym w źródle danych.