Projektowanie raportów stronicowanych w usługach Reporting Services za pomocą Projektanta Raportów (SSRS)

Dotyczy: SQL Server 2016 (13.x) Reporting Services i nowsze wersje

Projektant raportów umożliwia tworzenie w pełni funkcjonalnych stronicowanych raportów i rozwiązań raportowania w usługach SQL Server Reporting Services (SSRS). Projektant raportów udostępnia:

• Sposób definiowania źródeł danych, zestawów danych i zapytań.
• Możliwości projektowania i dostosowywania układu regionów danych i pól.
• Interaktywne funkcje, takie jak parametry i zestawy raportów, które współpracują ze sobą.

Projektant raportów to funkcja narzędzi SQL Server Data Tools (SSDT), środowiska programu Microsoft Visual Studio do tworzenia rozwiązań analizy biznesowej.

Instalacja programu SSDT

Program SSDT nie jest dołączony do programu SQL Server. Należy zainstalować program SSDT oddzielnie. Aby uzyskać instrukcje, zobacz Instalowanie narzędzi SSDT za pomocą programu Visual Studio.

Aby użyć szablonów projektanta raportów, należy również zainstalować rozszerzenie usług SSRS dla programu Visual Studio. Aby uzyskać instrukcje, zobacz Instalowanie rozszerzeń dla usług Analysis Services, Integration Services i Reporting Services.

Zalety projektów raportów

W Projektancie raportów można organizować raporty przy użyciu projektów. Projekty raportów działają jako kontenery dla definicji raportów i zasobów. Projekty można używać do wykonywania następujących zadań:

• Organizowanie raportów i powiązanych elementów w jednym kontenerze.
• Przeprowadzanie testów rozwiązań raportowych, które obejmują raporty i powiązane elementy lokalnie.
• Wdrażanie powiązanych elementów razem. Aby wdrożyć elementy w wielu środowiskach, można użyć właściwości projektu i zarządzania konfiguracją.
• Zachowanie zestawu kopii podstawowych dla raportów i powiązanych elementów, ponieważ po wdrożeniu opublikowane raporty mogą zostać przypadkowo zmodyfikowane.

