Udostępnij za pośrednictwem


Creating Report Parameters and Setting Report Parameter Properties

Parametry raportu są definiowane globalnie dla raportu.Parametry raportu są tworzone automatycznie, jeśli zapytanie raportu zawiera parametry, ale można też utworzyć je ręcznie.Po utworzeniu parametru raportu należy ustawić identyfikujące go właściwości oraz właściwości określające sposób, w jaki można używać go w raporcie.

Aby pracować z parametrami przed opublikowaniem raportu, należy użyć okna dialogowego Parametry raportu w programie Report Designer.Aby uzyskać więcej informacji zobacz How to: Add, Change, or Delete a Report Parameter (Reporting Services).

After the report is published, you can modify many report parameter properties in Report Manager or SQL Server Management Studio.Aby uzyskać więcej informacji na temat modyfikowania właściwości parametru i zagadnienia dotyczące zabezpieczeń Zobacz Setting Parameter Properties for a Published Report.

Parametry raportu

Parametry raportu są tworzone automatycznie dla parametrów zapytania, gdy jest zapisywane zapytanie zestawu danych, ale można też ręcznie utworzyć parametr raportu.Po utworzeniu parametru raportu może zajść konieczność dostosowania wartości domyślnych właściwości parametru raportu w celu uzyskania wymaganej funkcjonalności.Na przykład może być konieczna zmiana typu danych, utworzenie zestawu danych w celu dostarczenia listy dostępnych wartości, utworzenie zestawu danych dla wartości domyślnych lub określenie, czy wartości mogą być puste lub równe null.

Jeśli parametr ma zezwalać na użycie wielu wartości, należy zmienić zapytanie zestawu danych, aby również zezwalała na użycie wielu wartości.Aby uzyskać więcej informacji zobacz Using Single-Value and Multivalue Parameters. Ponadto, jeśli w wyrażeniu umieszczono parametr wielowartościowy, należy wiedzieć, jak napisać wyrażenie umożliwiające dostęp do odpowiednich wartości.Aby uzyskać więcej informacji zobacz Using Parameters Collection References in Expressions (Reporting Services).

Aby utworzyć lub zmodyfikować parametr raportu, kliknij prawym przyciskiem myszy węzeł parametry w okienku danych i Otwórz Właściwości parametru raportu -okno dialogowe.

Uwaga

Podczas usuwania parametru zapytania lub zmieniania jego nazwy odpowiadający mu parametr raportu nie jest automatycznie usuwany lub zmieniany.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.Jeśli po usunięciu parametru zapytania odpowiadający mu parametr raportu nie będzie już potrzebny, należy usunąć go ręcznie.

Nazwa i typ danych

Nazwy parametrów są wymagane i muszą być unikatowe w raporcie.Typ danych parametru jest zestaw do String Domyślnie. Inny typ danych można wybrać z listy rozwijanej.If the report parameter is based on a query parameter, make sure that the report parameter data type matches the query parameter data type.Reporting Services does not detect query parameter data types so you must adjust the data type yourself.

Nazwy muszą być zgodne ze standardami specyfikacji CLS (Common Language Specification) dotyczącymi znaków i wielkości liter.Aby uzyskać więcej informacji zobacz Specyfikacja języka wspólnego pod adresem https://msdn.microsoft.com.

Monit

W opublikowanym raporcie parametry zazwyczaj są wyświetlane jako pola tekstowe w obszarze wprowadzania parametrów u góry raportu.Ciąg monitu definiuje etykietę identyfikującą parametr w obszarze wprowadzania.Monit może być nazwą parametru lub instrukcjami dla użytkownika, na przykład „Rok” lub „Wybierz rok”.Jeśli monit będzie pusty i zostanie określona domyślna wartość parametru, będzie używana wartość domyślna, a pole wprowadzania parametru nie będzie wyświetlane po uruchomieniu raportu przez użytkownika.Jeśli monit będzie pusty i nie zostanie określona domyślna wartość parametru, nie będzie można uruchomić raportu.Jeśli nie chcesz monitować użytkownika o wartości parametrów, należy wybrać Ukryte or Wewnętrzny.

Parametry ukryte i wewnętrzne

Można ustawić opcje określające widoczność parametru w opublikowanym raporcie.Ustawianie Ukryte and Wewnętrzny opcje zapewnia różne poziomy widoczności.Można ukryć parametr w obszarze wprowadzania parametrów opublikowanego raportu i ustawić dla niego wartości w adresie URL raportu lub definicji subskrypcji.Jeżeli parametr jest ustawiony na Wewnętrzny, to nie jest narażony w dowolny sposób oprócz definicja raportu.Jako parametr wewnętrzny musi mieć wartość domyślną, która może być zerowy Jeśli Zezwalaj na wartości null wybrano opcję.

Parametry jednowartościowe i wielowartościowe

