Parametry (program Report Builder 3.0 i usługi SSRS)

Parametry raportu umożliwiają użytkownikowi kontrolować dane raportu, łączyć raporty pokrewne i zmieniać prezentację raportu.Aby zaprojektować raport, w którym parametry będą efektywnie wykorzystywane, trzeba wiedzieć, jak są ze sobą powiązane parametry i zapytania zestawu danych, jak uwzględniać parametry w wyrażeniach i jak zarządzać parametrami niezależnie od definicji raportu na serwerze raportów lub w witrynie programu SharePoint.

Parametry raportu można utworzyć następującymi sposobami:

• Utwórz lub Dodaj obiekt dataset osadzone lub udostępniony, zawierający kwerendę, która zawiera zmienne kwerendy.

• Ręcznie utwórz parametr w okienku Dane raportu.

• Dodaj składnik Report Part zawierający odwołania do parametru lub do udostępnionego zestawu danych, który zawiera zmienne.

Po opublikowaniu raportu parametrami można zarządzać niezależnie od definicji raportu.Do jednego raportu można nawet utworzyć wiele zestawów parametrów.Aby uzyskać więcej informacji, zobacz Ustawienie właściwości parametru dla opublikowanego raportu i Dodawanie, modyfikowanie i usuwanie połączonych raportów.

Wszystkie parametry są wyświetlane na pasku narzędzi podglądu raportów, więc użytkownik może w sposób interakcyjny określać wartości.Na poniższej ilustracji pokazano obszar parametrów raportu zawierający parametry @StartDate, @EndDate, @Subcategory i @ShowAllRows.

1. Parametry okienkanarzędzi viewer raport wyświetla monit i domyślne wartości wszystkich parametrów.Układ parametrów na tym pasku narzędzi jest formatowany automatycznie.Ich kolejność jest ustalana na podstawie kolejności, w jakiej parametry są wyświetlane w okienku Dane raportu.

2. Parametry @ data_rozpoczęcia i @ EndDateparametr @ data_rozpoczęcia typem danych jest DateTime.Obok pola tekstowego jest wyświetlany monit Start Date (data początkowa).Aby zmodyfikować datę, należy wpisać nową datę w polu tekstowym lub użyć formantu kalendarza.

   Parametr @ EndDate obok data_rozpoczęcia @.

3. Parametr @ podkategoriityp danych jest parametr @ podkategorii Text.Parametr @Subcategory ma listę dostępnych wartości, więc jego prawidłowe wartości są wyświetlane na liście rozwijanej.Należy wybrać wartości z tej listy.Ponieważ @ podkategorii wielowartościowych, Zaznacz wszystko pojawia się opcja, który pozwala wyczyścić wszystkie i zaznacz wszystkie wartości na liście.

4. Parametr @ ShowAllRowstyp danych jest parametr @ ShowAllRows Boolean.Użyj przycisków radiowych do określenia True lub False.

5. Uchwyt pokazywania lub ukrywania obszaru parametrów   Na pasku narzędzi podglądu raportów należy kliknąć tę strzałkę, aby pokazać lub ukryć okienko parametrów.

6. Przycisk Parametry   W podglądzie programu Report Builder, na Wstążce należy kliknąć przycisk Parametry, aby pokazać lub ukryć okienko parametrów.

7. Przycisk Widok raportuna pasku narzędzi Podgląd raportu kliknij Wyświetl raport do uruchomienia raportu po wprowadzeniu wartości parametrów.Jeśli wszystkie parametry mają zdefiniowane wartości domyślne, raport jest uruchamiany automatycznie przy jego pierwszym wyświetleniu.

Aby uzyskać więcej informacji na temat od razu przy użyciu parametrów, zobacz Samouczek: Dodanie parametru do raportu (Konstruktora raportów 3.0), Samouczek: Dodanie parametrów do raportu (SSRS), lub Próbek raportu (3.0 Konstruktora raportów i SSRS)