Informacje przedstawione w tym artykule umożliwiają projektowanie raportów podzielonych na strony i powiązanych elementów dla pojedynczego projektu raportowania w rozwiązaniu SSDT. Aby uzyskać więcej informacji na temat rozwiązań i wielu projektów w programie SSDT, zobacz Reporting Services in SQL Server Data Tools (SSDT) (Usługi Reporting Services w narzędziach SQL Server Data Tools (SSDT).

Udostępnione źródła danych i zestawy danych

Narzędzie SSDT umożliwia definiowanie i wdrażanie udostępnionych źródeł danych oraz udostępnionych zestawów danych dla rozwiązania do raportowania.

• Aby wdrożyć udostępnione źródło danych niezależnie od innych elementów w projekcie, możesz użyć właściwości OverwriteDataSources i TargetDataSourceFolder.
• Aby wdrożyć udostępniony zestaw danych niezależnie od innych elementów w projekcie, możesz użyć właściwości OverwriteDatasets i TargetDatasetFolder.

Aby uzyskać więcej informacji, zobacz Ustawianie właściwości wdrożenia (Reporting Services).

W projektancie raportów pracujesz zarówno w okienku Dane raportu, jak i w Eksploratorze rozwiązań, aby zdefiniować źródła danych i udostępnione zestawy danych używane w raporcie. Aby uzyskać więcej informacji, zobacz Okienko danych raportu.

Jeśli źródło danych jest publikowane na serwerze raportów lub w witrynie programu SharePoint, ale nie jest uwzględnione w rozwiązaniu SSDT, nie można użyć narzędzia SSDT do otwarcia tego źródła danych. Podobnie nie można używać programu SSDT do otwierania opublikowanych zestawów danych bezpośrednio z serwera raportów lub witryny programu SharePoint. Aby otworzyć źródło danych lub zestaw danych w tych scenariuszach, możesz użyć programu Report Builder. Aby uzyskać więcej informacji, zobacz Report Builder authoring environment (SSRS). W przypadku zestawów danych użyj tego środowiska w trybie udostępnionego zestawu danych.

SSDT to narzędzie klienckie. Możesz z tego korzystać, aby:

• Przetestuj rozwiązanie do raportowania lokalnie na komputerze.
• Przetestuj rozwiązanie serwera, wdrażając rozwiązanie do raportowania w środowisku testowym.
• Wdróż rozwiązanie raportowania w środowisku produkcyjnym.
• Pomóż tworzyć i testować wyniki zapytań lokalnie, korzystając z możliwości podglądu projektantów zapytań SSDT.

Po wdrożeniu:

• Należy sprawdzić, czy rozszerzenia przetwarzania źródła danych i poświadczenia źródła danych są skonfigurowane dla środowiska serwera raportów. Menedżer konfiguracji serwera raportów umożliwia zarządzanie właściwościami wielu wdrożeń. Aby uzyskać więcej informacji, zobacz Reporting Services in SQL Server Data Tools (SSDT) (Usługi Reporting Services w narzędziach SQL Server Data Tools (SSDT).
• Udostępnione zestawy danych można zarządzać niezależnie od udostępnionych źródeł danych i raportów, od których zależą. Aby uzyskać więcej informacji, zobacz następujące zasoby:
  • Raportowanie osadzonych zestawów danych i udostępnionych zestawów danych (Report Builder i SSRS)
  • Narzędzia do projektowania zapytań (SSRS)
  • Zarządzanie udostępnionymi zestawami danych

Aby uzyskać więcej informacji na temat dołączania danych do raportów podzielonych na strony, zobacz Tworzenie parametrów połączenia danych w programie Report Builder.

Raporty wielostronicowe

Raporty podzielone na strony to pliki przechowywane w projekcie raportu. Możesz użyć pliku raportu stronicowanego jako samodzielnego raportu, podraportu lub jako elementu docelowego dla akcji drill-through z raportów głównych. Aby wdrożyć raport niezależnie od innych elementów w projekcie, możesz użyć TargetReportFolder właściwości i innych ustawień. Aby uzyskać więcej informacji, zobacz Ustawianie właściwości wdrożenia (Reporting Services).

Jeśli zainstalujesz rozszerzenie usług SSRS w programie Visual Studio, zgodnie z opisem we wcześniejszej instalacji programu SSDT, możesz użyć szablonu projektu serwera raportów, aby utworzyć nowy projekt. Następnie możesz dodać raport do projektu w dowolny z następujących sposobów:

• Użyj kreatora raportów. Raport jest tworzony w sposób krok po kroku. Kreator raportów upraszcza definicję danych i projekt raportu w serię kroków, które dają gotowy raport. Możesz dodać style, aby dostosować kreatora dla własnej organizacji. Aby uzyskać więcej informacji, zobacz Dodawanie nowego raportu przy użyciu kreatora raportów.

• Dodaj nowy element typu raport. Pusty raport zostanie otwarty w Projektancie raportów. Aby uzyskać więcej informacji, zobacz Dodawanie nowego pustego raportu.

• Dodaj istniejący element. Istniejący plik definicji raportu (rdl) zostanie otwarty w Projektancie raportów. Otwarcie raportu lub projektu z wcześniejszej wersji usług SSRS może automatycznie uaktualnić projekt do bieżącej wersji i raportu do bieżącego schematu. Aby uzyskać więcej informacji, zobacz Uaktualnianie raportów (SSRS).

• Zaimportuj raport programu Microsoft Access. Proces importowania importuje wszystkie raporty z bazy danych programu Access (.mdb, accdb) lub pliku projektu (adp). Projektant raportów konwertuje każdy raport w bazie danych lub pliku projektu na język RDL (Report Definition Language) i zapisuje go w projekcie raportu. Nie wszystkie funkcje raportu programu Access przenoszą się do pliku definicji raportu (.rdl). Aby uzyskać więcej informacji, zobacz Importowanie raportów z programu Microsoft Access (Reporting Services).

  Uwaga / Notatka

  Aby można było korzystać z funkcji importowania, musisz mieć zainstalowany program Access 2002 lub nowszą wersję na tym samym komputerze, na którym zainstalowano projektanta raportów. Źródło danych raportów programu Access musi być dostępne po zaimportowaniu raportów.

• Pracuj bezpośrednio w pliku RDL. Raport jest zapisywany w formacie XML jako plik RDL. Ten plik można edytować w Projektancie raportów, edytorze tekstów lub dowolnym edytorze XML.

  Podczas edytowania źródła definicji raportu w projektancie raportów pracujesz w bieżącym schemacie języka RDL dla wersji programu SQL Server, z której zainstalowano narzędzia programistyczne. Podczas kompilowania projektu wersja schematu może ulec zmianie w zależności od właściwości wdrożenia. Aby uzyskać więcej informacji, zobacz Wdrażanie i obsługa wersji w narzędziach SQL Server Data Tools (SSDT).

  Bezpośrednia edycja RDL może skutkować problemami z opublikowaniem raportu na serwerze raportów lub jego uruchomieniem. Podobnie jak w przypadku dowolnego pliku XML, upewnij się, że poprawnie kodujesz znaki specyficzne dla kodu XML używane w elementach. Podczas publikowania raportu serwer raportów używa schematu do sprawdzania poprawności kodu XML w pliku RDL.

  Aby uwzględnić elementy, które nie są częścią schematu języka RDL, umieść je w elemecie niestandardowym. Niestandardowe rozszerzenia renderowania mogą odczytywać elementy niestandardowe. Jednak rozszerzenia renderowania zapewniane przez usługę SSRS ignorują element . Na przykład możesz użyć elementu niestandardowego do przechowywania komentarzy w raporcie.

  Aby uzyskać więcej informacji, zobacz Report Definition Language (SSRS).

Części raportu

W Projektancie raportów można tworzyć tabele, wykresy i inne elementy raportu podzielonego na strony w projekcie. Po ich utworzeniu można opublikować je jako części raportu na serwerze raportów lub w witrynie programu SharePoint zintegrowanej z serwerem raportów. Ta akcja umożliwia tobie i innym osobom ponowne użycie ich w innych raportach. Aby uzyskać więcej informacji, zobacz Report part in Report Designer (SSRS) (Składniki raportów w projektancie raportów (SSRS).

Części raportu można wdrażać niezależnie od innych elementów w projekcie przy użyciu właściwości TargetReportPartFolder i innych. Aby uzyskać więcej informacji, zobacz Ustawianie właściwości wdrożenia (Reporting Services).

Zasoby

Możesz dodawać pliki do projektu, które są powiązane z raportem, ale nie są przetwarzane przez serwer raportów. Możesz na przykład dodać obrazy lub dodać pliki kształtów Environmental Systems Research Institute, Inc. (ESRI) dla danych przestrzennych. Aby uzyskać więcej informacji, zobacz Zasoby.

Układ raportu podzielonego na strony

Aby utworzyć układ raportu, przeciągnij elementy raportu i regiony danych z przybornika Projektanta raportów do powierzchni projektowej i rozmieść je. Przeciągając pola zestawu danych do elementów na powierzchni projektowej, możesz dodać dane do raportu. Aby zorganizować dane w grupach w regionie danych elementu tablix, przeciągnij pola zestawu danych do okienka Grupowanie. Ponieważ narzędzia do tworzenia raportów są zasadniczo sposobem tworzenia definicji raportów, podejście do projektowania raportów jest podobne w programie Report Builder i projektancie raportów.

Wyświetlanie podglądu raportu podzielonego na strony

Możesz użyć widoku Podgląd, aby zweryfikować projekt danych raportu i układu. Podczas wyświetlania podglądu raportu procesor raportów weryfikuje schemat definicji raportu i składnię wyrażeń. Zawiera również listę problemów w oknie Dane wyjściowe .

Podgląd raportu można wyświetlić w następujący sposób:

• Widok podglądu. Jeśli wybierzesz kartę Podgląd , raport zostanie uruchomiony lokalnie. Używa on tej samej funkcji przetwarzania i renderowania raportów, które zapewnia serwer raportów. Wyświetlany raport jest interaktywnym obrazem. Możesz wybrać parametry, wybrać łącza, wyświetlić mapę dokumentu i rozwinąć i zwinąć ukryte obszary raportu. Raport można również wyeksportować do dowolnego z zainstalowanych formatów renderowania.

• Autonomiczna wersja zapoznawcza. Raport lokalny można uruchomić w przeglądarce. Korzystając z konfiguracji debugowania, możesz również użyć tego trybu do debugowania zestawów niestandardowych, które piszesz. Istnieją trzy sposoby uruchamiania projektu w trybie debugowania:

  • W menu Debugowanie możesz wybrać pozycję Rozpocznij debugowanie.
  • Na standardowym pasku narzędzi programu Visual Studio możesz wybrać przycisk Uruchom .
  • Możesz wybrać F5.

  Jeśli używasz konfiguracji projektu, która kompiluje raport, ale go nie wdraża, raport określony we StartItem właściwości bieżącej konfiguracji zostanie otwarty w osobnym oknie podglądu.

  Uwaga / Notatka

  Aby użyć trybu debugowania, należy ustawić element początkowy. Aby ustawić element początkowy, przejdź do Eksploratora rozwiązań, kliknij prawym przyciskiem myszy projekt raportu i wybierz polecenie Właściwości. Następnie w menu StartItem wybierz nazwę raportu do wyświetlenia.

  Jeśli chcesz wyświetlić podgląd określonego raportu, który nie jest elementem początkowym projektu, możesz wybrać konfigurację, która kompiluje raport, ale go nie wdraża. Na przykład można użyć konfiguracji DebugLocal. Następnie kliknij prawym przyciskiem myszy raport i wybierz polecenie Uruchom. Musisz wybrać konfigurację, która nie wdraża raportu. W przeciwnym razie raport zostanie opublikowany na serwerze raportów zamiast być wyświetlany lokalnie w oknie podglądu.

• Podgląd wydruku. Po pierwszym wyświetleniu raportu w trybie podglądu lub w oknie podglądu widok raportu przypomina raport generowany przez rozszerzenie renderowania HTML. Podgląd nie jest kodem HTML, ale układ i stronicowanie raportu są podobne do danych wyjściowych HTML.

  Widok można zmienić tak, aby przedstawiał wydrukowany raport, przełączając się na tryb podglądu wydruku. Po wybraniu opcji Podgląd wydruku na pasku narzędzi Podgląd raport jest wyświetlany tak, jakby znajdował się na stronie fizycznej. Ten widok przypomina dane wyjściowe, które tworzą rozszerzenia renderowania obrazów i plików PDF. Podgląd wydruku nie jest obrazem ani plikiem PDF, ale układ i stronicowanie raportu są podobne do danych wyjściowych w tych formatach. Możesz na przykład wybrać rozmiar obrazu raportu i ustawić szerokość strony.

  Podgląd wydruku pomaga zidentyfikować problemy z renderowaniem, które mogą wystąpić podczas drukowania raportu. Typowe problemy z renderowaniem obejmują:

  • Dodatkowe puste strony, ponieważ raport jest zbyt szeroki, aby zmieścić się w rozmiarze papieru określonym dla raportu.
  • Dodatkowe puste strony, ponieważ raport zawiera tabelę, która dynamicznie się rozszerza, przekraczając określoną szerokość papieru.
  • Podziały stron między grupami, które nie działają tak, jak chcesz.
  • Nagłówki i stopki, które nie są wyświetlane zgodnie z oczekiwaniami.
  • Układy raportów, które wymagają modyfikacji, powinny wyglądać lepiej w formacie drukowanym.

Zapisywanie i wdrażanie raportów podzielonych na strony

W Projektancie raportów można zapisywać raporty i inne pliki projektu lokalnie lub wdrażać je na serwerze raportów lub w witrynie programu SharePoint. Udostępnione źródła danych, udostępnione zestawy danych, raporty, zasoby raportu i części raportów można wdrażać niezależnie lub razem w zależności od skonfigurowanych właściwości wdrożenia projektu. Aby uzyskać więcej informacji, zobacz Właściwości konfiguracji i wdrażania.

W projektancie raportów projektujesz raport przy użyciu schematu definicji raportu obsługiwanego przez bieżącą wersję usług SSRS w programie SSDT. Właściwości wdrożenia projektu można ustawić dla określonego serwera raportów lub witryny programu SharePoint. Po zapisaniu raportu projektant raportów zapisuje definicję raportu w katalogu kompilacji w schemacie zgodnym z wersją na docelowym serwerze raportów. Aby utworzyć raporty, które można opublikować na serwerze raportów używającym starszej wersji usług SSRS, Projektant raportów usuwa elementy raportów, które nie istnieją w schemacie docelowym. Ta akcja jest wykonywana automatycznie i bez monitowania. W przypadku tej akcji oryginalna definicja raportu jest zachowywana w folderze projektu. Zmodyfikowana definicja raportu wdrażana przez projektanta raportów znajduje się w folderze kompilacji.

Aby uzyskać więcej informacji, zobacz Wdrażanie i obsługa wersji w narzędziach SQL Server Data Tools (SSDT).

Lokalne zapisywanie raportu

Podczas pracy nad raportami lub innymi elementami projektu w Projektancie raportów pliki są zapisywane na komputerze lokalnym lub w udziale plików na innym komputerze, do którego masz dostęp.

Jeśli używasz oprogramowania kontroli źródła, działanie zapisywania raportu może sprawdzić go na serwerze kontroli źródła. Aby uzyskać więcej informacji, zobacz Kontrola źródła.

Wdrażanie lub publikowanie raportów podzielonych na strony

Z narzędzi SSDT można wdrażać raporty lub inne elementy projektu na wielu wersjach serwerów raportów usług SSRS. Konfiguracja projektu służy do kontrolowania uaktualniania definicji raportów do wersji schematu, które są zgodne z docelowymi serwerami raportów. Konfiguracje projektu kontrolują niektóre właściwości, w tym docelowy serwer raportów, folder, w którym proces kompilacji tymczasowo przechowuje definicje raportów dla wersji zapoznawczej i wdrożenia oraz poziomy błędów. Aby uzyskać więcej informacji, zobacz Właściwości konfiguracji i wdrażania oraz Ustawianie właściwości wdrożenia (Reporting Services).

Eksportowanie raportu podzielonego na strony do innego formatu pliku

Raporty można eksportować do różnych formatów. Te formaty mają wpływ na sposób działania niektórych funkcji układu raportu i interakcyjności. Aby uzyskać więcej informacji na temat zagadnień dotyczących projektowania dla różnych formatów danych wyjściowych, zobacz Eksportowanie raportów podzielonych na strony (Report Builder).

Zgłaszanie poziomów walidacji i błędów

Raporty są weryfikowane przed podglądem i podczas wdrażania. Podczas tworzenia raportów może wystąpić wiele problemów. Na przykład raporty mogą zawierać ciągi, takie jak wyrażenia lub zapytania niezgodne z wersją usług SSRS, którą określa konfiguracja projektu.

ErrorLevel Użyj właściwości , aby zarządzać ostrzeżeniami i błędami kompilacji. Właściwości ErrorLevel można przypisać wartość z zakresu od 0 do 4 włącznie. Wartość określa, które problemy z kompilacją są zgłaszane jako błędy i które są zgłaszane jako ostrzeżenia. Domyślna wartość wynosi 2. Ostrzeżenia i błędy są zapisywane w oknie danych wyjściowych SSDT.

Problemy z poziomami ważności, których wartości są mniejsze lub równe ErrorLevel, są zgłaszane jako błędy. Inne problemy są zgłaszane jako ostrzeżenia.

W poniższej tabeli wymieniono poziomy błędów.

Możesz podjąć próbę wyświetlenia podglądu lub wdrożenia raportu zawierającego elementy raportu, które nie są obsługiwane w Twojej wersji SSRS. Jednak te elementy raportu są czasami usuwane z raportu i jest wyświetlany błąd poziomu 2. Jeśli właściwość ErrorLevel jest ustawiona na wartość domyślną 2, kompilacja zakończy się niepowodzeniem w tym przypadku.

Możesz obejść ten problem, zmieniając ErrorLevel wartość na 0 lub 1. Następnie, gdy element zostanie porzucony, zostanie wyświetlone ostrzeżenie, a proces kompilacji będzie kontynuowany.

Treści powiązane

• Raporty usług SSRS (Reporting Services)
• Instalowanie narzędzi SQL Server Data Tools (SSDT) dla programu Visual Studio
• Narzędzia do projektowania zapytań (SSRS)