指定 XML 報表資料的元素路徑語法 (SSRS)

在「報表設計師」中，可藉由定義區分大小寫的元素路徑來指定要用於 XML 資料來源中之報表的資料。元素路徑會指出在 XML 資料來源中周遊 XML 階層式節點及其屬性的方法。若要使用預設的元素路徑，請將資料集查詢或 XML ElementPath (屬於 XML Query) 保留空白。由 XML 資料來源擷取資料時，具有文字值的元素節點以及元素節點屬性會變成結果集內的資料行。執行查詢時，節點及屬性的值會變成資料列資料。這些資料行會以資料集欄位集合的方式顯示在 [報表資料] 窗格中。此主題描述元素路徑語法。

[!附註]

元素路徑與命名空間無關。若要在元素路徑中使用命名空間，請使用包含 XML ElementPath 元素 (如＜指定 XML 報表資料的 XML 查詢語法 (SSRS)＞中所描述) 的 XML 查詢語法。

下表描述定義元素路徑所使用的慣例。

慣例	適用於
粗體字	文字必須完全依照顯示的樣子輸入。
| (分隔號)	會分隔語法項目，您只能選擇其中一個項目。
[ ] (方括號)	選擇性的語法項目，不要輸入方括號。
{ } (大括號)	會分隔語法項目的參數。
[,...n]	指出先前項目可以重複 n 次，以逗號分開各次出現項目。

語法

Element path ::=
    ElementNode[/Element path]
ElementNode ::=
    XMLName[(Encoding)][{[FieldList]}]
XMLName ::=
    [NamespacePrefix:]XMLLocalName
Encoding ::=
        HTMLEncoded | Base64Encoded
FieldList ::=
    Field[,FieldList]
Field ::=
    Attribute | Value | Element | ElementNode
Attribute ::=
        @XMLName[(Type)]
Value ::=
        @[(Type)]
Element ::=
    XMLName[(Type)]
Type ::=
        String | Integer | Boolean | Float | Decimal | Date | XML 
NamespacePrefix ::=
    Identifier that specifies the namespace.
XMLLocalName :: =
    Identifier in the XML tag. 

備註

下表摘要說明元素路徑的詞彙。表格中的範例會參考範例 XML 文件 Customers.xml (包含在本主題的「範例」一節中)。

[!附註]

XML 標記有區分大小寫。在元素路徑中指定 ElementNode 時，必須完全符合資料來源中的 XML 標記。

詞彙	定義
元素路徑	定義 XML 文件中周遊節點的順序，以便使用 XML 資料來源擷取資料集的欄位資料。
ElementNode	XML 文件中的 XML 節點。節點是由標記指定，並存在於與其他節點構成的階層式關聯性中。例如，<Customers> 是根元素節點。<Customer> 是 <Customers> 的子元素。
XMLName	節點的名稱。例如，Customers 節點的名稱為 Customers。XMLName 可以使用命名空間識別碼做為前置詞，以確保所有節點的名稱都是唯一的。
Encoding	指出本元素的 Value 是已編碼的 XML，需要加以解碼並加入做為此元素的子元素。
FieldList	定義用來擷取資料的元素與屬性組合。 如果沒有指定，所有屬性和子元素都會做為欄位使用。如果指定了空的欄位清單 ({})，不會使用這個節點的任何欄位。 FieldList 可能不會同時包含 Value 及 Element 或 ElementNode。
Field	指定擷取做為資料集欄位的資料。
Attribute	ElementNode 中名稱與值的配對。例如，在 <Customer ID="1"> 元素節點中，ID 為一屬性，而 @ID(Integer) 會在對應的資料欄位 ID 中以整數資料類型傳回 "1"。
Value	該元素的值，Value 只能在元素路徑中最後一個 ElementNode 上使用。例如，因為 <Return> 是一個分葉節點，如果將它加入元素路徑的結尾，Return {@} 的值會是 Chair。
Element	具名子元素的值。例如，Customers {}/Customer {}/LastName 只會擷取 LastName 元素的值。
Type	此元素建立之欄位所使用的選擇性資料類型。
NamespacePrefix	NamespacePrefix 是在 XML 查詢元素中定義。如果 XML 查詢元素不存在，則會省略 XML ElementPath 中的命名空間。如果有 XML 查詢元素，XML ElementPath 則會有選擇性的 IgnoreNamespaces 屬性。如果 IgnoreNamespaces 為 true，則會忽略 XML ElementPath 以及 XML 文件中的命名空間。如需詳細資訊，請參閱＜指定 XML 報表資料的 XML 查詢語法 (SSRS)＞。