Ostrzeżenie

Parametry można publikować w formie niezależnych składników Report Part dla obszarów danych mających zależne zestawy danych i parametry.Mimo że parametry są przedstawiane jako składniki Report Part, parametru składnika Report Part nie można bezpośrednio dodać do raportu.Zamiast tego po dodaniu składnika report part wszystkie niezbędne parametry raportu zostaną automatycznie utworzone na podstawie zapytań zestawu danych, które są zawarte w składniku Report Part lub są przez niego używane.Aby uzyskać informacje dotyczące części raportu, zobacz Składniki Report Part (program Report Builder 3.0) i Raport części Projektant raportów (SSRS).

Ostrzeżenie

Program Business Intelligence Development Studio umożliwia tworzenie i modyfikowanie definicji raportów (rdl) przy użyciu programów Report Builder 3.0 i Report Designer. Każde ze środowisk obsługuje różne sposoby tworzenia, otwierania i zapisywania raportów oraz powiązanych z nimi elementów. Aby uzyskać więcej informacji, zobacz temat Projektowanie raportów w programach Report Designer i Report Builder 3.0 (usługi SSRS) w witrynie sieci Web microsoft.com.

W tym dokumencie

Typowe zastosowania parametrów

Typy parametrów

Praca z parametrami raportu

Praca z parametrami zestawu danych

Parametry kaskadowe

Przekazywanie parametrów do raportów szczegółowych i podraportów

Zarządzanie parametrami na serwerze raportów lub w witrynie programu SharePoint

W tej sekcji

Tematy pokrewne

Typowe zastosowania parametrów

Poniżej przedstawiono najbardziej typowe sposoby używania parametrów:

• Umożliwienie użytkownikom określania wartości w celu dostosowania danych w raporcie.Na przykład określenie dwóch parametrów dla daty początkowej i daty końcowej w przypadku danych o sprzedaży.

• Umożliwienie użytkownikom określania wartości pomagających dostosować wygląd raportu.Na przykład określenie parametru logicznego wskazującego, czy wszystkie zagnieżdżone grupy wierszy w tabeli mają być rozwinięte, czy zwinięte.

• Utworzenie rozwijanej listy wartości do wyboru, aby użytkownik mógł wybrać tylko prawidłową wartość.

• Utworzenie wartości domyślnej dla każdego parametru, aby raport był uruchamiany automatycznie przy jego pierwszym wyświetleniu.

• Utworzenie wartości kaskadowych, aby lista rozwijana dla jednego parametru była zestawem wartości, które są prawidłowe na podstawie wyboru dokonanego dla poprzedniego parametru.Pozwala to na kolejne filtrowanie wartości parametrów, aby spośród tysięcy wartości uzyskać ich rozsądną liczbę.

• Dostosowanie zestawów parametrów do potrzeb wielu użytkowników.Na przykład utworzenie na serwerze raportów dwóch połączonych raportów opartych na raporcie sprzedaży.W jednym połączonym raporcie są używane wstępnie zdefiniowane wartości parametrów dla sprzedawców, a w drugim — wstępnie zdefiniowane wartości parametrów dla menedżerów sprzedaży.W przypadku obu raportów jest używana ta sama definicja raportów.

• Umożliwienie użytkownikom filtrowania danych z zestawu danych.Po dodaniu do raportu udostępnionego zestawu danych nie można zmienić zapytania.W raporcie można dodać filtr zestawu danych uwzględniający odwołanie do utworzonego parametru raportu.

Powrót do początku

Typy parametrów

Raporty obejmują dwa typy parametrów: Parametry DataSet i parametry raportu.

