Stel renderextensieparameters aan in RSReportServer.Config

Je kunt renderextensieparameters specificeren in het RSReportServer-configuratiebestand om het standaard rapportrenderingsgedrag voor rapporten die op een Reporting Services-rapportserver draaien te overschrijven. Je kunt rendering-extensieparameters aanpassen om de volgende doelstellingen te bereiken:

  • Verander hoe de naam van de renderextensie verschijnt in de Exportlijst van de rapportwerkbalk (bijvoorbeeld om "Web archive" te veranderen in "MHTML"), of lokaliseer de naam naar een andere taal.

  • Maak meerdere instanties van dezelfde renderextensie aan om verschillende rapportagepresentatie-opties te ondersteunen (bijvoorbeeld een portret- en landschapsversie van de Image rendering-extensie).

  • Verander de standaard parameters van de renderextensie zodat ze andere waarden gebruiken (bijvoorbeeld, de Image rendering extensie gebruikt TIFF als standaard uitvoerformaat; je kunt de extensieparameters aanpassen om in plaats daarvan EMF te gebruiken).

Het wijzigen van de parameters van de renderextensie beïnvloedt alleen renderingsoperaties op de rapportserver. Je kunt rendering-extensie-instellingen niet overschrijven in Report Preview in Report Designer.

Het specificeren van renderextensieparameters in de configuratiebestanden beïnvloedt renderextensies wereldwijd. De instellingen in de configuratiebestanden worden gebruikt in plaats van standaardwaarden telkens wanneer een bepaalde renderextensie wordt gebruikt. Als je rendering-extensieparameters wilt instellen voor een specifieke rapportage- of renderoperatie, moet je apparaatinformatie programmatisch specificeren met de Render methode of door apparaatinformatie-instellingen op een rapportage-URL te specificeren. Voor meer informatie over het specificeren van apparaatinformatie-instellingen voor een renderoperatie, en om de volledige lijst van apparaatinformatie-instellingen te bekijken, zie Pass device information settings to rendering extensies.

Zoek RSReportServer.config en wijzig dit bestand

Configuratie-instellingen voor rapportuitvoerformaten worden gespecificeerd als rendering-extensieparameters in het RSReportServer.config-bestand. Om renderextensieparameters in de configuratiebestanden te specificeren, moet je weten hoe je de XML-structuren definieert die renderingparameters instellen. Er zijn twee XML-structuren die je kunt aanpassen:

  • Het OverrideNames-element definieert de weergavenaam en taal van de renderextensie.

  • De DeviceInfo XML-structuur definieert de apparaatinformatie-instellingen die door een renderingsextensie worden gebruikt. De meeste parameters van rendering-extensies worden gespecificeerd als apparaatinformatie-instellingen.

Je kunt een teksteditor gebruiken om het bestand aan te passen. Het RSReportServer.config-bestand is te vinden in de map \Reporting Services\Report Server\Bin. Voor meer informatie over het wijzigen van configuratiebestanden, zie Een Reporting Services configuratiebestand wijzigen (RSreportserver.config).

Verander de weergavenaam

De weergavenaam van een renderingsextensie verschijnt in de Exportlijst van de rapportwerkbalk. Voorbeelden van standaard weergavenamen zijn Webarchive, TIFF-bestand en Acrobat (PDF)-bestand. Je kunt de standaard weergavenaam vervangen door een aangepaste waarde door het OverrideNames-element in de configuratiebestanden te specificeren. Daarnaast, als je twee instanties van één renderextensie definieert, kun je het OverrideNames-element gebruiken om elke instantie in de Export-lijst te onderscheiden.

Omdat weergavenamen gelokaliseerd zijn, moet je het Language-attribuut instellen als je de standaard weergavenaam vervangt door een aangepaste waarde. Anders wordt elke naam die je opgeeft genegeerd. De taalwaarde die je instelt moet geldig zijn voor de rapportservercomputer. Als de rapportserver bijvoorbeeld draait op een Frans besturingssysteem, moet je "fr-FR" als attribuutwaarde specificeren.

