Rendering-Erweiterungsparameter in RSReportServer.Config anpassen

Sie können in der RSReportServer-Konfigurationsdatei Rendering-Erweiterungsparameter angeben, um das Standard-Berichtsrendering-Verhalten für Berichte, die auf einem Reporting Services-Reportserver laufen, zu überschreiben. Sie können die Rendering-Erweiterungsparameter anpassen, um folgende Ziele zu erreichen:

  • Ändern Sie, wie der Name der Rendering-Erweiterung in der Exportliste der Berichtsleiste erscheint (zum Beispiel um "Web archive" in "MHTML" zu ändern), oder lokalisieren Sie den Namen in eine andere Sprache.

  • Erstelle mehrere Instanzen derselben Rendering-Erweiterung, um unterschiedliche Berichtspräsentationsoptionen zu unterstützen (zum Beispiel eine Hoch- und Querformatversion der Bild-Rendering-Erweiterung).

  • Ändere die Standardparameter der Rendering-Erweiterung, um andere Werte zu verwenden (zum Beispiel verwendet die Bild-Rendering-Erweiterung TIFF als Standardausgabeformat; du kannst die Erweiterungsparameter anpassen, um stattdessen EMF zu verwenden).

Die Änderung der Rendering-Erweiterungsparameter wirkt sich nur auf die Rendering-Operationen auf dem Berichtsserver aus. Sie können die Rendering-Erweiterungseinstellungen in der Berichtsvorschau im Berichts-Designer nicht überschreiben.

Die Angabe von Render-Erweiterungsparametern in den Konfigurationsdateien beeinflusst die Render-Erweiterungen global. Die Einstellungen in den Konfigurationsdateien werden anstelle von Standardwerten verwendet, wann immer eine bestimmte Rendering-Erweiterung verwendet wird. Wenn Sie Rendering-Erweiterungsparameter für einen bestimmten Bericht oder eine Renderoperation festlegen möchten, müssen Sie Geräteinformationen programmatisch mit der Methode Render oder durch Angabe von Geräteinformationseinstellungen auf einer Berichts-URL angeben. Für weitere Informationen zur Spezifizierung von Geräteinformationseinstellungen für eine Renderoperation und zur vollständigen Liste der Geräteinformationseinstellungen siehe Pass device information settings to rendering extensions.

Finde und verändere RSReportServer.config

Konfigurationseinstellungen für Berichtsausgabeformate werden als Rendering-Erweiterungsparameter in der RSReportServer.config-Datei angegeben. Um Rendering-Erweiterungsparameter in den Konfigurationsdateien zu spezifizieren, muss man wissen, wie man die XML-Strukturen definiert, die Rendering-Parameter festlegen. Es gibt zwei XML-Strukturen, die Sie ändern können:

  • Das OverrideNames-Element definiert den Anzeigenamen und die Sprache der Rendering-Erweiterung.

  • Die DeviceInfo XML-Struktur definiert die Geräteinformationseinstellungen, die von einer Rendering-Erweiterung verwendet werden. Die meisten Rendering-Erweiterungsparameter sind als Geräteinformationseinstellungen angegeben.

Du kannst einen Texteditor verwenden, um die Datei zu bearbeiten. Die RSReportServer.config-Datei ist im Ordner \Reporting Services\Report Server\Bin zu finden. Weitere Informationen zum Ändern von Konfigurationsdateien finden Sie unter Modify a Reporting Services configuration file (RSreportserver.config).

Ändere den Anzeigenamen

Der Anzeigename einer Rendering-Erweiterung erscheint in der Exportliste der Berichtsleiste. Beispiele für Standard-Anzeigenamen sind Webarchive, TIFF-Datei und Acrobat-(PDF)-Datei. Du kannst den Standard-Anzeigenamen durch einen benutzerdefinierten Wert ersetzen, indem du das OverrideNames-Element in den Konfigurationsdateien angibst. Außerdem kannst du, wenn du zwei Instanzen einer einzigen Rendering-Erweiterung definierst, das Element OverrideNames verwenden, um jede Instanz in der Exportliste zu unterscheiden.

