Personalizzare i parametri dell'estensione di rendering in RSReportServer.Config

Puoi specificare i parametri di estensione di rendering nel file di configurazione RSReportServer per sovrascrivere il comportamento predefinito di rendering dei report per i report che girano su un server di report Reporting Services. Puoi modificare i parametri di estensione di rendering per raggiungere i seguenti obiettivi:

  • Cambia come appare il nome dell'estensione di rendering nella lista Esporta della barra dei report (ad esempio, per cambiare "Web archive" in "MHTML"), oppure localizza il nome in un'altra lingua.

  • Creare più istanze della stessa estensione di rendering per supportare diverse opzioni di presentazione dei report (ad esempio, una versione in modalità verticale e orizzontale dell'estensione di rendering Image).

  • Modifica i parametri predefiniti dell'estensione di rendering per usare valori diversi (ad esempio, l'estensione Image rendering usa TIFF come formato di output predefinito; puoi modificare i parametri dell'estensione per usare invece l'EMF).

Modificare i parametri dell'estensione di rendering influisce solo sulle operazioni di rendering sul server di report. Non puoi sovrascrivere le impostazioni delle estensioni di rendering nell'anteprima del report in Progettazione report.

La specificazione dei parametri delle estensioni di rendering nei file di configurazione influisce sulle estensioni di rendering a livello globale. Le impostazioni nei file di configurazione vengono utilizzate al posto dei valori predefiniti ogni volta che viene utilizzata una particolare estensione di rendering. Se vuoi impostare parametri di estensione di rendering per un report o un'operazione di rendering specifica, devi specificare le informazioni del dispositivo in modo programmativo usando il Render metodo o specificando le impostazioni delle informazioni del dispositivo su un URL del report. Per maggiori informazioni sulla specifica delle impostazioni informative del dispositivo per un'operazione di rendering e per visualizzare l'elenco completo delle impostazioni delle informazioni del dispositivo, consulta Passa impostazioni informazioni del dispositivo alle estensioni di rendering.

Trova e modifica RSReportServer.config

Le impostazioni di configurazione per i formati di output dei report sono specificate come parametri di estensione di rendering nel file RSReportServer.config. Per specificare i parametri di estensione di rendering nei file di configurazione, devi sapere come definire le strutture XML che impostano i parametri di rendering. Ci sono due strutture XML che puoi modificare:

  • L'elemento OverrideNames definisce il nome di visualizzazione e la lingua dell'estensione di rendering.

  • La struttura XML di DeviceInfo definisce le impostazioni di informazione del dispositivo utilizzate da un'estensione di rendering. La maggior parte dei parametri delle estensioni di rendering è specificata come impostazioni di informazione del dispositivo.

Puoi usare un editor di testo per modificare il file. Il file RSReportServer.config si trova nella cartella \Reporting Services\Report Server\Bin. Per maggiori informazioni sulla modifica dei file di configurazione, vedi Modifica un file di configurazione Reporting Services (RSreportserver.config).

Cambia il nome visualizzato

Il nome visualizzato di un'estensione di rendering viene visualizzato nell'elenco Esporta della barra degli strumenti del report. Esempi di nomi visualizzati predefiniti includono Web archive, file TIFF e file Acrobat (PDF). Puoi sostituire il nome visualizzato predefinito con un valore personalizzato specificando l'elemento OverrideNames nei file di configurazione. Inoltre, se stai definendo due istanze di una singola estensione di rendering, puoi usare l'elemento OverrideNames per distinguere ogni istanza nella lista Export.

Poiché i nomi di visualizzazione sono localizzati, devi impostare l'attributo Lingua se stai sostituendo il nome visualizzato predefinito con un valore personalizzato. Altrimenti, qualsiasi nome tu specifichi verrà ignorato. Il valore linguistico che hai impostato deve essere valido per il computer server di report. Ad esempio, se il server di report è in esecuzione su un sistema operativo francese, dovresti specificare "fr-FR" come valore dell'attributo.

Il seguente esempio illustra come fornire un nome personalizzato su un server di report in inglese:

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

Modifica le impostazioni delle informazioni del dispositivo

Per modificare le impostazioni predefinite delle informazioni del dispositivo utilizzate da un'estensione di rendering già distribuita sul tuo server di report, devi digitare la struttura XML DeviceInfo nei file di configurazione. Ogni estensione di rendering supporta impostazioni di informazione del dispositivo uniche per quell'estensione. Per visualizzare l'elenco completo delle impostazioni delle informazioni del dispositivo, vedi Passaggio delle impostazioni delle informazioni del dispositivo alle estensioni di rendering.

Il seguente esempio fornisce un'illustrazione della struttura e della sintassi XML che modifica le impostazioni predefinite dell'estensione di rendering Image:

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

Configura più voci per un'estensione per il rendering

Puoi creare più istanze della stessa estensione di rendering per supportare diverse opzioni di presentazione dei report. Ogni istanza che definisci può avere una combinazione diversa di valori di parametri. Quando definisci nuove istanze di un'estensione di rendering esistente, assicurati di fare quanto segue:

  • Specifica un nome unico per l'estensione.

    Ogni istanza deve avere un valore unico per l'attributo Nome . Il seguente esempio utilizza i nomi "IMAGE (EMF Landscape)" e "IMAGE (EMF Portrait)" per distinguere tra le due istanze.

    Fai attenzione quando cambi il nome di un'estensione di rendering già implementata. Gli sviluppatori che specificano estensioni di rendering in modo programmativo usano il nome dell'estensione per identificare quale istanza utilizzare per una particolare operazione di rendering. Se stai utilizzando applicazioni Reporting Services personalizzate sul tuo server di report, assicurati che lo sviluppatore sappia se modifichi il nome di un'estensione esistente o ne aggiungi uno nuovo.

  • Specificare un nome di visualizzazione unico affinché gli utenti possano comprendere le differenze per ogni formato di output.

    Se configuri più versioni della stessa estensione, puoi dare a ciascuna versione un nome unico fornendo un valore per OverrideNames. Altrimenti, tutte le versioni dell'estensione appariranno con lo stesso nome nell'elenco delle opzioni di esportazione nella barra dei rapporti.

Il seguente esempio illustra come utilizzare l'estensione predefinita per il rendering Image (che produce output TIFF) per produrre EMF in modalità Portrait insieme a una seconda istanza che genera report in EMF in modalità Landscape. Nota che ogni nome di estensione è unico. Quando si testa questo esempio, ricorda di scegliere report che non contengano funzionalità interattive come opzioni di mostra/nascondere, matrici o collegamenti di perforazione (le funzionalità interattive non funzionano nell'estensione di rendering Image):

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

Contenuti correlati

  • Last updated on