Parametr wielowartościowe można zdefiniować, wybierając Wielowartościowe opcjiParametry raportu -okno dialogowe.Jeśli to pole wyboru nie będzie zaznaczone, parametr będzie parametrem jednowartościowym.Określanie Wielowartościowe opcja dodaje pola wyboru do wartości dostępnych w rozwijanej parametr-niedziałający opublikowanego raportu na liście.Użytkownicy mogą wybierać dowolne wartości; na przykład w przykładowym raporcie porównania przyczyn sprzedaży użytkownicy mogą wybrać wiele produktów, aby wyświetlić połączone dane sprzedaży dotyczące tych produktów.

Po określeniu dostępnych wartości można dostarczyć listę statyczną lub użyć zapytania w celu pobrania dostępnych wartości ze źródła danych.Parametr wielowartościowy musi zawierać co najmniej jedną wartość.Wartości null są niedozwolone.Opcja Zaznacz wszystko jest tworzona automatycznie i wyświetlana tylko wtedy, gdy są dostępne co najmniej dwie wartości.

Uwaga

W Reporting Services, jeśli używasz Analysis Services dane źródłowe, nie należy wybierać opcji Zaznacz wszystkie opcji.The Select All option can produce poor performance when processing an MDX query.Aby zaznaczyć wszystkie wartości, projektant kwerend, wybrać wyrażenie MDX Wszystkie element członkowski na liście w zamian.

Zezwalanie na wartość pustą

Podczas tworzenia listy dostępnych wartości, jeśli chcesz <Puste> dozwolone jako prawidłowy, należy umieścić go na liście prawidłowych wartości.

Zezwalanie na wartość null

Zezwalaj na wartości null jest to opcja wycenione pojedyncze parametrów.Nie można wybrać tej wartości dla parametru wielowartościowego.Po wybraniu Zezwalaj na wartości null, zezwolono parametr ma wartość null.Domyślnie niektóre języki zapytań nie zwracają wartości Null w zestawie wyników.

Dostępne wartości

Podczas definiowania parametru raportu należy zdefiniować wartości, których będzie można używać w raporcie.Te wartości są nazywane dostępnymi lub prawidłowymi wartościami.Lista dostępnych wartości zawiera zestaw par wartość/etykieta.Po uruchomieniu raportu użytkownik będzie widział etykietę.Gdy użytkownik wybierze etykietę, odpowiadająca jej wartość zostanie użyta jako wartość parametru.Dostępne wartości można wstępnie zdefiniować jako listę statyczną lub wyrażenie, ale można też pobrać je z zestawu danych:

  • Lista niebędąca wynikiem działania zapytania to statyczna lista par wartość/etykieta.Cała lista wchodzi w skład definicji parametru raportu.Każda wartość i etykieta może być wartością statyczną lub może być generowana przez wyrażenie.

  • Lista będąca wynikiem działania zapytania powoduje, że po uruchomieniu raportu serwer raportów pobiera zestaw wartości i etykiet z zestawu danych.Podczas określenia listy dostępnych wartości będącej wynikiem działania zapytania należy wybrać zestaw danych, pole, które będzie używane dla wartości, oraz pole, które będzie używane dla etykiety.

Zalecane jest, aby podczas określania listy dostępnych wartości będącej wynikiem działania zapytania utworzyć uproszczony zestaw danych, który będzie używany tylko przez parametr, zamiast używania bardziej złożonego zestawu danych, który będzie także używany przez obszary danych w raporcie.Użycie jednego zestawu danych dla listy prawidłowych wartości i obszarów danych w raporcie może spowodować powstanie nieoczekiwanych wyników na liście prawidłowych wartości.

Wartość domyślna

Można zdefiniować wartość domyślną dla parametru.Jeśli wszystkie parametry w raporcie mają wartości domyślne, przetwarzanie raportu rozpocznie się natychmiast po otwarciu raportu przez użytkownika lub wyświetleniu jego podglądu w programie Report Designer.Jeśli co najmniej jeden parametr nie ma wartości domyślnej, dane zostaną wyświetlone w raporcie tylko wtedy, gdy użytkownik wprowadzi wszystkie wartości parametrów i uruchomi raport.

Jako wartości domyślnych można użyć wartości będących lub niebędących wynikiem działania zapytania.Wartość domyślna niebędąca wynikiem działania zapytania to wartość statyczna lub wyrażenie.Wartość domyślna będąca wynikiem działania zapytania to wyrażenie wskazujące pole w zestawie danych.Jeśli zapytanie zwróci wiele wierszy, będzie używana wartość z pierwszego wiersza zwróconego zestawu danych.

Można także zrezygnować z określania wartości domyślnej.W takim przypadku należy określić monit.

Uwaga

Jeśli będzie używany parametr wielowymiarowy, a zapytanie zwróci kilka wierszy, wszystkie wiersze będą używane jako wartość domyślna.