Festlegen von Renderingerweiterungsparametern in Konfigurationsdateien

Artikel
12/15/2008

Aktualisiert: 14. April 2006

Sie können in der RSReportServer-Konfigurationsdatei Parameter für Renderingerweiterungen angeben, um das standardmäßige Rendern von Berichten zu überschreiben, die auf einem Reporting Services-Berichtsserver ausgeführt werden. Sie können die Parameter für Renderingerweiterungen ändern, um Folgendes zu bewirken:

Ändern der Anzeige des Renderingerweiterungsnamens in der Exportliste der Berichtssymbolleiste (z. B. Ändern von "Webarchiv" in "MHTML") oder Lokalisieren des Namens in eine andere Sprache.
Erstellen mehrerer Instanzen derselben Renderingerweiterung, um verschiedene Berichtspräsentationsoptionen zu unterstützen (z. B. Darstellung einer Bildrenderingerweiterung im Hoch- und im Querformat).
Ändern der standardmäßigen Renderingerweiterungsparameter, um verschieden Werte zu verwenden (beispielsweise wird für die Bildrenderingerweiterung TIFF als Standardausgabeformat verwendet; sie können die Erweiterungsparameter so ändern, dass stattdessen EMF verwendet wird).

Eine Änderung der Parameter für Renderingerweiterungen wirkt sich nur auf die Renderingvorgänge auf dem Berichtsserver aus. Sie können die Renderingerweiterungseinstellungen in der Berichtsvorschau im Berichts-Designer nicht überschreiben.

Wenn Sie Parameter für Renderingerweiterungen in den Konfigurationsdateien angeben möchten, müssen Sie wissen, wie die XML-Strukturen definiert werden, die Renderingparameter festlegen. Es stehen zwei XML-Strukturen zur Verfügung, die geändert werden können:

Das OverrideNames-Element definiert den Anzeigenamen und die Sprache der Renderingerweiterung.
Die DeviceInfo-XML-Struktur definiert die von einer Renderingerweiterung verwendeten Geräteinformationseinstellungen. Die meisten Parameter für Renderingerweiterungen werden als Geräteinformationseinstellungen angegeben.

Die Angabe von Parametern für Renderingerweiterungen in den Konfigurationsdateien wirkt sich global auf Renderingerweiterungen aus. Die Einstellungen in den Konfigurationsdateien werden bei Verwendung einer bestimmten Renderingerweiterung statt der Standardwerte verwendet. Wenn Sie Renderingerweiterungsparameter für einen bestimmten Bericht oder Rendervorgang festlegen möchten, müssen Sie die Geräteinformationen entweder programmgesteuert mithilfe der Render-Methode angeben oder durch Angabe der Geräteinformationseinstellungen für einen Berichts-URL. Weitere Informationen zum Angeben von Geräteinformationseinstellungen für einen Rendervorgang und zum Anzeigen der vollständigen Liste der Geräteinformationseinstellungen finden Sie unter Reporting Services Device Information Settings.

Suchen und Ändern von RSReportServer.config

Parameter für Renderingerweiterungen werden in der Datei RSReportServer.config angegeben. Sie können die Datei mithilfe eines Text-Editors ändern. Die Datei RSReportServer.config befindet sich im Ordner \Reporting Services\Report Server\Bin. Weitere Informationen zum Ändern von Konfigurationsdateien finden Sie unter Reporting Services-Konfigurationsdateien.

Ändern des Anzeigenamens

Der Anzeigename für eine Renderingerweiterung wird in der Exportliste der Berichtssymbolleiste angezeigt. Zu den Standardanzeigenamen gehören unter anderem Webarchiv, TIFF-Datei und Acrobat-Datei (PDF-Datei). Sie können den Standardanzeigenamen durch einen benutzerdefinierten Wert ersetzen, indem Sie in den Konfigurationsdateien das OverrideNames-Element angeben. Darüber hinaus können Sie das OverrideNames-Element verwenden, um die einzelnen Instanzen in der Exportliste voneinander zu unterscheiden, wenn Sie zwei Instanzen für eine einzelne Renderingerweiterung definieren.

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