• Parametr DataSetparametr dataset osadzony dataset lub udostępnionych zestawu danych jest tworzone automatycznie dla każdej zmiennej kwerendy w poleceniu query dataset.Niektórzy projektanci zapytań mają obszar, w którym można dodawać filtry stosowane na podstawie nazw pól, oraz opcję dodania parametru zestawu danych na podstawie nazwy pola.

  Parametry zestawu danych konfiguruje się po zdefiniowaniu zapytania zestawu danych.Dla każdego parametru zestawu danych można niezależnie określić wartości domyślne.W przypadku dodania udostępnionego zestawu danych do raportu parametry zestawu danych, które są oznaczone jako wewnętrzne, nie mogą zostać zastąpione w raporcie.Można zastąpić parametry zestawu danych, które nie są oznaczone jako wewnętrzne.Można również utworzyć dodatkowe parametry.Aby uzyskać więcej informacji, zobacz pracy z parametrami Dataset w tym temacie.

• Parametr raportparametr raport jest tworzony automatycznie dla każdego parametru dataset.Parametry raportu można również tworzyć ręcznie.Parametry raportu można skonfigurować w taki sposób, aby użytkownik mógł interakcyjnie wprowadzać wartości pomagające w dostosowaniu zawartości lub wyglądu raportu.Można je również skonfigurować w taki sposób, aby użytkownik nie mógł zmienić wstępnie skonfigurowanych wartości.Parametrami raportu zarządza się niezależnie od raportu opublikowanego na serwerze raportów.Aby uzyskać więcej informacji, zobacz pracy z parametrów raportu w tym temacie.

  Parametr raportu można również zapisać niezależnie od raportu w formie składnika Report Part.Składniki Report Part są przechowywane na serwerze raportów i inni użytkownicy mogą używać ich w swoich raportach.Składnikami Report Part, które są parametrami, nie można zarządzać z serwera raportów.Parametry można wyszukać w galerii składników Report Part, a po ich dodaniu można je skonfigurować w raporcie.Aby uzyskać więcej informacji, zobacz Składniki Report Part (program Report Builder 3.0).

Większość z czas, będziesz pracować z parametrów raportu.

Powrót do początku

Praca z parametrami raportu

Najpowszechniejszym zastosowaniem parametrów jest różnicowanie danych raportu pobieranych przez zapytania zestawu danych.W tym scenariuszu po uruchomieniu raportu użytkownicy są monitowani o podanie jednej lub kilku wartości, a zapytanie zestawu danych pobiera tylko żądane dane.Zapytanie zestawu danych zawiera parametry zapytania, a procesor raportów automatycznie tworzy parametry raportu, które są pośrednio połączone z parametrami zapytania.

Domyślnie w przypadku parametrów tworzonych automatycznie są używane automatycznie wygenerowane nazwy, monity i typy danych.Właściwości parametru raportu można zmienić z poziomu okienka Dane raportu za pomocą okna dialogowego Właściwości raportu.W poniższej tabeli podsumowano właściwości, które można ustawić dla każdego parametru.

