Odwołania do kolekcji pól zestawu danych w raporcie stronicowanym (Report Builder)

Dotyczy: Microsoft Report Builder (SSRS) Power BI Report Builder Projektant raportów w narzędziu SQL Server Data Tools

Każdy zestaw danych w raporcie podzielonym na strony zawiera jedną kolekcję Pola . Kolekcja Pola to zestaw pól określonych przez zapytanie zestawu danych oraz inne utworzone pola obliczeniowe. Po utworzeniu zestawu danych kolekcja pól zostanie wyświetlona w okienku Dane raportu.

Proste odwołanie do pola w wyrażeniu jest wyświetlane na powierzchni projektowej jako proste wyrażenie. Na przykład po przeciągnięciu pola Sales z okienka Dane raportu do komórki tabeli na powierzchni [Sales] projektowej jest wyświetlana. Ta wartość reprezentuje wyrażenie =Fields!Sales.Value bazowe ustawione we właściwości Value pola tekstowego. Po uruchomieniu raportu procesor raportów oblicza to wyrażenie i wyświetla rzeczywiste dane ze źródła danych w polu tekstowym w komórce tabeli. Aby uzyskać więcej informacji, zobacz Expressions (Report Builder) i Dataset Fields collection (Report Builder).

Wyświetlanie kolekcji pól dla zestawu danych

Aby wyświetlić poszczególne wartości kolekcji pól, przeciągnij każde pole do wiersza szczegółów tabeli i uruchom raport. Odwołania z wiersza szczegółów tabeli lub regionu danych listy zawierają wartość dla każdego wiersza w zestawie danych.

Aby wyświetlić podsumowane wartości pola, przeciągnij każde pole liczbowe do obszaru danych macierzy. Domyślną funkcją agregacji dla wiersza sumy jest suma, na przykład =Sum(Fields!Sales.Value). Możesz zmienić funkcję domyślną, aby obliczyć różne sumy. Więcej informacji znajdziesz w Odwołanie do funkcji agregujących (Report Builder).

Aby wyświetlić podsumowane wartości kolekcji pól w polu tekstowym bezpośrednio na powierzchni projektowej, która nie jest częścią regionu danych, należy określić nazwę zestawu danych jako zakres funkcji agregującej. Na przykład w przypadku zestawu danych o nazwie SalesDatanastępujące wyrażenie określa sumę wszystkich wartości dla pola Sales: =Sum(Fields!Sales,"SalesData").

Gdy używasz okna dialogowego Wyrażenie do zdefiniowania odwołania do pola, możesz wybrać kolekcję Pola w okienku Kategoria i wyświetlić listę dostępnych pól w okienku Pola . Każde pole ma kilka właściwości, w tym Wartość i IsMissing. Pozostałe właściwości są wstępnie zdefiniowanymi właściwościami pól rozszerzonych, które mogą być dostępne dla zestawu danych w zależności od typu źródła danych.

Wykrywanie wartości null dla pola zestawu danych

Aby wykryć wartość pola o wartości null (Nic w Visual Basic), możesz użyć funkcji IsNothing. Po umieszczeniu w polu tekstowym w wierszu szczegółów tabeli następujące wyrażenie sprawdza pole MiddleName i zastępuje tekst "Brak drugiego imienia", gdy wartość jest null, a wartość pola, gdy nie jest null.

=IIF(IsNothing(Fields!MiddleName.Value),"No Middle Name",Fields!MiddleName.Value)

Wykrywanie brakujących pól dla zapytań dynamicznych w czasie wykonywania

Domyślnie elementy w kolekcji Pola mają dwie właściwości: Wartość i IsMissing. Właściwość IsMissing wskazuje, czy pole zdefiniowane dla zestawu danych w czasie projektowania znajduje się w polach pobranych w czasie wykonywania. Na przykład zapytanie może wywołać procedurę składowaną, w której zestaw wyników różni się w zależności od parametru wejściowego lub zapytanie może mieć SELECT * FROM <table> miejsce, w którym zmieniono definicję tabeli.

Właściwość IsMissing można przetestować w kodzie niestandardowym, aby określić, czy pole znajduje się w zestawie wyników. Nie można przetestować jej obecności przy użyciu wyrażenia z wywołaniem funkcji Języka Visual Basic, takim jak IIF lub SWITCH, ponieważ język Visual Basic ocenia wszystkie parametry w wywołaniu funkcji, co powoduje błąd podczas oceniania odwołania do brakującego elementu.

Przykład kontrolowania widoczności kolumny dynamicznej dla brakującego pola

Aby ustawić wyrażenie kontrolujące widoczność kolumny wyświetlającej pole w zestawie danych, należy najpierw zdefiniować niestandardową funkcję kodu. Ta funkcja powinna zwrócić wartość logiczną. Wartość jest oparta na tym, czy brakuje pola. Na przykład następująca niestandardowa funkcja kodu zwraca wartość true, jeśli brakuje pola i wartość false, jeśli pole istnieje.

Public Function IsFieldMissing(field as Field) as Boolean  
 If (field.IsMissing) Then  
 Return True  
  Else   
  Return False  
 End If  
End Function  

Aby użyć tej funkcji do kontrolowania widoczności kolumny, ustaw właściwość Hidden kolumny na następujące wyrażenie:

=Code.IsFieldMissing(Fields!FieldName)

Kolumna jest ukryta, gdy pole nie istnieje.

Przykład kontrolowania wartości pola tekstowego dla brakującego pola

Aby zastąpić tekst zamiast wartości brakującego pola, musisz napisać kod niestandardowy. Ten kod powinien zwrócić tekst, którego można użyć jako zamiany, gdy brakuje pola. Na przykład następująca niestandardowa funkcja kodu zwraca wartość pola, jeśli pole istnieje. Ponadto kod zwraca komunikat określony jako drugi parametr, jeśli pole nie istnieje:

Public Function IsFieldMissingThenString(field as Field, strMessage as String) as String  
 If (field.IsMissing) Then  
  Return strMessage  
 Else   
  Return field.Value  
  End If  
End Function  

Aby użyć tej funkcji w polu tekstowym, dodaj następujące wyrażenie do właściwości Value:

=Code.IsFieldMissingThenString(Fields!FieldName,"Missing")

W polu tekstowym zostanie wyświetlona wartość pola lub określony tekst.

Używanie właściwości pola rozszerzonego

Rozszerzone właściwości pola to inne właściwości zdefiniowane w polu przez rozszerzenie przetwarzania danych. Typ źródła danych jest określony dla zestawu danych. Właściwości pola rozszerzonego są wstępnie zdefiniowane lub specyficzne dla typu źródła danych. Aby uzyskać więcej informacji, zobacz Rozszerzone właściwości pól dla bazy danych usług analiz (SSRS).

Jeśli określisz właściwość, która nie jest obsługiwana dla tego pola, wyrażenie zwróci wartość null (Nic w Visual Basic). Jeśli dostawca danych nie obsługuje właściwości pola rozszerzonego lub jeśli pole nie zostanie znalezione podczas wykonywania zapytania, wartość właściwości właściwości ma wartość null (Nic w Visual Basic) dla właściwości typu Ciąg i obiekt oraz zero (0) właściwości typu Liczba całkowita. Rozszerzenie przetwarzania danych może korzystać ze wstępnie zdefiniowanych właściwości, optymalizując zapytania, które obejmują tę składnię.

Treści powiązane

• Przykłady wyrażeń (Report Builder)
• Zestawy danych raportów