範例 - 沒有命名空間

下列範例會使用 XML 文件 Customers.xml。這個表格會顯示元素路徑語法的範例，並且以 XML 文件為資料來源，顯示在定義資料集的查詢中使用元素路徑的結果。

[!附註]

如果元素路徑為空時，查詢會使用預設的元素路徑：到達分葉節點集合的第一條路徑。在第一個範例中，將元素路徑保留為空白相當於將元素路徑指定為 /Customers/Customer/Orders/Order。路徑上的所有節點值和屬性都會傳回到結果集，而節點名稱和屬性會以資料集欄位的方式顯示。

範例	資料集內的欄位
空的	OrderQtyIDFirstNameLastNameCustomer.IDxmlns Chair61BobbyMoore11https://www.adventure-works.com 資料表12BobbyMoore11https://www.adventure-works.com Sofa28CrystalHu20https://www.adventure-works.com EndTables215WyattDiaz33https://www.adventure-works.com
Customers {}/Customer	FirstNameLastNameID BobbyMoore11 CrystalHu20 WyattDiaz33
Customers {}/Customer {}/LastName	LastName Moore Hu Diaz
Customers {}/Customer {}/Orders/Order {@,@Qty}	OrderQty Chair6 Table1 Sofa2 EndTables2
Customers {}/Customer/Orders/Order{ @ID(Integer)}	Order.IDFirstNameLastNameID 1BobbyMoore11 2BobbyMoore11 8CrystalHu20 15WyattDiaz33

XML 文件：Customers.xml

若要嘗試前一節中的元素路徑範例，可以複製這段 XML 並將它儲存為報表設計師可以存取的 URL，然後使用 XML 文件做為 XML 資料來源：例如，https://localhost/Customers.xml。

<?xml version="1.0"?>
<Customers xmlns="https://www.adventure-works.com">
   <Customer ID="11">
      <FirstName>Bobby</FirstName>
      <LastName>Moore</LastName>
      <Orders>
         <Order ID="1" Qty="6">Chair</Order>
         <Order ID="2" Qty="1">Table</Order>
      </Orders>
      <Returns>
         <Return ID="1" Qty="2">Chair</Return>
      </Returns>
   </Customer>
   <Customer ID="20">
      <FirstName>Crystal</FirstName>
      <LastName>Hu</LastName>
      <Orders>
         <Order ID="8" Qty="2">Sofa</Order>
      </Orders>
      <Returns/>
   </Customer>
   <Customer ID="33">
      <FirstName>Wyatt</FirstName>
      <LastName>Diaz</LastName>
      <Orders>
         <Order ID="15" Qty="2">EndTables</Order>
      </Orders>
      <Returns/>
   </Customer>
</Customers>

您也可以使用下列程序來建立 XML 資料來源，其中不包含連接字串，查詢中也不內嵌 Customers.XML。

在查詢中內嵌 Customers.XML

1. 使用空白連接字串建立 XML 資料來源。

2. 建立 XML 資料來源的新資料集。

3. 在 [資料集屬性] 對話方塊中，按一下 [查詢設計工具]。以文字為基礎的查詢設計工具對話方塊隨即開啟。

4. 在查詢窗格中，輸入下列兩行程式碼：

   <Query>

   <XmlData>

5. 複製 Customers.XML，然後將這些文字貼在查詢窗格中的 <XmlData> 之後。

6. 在查詢窗格中，刪除從 Customers.XML 複製的第一行程式碼：<?xml version="1.0"?>

7. 在查詢尾端，加入下列兩行程式碼：

   <XmlData>

   <Query>

8. 按一下 [執行查詢] (!)。

   結果集會顯示具有下列資料行的 4 行資料：xmlns、Customer.ID、FirstName、LastName、ID、Qty、Order。

9. 按一下 [確定]。

請參閱

工作

如何：加入、編輯、重新整理報表資料窗格中的欄位 (報表產生器 3.0 和 SSRS)

概念

XML 連接類型 (SSRS)

其他資源

教學課程 (SSRS)