Da Anzeigenamen lokalisiert sind, müssen Sie das Attribut Language festlegen, wenn Sie den Standard-Anzeigenamen durch einen benutzerdefinierten Wert ersetzen. Andernfalls wird jeder von dir angegebene Name ignoriert. Der von dir festgelegte Sprachwert muss für den Berichtsserver gültig sein. Wenn der Berichtsserver beispielsweise auf einem französischen Betriebssystem läuft, sollten Sie "fr-FR" als Attributwert angeben.

Das folgende Beispiel zeigt, wie man auf einem englischen Berichtsserver einen benutzerdefinierten Namen bereitstellt:

<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>

Einstellungen für Geräteinformationen ändern

Um die Standardeinstellungen der Geräteinformationen zu ändern, die von einer bereits auf Ihrem Berichtsserver bereitgestellten Rendering-Erweiterung verwendet werden, müssen Sie die DeviceInfo XML-Struktur in die Konfigurationsdateien eingeben. Jede Rendering-Erweiterung unterstützt Geräteinformationseinstellungen, die einzigartig für diese Erweiterung sind. Die vollständige Liste der Einstellungen für Geräteinformationen finden Sie unter Übergeben von Einstellungen für Geräteinformationen an Rendering-Erweiterungen.

Das folgende Beispiel zeigt eine Illustration der XML-Struktur und -Syntax, die die Standardeinstellungen der Bildrendering-Erweiterung ändert:

<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>

Konfigurieren Sie mehrere Einträge für eine Rendering-Erweiterung

Man kann mehrere Instanzen derselben Rendering-Erweiterung erstellen, um unterschiedliche Berichtspräsentationsoptionen zu unterstützen. Jede Instanz, die du definierst, kann eine andere Kombination von Parameterwerten haben. Wenn Sie neue Instanzen einer bestehenden Rendering-Erweiterung definieren, sollten Sie Folgendes tun:

  • Gib einen eindeutigen Namen für die Erweiterung an.

    Jede Instanz muss einen eindeutigen Wert für das Name-Attribut haben. Das folgende Beispiel verwendet die Namen "IMAGE (EMF Landscape)" und "IMAGE (EMF Portrait)", um zwischen den beiden Instanzen zu unterscheiden.

    Seien Sie vorsichtig, wenn Sie den Namen einer bereits bereitgestellten Rendering-Erweiterung ändern. Entwickler, die programmatisch Rendering-Erweiterungen angeben, verwenden den Erweiterungsnamen, um zu bestimmen, welche Instanz für eine bestimmte Renderoperation verwendet werden soll. Wenn Sie benutzerdefinierte Reporting Services-Anwendungen auf Ihrem Berichtsserver ausführen, stellen Sie sicher, dass der Entwickler weiß, ob Sie einen bestehenden Erweiterungsnamen ändern oder eine neue hinzufügen.

  • Geben Sie einen eindeutigen Anzeigenamen an, damit Nutzer die Unterschiede für jedes Ausgabeformat verstehen können.

    Wenn Sie mehrere Versionen derselben Erweiterung konfigurieren, können Sie jeder Version einen eindeutigen Namen geben, indem Sie einen Wert für OverrideNames angeben. Andernfalls scheinen alle Versionen der Erweiterung in der Liste der Exportoptionen in der Symbolleiste des Berichts denselben Namen zu haben.

Das folgende Beispiel veranschaulicht, wie die Standarderweiterung für die Bildwiedergabe (die TIFF-Ausgabe erzeugt) verwendet wird, um EMF im Hochformat auszugeben, zusammen mit einer zweiten Instanz, die Berichte im EMF-Format im Querformat ausgibt. Beachten Sie, dass jeder Erweiterungsname eindeutig ist. Beim Testen dieses Beispiels sollten Sie Berichte auswählen, die keine interaktiven Funktionen wie Anzeigen/Verbergen-Optionen, Matrizen oder Drillthrough-Links enthalten (interaktive Funktionen funktionieren in der Bild-Rendering-Erweiterung nicht):

<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>

Verwandte Inhalte

  • Last updated on