Przykłady wyrażeń (program Report Builder 3.0 i usługi SSRS)

Za pomocą funkcji języka Visual Basic można wykonywać operacje na danych wyświetlanych w polach tekstowych lub używanych w parametrach, właściwościach lub innych obszarach raportu.W tej sekcji zamieszczono przykłady pokazujące niektóre z tych funkcji.Aby uzyskać więcej informacji, zobacz Elementy członkowskie biblioteki wykonawczej języka Visual Basic w witrynie MSDN.

Program .NET Framework oferuje wiele niestandardowych opcji formatu, na przykład dla określonych formatów dat.Aby uzyskać więcej informacji, zobacz temat Typy formatowania w witrynie MSDN.

Funkcje matematyczne

Funkcje daty

Funkcje ciągów

Funkcja Lookup

Funkcja LookupSet

Funkcje konwersji

Funkcje decyzji

Do wyrażenia można dodać odwołanie do dodatkowych funkcji raportu, za pomocą których można wykonywać operacje na danych znajdujących się w raporcie.W tej sekcji zamieszczono przykłady dotyczące dwóch z tych funkcji.Aby uzyskać więcej informacji dotyczących funkcji raportu i zapoznać się z przykładami, zobacz Kompendium funkcji agregujących (program Report Builder 3.0 i usługi SSRS).

Podczas projektowania raportu można dojść do wniosku, że warto wyświetlić w stopce raportu nazwę raportu i numer strony.W tym celu można użyć następujących wyrażeń:

• Poniższe wyrażenie dostarcza nazwę raportu oraz godzinę jego uruchomienia.Można je umieścić w polu tekstowym w stopce lub treści raportu.Godzina jest formatowana za pomocą ciągu formatowania programu .NET Framework do formatu daty krótkiej:

  =Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")
  

• Poniższe wyrażenie, umieszczone w polu tekstowym w stopce raportu, dostarcza numer strony oraz łączną liczbę stron w raporcie:

  =Globals.PageNumber & " of " & Globals.TotalPages
  

W poniższych przykładach opisano sposób wyświetlania w nagłówku strony pierwszej i ostatniej wartości ze strony, co przypomina sposób wyświetlania listy katalogów.W przykładzie przyjęto założenie, że obszar danych zawiera pole tekstowe o nazwie LastName.

• Poniższe wyrażenie, umieszczone w polu tekstowym po lewej stronie nagłówka strony, dostarcza pierwszą wartość pola tekstowego LastName na stronie:

  =First(ReportItems("LastName").Value)
  

• Poniższe wyrażenie, umieszczone w polu tekstowym po prawej stronie nagłówka strony, dostarcza ostatnią wartość pola tekstowego LastName na stronie:

  =Last(ReportItems("LastName").Value)
  

W poniższym przykładzie opisano sposób wyświetlania łącznej liczby stron.W przykładzie przyjęto założenie, że obszar danych zawiera pole tekstowe o nazwie Cost.

• Poniższe wyrażenie, umieszczone w nagłówku lub stopce strony, dostarcza sumę wartości w polu tekstowym Cost dla strony:

  =Sum(ReportItems("Cost").Value)
  

W niektórych raportach może być konieczne umieszczenie podziału strony po określonej liczbie wierszy zamiast (lub oprócz) w grupach lub elementach raportu.W tym celu należy utworzyć grupę zawierającą odpowiednie grupy lub rekordy szczegółowe, dodać podział strony do grupy, a następnie dodać wyrażenie grupy służące do grupowania według określonej liczby wierszy.

• Umieszczenie w wyrażeniu grupy poniższego wyrażenia spowoduje, że będzie ono przypisywać numer każdemu zestawowi 25 wierszy.Gdy zostanie zdefiniowany podział strony dla grupy, użycie tego wyrażenia spowoduje wstawianie podziału strony co 25 wierszy.

  =Ceiling(RowNumber(Nothing)/25)
  

  Aby umożliwić użytkownikowi ustawienie wartości odpowiadającej liczbie wierszy na stronie, należy utworzyć parametr o nazwie RowsPerPage i utworzyć wyrażenie grupy oparte na tym parametrze, tak jak pokazano w poniższym wyrażeniu:

  =Ceiling(RowNumber(Nothing)/Parameters!RowsPerPage.Value)
  

  Aby uzyskać więcej informacji dotyczących ustawiania podziałów strony dla grupy, zobacz Jak Dodawanie podziału strony (Konstruktora raportów 3.0 i SSRS).

