Freigeben über

Anpassen von Renderingerweiterungsparametern in RSReportServer.Config

Sie können renderingerweiterungsparameter in der RSReportServer-Konfigurationsdatei angeben, um das Standardmäßige Berichtsrenderingverhalten für Berichte außer Kraft zu setzen, die auf einem Reporting Services-Berichtsserver ausgeführt werden. Sie können Renderingerweiterungsparameter ändern, um die folgenden Ziele zu erreichen:

  • Ändern Sie, wie der Name der Renderingerweiterung in der Exportliste der Berichtssymbolleiste angezeigt wird (z. B. um "Webarchiv" in "MHTML" zu ändern), oder lokalisieren Sie den Namen in einer anderen Sprache.

  • Erstellen Sie mehrere Instanzen derselben Renderingerweiterung, um verschiedene Optionen für die Berichtspräsentation zu unterstützen (z. B. eine Hoch- und Querformatversion der Bildrenderingerweiterung).

  • Ändern Sie die Standardparameter für die Renderingerweiterung so, dass unterschiedliche Werte verwendet werden (z. B. verwendet die Bildrenderingerweiterung TIFF als Standardausgabeformat; Sie können die Erweiterungsparameter ändern, um stattdessen EMF zu verwenden).

Das Ändern der Renderingerweiterungsparameter wirkt sich nur auf Renderingvorgänge auf dem Berichtsserver aus. Sie können die Renderingerweiterungseinstellungen in der Berichtsvorschau im Berichts-Designer nicht außer Kraft setzen.

Die Angabe von Renderingerweiterungsparametern in den Konfigurationsdateien beeinflusst die Renderingerweiterungen global. Die Einstellungen in den Konfigurationsdateien werden anstelle von Standardwerten verwendet, wenn eine bestimmte Renderingerweiterung verwendet wird. Wenn Sie Renderingerweiterungsparameter für einen bestimmten Bericht oder Rendervorgang festlegen möchten, müssen Sie Geräteinformationen programmgesteuert mithilfe der Render Methode oder durch Angeben von Geräteinformationseinstellungen für eine Berichts-URL angeben. Weitere Informationen zum Angeben von Geräteinformationseinstellungen für einen Rendervorgang und zum Anzeigen der vollständigen Liste der Geräteinformationseinstellungen finden Sie unter Übergeben von Geräteinformationseinstellungen an Renderingerweiterungen.

Suchen und Ändern von RSReportServer.config

Konfigurationseinstellungen für Berichtsausgabeformate werden als Renderingerweiterungsparameter in der RSReportServer.config Datei angegeben. Um Renderingerweiterungsparameter in den Konfigurationsdateien anzugeben, müssen Sie wissen, wie Sie die XML-Strukturen definieren, die Renderingparameter festlegen. Es gibt zwei XML-Strukturen, die Sie ändern können:

  • Das OverrideNames Element definiert den Anzeigenamen und die Sprache der Renderingerweiterung.

  • Die DeviceInfo XML-Struktur definiert die Geräteinformationseinstellungen, die von einer Renderingerweiterung verwendet werden. Die meisten Renderingerweiterungsparameter werden als Geräteinformationseinstellungen angegeben.

Sie können einen Text-Editor verwenden, um die Datei zu ändern. Die datei "RSReportServer.config" befindet sich im Ordner "\Reporting Services\Report Server\Bin". Weitere Informationen zum Ändern von Konfigurationsdateien finden Sie unter "Ändern einer Reporting Services-Konfigurationsdatei (RSreportserver.config)".

Ändern des Anzeigenamens

Der Anzeigename einer Render-Erweiterung erscheint in der Exportliste der Berichtstoolleiste. Beispiele für Standardanzeigenamen sind Webarchiv, TIFF-Datei und Acrobat-Datei (PDF). Sie können den Standardanzeigenamen durch einen benutzerdefinierten Wert ersetzen, indem Sie das OverrideNames Element in den Konfigurationsdateien angeben. Wenn Sie außerdem zwei Instanzen einer einzelnen Renderingerweiterung definieren, können Sie das OverrideNames Element verwenden, um jede Instanz in der Exportliste zu unterscheiden.

