XML 보고서 데이터를 위한 요소 경로 구문(SSRS)

아티클
11/09/2024

보고서 디자이너 대/소문자를 구분하는 요소 경로를 정의하여 XML 데이터 원본의 보고서에 사용할 데이터를 지정합니다. 요소 경로는 XML 데이터 원본에서 XML 계층적 노드 및 해당 특성을 트래버스하는 방법을 나타냅니다. 기본 요소 경로를 사용하려면 데이터 세트 쿼리 또는 XML 쿼리의 XML ElementPath를 비워 둡니다. XML 데이터 원본에서 데이터를 검색하면 텍스트 값과 요소 노드 특성이 있는 요소 노드가 결과 집합의 열이 됩니다. 쿼리를 실행할 때 노드 및 특성의 값은 행 데이터가 됩니다. 열은 보고서 데이터 창에서 데이터 세트 필드 컬렉션으로 표시됩니다. 이 항목에서는 요소 경로 구문을 설명합니다.

참고 항목

요소 경로 구문은 네임스페이스와 독립적입니다. 요소 경로에 네임스페이스를 사용하려면 XML 보고서 데이터를 위한 XML 쿼리 구문(SSRS)에 설명된 대로 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 태그와 일치해야 합니다.

용어	정의
요소 경로	XML 데이터 원본을 사용하여 데이터 세트의 필드 데이터를 검색하기 위해 XML 문서 내에서 트래버스할 노드 시퀀스를 정의합니다.
ElementNode	XML 문서의 XML 노드입니다. 노드는 태그로 지정되며 다른 노드와 계층 관계에 있습니다. 예를 들어 <Customers>는 루트 요소 노드이고 <Customer>는 <Customers>의 하위 요소입니다.
XMLName	노드의 이름입니다. 예를 들어 고객 노드의 이름은 Customers입니다. XMLName에는 네임스페이스 식별자를 접두사로 지정하여 모든 노드의 이름을 고유하게 지정할 수 있습니다.
인코딩	이 요소에 대한 Value 가 인코딩된 XML이므로 이 값을 디코딩하여 이 요소의 하위 요소로 포함해야 함을 나타냅니다.
FieldList	데이터를 검색하는 데 사용할 요소 및 특성 집합을 정의합니다. 지정하지 않으면 모든 특성 및 하위 항목이 필드로 사용됩니다. 빈 필드 목록을 지정하면({}) 이 노드의 필드가 사용되지 않습니다. FieldList에는 Value와 Element 또는 ElementNode가 모두 포함될 수 없습니다.
필드	데이터 세트 필드로 검색되는 데이터를 지정합니다.
Attribute	ElementNode 내의 이름-값 쌍입니다. 예를 들어 요소 노드 <Customer ID="1">에서 ID는 특성이며 @ID(Integer)는 해당 데이터 필드 ID에 정수 형식으로 "1"을 반환합니다.
값	요소의 값입니다. 값 은 요소 경로의 마지막 ElementNode 에서만 사용할 수 있습니다. 예를 들어 <Return>은 리프 노드이므로 요소 경로의 끝에 이 노드를 포함하면 Return {@} 값은 Chair가 됩니다.
요소	명명된 하위 요소의 값입니다. 예를 들어 Customers {}/Customer {}/LastName은 LastName 요소에 대한 값만 검색합니다.
Type	이 요소에서 만든 필드에 사용할 선택적 데이터 형식입니다.
NamespacePrefix	NamespacePrefix 는 XML 쿼리 요소에 정의됩니다. XML Query 요소가 없으면 XML ElementPath 의 네임스페이스는 무시됩니다. XML 쿼리 요소가 있으면 XML ElementPath 에 선택적 특성 IgnoreNamespaces가 포함됩니다. IgnoreNamespaces가 true이면 XML ElementPath 및 XML 문서의 네임스페이스가 무시됩니다. 자세한 내용은 XML 보고서 데이터를 위한 XML 쿼리 구문(SSRS)을 참조하세요.

예제 - 네임스페이스 없음