• Użycie poniższego wyrażenia we właściwości Color pola tekstowego spowoduje, że kolor tekstu będzie się zmieniał w zależności od wartości pola Profit:

  =Iif(Fields!Profit.Value < 0, "Red", "Black")
  

  Można także użyć zmiennej obiektu języka Visual Basic Me.Ta zmienna stanowi inny sposób odwoływania się do wartości pola tekstowego.

  =Iif(Me.Value < 0, "Red", "Black")

• Użycie poniższego wyrażenia we właściwości BackgroundColor elementu raportu w obszarze danych spowoduje, że wiersze będą mieć na przemian tło w kolorze bladozielonym i białym:

  =Iif(RowNumber(Nothing) Mod 2, "PaleGreen", "White")
  

  Jeśli wyrażenie ma być używane dla określonego zakresu, może być konieczne wskazanie zestawu danych dla funkcji agregującej:

  =Iif(RowNumber("Employees") Mod 2, "PaleGreen", "White")
  

Aby określić kolory wykresu kształtowego, można użyć kodu niestandardowego w celu sterowania kolejnością mapowania kolorów na wartości punktów danych.Dzięki temu będzie można używać spójnych kolorów na wielu wykresach zawierających takie same grupy kategorii.Aby uzyskać więcej informacji, zobacz temat Jak Określić spójne kolory w wielu wykresów kształtu (Konstruktora raportów 3.0 i SSRS).

Elementy w raporcie można pokazywać i ukrywać, używając właściwości widoczności elementu raportu.W obszarze danych, takim jak tabela, można początkowo ukryć wiersze szczegółów na podstawie wartości wyrażenia.

• Użycie poniższego wyrażenia w celu określenia początkowej widoczności wierszy szczegółów w grupie spowoduje pokazanie wierszy szczegółów dotyczących wszystkich sprzedaży, dla których wartość w polu PctQuota będzie większa niż 90 procent:

  =Iif(Fields!PctQuota.Value>.9, False, True)
  

• Ustawienie poniższego wyrażenia we właściwości Hidden tabeli spowoduje, że tabela będzie widoczna tylko wtedy, gdy będzie zawierać ponad 12 wierszy:

  =IIF(CountRows()>12,true,false)
  

• Ustawienie poniższego wyrażenia we właściwości Ukryte kolumny spowoduje, że kolumna będzie widoczna tylko wtedy, gdy po pobraniu danych ze źródła danych w zestawie danych raportu będzie znajdować się pole:

  =IIF(Fields!Column_1.IsMissing, true, false)
  

Używając danych raportu, można dostosowywać adresy URL. Można również warunkowo określać, czy adresy URL będą dodawane jako akcja pola tekstowego.

• Użycie poniższego wyrażenia jako akcji w polu tekstowym spowoduje wygenerowanie dostosowanego adresu URL, w którym pole zestawu danych EmployeeID będzie parametrem adresu URL.

  ="http://adventure-works/MyInfo?ID=" & Fields!EmployeeID.Value
  

  Aby uzyskać więcej informacji, zobacz temat Jak Dodaj hiperłącze do adresu URL (Konstruktora raportów 3.0 i SSRS).

• Poniższe wyrażenie warunkowo określa, czy adres URL ma zostać dodany do pola tekstowego.To wyrażenie jest zależne od parametru o nazwie IncludeURLs, który umożliwia użytkownikowi określenie, czy do raportu mają być włączane aktywne adresy URL.To wyrażenie jest ustawione jako akcja w polu tekstowym.Ustawienie dla tego parametru wartości False i wyświetlenie raportu umożliwia wyeksportowanie raportu do programu Microsoft Excel bez hiperłączy.

  =IIF(Parameters!IncludeURLs.Value,"http://adventure-works.com/productcatalog",Nothing)
  

Używając wyrażeń w parametrze, można zmienić jego wartość domyślną.Na przykład za pomocą parametru można filtrować dane dla określonego użytkownika na podstawie identyfikatora użytkownika, którego użyto w celu uruchomienia raportu.

• Gdy poniższe wyrażenie będzie używane jako wartość domyślna parametru, będzie ono gromadzić identyfikatory użytkowników uruchamiających raport:

  =User!UserID
  

• Aby odwoływać się do parametru w parametrze zapytania, wyrażeniu filtru, polu tekstowym lub innym obszarze raportu, należy użyć kolekcji globalnej Parameters.W tym przykładzie przyjęto założenie, że parametr ma nazwę Department:

  =Parameters!Department.Value
  

• W raporcie można tworzyć parametry i ustawiać je jako ukryte.Gdy raport zostanie uruchomiony na serwerze raportów, parametr nie będzie widoczny na pasku narzędzi, a osoba czytająca raport nie będzie mogła zmienić jego wartości domyślnej.Parametru ukrytego, dla którego ustawiono wartość domyślną, można używać jako stałej niestandardowej.Tej wartości można użyć w dowolnym wyrażeniu, w tym w wyrażeniu pola.Poniższe wyrażenie identyfikuje pole określone przez wartość domyślną parametru o nazwie ParameterField:

  =Fields(Parameters!ParameterField.Value).Value
  