Właściwość	Opis
Nazwa	W tym polu należy wpisać nazwę parametru, w której jest rozróżniana wielkość liter.Nazwa musi rozpoczynać się od litery, może zawierać litery, liczby oraz znaki podkreślenia (_) i nie może zawierać spacji.W przypadku parametrów generowanych automatycznie nazwa odpowiada parametrowi zapytania w zapytaniu zestawu danych.Domyślnie nazwy parametrów tworzonych ręcznie są podobne do nazwy ParametrRaportu1.
Monit	Tekst wyświetlany obok parametru na pasku narzędzi viewer.
Typ danych	Parametr raport musi być jednym z następujących typów danych: Text, Integer, Float, DateTime, Boolean. Typ danych parametru raportu określa sposób jego wyświetlania na pasku narzędzi podglądu raportów.Typ danych może być również istotny przy pisaniu wyrażeń zawierających odwołanie do parametru.
Zezwalaj na wartość pustą	Tę opcję należy wybrać, jeśli wartość parametru może być ciągiem pustym lub wartością pustą. W przypadku określania prawidłowych wartości dla parametru, jeśli jedną z nich ma być wartość pusta, trzeba ją uwzględnić jako jedną z określanych prawidłowych wartości.Wybranie tej opcji nie powoduje automatycznego uwzględnienia wartości pustej jako jednej z dostępnych wartości.
Zezwalaj na wartość null	Tę opcję należy wybrać, jeśli wartość parametru może być równa null. W przypadku określania prawidłowych wartości dla parametru, jeśli jedną z nich ma być wartość null, trzeba ją uwzględnić jako jedną z określanych prawidłowych wartości.Wybranie tej opcji nie powoduje automatycznego uwzględnienia wartości null jako jednej z dostępnych wartości.
Zezwalaj na wiele wartości	Należy podać dostępne wartości w celu utworzenia listy rozwijanej, z której użytkownicy mogą wybierać wartości.Jest to dobry sposób zapewnienia, że w zapytaniu zestawu danych będą przekazywane tylko prawidłowe wartości. Tę opcję należy wybrać, jeśli wartością parametru może być wiele wartości wyświetlanych na liście rozwijanej.Wartości null są niedozwolone.Po wybraniu tej opcji do listy dostępnych wartości wyświetlanych na liście rozwijanej parametru zostaną dodane pola wyboru.U góry listy zawiera pole wyboru dla Zaznacz wszystko.Użytkownicy mogą zaznaczyć wybrane przez siebie wartości. Jeśli dane dostarczające wartości szybko się zmieniają, lista widoczna dla użytkownika może nie być listą najbardziej aktualną.
Widoczny	Wybranie tej opcji spowoduje, że po uruchomieniu raportu parametr raportu będzie wyświetlany u góry raportu.Ta opcja umożliwia użytkownikom wybieranie wartości parametru w czasie wykonywania.
Ukryte	Wybranie tej opcji spowoduje, że parametr raportu będzie ukryty.Wartości parametru raportu można ustawić w adresie URL raportu, w definicji subskrypcji lub na serwerze raportów za pomocą programu Report Manager.
Wewnętrzny	Wybranie tej opcji spowoduje, że parametr raportu będzie ukryty.Ten parametr raportu będzie można wyświetlić tylko w definicji raportu.
Dostępne wartości	W przypadku określenia dostępnych wartości dla parametru prawidłowe wartości są zawsze wyświetlane jako lista rozwijana.Na przykład, jeśli dostępne wartości dla DateTime parametr, drop -niedziałający zostanie wyświetlona lista dat w okienku parametr zamiast formantu kalendarza. Aby zapewnić spójny między raportem i podraportów listę wartości, zestaw opcję na danych źródło używać pojedynczej transakcji dla wszystkich kwerend w zestawach danych, które są skojarzone z danych źródło. Uwaga dotycząca zabezpieczeń W dowolnym raporcie, który zawiera parametr typu danych Text, należy użyć listy dostępnych wartości (znany także jako lista prawidłowych wartości) i upewnij się, że każdy użytkownik uruchamiania raportu ma tylko uprawnienia niezbędne do wyświetlania danych w raporcie.Aby uzyskać więcej informacji, zobacz Zabezpieczenia (program Report Builder 3.0).
Wartości domyślne	Ustawić wartości domyślne z kwerendy lub listy statycznej. Jeśli parametr ma zdefiniowaną wartość domyślną, raport jest uruchamiany automatycznie przy jego pierwszym wyświetleniu.
Zaawansowane	Ustaw wartość wskazująca, czy ten parametr ma wpływ bezpośrednio lub pośrednio na dane w raporcie. serwer raportów ta wartość jest używana, aby określić opcje pamięci podręcznej dla raportów i danych raportu. Aby uzyskać więcej informacji, zobacz Okno dialogowe Właściwości parametru raportu, Zaawansowane (program Report Builder 3.0).

Powrót do początku

Praca z parametrami zestawu danych

