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

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