Używanie parametrów w celu sterowania danymi raportu (program Report Builder 2.0)
Parametry raportu można używać na dwa sposoby: Filtrowanie danych w źródle danych albo do filtrowania danych w raporcie. Filtrowanie danych w źródle danych może zwiększyć wydajność przetwarzania i wyświetlania raportu.Jeśli nie można filtrować danych w źródle, można użyć parametrów w celu filtrowania danych raportu w raporcie.Za pomocą parametrów można także sortować i organizować dane w raporcie.
Aby uzyskać ogólne informacje o filtrowaniu danych zobacz Filtrowanie danych w raporcie (program Report Builder 2.0).
Tematu tego można użyć, aby dowiedzieć się więcej na temat filtrowania danych przy użyciu parametrów.
Filtrowanie danych w źródle danych
Aby filtrować dane w źródle danych, należy użyć parametrów zapytania w zapytaniu zestawu danych.W niektórych projektantach zapytań można dodać pola do okienka Filtr i wybrać opcję parametru dla każdego pola, które ma być parametrem raportu.W innych projektantach zapytań parametry zapytania można dodać do polecenia zapytania.Tekst polecenia jest analizowany podczas zapisywania zapytania.Dla każdego parametru zapytania jest tworzony odpowiadający mu parametr raportu.Używając węzła Parametry w okienku Dane raportu, można wyświetlić listę parametrów raportu.
Po uruchomieniu raportu użytkownik wybierze wartości dla każdego parametru raportu i te wartości zostaną przekazane do zapytania.Gdy zapytaniw zostanie uruchomione w źródle danych, tylko wartości określone przez użytkownika zostaną pobrane do raportu.Można również określić monit stanowiący etykietę parametru raportu na pasku narzędzi raportu.
Parametry zapytania
Parametry raportu są tworzone automatycznie podczas definiowania parametrów zapytania.
When you define a dataset, you specify a particular type of data source, for example, Microsoft SQL Server.Podczas definiowania zapytania dla każdego zestawu danych skojarzony projektant zapytań identyfikuje zmienne w tekście polecenia zapytania i tworzy parametr zapytania dla każdej z nich.Zapytania ze zmiennymi nie są obsługiwane w każdej kombinacji źródła danych i dostawcy danych.Aby uzyskać więcej informacji na temat składni kwerendy oczekiwanego przez urządzenie źródłowe danych zobacz Używanie parametrów zapytania z określonymi źródłami danych (program Report Builder 2.0).
Aby SQL Server urządzenie źródłowe danych kwerendy zazwyczaj obejmują zmienne w klauzula WHERE Transact-SQL Instrukcja ograniczenie zakres danych zwracanych po uruchomieniu kwerendy. Projektant zapytań relacyjnych automatycznie tworzy zapytaniw i oferuje opcję utworzenia zmiennej zapytania dla każdego ustawianego filtru.Aby uzyskać więcej informacji zobaczInterfejs użytkownika projektanta zapytań relacyjnych (program Report Builder 2,0).
W podobny sposób Analysis Services kwerendy urządzenie źródłowe danych zawiera zwykle MDX zmienne użyte w klauzula filtru. Zapytania mogą także zawierać zmienne przekazane jako dane wejściowe do procedur przechowywanych lub funkcji zdefiniowanych przez użytkownika.
Po każdej modyfikacji zapytania zestawu danych jest ona ponownie przetwarzana.Jeśli zmiana zapytania będzie polegać na usunięciu zmiennej lub zmianie jej nazwy, ta zmiana zostanie odzwierciedlona w parametrach zapytania.
Można utworzyć zestawu danych dodatkowych parametrów na Parametry stronaWłaściwości zestawów danych -okno dialogowe.Parametry tworzone przez użytkownika nie są zmieniane, gdy jest zmieniane zapytanie.
Jako wartość domyślna każdego parametru zapytania jest ustawiane wyrażenie, którego wynikiem jest odpowiedni parametr raportu.Aby zmienić ustawienie domyślne, należy użyć Parametry stronaWłaściwości zestawów danych -okno dialogowe.Na przykład w przypadku SQL Server urządzenie źródłowe danych, jeśli parametr kwerendy @MyParameter, jest parametr raportu MyParameter i wartości dla @MyParameter jest zestaw do wyrażenie [@MyParameter]. Aby uzyskać więcej informacji zobaczOkno dialogowe Właściwości zestawu danych, Parametry (program Report Builder 2,0).Można ręcznie edytować parametry zapytania i ustawiać ich wartości domyślne.Aby uzyskać więcej informacji zobaczJak Kojarzenie parametr kwerendy z parametrem raportu (Report Builder 2.0).
Parametry raportu, które są tworzone automatycznie za pomocą następujących ustawień domyślnych:
Pojedyncza wartość
Typ danych Text
Monit ustawiony na nazwę parametru
Brak wartości domyślnych
Brak dostępnych wartości
W zależności od typu danych reprezentowanych przez parametr zapytania może być konieczna zmiana tych właściwości.Aby uzyskać więcej informacji zobaczTworzenie parametrów raportu i ustawianie właściwości parametrów raportu (program Report Builder 2.0).
Uwaga
Podczas usuwania parametru zapytania lub zmieniania jego nazwy odpowiadający mu parametr raportu nie jest automatycznie usuwany lub zmieniany.Jeśli po usunięciu parametru zapytania odpowiadający mu parametr raportu nie będzie już potrzebny, należy usunąć go ręcznie.Zmiana nazwy parametru zapytania spowoduje, że przy zapisywaniu zapytania zostanie utworzony nowy parametr raportu odpowiadający zmienionej nazwie.Nazwę parametru raportu można zmienić, aby była zgodna z nową nazwą parametru zapytania i można też zaktualizować właściwości parametru zestawu danych w celu połączenia parametru zapytania z parametrem raportu.
W wersji 1.0 Konstruktora raportów parametry raportu są tworzone automatycznie, gdy ustawienie monitu na klauzulę filtru.
Parametry zależne lub kaskadowe
W przypadku tworzenia zapytania, w którym jest używanych wiele parametrów zapytania, można utworzyć zestaw parametrów kaskadowych.Parametry kaskadowe umożliwiają filtrowanie bardzo dużej liczby wartości parametrów w celu uzyskania rozsądnej liczby wartości.Na przykład zapytanie zawiera parametry @Kategoria, @Podkategoria i @Produkt, gdzie lista podkategorii jest zależna od parametru @Kategoria, a lista produktów jest zależna od parametru @Podkategoria.Gdy użytkownik wybierze wartość dla parametru raportu Kategoria, wartości parametru Podkategoria zostaną ograniczone to prawidłowych wartości dla wybranej kategorii.Gdy użytkownik wybierze wartość dla parametru Podkategoria, wartości dostępne dla parametru Produkt będą już przefiltrowane na podstawie wartości wybranej kategorii i podkategorii.Używając tej techniki, można zmniejszyć liczbę prawidłowych wartości parametru do rozsądnej liczby wartości.
Aby zaprojektować parametry kaskadowe, należy włączyć do raportu następujące elementy:
Główne zapytanie zestawu danych, które zawiera wiele pokrewnych parametrów zapytania.
Uporządkowana lista parametrów raportu, z których każdy jest powiązany z parametrem zapytania.Zazwyczaj są one tworzone automatycznie na podstawie zapytania głównego.Każdy parametr zależny musi znajdować się po parametrze, od którego jest zależny.Kolejność parametrów można zmienić w okienku Dane raportu, w którym parametry można przenosić w górę i w dół kolekcji.Aby uzyskać więcej informacji zobaczJak Zmiana kolejności parametru raportu (Report Builder 2.0).
Osobny zestaw danych dla każdego parametru raportu dostarczającego dostępne wartości.Ważne jest, aby używać takiej samej pisowni (z uwzględnieniem wielkości liter) dla każdego parametru zapytania, ponieważ umożliwi to poprawne połączenie parametrów zapytania i parametrów raportu.Zapytanie dotyczące każdego zestawu dostępnych wartości dla każdego parametru raportu musi dostarczać tylko wartości, które są sensowne w kontekście zapytania głównego.
W tym przykładzie parametr raportu Produkt jest zależny od parametru Podkategoria, który jest zależny od parametru Kategoria.Parametr Kategoria musi być pierwszy, a po nim muszą znajdować się parametry Podkategoria i Produkt.Zapytanie zestawu danych dostarczające dostępne wartości dla parametru Kategoria musi pokazywać wszystkie kategorie prawidłowe dla zapytania głównego.Zapytanie dostarczające dostępne wartości dla parametru Podkategoria po wybraniu kategorii powinno dostarczać wartości prawidłowe dla danej wartości parametru Kategoria, z uwzględnieniem wszystkich ograniczeń występujących w zapytaniu głównym.
Aby uzyskać więcej informacji zobaczJak Dodawanie kaskadowy parametry do raportu (Report Builder 2.0).
Filtrowanie danych raportu po uruchomieniu zapytania
Można także utworzyć parametry raportu i użyć ich w wyrażeniach filtru w celu filtrowania danych w zestawie danych raportu, obszarze danych lub grupie elementu tablix.Aby uzyskać więcej informacji zobacz Filtrowanie danych w raporcie (program Report Builder 2.0) i Jak Dodaj filtr (Konstruktora raportów 2.0).
Parametry raportu są częścią definicji raportu podczas jego tworzenia, ale po opublikowaniu raportu można nimi zarządzać niezależnie.Po opublikowaniu definicji raportu można zmodyfikować właściwości parametrów, korzystając z programu Report Manager.Aby uzyskać więcej informacji, zobacz "Ustawianie właściwości na a opublikowane Report" w Dokumentację usług raportowania w dokumentacji programu SQL Server Books Online.
Praca z szybko zmieniającymi się prawidłowymi wartościami parametru
W przypadku określenia dostępnych wartości, które się szybko zmieniają, wartości mogą stać się nieaktualne przed uruchomieniem raportu.Może to spowodować, że użytkownik wybierze z listy wartość, która nie będzie już prawidłowa po przesłaniu wartości i uruchomieniu raportu.Aby uniknąć takich sytuacji, należy napisać zapytania zwracające zestawy danych dla list prawidłowych wartości, które nie będą zmieniać się w czasie, jakiego typowy użytkownik potrzebuje na wybranie wartości i uruchomienie raportu.
Należy także unikać szybko zmieniających się wartości, które nie są wynikiem działania zapytania.Na przykład, jeśli zostanie wprowadzony bieżącej data jako wartości dostępne napisać wyrażenie używające DateTime.Today Właściwość zamiast DateTime.Now Właściwość. Spowoduje to wyeliminowanie szybko zmieniającej się części godziny w wartości.W celu obliczenia wartości i zachowania jej jako stałej w czasie przetwarzania raportu można również użyć zmiennej raportu lub zmiennej grupy.Aby uzyskać więcej informacji zobaczUżywanie w wyrażeniach odwołań do kolekcji zmiennych raportu i zmiennych grupy (program Report Builder 2,0).
See Also