Het volgende voorbeeld illustreert hoe je een aangepaste naam kunt geven op een Engelse rapportserver:

<Extension Name="XML" Type="Microsoft.ReportingServices.Rendering.DataRenderer.XmlDataReport,Microsoft.ReportingServices.DataRendering">  
   <OverrideNames>  
     <Name Language="en-US">My Custom Display Name for XML Rendering</Name>  
   </OverrideNames>  
</Extension>

Verander apparaatinformatie-instellingen

Om de standaard apparaatinformatie-instellingen te wijzigen die worden gebruikt door een renderingsextensie die al op je rapportserver is uitgerold, moet je de DeviceInfo XML-structuur in de configuratiebestanden typen. Elke rendering-extensie ondersteunt apparaatinformatie-instellingen die uniek zijn voor die extensie. Raadpleeg Apparaatinformatie-instellingen doorgeven aan renderextensies voor de volledige lijst met apparaatinformatie-instellingen.

Het volgende voorbeeld geeft een illustratie van de XML-structuur en syntaxis die de standaardinstellingen van de Image rendering-extensie aanpast:

<Render>  
    <Extension Name="IMAGE (EMF)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">Image (EMF)</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <ColorDepth>32</ColorDepth>  
                <DpiX>300</DpiX>  
                <DpiY>300</DpiY>  
                <OutputFormat>EMF</OutputFormat>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
</Render>

Configureer meerdere entries voor een rendering-extensie

Je kunt meerdere instanties van dezelfde renderextensie maken om verschillende rapportage-opties te ondersteunen. Elke instantie die je definieert kan een andere combinatie van parameterwaarden hebben. Bij het definiëren van nieuwe instanties van een bestaande renderextensie, doe dan het volgende:

  • Specificeer een unieke naam voor de extensie.

    Elke instantie moet een unieke waarde hebben voor het Name-attribuut. Het volgende voorbeeld gebruikt de namen "IMAGE (EMF Landscape)" en "IMAGE (EMF Portrait)" om de twee instanties te onderscheiden.

    Wees voorzichtig bij het wijzigen van de naam van een renderextensie die al is uitgerold. Ontwikkelaars die renderextensies programmatisch specificeren, gebruiken de extensienaam om te bepalen welke instantie voor een bepaalde renderoperatie moet worden gebruikt. Als je aangepaste Reporting Services-applicaties op je rapportserver draait, zorg er dan voor dat de ontwikkelaar weet of je een bestaande extensienaam wijzigt of een nieuwe toevoegt.

  • Specificeer een unieke weergavenaam zodat gebruikers de verschillen voor elk uitvoerformaat kunnen begrijpen.

    Als je meerdere versies van dezelfde extensie configureert, kun je elke versie een unieke naam geven door een waarde voor OverrideNames te geven. Anders zullen alle versies van de extensie dezelfde naam hebben in de lijst met exportopties op de rapportbalk.

Het volgende voorbeeld illustreert hoe je de standaard Image rendering extensie (die TIFF-output produceert) kunt gebruiken om EMF in Portretmodus uit te geven, naast een tweede instantie die rapporten in EMF uitvoert in Landschapsmodus. Let op dat elke extensienaam uniek is. Bij het testen van dit voorbeeld, kies dan rapporten die geen interactieve functies bevatten zoals toon/verberg-opties, matrices of drillthrough-links (interactieve functies werken niet in de Image rendering-extensie):

<Render>  
    <Extension Name="IMAGE (EMF Landscape)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">EMF in Landscape Mode</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <OutputFormat>EMF</OutputFormat>  
                <PageHeight>8.5in</PageHeight>  
                <PageWidth>11in</PageWidth>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
    <Extension Name="IMAGE (EMF Portrait)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">EMF in Portrait Mode</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <OutputFormat>EMF</OutputFormat>  
                <PageHeight>11in</PageHeight>  
                <PageWidth>8.5in</PageWidth>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
</Render>

Verwante onderwerpen

  • Last updated on