다음 예제에서는 XML 문서 Customers.xml 사용합니다. 이 표에서는 요소 경로 구문의 예를 보여 주고 XML 문서를 기본 데이터 원본으로 하여 데이터 세트를 정의하는 쿼리에 해당 요소 경로를 사용한 결과를 보여 줍니다.

참고 항목

요소 경로가 비어 있으면 쿼리는 기본 요소 경로인 리프 노드 컬렉션의 첫 번째 경로를 사용합니다. 첫 번째 예제에서 요소 경로를 비워 두는 것은 요소 경로 /Customers/Customer/Orders/Order를 지정하는 것과 같습니다. 경로의 모든 노드 값과 특성이 결과 집합에 반환되고 노드 이름과 특성 이름이 데이터 세트 필드로 표시됩니다.

예제 #1: 비어 있음

순서	수량	ID	FirstName	LastName	Customer.ID	Xmlns
Chair	6	1	Bobby	무어	11	https://www.adventure-works.com
테이블	1	2	Bobby	무어	11	https://www.adventure-works.com
소파	2	8	Crystal	Hu(후)	20	https://www.adventure-works.com
EndTables	2	15	와이엇 주	디아즈	33	https://www.adventure-works.com

예제 #2: Customers {}/Customer

FirstName	LastName	ID
Bobby	무어	11
Crystal	Hu(후)	20
와이엇 주	디아즈	33

예제 #3: Customers {}/Customer {}/LastName

LastName
무어
Hu(후)
디아즈

예제 #4: Customers {}/Customer {}/Orders/Order {@,@Qty}

순서	수량
Chair	6
테이블	1
소파	2
EndTables	2

예제 #5: Customers {}/Customer/Orders/Order{ @ID(Integer)}

Order.ID	FirstName	LastName	ID
1	Bobby	무어	11
2	Bobby	무어	11
8	Crystal	Hu(후)	20
15	와이엇 주	디아즈	33

XML 문서: Customers.xml

이전 섹션에서 요소 경로 예제를 사용해 보려면 이 XML을 복사하여 보고서 디자이너 액세스할 수 있는 URL에 저장한 다음 XML 문서를 XML 데이터 원본으로 사용할 수 있습니다. 예를 들면 다음과 같습니다https://localhost/Customers.xml.

<?xml version="1.0"?>  
<Customers xmlns="http://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>

또는 다음 절차를 사용하여 연결 문자열 없고 쿼리에 Customers.XML 포함하는 XML 데이터 원본을 만들 수 있습니다.

쿼리에 Customers.XML 포함하려면

빈 연결 문자열 사용하여 XML 데이터 원본을 만듭니다.
XML 데이터 원본에 대한 새 데이터 세트를 만듭니다.
데이터 세트 속성 대화 상자에서 쿼리 디자이너를 클릭합니다. 텍스트 기반 쿼리 디자이너 대화 상자가 열립니다.
쿼리 창에서 다음 두 줄을 입력합니다.

<Query>

<XmlData>
Customers.XML 복사한 후 <XmlData>쿼리 창에 텍스트를 붙여넣습니다.
쿼리 창에서 Customers.XML 복사한 첫 번째 줄을 삭제합니다. <?xml version="1.0"?>
쿼리의 끝에서 다음 두 줄을 추가합니다.

<XmlData>

<Query>
쿼리 실행(!)을 클릭합니다.

결과 집합에는 다음 열이 있는 4줄의 데이터가 표시됩니다. xmlnsCustomer.IDFirstNameLastNameIDQtyOrder
확인을 선택합니다.

다음을 통해 공유

XML 보고서 데이터를 위한 요소 경로 구문(SSRS)

구문

설명

예제 - 네임스페이스 없음

XML 문서: Customers.xml

쿼리에 Customers.XML 포함하려면

피드백

추가 리소스

다음을 통해 공유

XML 보고서 데이터를 위한 요소 경로 구문(SSRS)

구문

설명

예제 - 네임스페이스 없음

XML 문서: Customers.xml

쿼리에 Customers.XML 포함하려면

관련 콘텐츠

피드백

추가 리소스