Parametry zapytania są definiowane podczas konstruowania zapytania w projektancie zapytań.Niektóre rozszerzenia danych oferują sposób wybierania pól, które mają być uwzględnione jako parametry.Inne natomiast określają zmienne zapytania w poleceniu zapytania.Parametr zapytania jest tworzony automatycznie dla każdej zmiennej zapytania.

Nie wszystkie źródła danych obsługują parametry zapytania.W sytuacji, gdy nie można filtrować danych w źródle, można użyć parametrów raportu, aby umożliwić użytkownikom filtrowanie danych już pobranych do raportu.Mimo że wszystkie parametry zapytania mają odpowiadające im parametry raportu, parametry raportu można definiować niezależnie.Parametrów raportu można także używać w celu zmiany wyglądu lub organizacji raportu po pobraniu danych.

Aby filtrować dane w kwerendzie zestawu danych, można dołączyć ograniczenie klauzula , która ogranicza pobrane dane przez określenie wartości, aby dołączyć lub wykluczyć z zestaw wyników.

Za pomocą projektanta kwerend związanych z danymi źródło pomocny w tworzeniu kwerend parametrycznych.

• Dla Transact-SQL kwerend różnych źródeł danych obsługują składnię różnych parametrów.Obsługa różni się w zależności od tego, czy parametry są identyfikowane w zapytaniu według pozycji czy według nazwy.Aby uzyskać więcej informacji, zobacz Tematy dla typów źródło danych zewnętrznych w Dodawanie danych do raportu (program Report Builder 3.0 i usługi SSRS).Aby w projektancie zapytań relacyjnych utworzyć zapytanie parametryczne, należy wybrać opcję parametru dla filtru.Aby uzyskać więcej informacji, zobacz Projektant kwerend relacyjnych (Konstruktora raportów 3.0).

• W przypadku zapytań opartych na wielowymiarowym źródle danych, takim jak Microsoft SQL Server Analysis Services, SAP NetWeaver BI lub Hyperion Essbase, można określić, czy ma zostać utworzony parametr oparty na filtrze określonym w projektancie zapytań.Aby uzyskać więcej informacji, zobacz temat projektant zapytań w Projektanci zapytań (program Report Builder 3.0) , który odpowiada rozszerzenie danych.

Powrót do początku

Parametry kaskadowe

Można utworzyć parametry kaskadowe, w przypadku których użytkownik wybiera wartość dla każdego parametru w określonej kolejności, a każdy wybór sukcesywnie ogranicza wartości dla następnego parametru.Parametry kaskadowe umożliwiają zmniejszenie do rozsądnej wartości potencjalnie ogromnej liczby opcji do wyboru.Na przykład użytkownik wybiera kategorię produktów, następnie wybiera wartość z listy dostępnych produktów w tej kategorii, następnie wybiera rozmiar, a następnie kolor.

Aby uzyskać więcej informacji, zobacz Jak Dodawanie parametrów kaskadowych do raportu (Konstruktora raportów 3.0 i SSRS).

Powrót do początku

Przekazywanie parametrów do raportów szczegółowych i podraportów

Parametry służą do łączenia raportów z podraportami i raportami szczegółowymi.Te parametry raportu mogą być ukryte, mogą używać wartości z raportu głównego w celu wybierania poprawnych danych dla połączonego raportu lub mogą być widoczne dla użytkownika w czasie wykonywania.

Aby uzyskać więcej informacji, zobacz Używanie parametrów w celu tworzenia połączeń z innymi raportami (program Report Builder 3.0 i usługi SSRS).

Zarządzanie parametrami na serwerze raportów lub w witrynie programu SharePoint

Po opublikowaniu raportu parametrami można zarządzać niezależnie od definicji raportu.W zależności od określonej w czasie projektowania konfiguracji parametru w raporcie administratorzy serwera raportów mogą zmodyfikować wiele właściwości parametru raportu lub udostępnionego zestawu danych.Przy projektowaniu raportu, dla którego ma zostać utworzony plan buforowania lub subskrypcji, mogą występować dodatkowe wymagania dotyczące parametrów.For more information, see the following topics in the Reporting Services documentation in SQL Server Books Online.

