Delen via

Een Reporting Services-configuratiebestand (RSreportserver.config) wijzigen

  • Artikel

Reporting Services slaat toepassingsinstellingen op in een set configuratiebestanden. Met Setup worden de configuratiebestanden gemaakt voor elk exemplaar van de rapportserver dat u installeert. Binnen elk bestand worden waarden ingesteld tijdens de installatie of wanneer u hulpprogramma's en toepassingen gebruikt om een server te configureren voor bewerking. In sommige gevallen moet u een bestand rechtstreeks wijzigen om geavanceerde instellingen toe te voegen of te configureren. Configuratie-instellingen worden opgegeven als XML-elementen of -kenmerken. Als u XML- en configuratiebestanden begrijpt, kunt u een tekst- of code-editor gebruiken om door de gebruiker gedefinieerde instellingen te wijzigen.

Sommige configuratie-instellingen kunnen alleen worden ingesteld via een hulpprogramma. Instellingen die versleutelde waarden bevatten, moeten worden gewijzigd via het hulpprogramma Reporting Services-configuratie, het installatieprogramma of het rsconfig opdrachtregelprogramma. U moet lid zijn van de lokale groep Administrators om deze hulpprogramma's uit te voeren.'

Belangrijk

Wees voorzichtig bij het wijzigen van configuratiebestanden. Als u een instelling wijzigt die is gereserveerd voor intern gebruik, kunt u de installatie uitschakelen. Over het algemeen wordt het wijzigen van configuratie-instellingen niet aanbevolen, tenzij u een specifiek probleem probeert op te lossen. Zie RsReportServer.config configuratiebestand of RSReportDesigner-configuratiebestandvoor meer informatie over welke instellingen veilig kunnen worden gewijzigd. Zie de microsoft .NET Framework-productdocumentatie voor meer informatie over configuratiebestanden.

In dit artikel:

Configuratiewaarden lezen en gebruiken

Een rapportserver leest de configuratiebestanden wanneer de service wordt gestart en wanneer het configuratiebestand wordt opgeslagen. Nieuwe en herziene waarden worden van kracht in een nieuw toepassingsdomein nadat het huidige toepassingsdomein is verlopen. Indien mogelijk kunnen aanvragen die nog worden verwerkt in het huidige toepassingsdomein worden voltooid. Voor een aantal instellingen is echter een onmiddellijke recyclebewerking van het toepassingsdomein vereist. In dit geval worden alle aanvragen die worden verwerkt opnieuw gestart in een nieuw toepassingsdomein.

Als de rapportserver een ongeldige waarde detecteert, registreert de rapportserver een fout in het Windows-toepassingslogboek en start deze niet of wordt een standaardwaarde gebruikt, afhankelijk van de fout.

  • Als er sprake is van ongeldige XML, start de rapporteringsserver niet. Als de rapportserver wordt uitgevoerd wanneer u de fout introduceert, negeert de rapportserver het ongeldige configuratiebestand. Het bestand wordt genegeerd totdat de rapportserver opnieuw wordt opgestart of het toepassingsdomein wordt gerecycled. Zodra de fout is gedetecteerd, wordt de rapportserver niet meer gestart.

  • Als de fout een ongeldige configuratiewaarde is, gebruikt de server interne standaardwaarden en registreert een fout in de traceringslogboekbestanden. In de weinig gevallen waarin interne standaardwaarden niet beschikbaar zijn, retourneert de server de rsServerConfigurationError fout als de ongeldige configuratie-instelling essentieel is voor serverbewerkingen. Fouten over ontbrekende of ongeldige kritieke instellingen worden geretourneerd naar de clienttoepassing op een HTML-foutpagina en vastgelegd in het gebeurtenislogboek.

Alle wijzigingen in het configuratiebestand, inclusief geslaagde wijzigingen, worden vastgelegd in het traceringslogboekbestand van de rapportserver. Alleen fouten worden vastgelegd in het gebeurtenislogboek van de toepassing.

Over standaardwaarden

De meeste configuratie-instellingen hebben standaardwaarden die intern zijn opgegeven in de rapportserver. De rapportserver gebruikt deze waarden als een door de gebruiker gedefinieerde waarde ongeldig is of niet is opgegeven. Als een standaardwaarde moet worden gebruikt vanwege een ongeldige configuratie-instelling, wordt er een fout naar het traceringslogboekbestand geschreven.

Configuratie-instellingen verwijderen

Voor configuratie-instellingen met standaardwaarden heeft het verwijderen van de instelling uit het configuratiebestand geen effect. De meeste configuratie-instellingen worden intern gedefinieerd en geconfigureerd. Als u een item uit het configuratiebestand verwijdert, is de interne kopie nog steeds beschikbaar en wordt de standaardwaarde gebruikt die hiervoor is gedefinieerd.

Een Reporting Services-configuratiebestand bewerken

  1. Zoek het configuratiebestand dat u wilt bewerken:

    • RSReportServer.config bevindt zich in de volgende map:

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

      Geldt voor: januari 2017 Technische Voorvertoning van Power BI-rapporten in SQL Server Reporting Services

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

    • RSReportServerServices.exe.config bevindt zich in de volgende map:

      Notitie

      Dit is niet beschikbaar in de Technical Preview van Power BI-rapporten in januari 2017 in SQL Server Reporting Services.

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

    • RSReportDesigner.config bevindt zich in de volgende map:

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

  2. Sla een kopie van het bestand op als u de wijzigingen wilt terugdraaien.

  3. Open het oorspronkelijke bestand in Notepad of een code-editor. Gebruik Textpad niet. Hiermee wordt de lengte van het bestand ingesteld voordat het bestand wordt opgeslagen, waardoor er een ongeldige tekenfout naar het traceringslogboekbestand wordt geschreven.

  4. Typ het element of de waarde die u wilt toevoegen of gebruiken. Elementen zijn hoofdlettergevoelig. Als u een element toevoegt, moet u de juiste hoofdletters en kleine letters gebruiken. Specifieke instructies voor het bewerken van configuratiebestanden zijn beschikbaar als u de renderingextensie, verificatie-extensies of gegevensverwerkingsextensies wilt aanpassen:

  5. Sla het bestand op.

  6. Controleer de traceerlogboekbestanden om te controleren of er geen fouten zijn opgetreden. Als u foutvoorwaarden ziet, wordt een instelling of de waarde ervan onjuist opgegeven. Controleer het RsReportServer.config configuratiebestand op geldige waarden voor een instelling die een fout veroorzaakt. Zie het traceringslogboek van de servicerapportservervoor meer informatie over hoe u het traceringslogboek kunt bekijken.

Verwante inhoud