Można zainicjować wartość zmiennej grupy, która jest lokalna dla określonego zakresu grupy, a następnie używać w wyrażeniach odwołań do tej zmiennej.Jednym ze sposobów użycia zmiennej grupy w kodzie niestandardowym jest implementacja agregacji niestandardowej.Aby uzyskać więcej informacji, zobacz temat Używanie zmiennych grupy w usługach Reporting Services 2008 w celu utworzenia agregacji niestandardowej.

Aby uzyskać więcej informacji dotyczącej zmiennych, zobacz temat Używanie odwołań do kolekcji zmiennych raportu i zmiennych grupy (program Report Builder i usługi SSRS).

W poniższym przykładzie pokazano wywołanie osadzonej metody o nazwie FixSpelling, która zamienia wszystkie wystąpienia wyrazu „Bike” w polu SubCategory.Value na wyraz „Bicycle”.

=Code.FixSpelling(Fields!SubCategory.Value)

Osadzenie poniższego kodu w definicji raportu umożliwia pokazanie implementacji metody FixSpelling.W tym przykładzie pokazano sposób odwoływania się do klasy System.Text.StringBuilder programu .NET Framework.Aby uzyskać więcej informacji, zobacz temat Jak Dodawanie kodu do raportu (SSRS).

Public Function FixSpelling(ByVal s As String) As String
   Dim strBuilder As New System.Text.StringBuilder(s)
   If s.Contains("Bike") Then
      strBuilder.Replace("Bike", "Bicycle")
      Return strBuilder.ToString()
      Else : Return s
   End If
End Function

W czasie przetwarzania raportu wynikiem obliczania niektórych wyrażeń może być wartość null lub wartość niezdefiniowana.Może to powodować błędy w czasie wykonywania, z powodu których w polu tekstowym będzie wyświetlany ciąg #Błąd zamiast wyniku wyrażenia.Na to zachowanie szczególnie wrażliwa jest funkcja IIF, ponieważ w przeciwieństwie do instrukcje If-Then-Else każda część instrukcji IIF jest obliczana (obejmuje to również wywołania funkcji) przed przejściem do procedury sprawdzającej, czy wynikiem jest wartość true czy false.Instrukcja =IIF(Fields!Sales.Value is NOTHING, 0, Fields!Sales.Value) wygeneruje wartość #Błąd w renderowanym raporcie, jeśli wartość Fields!Sales.Value będzie równa NOTHING.

Aby uniknąć tego stanu, należy zastosować jedną z następujących strategii:

• Jeśli wartość pola B będzie równa 0 lub będzie niezdefiniowana, należy ustawić licznik na 0, a mianownik na 1; w przeciwnym razie należy ustawić licznik na wartość pola A, a mianownik na wartość pola B.

  =IIF(Field!B.Value=0, 0, Field!A.Value / IIF(Field!B.Value =0, 1, Field!B.Value))
  

• Należy użyć funkcji kodu niestandardowego, aby zwrócić wartość wyrażenia.W poniższym przykładzie jest zwracana procentowa różnica między wartością bieżącą a wartością poprzednią.Za pomocą tego kodu można obliczać różnicę między dwiema kolejnym wartościami. Obsługuje on przypadek graniczny pierwszego porównania (gdy nie ma wartości poprzedniej) oraz przypadki, w których poprzednia lub bieżąca wartość jest równa null (Nothing w języku Visual Basic).

  Public Function GetDeltaPercentage(ByVal PreviousValue, ByVal CurrentValue) As Object
      If IsNothing(PreviousValue) OR IsNothing(CurrentValue) Then
          Return Nothing
      Else if PreviousValue = 0 OR CurrentValue = 0 Then
          Return Nothing
      Else 
          Return (CurrentValue - PreviousValue) / CurrentValue
      End If
  End Function
  

  Poniższy przykład pokazuje sposób wywoływania tego kodu niestandardowego z poziomu pola tekstowego:

  =Code.GetDeltaPercentage(Previous(Sum(Fields!Sales.Value),"ColumnGroupByYear"), Sum(Fields!Sales.Value))
  

  Pomaga to uniknąć wyjątków w czasie wykonywania.Teraz można używać wyrażeń, takich jak =IIF(Me.Value < 0, "red", "black"), we właściwości Color pola tekstowego w celu wyświetlania tekstu w zależności od tego, czy wartości są większe, czy mniejsze od zera.