• **Buforowane raportów.   **Aby utworzyć plan pamięci podręcznej dla raportu, każdy parametr musi mieć wartość domyślną.Aby uzyskać więcej informacji, zobacz Buforowanie raportów (SSRS).

• **W pamięci podręcznej zestawów danych udostępnionych.   **Do tworzenia planu pamięci podręcznej dla udostępnianego zestawu danych każdego parametru musi mieć wartość domyślną.Aby uzyskać więcej informacji, zobacz Buforowanie raportów (SSRS).

• **Połączone raportów.**Można tworzyć raporty połączone z wartościami parametrów gotowych do filtrowania danych dla różnych odbiorców.Aby uzyskać więcej informacji, zobacz Dodawanie, modyfikowanie i usuwanie połączonych raportów.

• **Raport subskrypcje.**Można określić wartości parametru do filtrowania danych i dostarczenie raportów za pośrednictwem subskrypcji.Aby uzyskać więcej informacji, zobacz Ustawianie parametrów w subskrypcji i Subskrypcja i dostawy (Reporting Services).

• **Adres URL dostępu.**Można określić wartości parametru URL do raportu.Można także uruchamiać raporty i określać wartości parametrów, korzystając z dostępu za pomocą adresu URL.Aby uzyskać więcej informacji, zobacz Adres URL dostępu.

Powrót do początku

Tematy dotyczące sposobów wykonywania określonych zadań

W tej sekcji zamieszczono listę procedur pokazujących krok po kroku sposób pracy z parametrami i filtrami.

• Jak Dodać, zmienić lub usunąć parametr raportu (Konstruktora raportów 3.0 i SSRS)

• Jak Dodawanie, zmienianie lub usuwanie dostępnych wartości dla parametru raportu (Konstruktora raportów 3.0 i SSRS)

• Jak Dodawanie, zmienianie lub usuwanie domyślne wartości dla parametru raportu (Konstruktora raportów 3.0 i SSRS)

• Jak Zmiana kolejności parametrów raportu (Konstruktora raportów 3.0 i SSRS)

• Jak Dodawanie parametrów kaskadowych do raportu (Konstruktora raportów 3.0 i SSRS)

• Jak Dodaj filtr DataSet (Konstruktora raportów 3.0 i SSRS)

Powrót do początku

W tej sekcji

Używanie parametrów jednowartościowych i wielowartościowych (program Report Builder 3.0 i usługi SSRS)

Używanie parametrów w celu tworzenia połączeń z innymi raportami (program Report Builder 3.0 i usługi SSRS)

Powrót do początku

Sekcje pokrewne

Używanie odwołań do kolekcji Parameters (program Report Builder 3.0 i usługi SSRS)

Używanie wyrażeń (program Report Builder 3.0 i usługi SSRS)

Wyrażenia (program Report Builder 3.0 i usługi SSRS)

Okno dialogowe Właściwości parametru raportu, Ogólne (program Report Builder 3.0)

Okno dialogowe Właściwości parametru raportu, Ogólne

Okno dialogowe Właściwości zestawu danych, Zapytanie (program Report Builder 3.0)

Okno dialogowe Właściwości zestawu danych, Zapytanie

Projektanci zapytań (program Report Builder 3.0)

Projektanci kwerendy usług raportowania

Zabezpieczenia (program Report Builder 3.0)

Powrót do początku

Zobacz także

Koncepcje

Sortowanie interakcyjne, plany dokumentu i łącza (program Report Builder 3.0 i usługi SSRS)

Przeglądanie szczegółowe, rozwijanie szczegółów, podraporty i zagnieżdżone obszary danych (program Report Builder 3.0 i usługi SSRS)