在 RSReportServer.Config 中自訂轉譯延伸模組參數

尋找及修改 RSReportServer.config

報表輸出格式的組態設定會在 RSReportServer.config 檔中指定為轉譯延伸模組參數。若要指定組態檔中的轉譯延伸模組參數，您必須了解如何定義設定轉譯參數的 XML 結構。可進行修改的 XML 結構有兩種：

• OverrideNames 元素會定義轉譯延伸模組顯示的名稱和語言。

• DeviceInfo XML 結構會定義轉譯延伸模組所使用的裝置資訊設定。大部分的轉譯延伸模組參數會指定為裝置資訊設定。

您可以使用文字編輯器來修改 RSReportServer.config 檔案，此檔案可以在 \Reporting Services\Report Server\Bin 資料夾中找到。如需有關修改組態檔的詳細資訊，請參閱＜如何：修改 Reporting Services 組態檔＞。

變更顯示名稱

轉譯延伸模組的顯示名稱會出現在報表工具列的 [匯出] 清單中。預設顯示名稱的範例包括網頁封存、TIFF 檔案和 Acrobat (PDF) 檔案。藉著指定組態檔中的 OverrideNames 元素，您可以使用自訂的值來取代預設的顯示名稱。此外，如果您正在定義單一轉譯延伸模組的兩個執行個體，也可以使用 OverrideNames 元素在 [匯出] 清單中區分每一個執行個體。

由於顯示名稱已經當地語系化，如果您要使用自訂的值取代預設顯示名稱，就必須設定 Language 屬性。否則，任何指定的名稱都會被忽略。您所設定的語言值，對於報表伺服器電腦必須是有效值。例如，如果報表伺服器是在法文作業系統上執行，您應該指定「fr-FR」做為屬性值。

下列範例會說明在英文報表伺服器上提供自訂名稱的方法：

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

變更裝置資訊設定

若要修改已經部署在您報表伺服器上之轉譯延伸模組所使用的預設裝置資訊設定，您必須在組態檔中輸入 DeviceInfo XML 結構。每一個轉譯延伸模組都支援該延伸模組獨特的裝置資訊設定。若要檢視裝置資訊設定的完整清單，請參閱＜Reporting Services 裝置資訊設定＞。

下列範例會提供 XML 結構的說明，以及修改影像轉譯延伸模組預設設定的語法：

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

設定轉譯延伸模組的多個項目

您可以建立同一個轉譯延伸模組的多個執行個體，以支援不同的報表呈現選項。您定義的每個執行個體可以具有不同的參數值組合。定義現有轉譯延伸模組的執行個體時，請務必執行下列動作：

• 指定延伸模組的唯一名稱。

  每個延伸模組必須具有 Name 屬性的唯一值。下列範例會使用 "IMAGE (EMF Landscape)" 和 "IMAGE (EMF Portrait)" 的名稱來區分兩個執行個體。

  變更已經部署之轉譯延伸模組的名稱時，要特別小心，因為透過程式設計的方式指定轉譯延伸模組的開發人員，會使用延伸模組名稱來識別特定轉譯作業所使用的執行個體。如果您在報表伺服器上執行自訂的 Reporting Services 應用程式，請確定開發人員知道您修改了現有的延伸模組名稱，或是新增了新的延伸模組名稱。

• 請指定唯一的顯示名稱，如此使用者可以了解每一個輸出格式的差異。

  如果您為同一個延伸模組設定多個版本，則可以提供 OverrideNames 的值，藉此為每個版本指定一個唯一名稱。否則，在報表工具列的 [匯出] 清單中，每個版本的延伸模組都會有相同的名稱。

下列範例說明使用預設影像轉譯延伸模組 (這會產生 TIFF 輸出) 輸出縱向模式 EMF，連同以第二個執行個體輸出橫向模式 EMF 格式報表的方法。請注意，每個延伸模組名稱都是唯一的。測試此範例時，請記得選擇沒有包含互動式功能 (例如顯示/隱藏選項、矩陣或鑽研連結) 的報表，因為互動式功能不能在影像轉譯延伸模組中執行：

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

請參閱

參考

概念

變更記錄