Im folgenden Beispiel wird dargestellt, wie Sie einen benutzerdefinierten Namen auf einem englischen Berichtsserver bereitstellen:

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

Ändern der Geräteinformationseinstellungen

Wenn Sie die standardmäßigen Geräteinformationseinstellungen ändern möchten, die von einer bereits auf dem Berichtsserver bereitgestellten Renderingerweiterung verwendet werden, müssen Sie die DeviceInfo-XML-Struktur in die Konfigurationsdateien eingeben. Jede Renderingerweiterung unterstützt Geräteinformationseinstellungen, die für die jeweilige Erweiterung eindeutig sind. Die vollständige Liste der Geräteinformationseinstellungen finden Sie unter Reporting Services Device Information Settings.

Im folgenden Beispiel wird die XML-Struktur und -Syntax veranschaulicht, mit der die Standardeinstellungen für die Bildrenderingerweiterung geändert werden:

<Render>
    <Extension Name="IMAGE (EMF)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageReport,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, damit verschiedene Berichtspräsentationsoptionen unterstützt werden. Die von Ihnen definierten Instanzen können verschiedene Kombinationen der Parameterwerte aufweisen. Stellen Sie beim Definieren neuer Instanzen einer vorhandenen Renderingerweiterung Folgendes sicher:

Geben Sie einen eindeutigen Namen für die Erweiterung an.
Jede Instanz muss über einen eindeutigen Wert für das Name-Attribut verfügen. Im folgenden Beispiel werden die Namen "IMAGE (EMF Landscape)" und "IMAGE (EMF Portrait)" verwendet, um die beiden Instanzen voneinander unterscheiden zu können.
Gehen Sie beim Ändern des Namens für eine bereits bereitgestellte Renderingerweiterung mit Bedacht vor. Entwickler, die Renderingerweiterungen programmgesteuert angeben, verwenden den Erweiterungsnamen zur Identifizierung der für einen bestimmten Rendervorgang zu verwendenden Instanz. Stellen Sie sicher, dass der Entwickler informiert wird, sobald Sie einen vorhandenen Erweiterungsnamen ändern oder einen neuen hinzufügen, wenn Sie eine benutzerdefinierte Reporting Services-Anwendung auf dem Berichtsserver ausführen.
Geben Sie einen eindeutigen Anzeigenamen an, damit Benutzer die Unterschiede zwischen den einzelnen Ausgabeformaten nachvollziehen können.
Wenn Sie mehrere Versionen derselben Erweiterung konfigurieren, können Sie für jede Version einen eindeutigen Namen verwenden, indem Sie einen Wert für OverrideNames angeben. Andernfalls weisen alle Versionen der Erweiterung in der Exportoptionenliste auf der Berichtssymbolleiste denselben Namen auf.

Im folgenden Beispiel wird die Verwendung der standardmäßigen Bildrenderingerweiterung veranschaulicht (wobei das Ausgabeformat TIFF erstellt wird), um die EMF im Hochformat auszugeben, sowie eine zweite Instanz, mit der Berichte als EMF im Querformat ausgegeben werden. Beachten Sie, dass die einzelnen Erweiterungsnamen eindeutig sind. Achten Sie beim Testen dieses Beispiels darauf, dass Sie Berichte auswählen, die keine interaktiven Features wie Optionen zum Ein- und Ausblenden, Matrizen oder Drillthroughlinks enthalten (interaktive Features können in Bildrenderingerweiterungen nicht ausgeführt werden).

<Render>
    <Extension Name="IMAGE (EMF Landscape)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageReport,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.ImageReport,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

Änderungsverlauf

Version	Verlauf
14. April 2006	Neuer Inhalt: Ändern von Anzeigenamen

Festlegen von Renderingerweiterungsparametern in Konfigurationsdateien

Suchen und Ändern von RSReportServer.config

Ändern des Anzeigenamens

Ändern der Geräteinformationseinstellungen

Konfigurieren mehrerer Einträge für eine Renderingerweiterung

Siehe auch

Konzepte

Andere Ressourcen

Hilfe und Informationen

Änderungsverlauf

Zusätzliche Ressourcen