Przenoszenie raportów SSRS

Przenoszenie raportów SSRS obejmuje migrację ich definicji i źródeł danych do nowej usługi raportowej.

Zakres migracji raportów SSRS

Przenoszenie raportów SSRS, czyli SQL Server Reporting Services, polega na odtworzeniu raportów w innej instancji lub w nowej usłudze raportowej. Migracja obejmuje nie tylko pliki definicji raportów w formacie RDL, lecz także foldery, parametry, harmonogramy, subskrypcje, uprawnienia oraz konfigurację źródeł danych. Samo skopiowanie pliku RDL nie przenosi ustawień zapisanych po stronie serwera, dlatego pełny zakres prac trzeba ustalić przed rozpoczęciem operacji.

Raport RDL opisuje układ dokumentu, elementy wizualne, grupowanie, sortowanie, parametry i zapytania używane do pobierania danych. Raport może korzystać ze źródła danych osadzonego w definicji albo ze współdzielonego źródła danych zarejestrowanego na serwerze SSRS. W drugim przypadku konieczne jest odtworzenie zarówno samego źródła, jak i właściwego łącza raportu do tego obiektu. Należy również sprawdzić zależności od współdzielonych zestawów danych, obrazów, niestandardowych zestawów danych i rozszerzeń używanych przez konkretną instalację.

Przygotowanie definicji i źródeł danych

Przed importem raportów warto zinwentaryzować ich lokalizacje, nazwy, właścicieli, parametry oraz typy używanych źródeł danych. W środowisku SSRS źródło danych może wskazywać między innymi na relacyjną bazę danych przez dostawcę obsługiwanego przez daną instalację. W definicji trzeba zweryfikować nazwę serwera, instancję SQL Server, nazwę bazy, sposób uwierzytelniania oraz wymagane właściwości połączenia. Po migracji adres zapisany w źródle danych nie zmienia się automatycznie tylko dlatego, że raport został opublikowany na innym serwerze.

Raporty należy sprawdzić pod kątem zgodności wersji schematu RDL i funkcji dostępnych w docelowej wersji SSRS. Nowsze elementy definicji mogą nie być obsługiwane przez starszą usługę, a zmiana dostawcy danych może wpłynąć na składnię zapytań, typy parametrów, format dat oraz sposób zwracania wartości pustych. Szczególnej kontroli wymagają zapytania wykorzystujące nazwy schematów, funkcje specyficzne dla SQL Server, procedury składowane oraz wielowartościowe parametry. Raport powinien zostać uruchomiony z rzeczywistymi wartościami parametrów, a nie tylko zapisany na serwerze bez sprawdzenia wykonania zapytania.

Publikowanie oraz odtwarzanie konfiguracji SSRS

Definicje raportów można publikować przy użyciu narzędzi administracyjnych zgodnych z danym wariantem SSRS, interfejsu webowego albo skryptów wykorzystujących interfejs usług raportowych. Przy większej liczbie obiektów skryptowanie ułatwia zachowanie struktury folderów i kontrolę nad powtarzalnością operacji. Kolejność ma znaczenie: najpierw należy utworzyć foldery i źródła danych, następnie opublikować raporty, a później odtworzyć ustawienia bezpieczeństwa, subskrypcje i harmonogramy. Współdzielone źródło danych musi istnieć pod adresem oczekiwanym przez raport, ponieważ publikacja pliku RDL nie zawsze rozwiązuje jego odwołania.

Uprawnienia w SSRS są oparte na rolach przypisywanych do użytkowników i grup na poziomie witryny oraz poszczególnych folderów lub raportów. Po migracji należy zweryfikować członkostwo grup, dziedziczenie uprawnień i przypisanie ról takich jak Browser, Publisher, Content Manager lub Report Builder, zależnie od używanej konfiguracji. Osobno trzeba odtworzyć subskrypcje e-mailowe, subskrypcje oparte na harmonogramie, zapisane parametry oraz zadania wykonywane cyklicznie. Harmonogram wskazujący na nieistniejące źródło danych lub niedostępne konto może zostać zapisany poprawnie, ale zakończyć się błędem podczas wykonania.

Weryfikacja raportów po przeniesieniu

Odbiór migracji powinien obejmować porównanie wyników raportów w środowisku źródłowym i docelowym dla tych samych danych oraz identycznych parametrów. Należy sprawdzić liczbę wierszy, wartości sum i agregacji, filtrowanie, sortowanie, grupowanie, formatowanie dat, eksport do PDF, Excela i innych obsługiwanych formatów, a także działanie parametrów zależnych. Różnica w wynikach nie musi oznaczać błędu samej definicji RDL; może wynikać z innej wersji danych, ustawień językowych, strefy czasowej, uprawnień konta albo zmienionej konfiguracji dostawcy danych.

Warto wykonać test raportu z kontem o uprawnieniach zwykłego odbiorcy oraz osobno przetestować konto używane przez zaplanowane wykonanie. Trzeba przejrzeć dzienniki SSRS i historię wykonywania raportów, zwracając uwagę na błędy połączenia, przekroczenie czasu wykonania, brak uprawnień, nieprawidłowe parametry i problemy z renderowaniem. Dopiero po potwierdzeniu ręcznego uruchamiania, eksportu, subskrypcji i harmonogramów można uznać migrację za zakończoną. Dokumentacja powinna wskazywać mapowanie starych i nowych ścieżek, używane źródła danych oraz procedurę wycofania zmiany.