SQL Server Reporting Services Web Portal

Reporting Services Web Portal to interfejs przeglądarkowy do zarządzania i przeglądania raportów SSRS.

Rola portalu Web Portal w SQL Server Reporting Services

SQL Server Reporting Services Web Portal to aplikacja internetowa udostępniana przez instancję SSRS, która pozwala użytkownikom przeglądać raporty zapisane na serwerze raportów. Portal działa w przeglądarce i prezentuje hierarchię folderów, raporty, źródła danych, zestawy danych, subskrypcje oraz inne elementy opublikowane w środowisku Reporting Services. Nie jest to osobny silnik bazodanowy ani narzędzie do tworzenia tabel w SQL Server. Jego zadaniem jest obsługa zasobów raportowych i udostępnianie wyników raportów przez interfejs HTTP lub HTTPS.

W instalacjach SSRS w trybie natywnym portal jest zazwyczaj dostępny pod adresem zawierającym wirtualny katalog /reports, natomiast punkt dostępu do usługi raportowej znajduje się zwykle pod katalogiem /reportserver. Konkretne adresy zależą od konfiguracji instancji, nazwy hosta, portu oraz ustawionych nazw katalogów w narzędziu Reporting Services Configuration Manager. Portal może wyświetlać raporty paginowane, raporty mobilne w wersjach, które je obsługują, oraz zasoby pomocnicze, takie jak obrazy, pliki i współdzielone źródła danych.

Przeglądanie raportów, parametry i eksport wyników

Po otwarciu raportu Web Portal może wyświetlić formularz parametrów. Parametry sterują zakresem danych przekazywanych do zapytań raportu, wyborem wartości słownikowych, przedziałem dat albo sposobem prezentacji wyniku. Dostępne wartości mogą być pobierane z zapytań pomocniczych zdefiniowanych w raporcie. Użytkownik może następnie uruchomić raport z wybranymi parametrami, zmienić układ stron, przechodzić między stronami oraz korzystać z interaktywnych elementów, takich jak sortowanie, grupowanie i przechodzenie do raportu szczegółowego.

Raporty SSRS mogą zawierać akcje nawigacyjne. Kliknięcie elementu raportu może otworzyć inny raport, przekazać do niego wartości parametrów albo przejść do szczegółowego wiersza danych. Portal pozwala także eksportować wynik do formatów obsługiwanych przez serwer raportów, między innymi PDF, Excel, Word, CSV, XML oraz obrazu. Dostępność konkretnego formatu zależy od zainstalowanych rozszerzeń renderowania i wersji SQL Server Reporting Services. Eksport nie zmienia definicji raportu; tworzy reprezentację bieżącego wyniku wygenerowanego dla wybranych parametrów.

Uprawnienia, źródła danych i działanie po stronie serwera

Web Portal korzysta z mechanizmu zabezpieczeń skonfigurowanego dla SSRS. W typowej instalacji Windows Authentication tożsamość zalogowanego użytkownika jest przekazywana do serwera, a dostęp do folderów i raportów wynika z przypisanych ról. Wbudowane role mogą obejmować między innymi Browser, Content Manager, Publisher i Report Builder. Administrator nadaje te role na poziomie folderu lub elementu, dlatego dwóch użytkowników może widzieć różne raporty po wejściu pod ten sam adres portalu. Samo wyświetlenie strony portalu nie oznacza jeszcze prawa do uruchomienia każdego raportu.

Podczas wykonania raportu serwer raportów odczytuje jego definicję, rozwiązuje parametry, łączy się ze skonfigurowanym źródłem danych i wykonuje zapytania określone w definicji raportu. Źródłem może być między innymi baza SQL Server, ale sposób uwierzytelniania i uprawnienia do danych zależą od ustawień połączenia oraz zapisanych poświadczeń. Błąd widoczny w portalu może więc wynikać z niedostępności bazy, nieprawidłowych poświadczeń, przekroczenia czasu zapytania, błędnej definicji raportu albo braku uprawnień użytkownika. Analiza samego interfejsu przeglądarkowego nie zawsze wystarcza; przydatne są również logi usługi SSRS i dzienniki systemu.

Diagnostyka dostępu do SSRS Web Portal

Podstawowa diagnostyka polega na rozdzieleniu problemu z portalem od problemu z usługą raportową. Jeżeli nie otwiera się adres /reports, należy sprawdzić rozwiązywanie nazwy hosta, połączenie z właściwym portem, certyfikat HTTPS, konfigurację aplikacji serwerowej oraz działanie usługi SQL Server Reporting Services. Jeżeli portal otwiera się poprawnie, ale raport nie wykonuje się, trzeba sprawdzić definicję raportu, parametry, źródło danych i komunikat błędu zwrócony przez serwer. Adres /reports służy przede wszystkim do obsługi portalu, a /reportserver reprezentuje bezpośredni punkt dostępu do usługi raportowej.

W praktyce warto zweryfikować, czy problem występuje dla jednego raportu, całego folderu czy wszystkich zasobów. Błąd tylko jednego raportu może wskazywać na zmianę schematu bazy, usunięcie kolumny, niezgodność parametrów albo uszkodzoną definicję RDL. Brak całego folderu częściej wiąże się z dziedziczeniem uprawnień lub zmianą ścieżki zasobu. Problemy z powolnym działaniem mogą być związane z kosztownym zapytaniem, dużą liczbą rekordów, renderowaniem do ciężkiego formatu albo ograniczeniami serwera. Przy naprawie komputera używanego do dostępu do portalu sprawdza się również przeglądarkę, certyfikaty, łączność sieciową i poprawność uwierzytelniania, ale sama awaria klienta nie powinna być mylona z błędem instancji SSRS.