Da Anzeigenamen lokalisiert sind, müssen Sie das Language Attribut festlegen, wenn Sie den Standardanzeigenamen durch einen benutzerdefinierten Wert ersetzen. Andernfalls werden alle von Ihnen angegebenen Namen ignoriert. Der von Ihnen festgelegte Sprachwert muss für den Berichtsservercomputer gültig sein. Wenn beispielsweise der Berichtsserver auf einem französischen Betriebssystem ausgeführt wird, sollten Sie "fr-FR" als Attributwert angeben.

Im folgenden Beispiel wird veranschaulicht, wie sie einen benutzerdefinierten Namen auf einem englischen Berichtsserver bereitstellen:

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

Ändern der Geräteinformationseinstellungen

Zum Ändern von Standardeinstellungen für Geräteinformationen, die von einer Renderingerweiterung verwendet werden, die bereits auf dem Berichtsserver bereitgestellt wurde, müssen Sie die DeviceInfo XML-Struktur in die Konfigurationsdateien eingeben. Jede Renderingerweiterung unterstützt Geräteinformationseinstellungen, die für diese Erweiterung eindeutig sind. Informationen zum Anzeigen der vollständigen Liste der Geräteinformationseinstellungen finden Sie unter Übergeben von Geräteinformationseinstellungen an Renderingerweiterungen.

Das folgende Beispiel enthält eine Abbildung der XML-Struktur und -Syntax, die die Standardeinstellungen der Bildrenderingerweiterung ä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 mehrerer Einträge für eine Renderingerweiterung

Sie können mehrere Instanzen derselben Renderingerweiterung erstellen, um unterschiedliche Berichtspräsentationsoptionen zu unterstützen. Jede von Ihnen definierte Instanz kann eine andere Kombination aus Parameterwerten aufweisen. Wenn Sie neue Instanzen einer vorhandenen Renderingerweiterung definieren, gehen Sie folgendermaßen vor:

  • Geben Sie einen eindeutigen Namen für die Erweiterung an.

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

    Achten Sie beim Ändern des Namens einer bereits bereitgestellten Renderingerweiterung auf Vorsicht. Entwickler, die Renderingerweiterungen programmgesteuert angeben, verwenden den Erweiterungsnamen, um zu identifizieren, welche Instanz für einen bestimmten Rendervorgang verwendet werden soll. Wenn Sie benutzerdefinierte Reporting Services-Anwendungen auf Ihrem Berichtsserver ausführen, stellen Sie sicher, dass der Entwickler weiß, ob Sie einen vorhandenen Erweiterungsnamen ändern oder einen neuen hinzufügen.

  • Geben Sie einen eindeutigen Anzeigenamen an, damit Benutzer 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 angeben.OverrideNames Andernfalls scheinen alle Versionen der Erweiterung in der Liste "Exportoptionen" auf der Berichtssymbolleiste denselben Namen zu haben.

Im folgenden Beispiel wird veranschaulicht, wie Sie die Standarderweiterung "Bildrendering" (die TIFF-Ausgabe erzeugt) zum Ausgeben von EMF im Hochformatmodus zusammen mit einer zweiten Instanz verwenden, die Berichte im EMF im Querformatmodus ausgibt. Beachten Sie, dass jeder Erweiterungsname eindeutig ist. Denken Sie beim Testen dieses Beispiels daran, Berichte auszuwählen, die keine interaktiven Features enthalten, z. B. Ein-/Ausblenden von Optionen, Matrizen oder Drillthroughlinks (interaktive Features funktionieren in der Bildrenderingerweiterung 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 Portait Mode</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <OutputFormat>EMF</OutputFormat>  
                <PageHeight>11in</PageHeight>  
                <PageWidth>8.5in</PageWidth>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
</Render>

Siehe auch

RSReportServer-Konfigurationsdatei
RSReportDesigner Configuration File (RSReportDesigner-Konfigurationsdatei)
CSV-Geräteinformationseinstellungen
Excel-Geräteinformationseinstellungen
HTML-Geräteinformationseinstellungen
Bildgerät-Informationseinstellungen
MHTML-Geräteinformationseinstellungen
PDF-Geräteinformationseinstellungen
XML-Geräteinformationseinstellungen

  • Last updated on