用于指定 XML 报表数据的元素路径语法 (Report Builder 2.0)
在 Report Builder 2.0 中,可以通过定义区分大小写的元素路径来指定 XML 数据源中要用于报表的数据。元素路径指示如何遍历 XML 数据源中的 XML 层次结构节点及其属性。若要使用默认元素路径,请将数据集查询或 XML Query 的 XML ElementPath 保留为空。从 XML 数据源检索数据时,具有文本值的元素节点和元素节点属性将成为结果集中的列。运行查询时,节点值和属性将成为行数据。该列在“报表数据”窗格中显示为数据集字段集合。本主题介绍元素路径语法。
注意 |
---|
元素路径语法与命名空间无关。若要在元素路径中使用命名空间,请使用包括用于指定 XML 报表数据的 XML 查询语法 (Report Builder 2.0)中介绍的 XML ElementPath 元素的 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 标记。 |
字词 |
定义 |
---|---|
Element path |
定义为了使用 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) 将返回“1”表示对应数据字段 ID 中的整数类型。 |
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 查询语法 (Report Builder 2.0)。 |
示例 - 无命名空间
以下示例使用 XML 文档 Customers.xml。此表以此 XML 文档作为数据源,在此基础上显示了元素路径语法的示例,以及在定义数据集的查询中使用相应元素路径所得到的结果。
注意 |
---|
当元素路径为空时,查询将使用默认元素路径:指向叶节点集合的第一个路径。在第一个示例中,将元素路径保留为空等效于指定元素路径 /Customers/Customer/Orders/Order。将在结果集中返回沿该路径分布的所有节点值和属性,并且节点名和属性名将显示为数据集字段。 |
示例 |
数据集中的字段 |
---|---|
空 |
OrderQtyIDFirstNameLastNameCustomer.IDxmlns
Chair61BobbyMoore11https://www.adventure-works.com
Table12BobbyMoore11https://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
表1
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
使用空连接字符串创建一个 XML 数据源。
为 XML 数据源创建新的数据集。
在**“数据集属性”对话框中,单击“查询设计器”**。基于文本的查询设计器对话框打开。
在查询窗格中,输入以下两行:
<Query>
<XmlData>
复制 Customers.XML 并将文本粘贴到 <XmlData> 之后的查询窗格中。
在查询窗格中,删除从 Customers.XML 中复制的第一行:<?xml version="1.0"?>
在查询的结尾添加以下两行:
<XmlData>
<Query>
单击**“运行查询”**(!)。
结果集的以下列中显示 4 行数据:xmlns、Customer.ID、FirstName、LastName、ID、Qty、Order。
单击“确定”。