Udostępnij za pośrednictwem

Modyfikowanie pliku konfiguracji usług Reporting Services (RSreportserver.config)

  • Artykuł

Usługi Reporting Services przechowują ustawienia aplikacji w zestawie plików konfiguracji. Instalacja tworzy pliki konfiguracyjne dla każdej zainstalowanej instancji serwera raportów. W każdym pliku wartości są ustawiane podczas instalacji lub gdy używasz narzędzi i aplikacji do konfigurowania serwera na potrzeby operacji. W niektórych przypadkach należy zmodyfikować plik bezpośrednio, aby dodać lub skonfigurować ustawienia zaawansowane. Ustawienia konfiguracji są określane jako elementy XML lub atrybuty. Jeśli rozumiesz pliki XML i konfiguracji, możesz użyć edytora tekstu lub kodu, aby zmodyfikować ustawienia możliwe do zdefiniowania użytkownika.

Niektóre ustawienia konfiguracji można ustawić tylko za pomocą narzędzia. Ustawienia zawierające zaszyfrowane wartości muszą być modyfikowane za pomocą narzędzia konfiguracji usług Reporting Services, programu instalacyjnego lub narzędzia wiersza polecenia rsconfig. Aby uruchomić te narzędzia, musisz być członkiem lokalnej grupy Administratorzy.

Ważny

Zachowaj ostrożność podczas modyfikowania plików konfiguracji. Jeśli zmodyfikujesz ustawienie zarezerwowane do użytku wewnętrznego, możesz wyłączyć instalację. Ogólnie rzecz biorąc, modyfikowanie ustawień konfiguracji nie jest zalecane, chyba że próbujesz rozwiązać konkretny problem. Aby uzyskać więcej informacji na temat bezpiecznych ustawień, zobacz RsReportServer.config pliku konfiguracji lub pliku konfiguracji RSReportDesigner. Aby uzyskać więcej informacji na temat plików konfiguracji, zobacz dokumentację produktu Microsoft .NET Framework.

W tym artykule:

Odczytywanie i używanie wartości konfiguracji

Serwer raportów odczytuje pliki konfiguracji podczas uruchamiania usługi i za każdym razem, gdy plik konfiguracji zostanie zapisany. Nowe i poprawione wartości zostaną zastosowane w nowej domenie aplikacji po wygaśnięciu bieżącej domeny aplikacji. Jeśli to możliwe, żądania, które nadal są przetwarzane w bieżącej domenie aplikacji, mogą zostać ukończone. Jednak kilka ustawień wymaga natychmiastowej operacji recyklingu domeny aplikacji. W takim przypadku wszystkie żądania, które są w trakcie procesu, są uruchamiane ponownie w nowej domenie aplikacji.

Jeśli serwer raportów wykryje nieprawidłową wartość, rejestruje błąd w dzienniku aplikacji systemu Windows i albo nie uruchamia się, albo używa wartości domyślnej, w zależności od błędu.

  • Jeśli błąd jest nieprawidłowo sformułowany XML, serwer raportów nie zostanie uruchomiony. Jeśli serwer raportów jest uruchomiony podczas wprowadzania błędu, serwer raportów ignoruje nieprawidłowy plik konfiguracji. Ignoruje on plik do momentu ponownego uruchomienia serwera raportów lub ponownego uruchomienia domeny aplikacji. Po wykryciu błędu serwer raportów nie będzie już uruchamiany.

  • Jeśli błąd jest nieprawidłową wartością konfiguracji, serwer używa wewnętrznych wartości domyślnych i rejestruje błąd w plikach dziennika śledzenia. W niewielu przypadkach, gdy wewnętrzne wartości domyślne nie są dostępne, serwer zwraca błąd rsServerConfigurationError, jeśli nieprawidłowe ustawienie konfiguracji ma krytyczne znaczenie dla operacji serwera. Błędy dotyczące brakujących lub nieprawidłowych ustawień krytycznych są zwracane do aplikacji klienckiej na stronie błędu HTML i rejestrowane w dzienniku zdarzeń.

Wszystkie zmiany w pliku konfiguracji, w tym pomyślne zmiany, są rejestrowane w pliku dziennika śledzenia serwera raportów. Tylko błędy są rejestrowane w dzienniku zdarzeń aplikacji.

Informacje o wartościach domyślnych

Większość ustawień konfiguracji ma wartości domyślne określone wewnętrznie na serwerze raportów. Serwer raportów używa tych wartości, jeśli wartość zdefiniowana przez użytkownika jest nieprawidłowa lub nie została określona. Jeśli wartość domyślna musi być używana z powodu nieprawidłowego ustawienia konfiguracji, zostanie zapisany błąd w pliku dziennika śledzenia.

Usuwanie ustawień konfiguracji

W przypadku ustawień konfiguracji, które mają wartości domyślne, usunięcie ustawienia z pliku konfiguracji nie ma żadnego wpływu. Większość ustawień konfiguracji jest definiowana i konfigurowana wewnętrznie. Jeśli usuniesz element z pliku konfiguracji, kopia wewnętrzna będzie nadal dostępna i używa wartości domyślnej, która jest dla niej zdefiniowana.

Edytowanie pliku konfiguracji usług Reporting Services

  1. Znajdź plik konfiguracji, który chcesz edytować:

    • RSReportServer.config znajduje się w następującym folderze:

      C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer

      Dotyczy: styczeń 2017 r. wersja Technical Preview raportów usługi Power BI w usługach SQL Server Reporting Services

      C:\Program Files\Microsoft SQL Server Reporting Services\RSServer\ReportServer

    • RSReportServerServices.exe.config znajduje się w następującym folderze:

      Notatka

      Nie jest to dostępne w technicznej wersji zapoznawczej raportów Power BI ze stycznia 2017 r. w ramach SQL Server Reporting Services.

      C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer\bin

    • RSReportDesigner.config znajduje się w następującym folderze:

      C:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE\PrivateAssemblies

  2. Zapisz kopię pliku na wypadek konieczności wycofania zmian.

  3. Otwórz oryginalny plik w Notatniku lub edytorze kodu. Nie używaj tabletu Textpad. Ustawia długość pliku przed jego zapisaniem, co powoduje zarejestrowanie błędu z powodu nieprawidłowego znaku w pliku dziennika śledzenia.

  4. Wpisz element lub wartość, którą chcesz dodać lub użyć. W elementach jest rozróżniana wielkość liter. Jeśli dodajesz element, pamiętaj, aby użyć poprawnych wielkich i małych liter. Dostępne są szczegółowe instrukcje dotyczące edytowania plików konfiguracji w przypadku dostosowywania rozszerzenia renderowania, rozszerzeń uwierzytelniania lub rozszerzeń przetwarzania danych:

  5. Zapisz plik.

  6. Sprawdź pliki dziennika śledzenia, aby sprawdzić, czy nie wystąpiły błędy. Jeśli widzisz warunki błędu, ustawienie lub jego wartość jest niepoprawnie określona. Przejrzyj plik konfiguracji RsReportServer.config, aby uzyskać prawidłowe wartości dla dowolnego ustawienia powodującego błąd. Aby uzyskać więcej informacji o sposobie wyświetlania dziennika śledzenia, zobacz dziennik śledzenia usługi serwera raportów.

Powiązana zawartość