XML 中的 RDL 元素和屬性 (報表產生器)

當報表被另存為 XML 檔案時，「報表產生器」需要將報表定義語言 (RDL) 翻譯成 XML。XML 匯出選項會將報表項目另存為 XML 文件中的元素或屬性。每一個元素都可有一組屬性或子元素與其關聯。屬性或元素會依報表項目不同而不同。此主題討論另存為 XML 時要將 RDL 結構描述變更為何。

報表

Report 是 XML 根節點。它包含了指定 XML 文件和報表名稱之結構描述資訊的屬性。

XML 根節點中指定的「XML 結構描述 (XSD)」如下所示：

<Report xmlns="SchemaName" xmlns:sxi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="SchemaName ReportURL&rs:ImageID=SchemaName" Name="ReportName">

下表描述 XML 匯出選項儲存 Report RDL 元素中之屬性和元素的方式。

RDL 屬性	另存為
Name	根元素的 Name 屬性。

文字方塊

下表描述 XML 匯出選項儲存文字方塊的方式。文字方塊名稱和值另存為元素還是屬性要視文字方塊的 DataElementStyle RDL 元素值而定。

RDL 元素	另存為
DataElementName	文字方塊元素或屬性的名稱。如果未指定 DataElementName，則預設名稱為 RDL 中之文字方塊的名稱。
Value	文字方塊中資料的值。

資料表

下表描述 XML 匯出選項儲存資料表的方式。資料表另存為元素。

RDL 元素	另存為
DataElementName	資料表元素的名稱。如果未指定 DataElementName，則元素的名稱為 RDL 中之資料表的名稱。
TableGroup	第一個 TableGroup 元素會另存為資料表元素的子元素。每個後續 TableGroup 元素會另存為上一個 TableGroup 元素之群組執行個體的子元素。如此會產生巢狀資料群組。
Details	最後一個 TableGroup 元素之每一個群組執行個體的子元素。如果沒有資料表群組，則 Details 會另存為資料表元素的子元素。

TableGroup

下表描述 XML 匯出選項儲存資料表群組的方式。資料表群組會另存為元素。

RDL 元素	另存為
DataCollectionName (Grouping)	資料表群組元素的名稱。如果未指定 DataCollectionName，則元素的名稱為 DataElementName 元素中所指定的名稱加上字串 "_Collection"。
DataElementName (Grouping)	群組執行個體元素的名稱。群組執行個體元素是資料表群組元素的子元素。如果未指定 DataElementName，則元素的名稱為 RDL 中之群組的名稱。
Header	標頭中的所有項目都會另存為群組執行個體元素的子元素或屬性。

詳細資料

下表描述 XML 匯出選項儲存 Details RDL 元素中之屬性和元素的方式。Details 會另存為元素。

RDL 元素	另存為
DataCollectionName (Grouping)	詳細資料元素的名稱。如果未指定 DataCollectionName，則元素的名稱為 DataElementName 元素中所指定的名稱加上字串 "_Collection"。如果 Details 中沒有群組，則元素的名稱為 Detail_Collection。
DataElementName (Grouping)	群組執行個體元素的名稱。群組執行個體元素是詳細資料元素的子元素。如果未指定 DataElementName，則元素的名稱為 RDL 中之群組的名稱。如果 Details 中沒有群組，則元素的名稱為 Detail。
DetailsRows	詳細資料列中的所有項目都會另存為群組執行個體元素的子元素或屬性。

矩陣

下表描述 XML 匯出選項儲存矩陣的方式。矩陣會另存為元素。

RDL 元素	另存為
DataElementName	矩陣元素的名稱。如果未指定 DataElementName，則元素的名稱為 RDL 中之矩陣的名稱。
Corner	邊角中的所有項目都會另存為矩陣元素的子元素或屬性。
RowGrouping	第一個 RowGrouping 元素會另存為矩陣元素的子元素。每個後續 RowGrouping 元素會另存為上一個 RowGrouping 元素之群組執行個體的子元素。如此會產生巢狀資料群組。
ColumnGrouping	第一個 ColumnGrouping 元素會另存為最後一個 RowGrouping 元素之每個群組執行個體的子元素。每個後續 ColumnGrouping 元素會另存為上一個 ColumnGrouping 元素之群組執行個體的子元素。
MatrixCell	最後一個 ColumnGrouping 元素之每一個群組執行個體中的 Cell 子元素。矩陣資料格中的所有項目都會另存為 Cell 元素的子元素或屬性。

RowGrouping

下表描述 XML 匯出選項儲存資料列群組的方式。資料列群組會另存為元素。

RDL 元素	另存為
DataCollectionName (Grouping)	資料列群組元素的名稱。如果未指定 DataCollectionName，則元素的名稱為 DataElementName 元素中所指定的名稱加上字串 "_Collection"。不能用於靜態資料列群組。
DataElementName (Grouping)	群組執行個體元素的名稱。群組執行個體元素是資料列群組元素的子元素。如果未指定 DataElementName，則元素的名稱為 RDL 中之群組的名稱。對於靜態資料列群組，元素名稱為文字方塊在所使用之群組標頭中的 DataElementName 值。如果靜態資料列標頭沒有文字方塊，則元素名稱為 RowN，其中 N 是指派給資料列群組的數字。
ReportItems	資料列群組中的所有項目都會另存為資料列群組元素之父系的子元素或屬性。
Subtotal	資料列群組元素同層級的元素。此元素包含矩陣資料格。此元素的名稱為小計之 DataElementName 元素中所指定的名稱。如果未指定名稱，則元素的名稱為 Total。

附註：
依預設不會儲存小計。XML 匯出選項只在小計之 DataElementOutput RDL 元素值為 Output 時才會儲存小計。

ColumnGrouping

下表描述 XML 匯出選項儲存資料行群組的方式。資料行群組會另存為元素。

RDL 元素	另存為
DataCollectionName (Grouping)	資料行群組元素的名稱。如果未指定 DataCollectionName，則元素的名稱為 DataElementName 元素中所指定的名稱加上字串 "_Collection"。不能用於靜態資料行群組。
DataElementName (Grouping)	群組執行個體元素的名稱。群組執行個體元素是資料行群組元素的子元素。如果未指定 DataElementName，則元素的名稱為 RDL 中之群組的名稱。對於靜態資料行群組，元素的名稱為文字方塊在所使用之群組標頭中的 DataElementName 值。如果靜態資料行標頭沒有文字方塊，則元素名稱為 ColumnN，其中 N 是指派給資料行群組的數字。
ReportItems	資料行群組中的所有項目都會另存為資料行群組元素之父系的子元素或屬性。
Subtotal	和資料行群組元素同層級的元素。此元素包含矩陣資料格。此元素的名稱為小計之 DataElementName 元素中所指定的名稱。如果未指定名稱，則元素的名稱為 Total。

附註：
依預設不會儲存小計。XML 匯出選項只在小計之 DataElementOutput RDL 元素值為 Output 時才會儲存小計。

為了更好地瞭解 XML 匯出選項如何將報表中的「報表定義語言 (RDL)」元素另存為 XML 檔案，您可能想要進一步了解該元素的詳細資訊。如需有關 RDL 元素的詳細資訊，請參閱《SQL Server 2005 線上叢書》中的＜報表定義語言＞主題。

請參閱

Last updated on 2008-12-15

共用方式為